claimsMappingPolicy リソースの種類

名前空間: microsoft.graph

特定のアプリケーションに発行されたトークンに対する WS-Fed、SAML、OAuth 2.0、および OpenID Connect プロトコルの要求マッピング ポリシーを表します。 要求マッピング ポリシーを使用して、次のことができます。

• トークンに含めるクレームを選択する
• まだ存在しないクレームの種類を作成する
• 特定のクレームで出力されるデータのソースを選択または変更する

トークン サイズを小さくするために、要求マッピング ポリシーに追加できる要求と変換の数は制限されています。 制限に達した後に発生した要求、スキーマのエントリ、または変換は無視され、発行されたトークンには含まれません。 制限の詳細については、「 要求マッピング ポリシー定義のプロパティ」を参照してください。

stsPolicy から継承します。

その他のシナリオと構成の詳細については、次の記事を参照してください。

• Microsoft Entra 管理センターを通じて、テナント内の特定のアプリのトークンで発行される要求をカスタマイズします。
• 方法: Microsoft Graph の要求マッピング ポリシーを使用して要求をカスタマイズします。
• ポリシーを使用した要求のカスタマイズ このポリシーと カスタム クレーム ポリシーの違いを確認します。

メソッド

プロパティ

要求マッピング ポリシー定義のプロパティ

定義プロパティに挿入する JSON オブジェクトは、最初に引用符をエスケープした文字列に変換する必要があります。 このセクションでは、定義の例をいくつか示します。

例 : トークン 内のクレームとして EmployeeID と TenantCountry を含める定義

{
    "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"
}

例: クレーム変換を使用する定義

{
    "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"
}

リレーションシップ

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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