Ressourcentyp "claimsMappingPolicy"

Namespace: microsoft.graph

Stellt die Anspruchszuordnungsrichtlinien für WS-Fed-, SAML-, OAuth 2.0- und OpenID Connect-Protokolle für Token dar, die für eine bestimmte Anwendung ausgestellt wurden. Sie können Anspruchszuordnungsrichtlinien für Folgendes verwenden:

• Wählen Sie aus, welche Ansprüche in Token enthalten sind.
• Erstellen von Anspruchstypen, die noch nicht vorhanden sind
• Wählen Sie die Quelle der in bestimmten Ansprüchen ausgegebenen Daten aus, oder ändern Sie sie.

Die Anzahl der Ansprüche und Transformationen, die einer Anspruchszuordnungsrichtlinie hinzugefügt werden können, ist begrenzt, um die Tokengröße zu reduzieren. Alle Anspruchsschemaeinträge oder Transformationen, die nach Erreichen des Grenzwerts auftreten, werden ignoriert und sind nicht im ausgestellten Token enthalten. Weitere Informationen zu den Grenzwerten finden Sie unter Eigenschaften einer Anspruchszuordnungsrichtliniendefinition.

Erbt von stsPolicy.

Weitere Szenarien und Konfigurationsdetails finden Sie in den folgenden Artikeln:

• Passen Sie Ansprüche, die in Token für eine bestimmte App in einem Mandanten über das Microsoft Entra Admin Center ausgegeben werden, an.
• Gewusst wie: Anpassen von Ansprüchen mit der Anspruchszuordnungsrichtlinie in Microsoft Graph.
• Anpassung der Ansprüche mithilfe einer Richtlinie , um den Unterschied zwischen dieser Richtlinie und der benutzerdefinierten Anspruchsrichtlinie zu erfahren.

Methoden

Eigenschaften

Eigenschaften einer Richtliniendefinition für die Anspruchszuordnung

Das JSON-Objekt, das in die definitionseigenschaft eingefügt werden soll, muss zuerst in eine Zeichenfolge mit Escape-Zeichen für Anführungszeichen konvertiert werden. Dieser Abschnitt enthält einige Definitionsbeispiele.

Beispiel: Definition , um EmployeeID und TenantCountry als Ansprüche in Token einzuschließen

{
    "definition": [
        "{\"ClaimsMappingPolicy\":{\"Version\":1,\"IncludeBasicClaimSet\":\"true\",\"ClaimsSchema\": [{\"Source\":\"user\",\"ID\":\"employeeid\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name\",\"JwtClaimType\":\"name\"},{\"Source\":\"company\",\"ID\":\"tenantcountry\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/country\",\"JwtClaimType\":\"country\"}]}}"
    ],
    "displayName": "Test1234"
}

Beispiel: Definition , die eine Anspruchstransformation verwendet

{
    "definition": [
        "{\"ClaimsMappingPolicy\":{\"Version\":1,\"IncludeBasicClaimSet\":\"true\",\"ClaimsSchema\": [{\"Source\":\"user\",\"ID\":\"userprincipalname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier\"},{\"Source\":\"user\",\"ID\":\"givenname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/givenname\"},{\"Source\":\"user\",\"ID\":\"displayname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name\"},{\"Source\":\"user\",\"ID\":\"surname\",\"SamlClaimType\":\"http://schemas.xmlsoap.org/ws/2005/05/identity/claims/surname\"},{\"Source\":\"user\",\"ID\":\"userprincipalname\",\"SamlClaimType\":\"username\"}],\"ClaimsTransformation\":[{\"ID\":\"CreateTermsOfService\",\"TransformationMethod\":\"CreateStringClaim\",\"InputParameters\": [{\"ID\":\"value\",\"DataType\":\"string\", \"Value\":\"sandbox\"}],\"OutputClaims\":[{\"ClaimTypeReferenceId\":\"TOS\",\"TransformationClaimType\":\"createdClaim\"}]}]}}"
    ],
    "displayName": "Test1234"
}

Beziehungen

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "definition": ["String"],
  "displayName": "String",
  "id": "String (identifier)",
  "isOrganizationDefault": false,
}