为 ID 令牌提示创建可验证凭据

使用 idTokenHint 证明 的规则定义会生成一个颁发流，其中信赖方应用在颁发请求有效负载中传递声明值。 信赖方应用负责确保请求中传递所需的声明值。 如何收集声明值取决于应用程序。

创建自定义凭据

在门户中选择“添加凭据”时，可以选择启动两个快速入门。 选择“自定义凭据”，然后选择“下一步”。

在“新建凭据”页面上，输入规则的 JSON 代码并显示定义。 在“凭据名称”框中，为凭据提供类型名称。 选择“创建”以创建凭据。

示例 JSON 显示定义

显示定义的预期 JSON 为显示集合的内部内容。 JSON 是一个集合，如果要支持多个区域设置，则添加多个条目，以逗号作为分隔符。

{
    "locale": "en-US",
    "card": {
      "title": "Verified Credential Expert",
      "issuedBy": "Microsoft",
      "backgroundColor": "#000000",
      "textColor": "#ffffff",
      "logo": {
        "uri": "https://didcustomerplayground.z13.web.core.windows.net/VerifiedCredentialExpert_icon.png",
        "description": "Verified Credential Expert Logo"
      },
      "description": "Use your verified credential to prove to anyone that you know all about verifiable credentials."
    },
    "consent": {
      "title": "Do you want to get your Verified Credential?",
      "instructions": "Sign in with your account to get your card."
    },
    "claims": [
      {
        "claim": "vc.credentialSubject.firstName",
        "label": "First name",
        "type": "String"
      },
      {
        "claim": "vc.credentialSubject.lastName",
        "label": "Last name",
        "type": "String"
      }
    ]
}

规则定义的 JSON 示例

规则定义的预期 JSON 是规则属性的内部内容，它以 attestation 属性开头。

{
      "attestations": {
        "idTokenHints": [
          {
            "mapping": [
              {
                "outputClaim": "firstName",
                "required": true,
                "inputClaim": "$.given_name",
                "indexed": false
              },
              {
                "outputClaim": "lastName",
                "required": true,
                "inputClaim": "$.family_name",
                "indexed": true
              }
            ],
            "required": false
          }
        ]
      },
      "validityInterval":  2592000,
      "vc": {
        "type": [
          "VerifiedCredentialExpert"
        ]
      }
}

配置用于颁发和验证自定义凭据的示例

若要配置示例代码用于颁发自定义凭据并验证其使用，需要满足以下前提条件：

• 租户的颁发者分散式标识符 (DID)
• 凭据类型
• 指向凭据的清单 URL

查找自定义凭据的此信息的最简单方法是转到 Azure 门户中的凭据。 选择“颁发凭据”。 然后便可以访问具有请求服务 API JSON 有效负载的文本框。 将占位符值替换为环境的信息。 颁发者的 DID 是 authority 值。

后续步骤

有关详细信息，请参阅：

• 规则和显示定义参考