Nerdio Compass Permissions and Access Reference

Nerdio Compass is built to need as little from your environment as possible. Signing in and exploring the product requires no special privilege at all, and connecting Compass to your environment - if you choose to - only ever grants read-only access. This reference answers the questions people ask most often about what Compass needs, when, and from whom. 

Getting started

Do I need administrator privileges to sign in to Compass?

No. Signing in and completing setup requires only a work or school account - no administrator role of any kind, and no elevated privilege. You don't need to be a Global Administrator, and nothing is granted to Compass in your tenant at this stage. Administrator privilege only becomes relevant once you decide to connect a platform to Compass, which is always a separate, deliberate step you take later, after you've already seen the product. 

What happens the first time I sign in?

You sign in with your own work or school account (Compass never sees your password, since authentication is delegated to your own identity provider), choose the region your workspace's data will live in, tell us a little about yourself and your organization, and accept the terms of service. Compass then creates a workspace private to your organization. At this point the workspace is empty - nothing has been read from your environment, because nothing has been connected yet. 

What if my organization blocks users from consenting to new applications?

If your organization restricts user consent, your first sign-in will pause and ask for administrator approval instead of continuing. A Global Administrator (or Privileged Role Administrator, or Cloud Application Administrator) approves the Compass sign-in application once, for the whole tenant - after that, everyone else signs in normally. This approval covers sign-in only: reading your name and email so Compass knows who you are. It grants no access to your directory, devices, subscriptions, or data - those are separate grants that only happen if you choose to connect a platform. 

What does inviting a colleague to my workspace require?

Just a work or school account - nothing else. An invited colleague's first sign-in is condensed to brief context about the product, followed by whatever they were invited into. 

Are there different permission levels within a Compass workspace?

No - Compass has no roles inside a workspace. Anyone who's a member can do everything the workspace can do: import snapshots, connect platforms, add subscriptions, export reports, and change report branding. Invite people on the same basis you'd grant them the underlying access, since membership is the only boundary inside a workspace. Workspaces themselves are strictly isolated from one another - your organization can never see another organization's data. 

Connecting your environment

Do I need to connect Compass to my environment at all?

No. Every platform Compass supports can be assessed without granting Compass any access to your environment, by running an export tool yourself and uploading the file it produces. That upload path requires no consent, no service principal, no API client, and no inbound network access from Compass to you - there's nothing for a security team to approve except the file leaving your building. 

Connecting a platform directly is entirely optional, and it's always a decision you make after you've already seen the product - you're never asked for it during first-run setup. 

What's the difference between a "snapshot" and a "connection"?

A snapshot is the point-in-time capture of your environment's configuration that Compass actually assesses - it's the same underlying data whether it was produced by an export tool you ran yourself or captured through a direct connection. A connection is the read-only link Compass uses to reach into your environment. Having a connection doesn't create a snapshot by itself - it just lets you capture and import one directly from within Compass, without needing to run a separate tool and upload the result. 

Which platforms can Compass connect to directly?

The following table shows what a direct connection is available for today, and who in your organization needs to approve it. Other supported platforms - including Citrix Virtual Apps and Desktops (CVAD) - are assessed via snapshot upload only, at least for now. 

To connect

Who approves it

What it grants

Microsoft (Entra, Intune, Windows 365)

A Global Administrator

Admin consent to 13 read-only Microsoft Graph permissions

An Azure subscription (Azure Virtual Desktop)

Someone with Owner or User Access Administrator on that subscription

A Reader-equivalent role assignment

Citrix DaaS (Citrix Cloud)

A Citrix Cloud administrator

A read-only API client

Any platform, by upload

Nobody

Nothing - you run an export yourself and upload the file

Citrix

Do I need to connect Compass to my Citrix environment?

No. You can capture a snapshot of your Citrix environment with the Citrix Export tool and import it into Compass without granting Compass any access to your Citrix environment at all. This is the only option for Citrix Virtual Apps and Desktops (CVAD) environments today, and it remains a fully supported option for Citrix DaaS environments too, for organizations that would rather not open a direct connection from Compass to their production environment. 

What are the advantages of a direct connection between Compass and my Citrix environment?

A direct connection doesn't change what Compass can see - it changes how conveniently you can capture and import a snapshot. Instead of running the Citrix Export tool yourself and then uploading the file it produces, you can select Import snapshot directly in Compass, choose your Citrix DaaS connection, and Compass creates and imports the snapshot for you in one step. From the Connections page, you can also trigger a new snapshot from an existing connection at any time, without stepping back through the full import flow, and manage the connection itself (retest it, check its status) in the same place. 

In short: a direct connection is never required, but if you have one, it removes the manual export-and-upload step from the process. 

Does this apply to both Citrix DaaS and Citrix Virtual Apps and Desktops (CVAD)?

No. A direct connection is currently available for Citrix DaaS (Citrix Cloud) environments only. If you have a Citrix Virtual Apps and Desktops (CVAD) environment, capture snapshots with the Citrix Export tool and import them into Compass - support for connecting directly to a CVAD environment may be added in a future release. 

What access does Compass need to connect to my Citrix DaaS environment?

A Citrix Cloud administrator creates a read-only API client (technically a service principal) scoped to the Read Only Administrator role for DaaS. Compass authenticates with a customer ID, a client ID, and a client secret; the secret is held in a dedicated secret store, never in the application database, and is used only to obtain short-lived tokens. With this access, Compass reads delivery groups, machine catalogs, applications, policies, and session data - it never writes anything to your Citrix environment. 

For the full setup steps, see Connect a Citrix DaaS Environment to Nerdio Compass

Microsoft

Why are there two separate Microsoft grants?

Because Entra, Intune, and Windows 365 are managed through Microsoft Graph, while Azure Virtual Desktop is managed through Azure Resource Manager - a different system with no Graph permissions at all. Consenting to Graph permissions doesn't grant anything in Azure, and adding an Azure subscription doesn't grant anything in Graph - they're genuinely separate systems, not two steps of one process. Most organizations that use both end up completing both grants. 

What can Compass read via Microsoft Graph?

A Global Administrator opens the consent link Compass provides and approves it once for the tenant. This also creates the Compass service principal in your directory, which is why the role is required even though every permission requested is read-only: 

Permission

What Compass reads with it

Organization.Read.All

Tenant profile, licenses held, verified domains

User.Read.All

User accounts and assigned licenses, to size the estate

Group.Read.All

Group membership, to map entitlement and assignment

Device.Read.All

Registered and joined devices

Application.Read.All

Service principal lookup during subscription authorization

Policy.Read.All

Tenant policy configuration

Policy.Read.ConditionalAccess

Conditional Access policies, for readiness and governance findings

CloudPC.Read.All

Windows 365 Cloud PCs and provisioning policies

DeviceManagementManagedDevices.Read.All

Intune-managed devices

DeviceManagementConfiguration.Read.All

Configuration and compliance policies

DeviceManagementApps.Read.All

Managed applications and assignments

DeviceManagementScripts.Read.All

Platform and remediation scripts

DeviceManagementServiceConfig.Read.All

Intune service configuration and enrollment settings

Compass doesn't request Exchange Online or SharePoint Online permissions - some tenants don't have a service principal for those services, and including them would cause the entire consent request to fail rather than just skipping the unavailable part. 

What does adding an Azure subscription grant?

Adding a subscription is a separate grant from Microsoft Graph consent. Whoever adds it needs Owner or User Access Administrator on that specific subscription, because the action writes a role assignment - Global Administrator doesn't confer this by default. The grant itself is Reader on the subscription, the simplest built-in role available. With it, Compass reads how your virtual desktops are configured - never what's inside them. 

Security and data handling

Can Compass make changes to my environment?

No. Every permission described in this reference is a read permission - there's no grant anywhere that lets Compass create, modify, or delete a resource in your environment. Compass assesses an estate; it doesn't change one. 

Does Compass need inbound network access to my environment?

No. Compass never requires a network route from us into your environment. Snapshot collection via an export tool runs entirely inside your own environment, and even a direct Citrix DaaS or Microsoft connection only ever reaches out from Compass using the credentials you've granted - nothing reaches in. 

Is my data isolated from other Compass customers?

Yes. A workspace is strictly isolated from every other workspace - one organization can never see another's data, and a grant made in your tenant is only ever usable for your tenant. 

What happens to the credentials Compass stores?

Authentication to your identity provider is always delegated - Compass never sees or stores your password. Where Compass does hold a credential, such as a Citrix API client secret, it's kept in a dedicated secret store rather than the application database, and used only to obtain short-lived tokens. Compass also never asks for mailbox, file, or message content - only configuration. 

Troubleshooting

Sign-in says it needs approval from an administrator - what does that mean?

Your organization restricts user consent to new applications. Ask a Global Administrator to approve the Compass sign-in application once - after that, everyone else can sign in normally. 

I signed in but my workspace is empty - is that expected?

Yes. A new workspace holds nothing until you connect a platform or upload a snapshot - nothing is read from your environment automatically. 

Can I change my workspace's data region after setup?

No - the region is fixed when your workspace is created. Contact support before adding any data rather than working around it. 

Adding a subscription says I have insufficient permissions - why?

You can likely see the subscription but can't write a role assignment on it. You'll need Owner or User Access Administrator on that specific subscription - Contributor isn't enough, and Global Administrator doesn't grant it by default. 

I connected Microsoft, but Azure Virtual Desktop data is missing - why?

Microsoft Graph consent and the Azure subscription role are separate grants. Graph consent covers Entra, Intune, and Windows 365; Azure Virtual Desktop needs the subscription role assignment as well. 

A subscription is missing from the list when I try to add one - why?

Compass lists the subscriptions the signed-in administrator can see. If one is missing, that account doesn't have access to it - sign in as an administrator who does. 

A colleague can't sign in - what should I check?

Confirm they're using a work or school account from your organization, and that the sign-in application has been approved if your organization restricts user consent. 

Was this article helpful?

0 out of 0 found this helpful
Have more questions? Submit a request

Comments (0 comments)

Article is closed for comments.