Share via


Een toepassing beheerderstoestemming verlenen voor de hele tenant

In dit artikel leert u hoe u tenantbrede beheerderstoestemming kunt verlenen aan een toepassing in Microsoft Entra ID. Als u wilt weten hoe u instellingen voor afzonderlijke gebruikerstoestemming configureert, raadpleegt u Configureren hoe eindgebruikers toestemming geven voor toepassingen.

Wanneer u beheerderstoestemming voor de hele tenant verleent aan een toepassing, geeft u de toepassing toegang tot de machtigingen die namens de hele organisatie zijn aangevraagd. Het verlenen van beheerderstoestemming namens een organisatie is een gevoelige bewerking, waardoor de uitgever van de toepassing mogelijk toegang heeft tot aanzienlijke delen van de gegevens van uw organisatie of de machtiging om bewerkingen met hoge bevoegdheden uit te voeren. Voorbeelden van dergelijke bewerkingen zijn mogelijk rolbeheer, volledige toegang tot alle postvakken of alle sites en volledige gebruikersimitatie. Daarom moet u zorgvuldig de machtigingen controleren die de toepassing aanvraagt voordat u toestemming verleent.

Standaard kan het verlenen van beheerderstoestemming voor de hele tenant aan een toepassing alle gebruikers toegang geven tot de toepassing, tenzij anders beperkt. Als u wilt beperken welke gebruikers zich kunnen aanmelden bij een toepassing, configureert u de app om gebruikerstoewijzing te vereisen en wijst u vervolgens gebruikers of groepen toe aan de toepassing.

Belangrijk

Het verlenen van beheerderstoestemming voor de hele tenant kan machtigingen intrekken die al voor die toepassing zijn verleend. Machtigingen die gebruikers al namens hen hebben verleend, worden niet beïnvloed.

Vereisten

Voor het verlenen van beheerderstoestemming voor de hele tenant moet u zich aanmelden als een gebruiker die gemachtigd is om toestemming te geven namens de organisatie.

Als u tenantbrede beheerderstoestemming wilt verlenen, hebt u het volgende nodig:

  • Een Microsoft Entra-gebruikersaccount met een van de volgende rollen:

    • Beheerder van bevoorrechte rol, voor het verlenen van toestemming voor apps die een machtiging aanvragen voor elke API.
    • Cloudtoepassingsbeheerder of toepassingsbeheerder, voor het verlenen van toestemming voor apps die toestemming vragen voor elke API, met uitzondering van Microsoft Graph-app-rollen (toepassingsmachtigingen).
    • Een aangepaste maprol die de machtiging bevat voor het verlenen van machtigingen aan toepassingen, voor de machtigingen die vereist zijn voor de toepassing.

U kunt tenantbrede beheerderstoestemming verlenen via het deelvenster Bedrijfstoepassingen als de toepassing al is ingericht in uw tenant. Een app kan bijvoorbeeld worden ingericht in uw tenant als ten minste één gebruiker al toestemming heeft gegeven voor de toepassing. Zie Hoe en waarom toepassingen worden toegevoegd aan Microsoft Entra ID voor meer informatie.

Tip

Stappen in dit artikel kunnen enigszins variëren op basis van de portal waaruit u begint.

Een tenantbrede beheerderstoestemming verlenen aan een app die wordt vermeld in het deelvenster Bedrijfstoepassingen :

  1. Meld u als cloudtoepassingsbeheerder aan bij het Microsoft Entra-beheercentrum.
  2. Blader naar Bedrijfstoepassingen voor identiteitstoepassingen>>>Alle toepassingen.
  3. Voer de naam van de bestaande toepassing in het zoekvak in en selecteer vervolgens de toepassing in de zoekresultaten.
  4. Selecteer Machtigingen onder Beveiliging. Schermopname van het verlenen van beheerderstoestemming voor de hele tenant.
  5. Bekijk zorgvuldig de machtigingen die de toepassing nodig heeft. Als u akkoord gaat met de machtigingen die de toepassing vereist, selecteert u Beheerderstoestemming verlenen.

U kunt tenantbrede beheerderstoestemming verlenen vanuit App-registraties in het Microsoft Entra-beheercentrum voor toepassingen die uw organisatie heeft ontwikkeld en rechtstreeks in uw Microsoft Entra-tenant heeft geregistreerd.

Beheerderstoestemming voor de hele tenant verlenen vanuit App-registraties:

  1. Blader in het Microsoft Entra-beheercentrum naar Identiteitstoepassingen>> App-registraties> Alle toepassingen.
  2. Voer de naam van de bestaande toepassing in het zoekvak in en selecteer vervolgens de toepassing in de zoekresultaten.
  3. Selecteer API-machtigingen onder Beheren.
  4. Bekijk zorgvuldig de machtigingen die de toepassing nodig heeft. Als u akkoord gaat, selecteert u Beheerderstoestemming verlenen.

Wanneer u beheerderstoestemming voor de hele tenant verleent met behulp van een van de methoden die in de vorige sectie worden beschreven, wordt er een venster geopend vanuit het Microsoft Entra-beheercentrum om te vragen om beheerderstoestemming voor de hele tenant. Als u de client-id (ook wel de toepassings-id genoemd) van de toepassing kent, kunt u dezelfde URL maken om tenantbrede beheerderstoestemming te verlenen.

De URL voor tenantbrede beheerderstoestemming heeft de volgende indeling:

https://login.microsoftonline.com/{organization}/adminconsent?client_id={client-id}

waarbij geldt:

  • {client-id} is de client-id van de toepassing (ook wel toepassings-id genoemd).
  • {organization} is de tenant-id of een geverifieerde domeinnaam van de tenant waarin u toestemming wilt geven voor de toepassing. U kunt de waarde organizationsgebruiken die ervoor zorgt dat de toestemming plaatsvindt in de thuistenant van de gebruiker waarmee u zich aanmeldt.

Controleer zoals altijd zorgvuldig de machtigingen die een toepassing aanvraagt voordat u toestemming verleent.

Zie Beheerderstoestemming op het Microsoft Identity Platform voor meer informatie over het samenstellen van de URL voor beheerderstoestemming voor de hele tenant.

In deze sectie verleent u gedelegeerde machtigingen aan uw toepassing. Gedelegeerde machtigingen zijn machtigingen die uw toepassing nodig heeft voor toegang tot een API namens een aangemelde gebruiker. De machtigingen worden gedefinieerd door een resource-API en verleend aan uw bedrijfstoepassing, de clienttoepassing. Deze toestemming wordt verleend namens alle gebruikers.

In het volgende voorbeeld is de resource-API Microsoft Graph van object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb. De Microsoft Graph API definieert de gedelegeerde machtigingen User.Read.All en Group.Read.All. Het consentType is AllPrincipals, waarmee wordt aangegeven dat u toestemming geeft namens alle gebruikers in de tenant. De object-id van de client enterprise-toepassing is aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb.

Let op

Wees voorzichtig! Machtigingen die via een programma zijn verleend, zijn niet onderworpen aan controle of bevestiging. Ze worden onmiddellijk van kracht.

  1. Maak verbinding met Microsoft Graph PowerShell en meld u aan als ten minste een cloudtoepassingsbeheerder.

    Connect-MgGraph -Scopes "Application.ReadWrite.All", "DelegatedPermissionGrant.ReadWrite.All"
    
  2. Haal alle gedelegeerde machtigingen op die zijn gedefinieerd door Microsoft Graph (de resourcetoepassing) in uw tenanttoepassing. Identificeer de gedelegeerde machtigingen die u nodig hebt om de clienttoepassing te verlenen. In dit voorbeeld zijn User.Read.All de delegeringsmachtigingen en Group.Read.All

    Get-MgServicePrincipal -Filter "displayName eq 'Microsoft Graph'" -Property Oauth2PermissionScopes | Select -ExpandProperty Oauth2PermissionScopes | fl
    
  3. Verdeel de gedelegeerde machtigingen aan de client enterprise-toepassing door de volgende aanvraag uit te voeren.

    $params = @{
    
    "ClientId" = "00001111-aaaa-2222-bbbb-3333cccc4444"
    "ConsentType" = "AllPrincipals"
    "ResourceId" = "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
    "Scope" = "User.Read.All Group.Read.All"
    }
    
    New-MgOauth2PermissionGrant -BodyParameter $params | 
    Format-List Id, ClientId, ConsentType, ResourceId, Scope
    
  4. Bevestig dat u beheerderstoestemming voor de hele tenant hebt verleend door de volgende aanvraag uit te voeren.

 Get-MgOauth2PermissionGrant -Filter "clientId eq '00001111-aaaa-2222-bbbb-3333cccc4444' and consentType eq 'AllPrincipals'" 

In deze sectie verleent u toepassingsmachtigingen aan uw bedrijfstoepassing. Toepassingsmachtigingen zijn machtigingen die uw toepassing nodig heeft voor toegang tot een resource-API. De machtigingen worden gedefinieerd door de resource-API en verleend aan uw bedrijfstoepassing. Dit is de principal-toepassing. Nadat u uw toepassing toegang hebt verleend tot de resource-API, wordt deze uitgevoerd als een achtergrondservice of daemon zonder een aangemelde gebruiker. Toepassingsmachtigingen worden ook wel app-rollen genoemd.

In het volgende voorbeeld verleent u de Microsoft Graph-toepassing (de principal van id aaaaaaaa-bbbb-cccc-1111-222222222222) een app-rol (toepassingsmachtiging) van de id df021288-bdef-4463-88db-98f22de89214 die wordt weergegeven door een resource-API van id 11112222-bbbb-3333-cccc-4444dddd5555.

  1. Maak verbinding met Microsoft Graph PowerShell en meld u aan als minimaal een beheerder van bevoorrechte rollen.

    Connect-MgGraph -Scopes "Application.ReadWrite.All", "AppRoleAssignment.ReadWrite.All"
    
  2. Haal de app-rollen op die zijn gedefinieerd door Microsoft Graph in uw tenant. Identificeer de app-rol die u nodig hebt om de client-bedrijfstoepassing te verlenen. In dit voorbeeld is df021288-bdef-4463-88db-98f22de89214de id van de app-rol.

    Get-MgServicePrincipal -Filter "displayName eq 'Microsoft Graph'" -Property AppRoles | Select -ExpandProperty appRoles |fl
    
  3. Verdeel de toepassingsmachtiging (app-rol) aan de principal-toepassing door de volgende aanvraag uit te voeren.

 $params = @{
  "PrincipalId" ="aaaaaaaa-bbbb-cccc-1111-222222222222"
  "ResourceId" = "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
  "AppRoleId" = "df021288-bdef-4463-88db-98f22de89214"
}

New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId 'aaaaaaaa-bbbb-cccc-1111-222222222222' -BodyParameter $params | 
  Format-List Id, AppRoleId, CreatedDateTime, PrincipalDisplayName, PrincipalId, PrincipalType, ResourceDisplayName

Gebruik Graph Explorer om gedelegeerde en toepassingsmachtigingen te verlenen.

In deze sectie verleent u gedelegeerde machtigingen aan uw toepassing. Gedelegeerde machtigingen zijn machtigingen die uw toepassing nodig heeft voor toegang tot een API namens een aangemelde gebruiker. De machtigingen worden gedefinieerd door een resource-API en verleend aan uw bedrijfstoepassing, de clienttoepassing. Deze toestemming wordt verleend namens alle gebruikers.

U moet zich aanmelden als ten minste een cloudtoepassingsbeheerder.

In het volgende voorbeeld is de resource-API Microsoft Graph van object-id aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb. De Microsoft Graph API definieert de gedelegeerde machtigingen User.Read.All en Group.Read.All. Het consentType is AllPrincipals, waarmee wordt aangegeven dat u toestemming geeft namens alle gebruikers in de tenant. De object-id van de client enterprise-toepassing is aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb.

Let op

Wees voorzichtig! Machtigingen die via een programma zijn verleend, zijn niet onderworpen aan controle of bevestiging. Ze worden onmiddellijk van kracht.

  1. Haal alle gedelegeerde machtigingen op die zijn gedefinieerd door Microsoft Graph (de resourcetoepassing) in uw tenanttoepassing. Identificeer de gedelegeerde machtigingen die u nodig hebt om de clienttoepassing te verlenen. In dit voorbeeld zijn User.Read.All de delegeringsmachtigingen en Group.Read.All

    GET https://graph.microsoft.com/v1.0/servicePrincipals?$filter=displayName eq 'Microsoft Graph'&$select=id,displayName,appId,oauth2PermissionScopes
    
  2. Verdeel de gedelegeerde machtigingen aan de client enterprise-toepassing door de volgende aanvraag uit te voeren.

    POST https://graph.microsoft.com/v1.0/oauth2PermissionGrants
    
    Request body
    {
       "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
       "consentType": "AllPrincipals",
       "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
       "scope": "User.Read.All Group.Read.All"
    }
    
  3. Bevestig dat u beheerderstoestemming voor de hele tenant hebt verleend door de volgende aanvraag uit te voeren.

    GET https://graph.microsoft.com/v1.0/oauth2PermissionGrants?$filter=clientId eq '00001111-aaaa-2222-bbbb-3333cccc4444' and consentType eq 'AllPrincipals'
    

In deze sectie verleent u toepassingsmachtigingen aan uw bedrijfstoepassing. Toepassingsmachtigingen zijn machtigingen die uw toepassing nodig heeft voor toegang tot een resource-API. De machtigingen worden gedefinieerd door de resource-API en verleend aan uw bedrijfstoepassing. Dit is de principal-toepassing. Nadat u uw toepassing toegang hebt verleend tot de resource-API, wordt deze uitgevoerd als een achtergrondservice of daemon zonder een aangemelde gebruiker. Toepassingsmachtigingen worden ook wel app-rollen genoemd.

In het volgende voorbeeld verleent u de toepassing Microsoft Graph (de principal van id 00001111-aaaa-2222-bbbb-3333cccc4444) een app-rol (toepassingsmachtiging) van de id df021288-bdef-4463-88db-98f22de89214 die wordt weergegeven door een resource-ondernemingstoepassing van id 11112222-bbbb-3333-cccc-4444dddd5555.

U moet zich aanmelden als ten minste een beheerder van bevoorrechte rollen.

  1. Haal de app-rollen op die zijn gedefinieerd door Microsoft Graph in uw tenant. Identificeer de app-rol die u nodig hebt om de client-bedrijfstoepassing te verlenen. In dit voorbeeld is de id van de app-rol df021288-bdef-4463-88db-98f22de89214

    GET https://graph.microsoft.com/v1.0/servicePrincipals?$filter=displayName eq 'Microsoft Graph'&$select=id,displayName,appId,appRoles
    
  2. Verdeel de toepassingsmachtiging (app-rol) aan de principal-toepassing door de volgende aanvraag uit te voeren.

    POST https://graph.microsoft.com/v1.0/servicePrincipals/11112222-bbbb-3333-cccc-4444dddd5555/appRoleAssignedTo
    
    Request body
    
    {
       "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222",
       "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1",
       "appRoleId": "df021288-bdef-4463-88db-98f22de89214"
    }
    

Volgende stappen