vysovsky.com / reference / gdap

GDAP Role Reference

Which granular delegated admin role you actually need for the task in front of you. GDAP relationships should carry the minimum roles that let engineers do their jobs. This table is the "minimum" part.

Last reviewed July 2026. Roles are the standard Entra ID built-in roles; GDAP simply delegates them cross-tenant through Partner Center.

The shape of GDAP in one paragraph: a relationship with each customer tenant carries a set of Entra roles and an expiry (maximum 2 years, auto-extendable). On the partner side, security groups map to those roles, so an engineer's effective access in a customer tenant works like this: they are in a partner group, the group maps to a role in the relationship, and the role applies in the customer tenant. When access unexpectedly fails, one of those three links is broken. Check group membership first, it is the usual one.

Resist Global Administrator in GDAP relationships. It defeats the entire point of the DAP-to-GDAP migration, many customers' insurers now ask about it, and nearly every task below has a narrower role that works. If a relationship still carries GA "temporarily", that is the finding a security review will lead with.

Task-to-role lookup

Type to filter. Matches tasks, roles and notes.

TaskMinimum roleNotes
Everyday helpdesk
Reset a standard user's passwordPassword AdministratorHelpdesk Administrator also works and adds sign-in log read. Neither can touch admins' passwords.
Reset MFA / re-register authentication methodsAuthentication AdministratorAlso issues Temporary Access Passes. For users holding admin roles you need Privileged Authentication Administrator.
Revoke sessions / block sign-in on a standard userHelpdesk AdministratorUser Administrator for anything beyond enable/disable and password.
Create users, edit profiles, manage licencesUser AdministratorLicence-only work fits the narrower License Administrator.
Manage groups and membershipsGroups AdministratorUser Administrator covers most group membership too; Groups Administrator is the precise fit.
Invite and manage guest usersGuest InviterJust inviting. Managing guests after redemption is User Administrator territory.
Read-only and reporting
Read everything, change nothing (tenant assessments)Global ReaderBelongs in every GDAP relationship. Covers config review across all workloads without write risk.
Read sign-in and audit logsReports ReaderSecurity Reader also reads them and adds security-portal read. Global Reader covers both.
Usage reports (mailbox sizes, Teams activity)Reports ReaderEnough for Get-MgReport* cmdlets.
Exchange Online
Mailbox admin: permissions, forwarding, shared mailboxes, quotasExchange AdministratorCovers the whole Exchange builder. Exchange Recipient Administrator is the narrower recipient-only alternative.
Message traceExchange AdministratorGlobal Reader can read traces too, which is enough for missing-email triage without write access.
Release quarantined messagesSecurity AdministratorQuarantine lives in Defender, not Exchange. Quarantine Administrator (Defender RBAC) is the precise fit where configured.
Transport rules, connectors, accepted domainsExchange AdministratorConnector changes affect all mail flow, so treat it as change-controlled work.
Identity security
Read Conditional Access policiesSecurity ReaderGlobal Reader also works.
Create and edit Conditional Access policiesConditional Access AdministratorPairs naturally with the CA policy explainer and baseline guide.
Investigate risky users, dismiss riskSecurity OperatorReading alone is Security Reader; dismissing risk needs Operator or Security Administrator.
Incident response: contain a compromised accountSecurity Administrator + User AdministratorSession revocation and sign-in block are user-write actions; risk and restricted-sender handling are security actions. The incident builder runbooks assume both.
Manage admin role assignments in the customer tenantPrivileged Role AdministratorExtremely powerful: it grants the ability to grant. Most MSPs should not hold this standing; request it per-incident.
Devices and Intune
All Intune work: policies, apps, remote actions, enrolmentIntune AdministratorCovers the whole Intune builder including wipe. No narrower built-in role covers remote actions.
Read device compliance for triageGlobal ReaderEnough for the device-state checks in the sign-in guide.
Entra device objects: enable/disable/delete, BitLocker keysCloud Device AdministratorBitLocker recovery key read is the common reason this role gets requested.
Collaboration workloads
SharePoint and OneDrive admin: sites, sharing, storageSharePoint AdministratorCovers the SharePoint builder and the leaver OneDrive handover.
Teams admin: policies, voice, meetingsTeams AdministratorTeams Communications Administrator is the voice/telephony-only subset.
Compliance and audit
Search the unified audit logCompliance AdministratorThe audit-log searches in the Purview builder. Global Reader can read some but not run compliance searches.
Compliance search and purge (phishing cleanup)Compliance Administrator + Search And PurgeThe purge step in the phishing runbook needs the Search And Purge Purview role on top, assigned in Purview RBAC, not Entra.
Litigation holds, retention policiesCompliance AdministratorSee the retention guide for how the pieces interact.

Auditing what a relationship actually carries

From the partner tenant, Graph exposes the relationships and their role assignments, worth a quarterly review against this table:

Connect-MgGraph -Scopes "DelegatedAdminRelationship.Read.All" -NoWelcome
Get-MgTenantRelationshipDelegatedAdminRelationship |
  Select-Object DisplayName, Status, @{n='Customer';e={$_.Customer.DisplayName}},
    @{n='Roles';e={$_.AccessDetails.UnifiedRoles.RoleDefinitionId.Count}}, EndDateTime

Role definition IDs map to names via Get-MgRoleManagementDirectoryRoleDefinition. Relationships nearing EndDateTime without auto-extend are the ones that cause the "we suddenly can't manage the customer" morning.

The pitfalls that generate tickets

Three recurring ones. Protected admins: Authentication Administrator and Helpdesk Administrator cannot act on accounts holding higher roles. Resetting a customer Global Admin's MFA needs Privileged Authentication Administrator, and the error will misleadingly look like a permissions bug. Portal vs role mismatch: some blades (Defender quarantine, Purview) use their own RBAC on top of Entra roles; the Entra role gets you in the door, the workload role governs the button. The missing group link: GDAP roles bind to partner security groups, so a new engineer with "the same role as everyone else" but no access is almost always missing the group membership, not the role.