自訂您的可驗認證

發行項
03/12/2024

可驗證的認證定義由兩個元件組成，顯示定義和規則定義。顯示定義會控制宣告的認證和樣式的商標。規則定義會決定使用者收到可驗證認證之前需要提供哪些專案。

本文說明如何修改這兩種類型的定義，以符合貴組織的需求。

顯示定義：電子貨幣包認證視覺效果

Microsoft Entra 驗證識別碼提供一組有限的選項，可用來反映您的品牌。本文提供如何自定義您的認證，以及設計認證的最佳作法，這些認證在發行給用戶之後看起來很棒。

Microsoft Authenticator 是分散式身分識別錢包，會以卡片的形式向用戶顯示可驗證的認證。身為 VC 系統管理員，您可以選擇卡片色彩、圖示和文字字串，以符合組織的品牌。

Authenticator 中已驗證認證卡的螢幕快照，指出重要元素。

卡片也包含可自定義的欄位。您可以使用這些欄位讓使用者知道卡片的用途、它所包含的屬性等等。

建立認證顯示定義

顯示定義是簡單的 JSON 檔，描述錢包應用程式應如何顯示可驗證認證的內容。

注意

此顯示模型目前僅供 Microsoft Authenticator 使用。

顯示定義具有下列結構。如果指定為 URL，則標誌 URI 必須是因特網中公開提供的 URL。

{
    "locale": "en-US",
    "card": {
      "title": "Verified Credential Expert",
      "issuedBy": "Microsoft",
      "backgroundColor": "#000000",
      "textColor": "#ffffff",
      "logo": {
        "uri": "https://didcustomerplayground.blob.core.windows.net/public/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"
      }
    ]
}

如需屬性的詳細資訊，請參閱 displayModel 類型。

規則定義：使用者的需求

規則定義是簡單的 JSON 檔，描述可驗證認證的重要屬性。特別是，它描述如何使用宣告來填入可驗證的認證和認證類型。

{
  "attestations": {
      ...
  },
  "validityInterval":  2592000,
  "vc": {
    "type": [
      "VerifiedCredentialExpert"
    ]
  }
}

證明

下列四種證明類型目前可在規則定義中設定。它們提供 Microsoft Entra 驗證識別碼發行服務用來插入可驗證認證的宣告，並證明該資訊與您的分散式標識碼（DID）不同。規則定義中可以使用多個證明類型。

標識元令牌：設定此選項時，您必須提供 OpenID 連線組態 URI，並包含應包含在可驗證認證中的宣告。系統會提示使用者在 Authenticator 應用程式上「登入」，以符合此需求，並從其帳戶新增相關聯的宣告。若要設定此選項，請參閱本指南
標識元令牌提示：範例應用程式和教學課程會使用標識元令牌提示。設定此選項時，信賴憑證者應用程式必須提供應該包含在要求服務 API 發行要求中可驗證認證的宣告。信賴憑證者應用程式從中取得宣告的位置取決於應用程式，但它可能來自目前的登入會話、來自後端CRM系統，甚至是來自自我判斷的使用者輸入。若要設定此選項，請參閱本指南
可驗證的認證：發行流程的最終結果是產生可驗證的認證，但您也可以要求使用者出示可驗證的認證，以發出認證。規則定義能夠從所呈現的可驗證認證取得特定宣告，並將這些宣告包含在您組織新發行的可驗證認證中。若要設定此選項，請參閱本指南
自我證明宣告：選取此選項時，使用者可以直接將資訊輸入 Authenticator。目前，字串是唯一支援自我證明宣告的輸入。若要設定此選項，請參閱本指南

如需規則 JSON 模型的詳細資訊，請參閱 rulesModel 類型。

認證類型

所有可驗證的認證都必須在其規則定義中宣告其類型。認證類型會區分可驗證的認證架構與其他認證，並確保簽發者和驗證程序之間的互操作性。若要指出認證類型，請提供認證滿足的一或多個認證類型。每個類型都以唯一字串表示。 URI 通常用來確保全域唯一性。 URI 不需要可尋址。它會被視為字串。例如，Contoso University 簽發的文憑認證可能會宣告下列類型：

類型	用途
`https://schema.org/EducationalCredential`	宣告 Contoso University 發出的文憑包含由 schema.org `EducationaCredential` 物件定義的屬性。
`https://schemas.ed.gov/universityDiploma2020`	宣告 Contoso 大學頒發的文憑包含美國教育部所定義的屬性。
`https://schemas.contoso.edu/diploma2020`	宣告 Contoso University 發出的文憑包含 Contoso University 所定義的屬性。

藉由宣告三種類型的文憑，Contoso 可以發出符合驗證程式不同要求的認證。銀行可以從使用者要求一組 EducationCredential，而文憑可以用來滿足要求。或者 Contoso 大學校友會可以要求類型的 https://schemas.contoso.edu/diploma2020認證，而且文憑也可以滿足要求。

為了確保認證互操作性，建議您與相關組織密切合作，以定義認證類型、架構和 URI，以供產業使用。許多業界機構提供官方文件結構的指引，這些檔可用於定義可驗證認證的內容。您也應該與認證的驗證者密切合作，以了解他們想要如何要求及取用可驗證的認證。

下一步

現在您已進一步瞭解可驗證的認證設計，以及如何建立您自己的認證，請參閱：

自訂您的可驗認證

顯示定義：電子貨幣包認證視覺效果

建立認證顯示定義

規則定義：使用者的需求

證明

認證類型

下一步

其他資源