Informazioni di riferimento sulle regole e sulla visualizzazione delle definizioni

Le regole e le definizioni di visualizzazione vengono usate per definire una credenziale. Per altre informazioni, vedere Come personalizzare le credenziali.

tipo rulesModel

Proprietà	Type	Descrizione
attestations	idTokenAttestation e/o idTokenHintAttestation e/o verificabilePresentationAttestation e/o selfIssuedAttestation	definisce i flussi di attestazione da usare per raccogliere attestazioni da rilasciare nelle credenziali verificabili.
validityInterval	number	rappresenta la durata della credenziale in secondi
vc	vcType	Tipi di credenziali verificabili per questo contratto

Esempio di tipo di attestazione in JSON. Si noti che selfIssued è una singola istanza mentre le altre sono raccolte. Per esempi di come usare il tipo di attestazione, vedere Le definizioni delle regole JSON di esempio nelle guide pratiche.

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

tipo idTokenAttestation

Quando si accede all'utente dall'interno di Authenticator, è possibile usare il token ID restituito dal provider compatibile openID Connessione come input.

Proprietà	Type	Descrizione
mapping	claimMapping (facoltativo)	regole per eseguire il mapping delle attestazioni di input in attestazioni di output nelle credenziali verificabili
configuration	string (url)	percorso del documento di configurazione del provider di identità
clientId	stringa	ID client da usare per ottenere il token ID
redirectUri	stringa	URI di reindirizzamento da usare per ottenere il token ID; DEVE ESSERE vcclient://openid/
scope	stringa	elenco delimitato da spazi di ambiti da usare per ottenere il token ID
required	booleano (valore predefinito false)	che indica se questa attestazione è obbligatoria o meno
trustedIssuers	stringa facoltativa (matrice)	elenco di ID autorizzati a rilasciare le credenziali verificabili per questo contratto. Questa proprietà viene usata solo per scenari specifici in cui id_token_hint può provenire da un'altra autorità emittente

tipo idTokenHintAttestation

Questo flusso usa l'hint del token ID, fornito come payload tramite l'API REST della richiesta. Il mapping è uguale a quello dell'attestazione del token ID.

Proprietà	Type	Descrizione
mapping	claimMapping (facoltativo)	regole per eseguire il mapping delle attestazioni di input in attestazioni di output nelle credenziali verificabili
required	booleano (valore predefinito false)	che indica se questa attestazione è obbligatoria o meno. L'API del servizio richieste avrà esito negativo se le attestazioni richieste non sono impostate nel payload createPresentationRequest.
trustedIssuers	stringa facoltativa (matrice)	elenco di ID autorizzati a rilasciare le credenziali verificabili per questo contratto. Questa proprietà viene usata solo per scenari specifici in cui id_token_hint può provenire da un'altra autorità emittente

tipo verificabilePresentationAttestation

Quando si vuole che l'utente presenti un'altra credenziale verificabile come input per una nuova credenziale verificabile rilasciata. Il portafoglio consentirà all'utente di selezionare le credenziali verificabili durante il rilascio.

Proprietà	Type	Descrizione
mapping	claimMapping (facoltativo)	regole per eseguire il mapping delle attestazioni di input in attestazioni di output nelle credenziali verificabili
credentialType	string (facoltativo)	tipo di credenziale richiesto dell'input
required	booleano (valore predefinito false)	che indica se questa attestazione è obbligatoria o meno
trustedIssuers	string (matrice)	elenco di ID autorizzati a rilasciare le credenziali verificabili per questo contratto. Per impostazione predefinita, il servizio sarà l'autorità emittente sotto le quinte, quindi non è necessario fornire questo valore manualmente.

tipo selfIssuedAttestation

Quando si desidera che l'utente immetta le informazioni stesse. Questo tipo è detto anche input autocertificato.

Proprietà	Type	Descrizione
mapping	claimMapping (facoltativo)	regole per eseguire il mapping delle attestazioni di input in attestazioni di output nelle credenziali verificabili
required	booleano (valore predefinito false)	che indica se questa attestazione è obbligatoria o meno

tipo claimMapping

Proprietà	Type	Descrzione
inputClaim	stringa	nome dell'attestazione da usare dall'input
outputClaim	stringa	nome dell'attestazione nella credenziale verificabile
indexed	booleano (valore predefinito false)	che indica se il valore di questa attestazione viene utilizzato per la ricerca; un solo oggetto clientMapping è indicizzabile per un determinato contratto
required	booleano (valore predefinito false)	che indica se questo mapping è obbligatorio o meno
type	string (facoltativo)	tipo di attestazione

Tipo vcType

Proprietà	Type	Descrizione
type	string (matrice)	un elenco di tipi di credenziali verificabili che questo contratto può emettere

Definizione di regole di esempio:

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

tipo displayModel

Proprietà	Type	Descrzione
locale	stringa	impostazioni locali di questa visualizzazione
credential	displayCredential	proprietà di visualizzazione delle credenziali verificabili
consent	displayConsent	dati supplementari quando vengono rilasciate le credenziali verificabili
claims	matrice displayClaims	etichette per le attestazioni incluse nella credenziale verificabile

displayCredential type

Proprietà	Type	Descrzione
title	stringa	titolo delle credenziali
issuedBy	stringa	nome dell'emittente della credenziale
backgroundColor	numero (esadecimale)	colore di sfondo delle credenziali in formato esadecimale, ad esempio #FFAABB
textColor	numero (esadecimale)	colore del testo delle credenziali in formato esadecimale, ad esempio #FFAABB
description	stringa	testo supplementare visualizzato insieme a ogni credenziale
logo	displayCredentialLogo	logo da usare per le credenziali

tipo displayCredentialLogo

Proprietà	Type	Descrizione
uri	string (url)	URL del logo.
description	stringa	la descrizione del logo

tipo displayConsent

Proprietà	Type	Descrzione
title	stringa	titolo del consenso
instructions	stringa	testo supplementare da usare quando viene visualizzato il consenso

tipo displayClaims

Proprietà	Type	Descrzione
label	stringa	etichetta dell'attestazione in visualizzazione
claim	stringa	nome dell'attestazione a cui si applica l'etichetta. Per il formato JWT-VC, il valore deve avere il vc.credentialSubject. prefisso .
type	stringa	tipo dell'attestazione
description	string (facoltativo)	descrizione dell'attestazione

Definizione di visualizzazione di esempio:

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

Passaggi successivi

• Altre informazioni su come personalizzare le credenziali