Condividi tramite

Informazioni di riferimento sulle regole e sulla visualizzazione delle definizioni

  • Articolo

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 Definizioni di 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 Connect 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 string ID client da usare per ottenere il token ID
redirectUri string URI di reindirizzamento da usare per ottenere il token ID; DEVE ESSERE vcclient://openid/
scope string 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 consente 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 viene impostato sull'autorità emittente, 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 Descrizione
inputClaim stringa nome dell'attestazione da usare dall'input
outputClaim string 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 Descrizione
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 Descrizione
title stringa titolo delle credenziali
issuedBy string 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 string 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 string la descrizione del logo

Nota

Microsoft consiglia di usare formati di immagine ampiamente supportati, ad esempio .PNG, .JPG o .BMP, per ridurre gli errori di formato del file.

tipo displayConsent

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

tipo displayClaims

Proprietà Type Descrizione
label stringa etichetta dell'attestazione in visualizzazione
claim string nome dell'attestazione a cui si applica l'etichetta. Per il formato JWT-VC, il valore deve avere il vc.credentialSubject. prefisso .
type string 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.z13.web.core.windows.net/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