Freigeben über


accessPackageAssignmentRequest: fortsetzen

Namespace: microsoft.graph

Setzen Sie die Zugriffspaketanforderung eines Benutzers nach dem Warten auf einen Rückruf von einer benutzerdefinierten Erweiterung fort.

Wenn in der Microsoft Entra-Berechtigungsverwaltung eine Zugriffspaketrichtlinie zum Aufrufen einer benutzerdefinierten Erweiterung aktiviert wurde und die Anforderungsverarbeitung auf den Rückruf des Kunden wartet, kann der Kunde eine Fortsetzungsaktion initiieren. Sie wird für ein accessPackageAssignmentRequest-Objekt ausgeführt, dessen requestStatus sich in einem WaitingForCallback Zustand befindet.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) EntitlementManagement.ReadWrite.All Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung EntitlementManagement.ReadWrite.All Nicht verfügbar.

Wichtig

Nur-App-Zugriff kann autorisiert werden, ohne der Anwendung die EntitlementManagement.ReadWrite.All Berechtigung für den Aufrufer zu gewähren. Weisen Sie dem Aufrufer stattdessen eine Berechtigungsverwaltungsrolle zu, wobei Access package assignment manager die rolle mit den geringsten Berechtigungen für diesen Vorgang unterstützt wird. Weitere Informationen zum Zuweisen einer Berechtigungsverwaltungsrolle finden Sie unter Erstellen von unifiedRoleAssignment oder Delegieren der Zugriffsgovernance für den Zugriff auf Paket-Manager in der Berechtigungsverwaltung.

HTTP-Anforderung

POST /identityGovernance/entitlementManagement/assignmentRequests/{accessPackageAssignmentRequestId}/resume

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung der Parameter an.

In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Aktion verwendet werden können.

Parameter Typ Beschreibung
source Zeichenfolge Quelle, aus der der Kunde versucht, die Anforderung fortzusetzen, die im Dienst gespeichert werden kann und für die Überwachung hilfreich ist.
type Zeichenfolge Geben Sie an, in welcher Phase die benutzerdefinierte Legendenerweiterung ausgeführt wurde. Mögliche Werte: microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated, microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestApproved, , microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestGranted, microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestRemoved
data accessPackageAssignmentRequestCallbackData Enthält Informationen zur Instanz der Legende, die an den Kundenendpunkt vorgenommen wurde.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Beispiel 1: Fortsetzen einer Zugriffspaketzuweisungsanforderung

Anforderung

Das folgende Beispiel zeigt eine Anforderung eines Aufrufs zum Fortsetzen einer Zugriffspaketzuweisungsanforderung, die auf einen Rückruf wartet.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests/0e60f18c-b2a0-4887-9da8-da2e30a39d99/resume
Content-Type: application/json

{
  "source": "Contoso.SodCheckProcess",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData",
    "stage": "assignmentRequestCreated",
    "customExtensionStageInstanceId": "957d0c50-466b-4840-bb5b-c92cea7141ff",
    "customExtensionStageInstanceDetail": "This user is all verified"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Beispiel 2: Fortsetzen und Verweigern einer Zugriffspaketzuweisungsanforderung

Anforderung

Das folgende Beispiel zeigt eine Anforderung zum Fortsetzen der Verarbeitung einer Zugriffspaketzuweisungsanforderung, indem die Anforderung abgelehnt wird, die auf einen Rückruf wartet. Eine Anforderung kann in der assignmentRequestCreated Phase der Legende nicht abgelehnt werden.

POST https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignmentRequests/9e60f18c-b2a0-4887-9da8-da2e30a39d99/resume
Content-Type: application/json

{
  "source": "Contoso.SodCheckProcess",
  "type": "microsoft.graph.accessPackageCustomExtensionStage.assignmentRequestCreated",
  "data": {
    "@odata.type": "microsoft.graph.accessPackageAssignmentRequestCallbackData",
    "stage": "AssignmentRequestCreated",
    "customExtensionStageInstanceId": "857d0c50-466b-4840-bb5b-c92cea7141ff",
    "state": "denied",
    "customExtensionStageInstanceDetail": "Potential risk user based on the SOD check"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content