verifiedIdProfile を作成する

名前空間: microsoft.graph

新しい verifiedIdProfile オブジェクトを 作成します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) VerifiedId-Profile.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション サポートされていません。 サポートされていません。

重要

職場または学校アカウントを使用した委任されたアクセスの場合、サインインしているユーザーには、サポートされているMicrosoft Entraロールまたはこの操作に必要なアクセス許可を付与するカスタム ロールが割り当てられている必要があります。 認証ポリシー管理者 は、この操作でサポートされる最小限の特権ロールです。

HTTP 要求

POST /identity/verifiedId/profiles

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 verifiedIdProfile オブジェクトの JSON 表現を指定します。

verifiedIdProfile を作成するときに、次のプロパティを指定できます。

プロパティ 型 説明
name String 検証済み ID プロファイルの表示名。 必須です。
説明 String 検証済み ID プロファイルの説明。 必須です。
state verifiedIdProfileState プロファイルの有効化状態。 使用可能な値: enabled、disabled、unknownFutureValue。 必須です。
verifierDid 文字列 検証可能な資格情報交換で検証者を表す分散型識別子 (DID) 文字列。 必須です。
priority Int32 複数のプロファイルが構成されている場合のプロファイル処理の優先順位を定義します。 省略可能。
verifiedIdProfileConfiguration verifiedIdProfileConfiguration 受け入れられた発行者、要求バインド、および資格情報の種類を表すプロパティのセット。 必須です。
faceCheckConfiguration faceCheckConfiguration Face Check 動作Entra Verified ID構成するプロパティのセット。 必須です。
verifiedIdUsageConfigurations verifiedIdUsageConfiguration コレクション プロファイルの使用目的を定義するコレクション。 使用可能な値: recovery、onboarding、all、unknownFutureValue。 必須です。

応答

成功した場合、このメソッドは応答コード 201 Created と応答本文 に verifiedIdProfile オブジェクトを返します。

例

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/v1.0/identity/verifiedId/profiles
Content-Type: application/json

{
  "name": "Contoso Verified ID",
  "description": "Contoso Verified Identity",
  "lastModifiedDateTime": null,
  "state": "enabled",
  "verifierDid": "did:web:eu.did-dev.contoso.io",
  "priority": 0,
  "verifiedIdProfileConfiguration": {
      "type": "verifiedIdentity",
      "acceptedIssuer": "did:web:eu.did-dev.contoso.io",
      "claimBindingSource": "directory",
      "claimBindings": [
          {
              "matchConfidenceLevel": "exact",
              "sourceAttribute": "First name",
              "verifiedIdClaim": "vc.credentialSubject.firstName"
          },
          {
              "matchConfidenceLevel": "exact",
              "sourceAttribute": "Last name",
              "verifiedIdClaim": "vc.credentialSubject.lastName"
          }
      ],
      "claimValidation": {
          "isEnabled": true,
          "customExtensionId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
      }
  },
  "faceCheckConfiguration": {
      "isEnabled": true,
      "sourcePhotoClaimName": "portrait"
  },
  "verifiedIdUsageConfigurations": [
      {
          "isEnabledForTestOnly": true,
          "purpose": "recovery"
      }
  ]
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#identity/verifiedId/profiles/$entity",
    "id": "ca15ec56-7adf-42ee-847b-00c3008264fb",
    "name": "Contoso Verified ID",
    "description": "Contoso Verified ID",
    "lastModifiedDateTime": null,
    "state": "enabled",
    "verifierDid": "did:web:eu.did-dev.contoso.io",
    "priority": 0,
    "verifiedIdProfileConfiguration": {
        "type": "verifiedIdentity",
        "acceptedIssuer": "did:web:eu.did-dev.contoso.io",
        "claimBindingSource": "directory",
        "claimBindings": [
            {
                "matchConfidenceLevel": "exact",
                "sourceAttribute": "First name",
                "verifiedIdClaim": "vc.credentialSubject.firstName"
            },
            {
                "matchConfidenceLevel": "exact",
                "sourceAttribute": "Last name",
                "verifiedIdClaim": "vc.credentialSubject.lastName"
            }
        ],
        "claimValidation": {
            "isEnabled": true,
            "customExtensionId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee"
        }
    },
    "faceCheckConfiguration": {
        "isEnabled": true,
        "sourcePhotoClaimName": "portrait"
    },
    "verifiedIdUsageConfigurations": [
        {
            "isEnabledForTestOnly": true,
            "purpose": "onboarding"
        }
    ]
}
  • Last updated on