Kurallar ve Görüntü Tanımı Başvurusu

Makale
12/07/2023

Kurallar ve Görüntü tanımları, kimlik bilgilerini tanımlamak için kullanılır. Bu konuda daha fazla bilgi için bkz. Kimlik bilgilerinizi özelleştirme.

rulesModel türü

Özellik	Türü	Açıklama
`attestations`	idTokenAttestation ve/veya idTokenHintAttestation ve/veya verifiablePresentationAttestation ve/veya selfIssuedAttestation	doğrulanabilir kimlik bilgisinde verilen talepleri toplamak için kullanılacak kanıtlama akışlarını tanımlar.
`validityInterval`	Numara	kimlik bilgilerinin saniye cinsinden kullanım ömrünü temsil eder
`vc`	vcType	bu sözleşme için doğrulanabilir kimlik bilgisi türleri

JSON'daki kanıtlama türü örneği. selfIssued Bunun tek bir örnek olduğuna, diğerleri ise koleksiyon olduğuna dikkat edin. Kanıtlama türünün nasıl kullanılacağına ilişkin örnekler için nasıl yapılır kılavuzlarındaki Örnek JSON kuralları tanımlarını inceleyin.

"attestations": {
  "idTokens": [],
  "idTokenHints": [],
  "presentations": [],
  "selfIssued": {}
}

idTokenAttestation türü

Authenticator'ın içinden kullanıcıda oturum açtığınızda, Giriş olarak OpenID Bağlan uyumlu sağlayıcıdan döndürülen kimlik belirtecini kullanabilirsiniz.

Özellik	Türü	Açıklama
`mapping`	claimMapping (isteğe bağlı)	doğrulanabilir kimlik bilgilerindeki çıkış taleplerine giriş beyanlarını eşleme kuralları
`configuration`	dize (url)	kimlik sağlayıcısının yapılandırma belgesinin konumu
`clientId`	Dize	kimlik belirtecini alırken kullanılacak istemci kimliği
`redirectUri`	Dize	kimlik belirtecini alırken kullanılacak yeniden yönlendirme uri'si; OLMALIDIR `vcclient://openid/`
`scope`	Dize	kimlik belirtecini alırken kullanılacak kapsamların boşlukla ayrılmış listesi
`required`	boole (varsayılan yanlış)	bu kanıtlamanın gerekli olup olmadığını gösterir
`trustedIssuers`	isteğe bağlı dize (dizi)	bu sözleşme için doğrulanabilir kimlik bilgilerini vermesine izin verilen DD'lerin listesi. Bu özellik yalnızca başka bir verenden gelebileceği belirli senaryolar `id_token_hint` için kullanılır

idTokenHintAttestation türü

Bu akış, İstek REST API'si aracılığıyla yük olarak sağlanan Kimlik Belirteci İpucunu kullanır. Eşleme, Kimlik Belirteci kanıtlaması ile aynıdır.

Özellik	Türü	Açıklama
`mapping`	claimMapping (isteğe bağlı)	doğrulanabilir kimlik bilgilerindeki çıkış taleplerine giriş beyanlarını eşleme kuralları
`required`	boole (varsayılan yanlış)	bu kanıtlamanın gerekli olup olmadığını gösterir. CreatePresentationRequest yükünde gerekli talepler ayarlanmadıysa İstek Hizmeti API'sinin çağrısı başarısız olur.
`trustedIssuers`	isteğe bağlı dize (dizi)	bu sözleşme için doğrulanabilir kimlik bilgilerini vermesine izin verilen DD'lerin listesi. Bu özellik yalnızca başka bir verenden gelebileceği belirli senaryolar `id_token_hint` için kullanılır

verifiablePresentationAttestation türü

Kullanıcının verilen yeni bir doğrulanabilir kimlik bilgisi için giriş olarak doğrulanabilir başka bir kimlik bilgisi sunmasını istediğinizde. Cüzdan, kullanıcının verme sırasında doğrulanabilir kimlik bilgilerini seçmesine izin verir.

Özellik	Türü	Açıklama
`mapping`	claimMapping (isteğe bağlı)	doğrulanabilir kimlik bilgilerindeki çıkış taleplerine giriş beyanlarını eşleme kuralları
`credentialType`	dize (isteğe bağlı)	girişin gerekli kimlik bilgisi türü
`required`	boole (varsayılan yanlış)	bu kanıtlamanın gerekli olup olmadığını gösterir
`trustedIssuers`	dize (dizi)	bu sözleşme için doğrulanabilir kimlik bilgilerini vermesine izin verilen DD'lerin listesi. Hizmet varsayılan olarak kapakların altında vereniniz olur, bu nedenle bu değeri kendiniz sağlamanız gerekmez.

selfIssuedAttestation türü

Kullanıcının bilgileri kendisi girmesini istediğinizde. Bu tür, kendi kendine test edilen giriş olarak da adlandırılır.

Özellik	Türü	Açıklama
`mapping`	claimMapping (isteğe bağlı)	doğrulanabilir kimlik bilgilerindeki çıkış taleplerine giriş beyanlarını eşleme kuralları
`required`	boole (varsayılan yanlış)	bu kanıtlamanın gerekli olup olmadığını gösterir

claimMapping türü

Özellik	Türü	Veri Akışı Açıklaması
`inputClaim`	Dize	girişten kullanılacak talebin adı
`outputClaim`	Dize	doğrulanabilir kimlik bilgilerindeki talebin adı
`indexed`	boole (varsayılan yanlış)	bu talebin değerinin arama için kullanılıp kullanılmadığını gösterir; Belirli bir sözleşme için yalnızca bir clientMapping nesnesi dizine eklenebilir
`required`	boole (varsayılan yanlış)	bu eşlemenin gerekli olup olmadığını gösterir
`type`	dize (isteğe bağlı)	talep türü

vcType türü

Özellik	Türü	Açıklama
`type`	dize (dizi)	bu sözleşmenin yayımlayabileceği doğrulanabilir kimlik bilgisi türlerinin listesi

Örnek kural tanımı:

{
  "attestations": {
    "idTokenHints": [
      {
        "mapping": [
          {
            "outputClaim": "givenName",
            "required": false,
            "inputClaim": "given_name",
            "indexed": false
          },
          {
            "outputClaim": "familyName",
            "required": false,
            "inputClaim": "family_name",
            "indexed": false
          }
        ],
        "required": false
      }
    ]
  },
  "validityInterval": 2592000,
  "vc": {
    "type": [
      "VerifiedCredentialExpert"
    ]
  }
}

displayModel türü

Özellik	Türü	Veri Akışı Açıklaması
`locale`	Dize	bu ekranın yerel ayarı
`credential`	displayCredential	doğrulanabilir kimlik bilgilerinin görüntü özellikleri
`consent`	displayConsent	doğrulanabilir kimlik bilgileri verildiğinde ek veriler
`claims`	displayClaims dizisi	doğrulanabilir kimlik bilgilerine dahil edilen talepler için etiketler

displayCredential türü

Özellik	Türü	Veri Akışı Açıklaması
`title`	Dize	kimlik bilgilerinin başlığı
`issuedBy`	Dize	kimlik bilgisi verenin adı
`backgroundColor`	sayı (onaltılık)	kimlik bilgilerinin onaltılık biçimde arka plan rengi, örneğin, #FFAABB
`textColor`	sayı (onaltılık)	onaltılık biçimde kimlik bilgilerinin metin rengi, örneğin, #FFAABB
`description`	Dize	her kimlik bilgisi ile birlikte görüntülenen ek metin
`logo`	displayCredentialLogo	kimlik bilgisi için kullanılacak logo

displayCredentialLogo türü

Özellik	Türü	Açıklama
`uri`	dize (url)	logonun url'sini seçin.
`description`	Dize	logo açıklaması

displayConsent türü

Özellik	Türü	Veri Akışı Açıklaması
`title`	Dize	onayın başlığı
`instructions`	Dize	onay görüntülenirken kullanılacak ek metin

displayClaims türü

Özellik	Türü	Veri Akışı Açıklaması
`label`	Dize	görüntülenen talebin etiketi
`claim`	Dize	etiketin uygulandığı talebin adı. JWT-VC biçimi için değerin ön ekine `vc.credentialSubject.` sahip olması gerekir.
`type`	Dize	talebin türü
`description`	dize (isteğe bağlı)	talebin açıklaması

Örnek görüntüleme tanımı:

{
  "locale": "en-US",
  "card": {
    "backgroundColor": "#FFA500",
    "description": "This is your Verifiable Credential",
    "issuedBy": "Contoso",
    "textColor": "#FFFF00",
    "title": "Verifiable Credential Expert",
    "logo": {
      "description": "Default VC logo",
      "uri": "https://didcustomerplayground.blob.core.windows.net/public/VerifiedCredentialExpert_icon.png"
    }
  },
  "consent": {
    "instructions": "Please click accept to add this credentials",
    "title": "Do you want to accept the verified credential expert dentity?"
  },
  "claims": [
    {
      "claim": "vc.credentialSubject.givenName",
      "label": "Name",
      "type": "String"
    },
    {
      "claim": "vc.credentialSubject.familyName",
      "label": "Surname",
      "type": "String"
    }
  ]
}

Sonraki adımlar

Kimlik bilgilerinizi özelleştirme hakkında daha fazla bilgi edinin

Aracılığıyla paylaş