fleet/articles/role-based-access.md

Role-based access

Users have different abilities depending on the access level they have.

Roles

Admin

Users with the admin role receive all permissions.

Maintainer

Maintainers can manage most entities in Fleet, like queries, policies, and labels.

Unlike admins, maintainers cannot edit higher level settings like application configuration, fleets or users.

Technician

Applies only to Fleet Premium

Technicians have the ability to run scripts, view their results, and install/uninstall software.

Observer

The observer role is a read-only role. It can access most entities in Fleet, like queries, policies, labels, application configuration, fleets, etc.

They can also run queries configured with the observer_can_run flag set to true.

Observer+

Applies only to Fleet Premium

Observer+ is an observer with the added ability to run any report.

GitOps

Applies only to Fleet Premium

GitOps is a modern approach to Continuous Deployment (CD) that uses Git as the single source of truth for declarative infrastructure and application configurations. GitOps is an API-only and write-only role that can be used on CI/CD pipelines.

User permissions

Action	Observer	Observer+*	Technician*	Maintainer	Admin	GitOps*
View all activity	✅	✅	✅	✅	✅
Cancel hosts' upcoming activity				✅	✅
Manage activity automations					✅	✅
View all hosts	✅	✅	✅	✅	✅
View a host by identifier	✅	✅	✅	✅	✅	✅
Filter hosts using labels	✅	✅	✅	✅	✅
Target hosts using labels	✅	✅	✅	✅	✅
Add/remove manual labels to/from hosts			✅	✅	✅	✅
Add and delete hosts				✅	✅
Transfer hosts between fleets*				✅	✅	✅
Add user information from IdP to hosts*				✅	✅
Create, edit, and delete labels			✅	✅	✅	✅
View all software	✅	✅	✅	✅	✅
Add, edit, and delete software				✅	✅	✅
Download added software			✅	✅	✅
Install/uninstall software on hosts			✅	✅	✅
Filter software by vulnerabilities	✅	✅	✅	✅	✅
Filter hosts by software	✅	✅	✅	✅	✅
Filter software by fleet*	✅	✅	✅	✅	✅
Manage vulnerability automations					✅	✅
Run queries designated "observer can run" as live queries against all hosts	✅	✅	✅	✅	✅
Run any query as live query against all hosts		✅	✅	✅	✅
Create, edit, and delete queries				✅	✅	✅
View all queries and their reports	✅	✅	✅	✅	✅	✅
Manage query automations				✅	✅	✅
Create, edit, view, and delete packs				✅	✅	✅
View all policies	✅	✅	✅	✅	✅	✅
Run all policies		✅	✅	✅	✅
Filter hosts using policies	✅	✅	✅	✅	✅
Create, edit, and delete policies for all hosts				✅	✅	✅
Create, edit, and delete policies for all hosts in a fleet*				✅	✅	✅
Edit "All fleets" policy automations					✅	✅
Edit any fleet's policy automations: calendar events, install software, and run script*				✅	✅	✅
Edit any fleet's policy automations: other workflows (tickets and webhooks)*					✅	✅
Edit "Unassigned" policy automations					✅	✅
View users**	✅	✅	✅	✅	✅
Create, edit, view, and delete users					✅
Add and remove a fleet's users*					✅	✅
Create, edit, and delete fleets*					✅	✅
Create, edit, and delete enroll secrets				✅	✅	✅
Create, edit, and delete enroll secrets for a fleet*				✅	✅
Read organization settings**	✅	✅	✅	✅	✅	✅
Read Single Sign-On settings**					✅
Read SMTP settings**					✅
Read osquery agent options**					✅
Edit organization settings					✅	✅
Edit agent options					✅	✅
Edit agent options for hosts in a fleet*					✅	✅
Initiate file carving				✅	✅
Retrieve contents from file carving					✅
Create Apple Push Certificates service (APNs) certificate signing request (CSR)					✅
View, edit, and delete APNs certificate					✅
View, edit, and delete Apple Business Manager (ABM) connections					✅
View, edit, and delete Volume Purchasing Program (VPP) connections					✅
Connect Android Enterprise					✅
View disk encryption key for macOS, Windows, and Linux hosts	✅	✅	✅	✅	✅
Edit OS updates for macOS, Windows, iOS, and iPadOS hosts					✅	✅
Create, edit, resend and delete configuration profiles for Apple (macOS/iOS/iPadOS), Windows, and Android hosts				✅	✅	✅
View and resend configuration profiles for Apple (macOS/iOS/iPadOS), Windows, and Android hosts			✅	✅	✅	✅
Execute MDM commands on macOS and Windows hosts**				✅	✅	✅
View results of MDM commands executed on macOS and Windows hosts**	✅	✅	✅	✅	✅
Edit OS settings				✅	✅	✅
View all OS settings			✅	✅	✅	✅
Edit setup experience*				✅	✅	✅
Add and edit identity provider for end user authentication, end user license agreement (EULA), and end user migration workflow*					✅
Add and edit certificate authorities (CA)*					✅	✅
Request certificates (CA)*					✅	✅
Run scripts on hosts			✅	✅	✅
Schedule scripts on hosts				✅	✅
View saved scripts*	✅	✅	✅	✅	✅
Edit/upload saved scripts*				✅	✅	✅
Lock, unlock, and wipe hosts*				✅	✅
Turn off MDM for specific hosts				✅	✅
Configure Microsoft Entra conditional access integration					✅
Add Microsoft Entra tenant					✅
View custom variables	✅	✅	✅	✅	✅
Create, edit, and delete custom variables	✅	✅	✅	✅	✅

* Applies only to Fleet Premium

** Applies only to Fleet REST API

Fleet-level user permissions

Applies only to Fleet Premium

Users in Fleet either have global access or access to specific fleets.

Users with access to specific fleets only have access to the hosts, software, and policies assigned to their fleet.

Users with global access have access to all hosts, software, queries, and policies. Check out the user permissions table above for global user permissions.

Users can be assigned to multiple fleets in Fleet.

Users with access to multiple fleets can be assigned different roles for each fleet. For example, a user can be given access to the "💻 Workstations" fleet and assigned the "Observer" role. This same user can be given access to the "📱🔐 Personal mobile devices" fleet and assigned the "Maintainer" role.

Action	Observer	Observer+	Technician	Maintainer	Admin	GitOps
View hosts	✅	✅	✅	✅	✅
View a host by identifier	✅	✅	✅	✅	✅	✅
Filter hosts using labels	✅	✅	✅	✅	✅
Target hosts using labels	✅	✅	✅	✅	✅
View hosts' past and upcoming activity	✅	✅	✅	✅	✅
Cancel hosts' upcoming activity				✅	✅
Add/remove manual labels to/from hosts			✅	✅	✅	✅
Create and edit self-authored labels			✅	✅	✅	✅
Add and delete hosts				✅	✅
View software	✅	✅	✅	✅	✅
Add, edit, and delete software				✅	✅	✅
Download added software			✅	✅	✅
Install/uninstall software on hosts			✅	✅	✅
Filter software by vulnerabilities	✅	✅	✅	✅	✅
Filter hosts by software	✅	✅	✅	✅	✅
Filter software	✅	✅	✅	✅	✅
Run queries designated "observer can run" as live queries against hosts	✅	✅	✅	✅	✅
Run any query as live query		✅	✅	✅	✅
Create, edit, and delete self-authored queries				✅	✅	✅
View the fleet's queries and their reports	✅	✅	✅	✅	✅
View global (inherited) queries and their reports**	✅	✅	✅	✅	✅
Manage query automations				✅	✅	✅
View the fleet's policies	✅	✅	✅	✅	✅
Run the fleet's policies as a live policy		✅	✅	✅	✅
View global (inherited) policies	✅	✅	✅	✅	✅
Run global (inherited) policies as a live policy		✅	✅	✅	✅
Filter hosts using policies	✅	✅	✅	✅	✅
Create, edit, and delete fleet-level policies				✅	✅	✅
Edit fleet-level policy automations: calendar events, install software, and run script				✅	✅	✅
Edit fleet-level policy automations: other workflows (tickets and webhooks)					✅	✅
Add and remove fleet-level users					✅	✅
Edit the fleet's name					✅	✅
Create, edit, and delete a fleet's enroll secrets				✅	✅
Read organization settings*	✅	✅	✅	✅	✅	✅
Read agent options*	✅	✅	✅	✅	✅
Edit agent options					✅	✅
Initiate file carving				✅	✅
View disk encryption key for macOS hosts	✅	✅	✅	✅	✅
Edit OS updates for macOS, Windows, iOS, and iPadOS hosts					✅	✅
Create, edit, resend and delete configuration profiles for Apple (macOS/iOS/iPadOS), Windows, and Android hosts				✅	✅	✅
View and resend configuration profiles for Apple (macOS/iOS/iPadOS), Windows, and Android hosts			✅	✅	✅	✅
Execute MDM commands on macOS and Windows hosts*				✅	✅
View results of MDM commands executed on macOS and Windows hosts*	✅	✅	✅	✅	✅
Edit a fleet's OS settings				✅	✅	✅
Edit setup experience*				✅	✅	✅
Run scripts on hosts			✅	✅	✅
Schedule scripts on hosts				✅	✅
View saved scripts	✅	✅	✅	✅	✅
Edit/upload saved scripts				✅	✅
View script details by host	✅	✅	✅	✅	✅
Lock, unlock, and wipe hosts				✅	✅
Turn off MDM for specific hosts				✅	✅
View custom variables	✅	✅	✅	✅	✅

* Applies only to Fleet REST API

** Fleet-level users only see global report results for hosts on fleets where they have access.