Knowledge Base

Microsoft GDAP Relationships (5.0)

Overview

This document covers how to create and manage GDAP relationships with your customers in Cloudmore: viewing existing relationships, requesting new ones, assigning security groups and terminating access.

For background on GDAP and the Microsoft Entra roles Cloudmore needs, see Microsoft GDAP (5.0).

🔖 GDAP relationship

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

🔖 Access assignment

A security group in your partner tenant together with the roles from the relationship it receives. Only members of an assigned group get the access.

View Current Relationships

👥

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

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

  • Read only: Global View Only Admin

  1. Log in to Cloudmore using your broker account.

  2. Navigate to Services > Microsoft 365.

  3. Open the GDAP relationships tab.

The list shows every GDAP relationship for your customers:

Column

What it shows

Organization name

The customer the relationship belongs to. A red tag icon means the Microsoft tenant is linked to more than one organization.

GDAP relationship name

The name given when the request was created.

Template

The GDAP template used, if any.

Status

Where the relationship is in its lifecycle, for example Pending approval, Active, Expiring soon or Expired.

Duration

How long the relationship is valid, in days.

Expires

The end date.

Auto-extend

Whether the relationship is extended automatically.

Use the search box to find relationships by organization, tenant or template name. The toolbar also lets you export the list to Excel and refresh it.

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

The full list of statuses and what each one means is in Microsoft GDAP (5.0).

Add New Relationship

  1. On the GDAP relationships tab, click Create relationship.

  2. Fill in the fields below.

  3. Click Finalize request.

Important fields

  • Organization - start typing the organization name and select it from the list.

  • GDAP template - optional. Selecting a template fills in the name, duration, auto-extend and roles from it. You can still change any value before you send the request. See Microsoft GDAP Templates (5.0).

  • GDAP relationship name - the unique name of the relationship. Required.

  • Duration - how many days the relationship is valid, from 1 to 730. The default is 730 days.

  • Auto-extend - when on, the relationship is extended automatically for another 6 months before it expires. When off, it expires at the end of its duration and has to be requested again. A relationship that includes the Global Administrator role cannot be auto-extended.

  • Microsoft Entra roles - the roles to request. Select at least one. Use the least privileged roles you need.

[SCREENSHOT] Create GDAP relationship dialog with a template selected.

When you click Finalize request, the relationship is created with the status Pending approval and the Send GDAP invitation dialog opens.

Send the invitation to the customer

A Global Administrator in the customer tenant has to approve the request. The invitation contains the approval link.

  • Enter the customer's email address, check the subject and message, and click Send email, or

  • Click Copy message and send it to the customer from outside Cloudmore.

Once the customer approves the request, the status changes to Active. It may take several hours for a GDAP change to take effect.

When you add the Microsoft 365 service for a new tenant, you can request a default GDAP relationship in the same step instead. See Microsoft GDAP (5.0).

View Permissions

To see what a relationship grants, open the actions menu (⋮) on the row and select View permissions. The dialog shows:

  • The GDAP relationship name, the Duration with its end date, and whether it is Auto-extended.

  • The Microsoft Entra roles granted by the relationship.

  • The Security groups assigned through the relationship, with their roles.

You can turn Auto extend on or off here while the relationship is Created or Active. The change is saved straight away.

[SCREENSHOT] View permissions dialog with roles and security groups.

Update Admin Access

After the customer approves a relationship, assign its roles to a security group in your partner tenant so your staff get the access. This is available on Active relationships.

  1. Open the actions menu (⋮) on the relationship and select Change access assignments.

  2. To add a group, click Add assignment, select the security group, and select the Administrative roles the group should get.

  3. To change or remove an existing group, use Edit assignment or Remove assignment on its row.

  4. Click Save changes. The message Access assignments updated. confirms the change.

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

Terminate Relationship

  1. Open the actions menu (⋮) on an Active relationship and select Terminate access.

  2. Confirm by clicking Terminate access.

Delegated admin access is removed 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.