Add FDA requirement + links to safari_extensions.yml (#33069)

Added reference to FDA requirement along with links to enable FDA and a
pre-created mobileconfig per discussion in product office hours
(9/16/25). ~Josh 🖖🏻
This commit is contained in:
Josh Roskos
2025-09-17 12:48:58 -04:00
committed by GitHub
parent ea238f4e88
commit 035d4f4839
3 changed files with 4 additions and 9 deletions
+1 -3
View File
@@ -210,15 +210,13 @@ Also, remember to replace both `AC_USERNAME` and `AC_PASSWORD` environment varia
### Grant full disk access to osquery on macOS
MacOS does not allow applications to access all system files by default.
macOS does not allow applications to access all system files by default.
If you are using an MDM solution or Fleet's MDM features, one of which is required to deploy these profiles, you can deploy a "Privacy Preferences Policy Control" policy to grant fleetd or osquery that level of access.
This is required to query for files located in protected paths as well as to use event
tables that require access to the [EndpointSecurity API](https://developer.apple.com/documentation/endpointsecurity#overview), such as *es_process_events*.
#### Creating the configuration profile
##### Obtaining identifiers
If you use plain osquery, instructions are [available here](https://osquery.readthedocs.io/en/stable/deployment/process-auditing/).
+1 -1
View File
@@ -23973,7 +23973,7 @@
],
"evented": false,
"cacheable": false,
"notes": "Because Safari data is intentionally isolated for each macOS user to maintain privacy, this query requires a `JOIN` operation.\n\nQuery explanation:\n\n- The `safari_extensions` table has a row for each installed extension\n- Each row has a column with the `uid` of the user who installed the extension\n- Each `uid` from the `safari_extensions` table is matched in the `users` table to collect Safari extensions in the output data for all user accounts on the Mac by the `JOIN`\n\nLinks:\n\n- Apple dcoumentaion on Safari Extensions: https://support.apple.com/en-us/102343\n- CROSS JOIN SQLite tutorial: https://www.sqlitetutorial.net/sqlite-cross-join/\n- [Fleet documentation on joining against the `users` table](https://fleetdm.com/guides/osquery-consider-joining-against-the-users-table)\n- Fleet users table: https://fleetdm.com/tables/users",
"notes": "Because Safari data is intentionally isolated for each macOS user to maintain privacy, this query requires [giving osquery full disk access](https://fleetdm.com/guides/enroll-hosts#grant-full-disk-access-to-osquery-on-macos) and a [`JOIN` against the `users` table](https://fleetdm.com/guides/osquery-consider-joining-against-the-users-table).\n\nQuery explanation:\n\n- The `safari_extensions` table has a row for each installed extension\n- Each row has a column with the `uid` of the user who installed the extension\n- Each `uid` from the `safari_extensions` table is matched in the `users` table to collect Safari extensions in the output data for all user accounts on the Mac by the `JOIN`\n\nLinks:\n\n- [Apple documentation on Safari Extensions](https://support.apple.com/en-us/102343)",
"examples": "Collect Safari extensions for all Mac users:\n\n```\nSELECT * FROM users CROSS JOIN safari_extensions USING (uid);\n```",
"columns": [
{
+2 -5
View File
@@ -9,7 +9,7 @@ examples: |-
SELECT * FROM users CROSS JOIN safari_extensions USING (uid);
```
notes: |-
Because Safari data is intentionally isolated for each macOS user to maintain privacy, this query requires a `JOIN` operation.
Because Safari data is intentionally isolated for each macOS user to maintain privacy, this query requires [giving osquery full disk access](https://fleetdm.com/guides/enroll-hosts#grant-full-disk-access-to-osquery-on-macos) and a [`JOIN` against the `users` table](https://fleetdm.com/guides/osquery-consider-joining-against-the-users-table).
Query explanation:
@@ -19,7 +19,4 @@ notes: |-
Links:
- Apple dcoumentaion on Safari Extensions: https://support.apple.com/en-us/102343
- CROSS JOIN SQLite tutorial: https://www.sqlitetutorial.net/sqlite-cross-join/
- [Fleet documentation on joining against the `users` table](https://fleetdm.com/guides/osquery-consider-joining-against-the-users-table)
- Fleet users table: https://fleetdm.com/tables/users
- [Apple documentation on Safari Extensions](https://support.apple.com/en-us/102343)