Knowledge Base

Microsoft GDAP (5.0)

Overview

This document explains Microsoft Granular Delegated Admin Privileges (GDAP), how it differs from the older DAP model, and how GDAP affects what you can do for your customers in Cloudmore.

It also shows where GDAP is managed in Cloudmore, which Microsoft Entra roles Cloudmore needs, and how to troubleshoot missing permissions.

🔖 DAP (Delegated Admin Privileges)

The earlier Microsoft framework that gave a partner the Global Admin role in every customer tenant, with no time limit.

🔖 GDAP (Granular Delegated Admin Privileges)

The Microsoft framework that replaced DAP. The partner gets only the Microsoft Entra roles the customer approves, for a limited time.

🔖 GDAP relationship

One approved request between you and a customer tenant. It holds the granted Entra roles, a duration and a status.

🔖 Security group

A group in your own partner tenant. The roles in a GDAP relationship only reach your staff once they are assigned to a security group your staff belong to.

DAP vs GDAP

Delegated Admin Privileges (DAP) is a Microsoft security framework that allows a Microsoft partner to access and carry out day-to-day operations on behalf of their customers, for instance creating users and assigning licenses.

DAP assigns the Global Admin role to the Microsoft partner, so the partner has full access to the customer tenant. From a security point of view, this makes it vulnerable to supply chain attacks and other risks.

To address this, Microsoft released Granular Delegated Admin Privileges (GDAP). GDAP gives the partner more granular, time-bound access to customer tenants. This least-privileged access has to be explicitly granted to the partner by the customer.

GDAP fully replaced DAP on . All partner access to customer tenants now goes through GDAP.

DAP

GDAP

Access level

Global Admin, full access

Only the Entra roles the customer approves

Duration

No end date

1 to 730 days, optionally auto-extended

Customer approval

Once, broad

Per relationship, by a customer Global Administrator

Who on your team gets access

Your admin agents

Only members of the security groups you assign

Granular Delegated Admin Privileges (GDAP)

GDAP gives partners granular, time-bound access to their customer tenants, while giving customers more control over what partners can access.

  • A GDAP relationship lasts up to 730 days (two years), which is also the default in Cloudmore. You can set any duration from 1 to 730 days.

  • You choose the Microsoft Entra roles to request. Use the least privileged roles; requesting Global Administrator is not recommended.

  • A GDAP relationship is established when you send a request to the customer and the customer approves it. The customer needs the Global Administrator role to approve the request.

  • You can create security groups to organize your team's access to customer tenants with separate roles.

  • You can track expiring relationships in Cloudmore: the relationship list shows Expires and the status Expiring soon.

  • Customers can track partners' activity in the Microsoft Entra sign-in logs.

  • A relationship can be set to Auto-extend. It is then extended automatically for another 6 months before it expires. Auto-extend cannot be used together with the Global Administrator role. Without auto-extend, the relationship expires at the end of its duration and you have to send a new request for the customer to approve.

  • GDAP applies to both Microsoft Partner Center and the Partner Center APIs that Cloudmore uses, so the same restrictions apply in both. If you don't have permission to create users in Partner Center, you can't create users through Cloudmore either.

Where GDAP is managed in Cloudmore

👥

Broker level: Services > Microsoft 365 and open the GDAP relationships or GDAP templates tab

  • Full access: Super Admin, Global Admin, Global Support Admin, Global Billing Admin

  • Read only: Global View Only Admin

Where

What you can do

GDAP relationships tab

See every relationship with its Organization name, GDAP relationship name, Template, Status, Duration, Expires and Auto-extend. Create a relationship, view its permissions, turn auto-extend on or off, change access assignments and terminate access. Export the list to Excel.

GDAP templates tab

Save standard sets of roles and duration so new relationship requests are pre-filled.

Link tenants tab

Reset grants flag on an organization makes Cloudmore re-check its delegated admin grants on the next sync.

Organization Services > Available services

When you add Microsoft 365 for a new tenant, you can request a default GDAP relationship and default security groups. See Default GDAP for new tenants.

[SCREENSHOT] Services > Microsoft 365, GDAP relationships tab with the relationship list.

How to request a GDAP relationship

  1. Navigate to Services > Microsoft 365 and open the GDAP relationships tab.

  2. Click Create relationship.

  3. Start typing the Organization name and select it.

  4. Optionally select a GDAP template. The name, duration, auto-extend and roles are filled in from the template.

  5. Enter the GDAP relationship name, the Duration (1 to 730 days), choose Auto-extend, and select the Microsoft Entra roles.

  6. Click Finalize request. The relationship is created with the status Pending approval.

  7. In Send GDAP invitation, send the approval link to the customer by email with Send email, or click Copy message and send it from outside Cloudmore.

  8. A Global Administrator in the customer tenant opens the link and approves the request. The relationship then becomes Active.

It may take several hours for a GDAP change to take effect.

[SCREENSHOT] Create GDAP relationship dialog.

Detailed instructions are in Microsoft GDAP Relationships (5.0) and Microsoft GDAP Templates (5.0).

Relationship statuses

Status

What it means

Created

The request exists but has not been sent for approval yet.

Pending approval

Waiting for a Global Administrator in the customer tenant to approve it.

Approved / Activating

The customer approved it and Microsoft is activating it.

Active

The roles are granted. Assign security groups now.

Expiring soon

Close to its end date. Turn on auto-extend or request a new relationship.

Termination requested / Terminating / Terminated

Access is being removed or has been removed.

Expired

The duration has ended. A new request has to be approved to restore access.

Change access assignments and Terminate access are only available on Active relationships. Auto-extend can be changed while a relationship is Created or Active.

Terminate access removes delegated admin access immediately, and your administrators lose the Entra roles this relationship granted. A new GDAP request has to be approved by the customer to restore access.

Assign security groups

Requesting GDAP permissions is not enough on its own. After the customer approves the relationship, you have to assign its roles to a security group in your partner tenant. Only members of that group get the access.

  1. On the GDAP relationships tab, open the actions menu (â‹®) on an Active relationship and select Change access assignments.

  2. Click Add assignment, select the security group, and select the Administrative roles the group should get.

  3. Click Save changes.

You can also edit or remove an existing assignment in the same dialog. To see what a relationship grants, select View permissions. It lists the Microsoft Entra roles and the security groups assigned through the relationship.

[SCREENSHOT] Change access assignments dialog with one security group assigned.

Default GDAP for new tenants

When you add the Microsoft 365 service for an organization that needs a new Microsoft tenant, from the organization's Services > Available services, you can request standard access in the same step:

  • Create a default Microsoft GDAP relationship - applied automatically and doesn't require explicit customer consent. It lasts 180 days, or is auto-extended if you turn on Auto-extend GDAP. It grants Directory readers, Directory writers, License administrator, User administrator, Privileged role administrator, Privileged authentication administrator and Global reader.

  • Add default Microsoft security groups - creates the Admin Agents and HelpdeskAgents groups with their default Microsoft Entra roles.

See Manage Microsoft Customer Tenants (5.0) for the other ways to create and link tenants.

Least Privilege Permissions

Microsoft has defined the least privileged role required to carry out each task. These permissions apply to both Microsoft Partner Center and Cloudmore.

For information on least privilege roles, see GDAP role guidance - Partner Center.

Cloudmore requires three roles in each organization to fully function: Directory Readers, User Administrator and License Administrator.

Task in Cloudmore

Role

Why needed

Manage users

User Administrator

Directory Readers

The User Administrator role is needed to create, view and edit Microsoft users in Cloudmore. Directory Readers is needed to create new users, as Cloudmore needs to read organization properties to create the user.

Manage licenses

License Administrator

Directory Readers

License Administrator is needed to assign and revoke licenses. Directory Readers is needed to view licenses in Cloudmore.

Cloudmore recommends one of the following roles in addition to the least privilege roles above, so that the Cloudmore CPV application can have consent granted through automation in the customer's tenant. Application consent is the process of a resource owner granting a client application access to protected resources, under specific permissions, on behalf of the resource owner. Cloudmore follows the Microsoft security guidelines and requires explicit app + user consent for every customer tenant.

Task in Cloudmore

Role

Why needed

Grant application consent

Application Administrator (replaced Privileged Role Administrator)

or

Cloud Application Administrator

The Application Administrator role is needed to create and manage all aspects of giving consent to and using the Cloudmore app.

For information on application consent, see Migrate your CPV/CSP applications to use granular delegated admin privileges.

Features that do not require permissions

As long as you have a Partner Relationship with the customer, these features do not require any GDAP roles, for both Microsoft 365 and Azure:

  • Subscription management

  • Price management

  • Linking tenants

  • MCA management

  • Cost center management

What happens if a role is missing?

If a GDAP role is missing, those tasks cannot be carried out in either Partner Center or Cloudmore. For instance, if the User Administrator role has not been granted, no user accounts can be viewed, created or deleted for the customer through Partner Center or Cloudmore. Cloudmore still works without the role, but the user and license views are empty.

If there is no active GDAP relationship with the customer at all, the organization's Microsoft views show: Could not load data from Microsoft: there is no active GDAP relationship with this customer.

Troubleshoot GDAP permissions

  1. Check the relationship in Cloudmore - On the GDAP relationships tab, search for the organization. Make sure it has one relationship with the status Active.

  2. Check the roles - Select View permissions. Make sure the relationship includes User Administrator, License Administrator and Directory Readers in one relationship. Do not split them across several relationships.

  3. Check the security groups - Make sure the AdminAgents group is assigned to the relationship with all three roles. Use Change access assignments if it is missing.

  4. Check the integration account - The account used to integrate your CSP tenant with Cloudmore must be a member of the security groups used in the relationship.

  5. Wait, then check Partner Center - Any GDAP change can take several hours for Microsoft to apply. Check the user and license pages for the customer in Partner Center. If they work there and all three roles are assigned, they work in Cloudmore too.

  6. Re-check grants - On the Link tenants tab, select Reset grants flag on the organization. Cloudmore re-checks the delegated admin grants on the next sync.

Sometimes customer information does not reach Cloudmore even though it is available in Partner Center. Refresh the app registration permissions by updating your authentication token: Services > Microsoft 365, Authentication tab, Update consent. See Microsoft Tenant Authentication (5.0).

GDAP changes made in Cloudmore are recorded in the audit log under the category GDAP and tenant access.