Règles et référence de définition d’affichage

  • Article

Remarque

La Vérification d’identité Microsoft Entra fait désormais partie de la famille de produits Microsoft Entra. En savoir plus sur la famille Microsoft Entra de solutions d’identité et bien démarrer dans le centre d’administration unifié Microsoft Entra.

Les règles et définitions d’affichage sont utilisées pour définir des informations d’identification. Vous pouvez en savoir plus à ce sujet dans Comment personnaliser vos informations d’identification.

type rulesModel

Propriété Type Description
attestations idTokenAttestation et/ou idTokenHintAttestation et/ou verifiablePresentationAttestation et/ou selfIssuedAttestation définit les flux d’attestation à utiliser pour recueillir les revendications à émettre dans les justificatifs vérifiables.
validityInterval nombre représente la durée de vie, en secondes, des informations d’identification
vc vcType types de justificatifs vérifiables pour ce contrat

Exemple de type d’attestation dans JSON. Notez que selfIssued est une instance unique, tandis que les autres sont des collections. Si vous désirez des exemples d’utilisation du type d’attestation, veuillez consulter les rubriques Exemples de définitions de règles JSON dans les guides pratiques.

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

type idTokenAttestation

Lorsque vous connectez l’utilisateur à partir de l’application Authenticator, vous pouvez utiliser comme entrée le jeton d’ID qui est retourné par le fournisseur compatible OpenID Connect.

Propriété Type Description
mapping claimMapping (facultatif) règles pour mapper les revendications d’entrée en revendications de sortie dans les justificatifs vérifiables
configuration string (url) Emplacement du document de configuration de votre fournisseur d’identité
clientId string ID client à utiliser lors de l’obtention du jeton d’ID
redirectUri string URI de redirection à utiliser lors de l’obtention du jeton d’ID. DOIT ÊTRE vcclient://openid/
scope string liste délimitée d’espaces d’étendues à utiliser lors de l’obtention du jeton d’ID
required booléenne (false par défaut) indiquant si cette attestation est requise ou non
trustedIssuers chaîne facultative (groupe) liste des DID autorisés à émettre les justificatifs vérifiables pour ce contrat. Cette propriété est utilisée uniquement pour des scénarios spécifiques où id_token_hint peut provenir d’un autre émetteur

idTokenHintAttestation type

Ce flux utilise l’indicateur de jeton d’ID, qui est fourni comme charge utile via l’API REST Request. Le mappage est le même que pour l’attestation de jeton d’ID.

Propriété Type Description
mapping claimMapping (facultatif) règles pour mapper les revendications d’entrée en revendications de sortie dans les justificatifs vérifiables
required booléenne (false par défaut) indiquant si cette attestation est requise ou non
trustedIssuers chaîne facultative (groupe) liste des DID autorisés à émettre les justificatifs vérifiables pour ce contrat. Cette propriété est utilisée uniquement pour des scénarios spécifiques où id_token_hint peut provenir d’un autre émetteur

type vérifiablePresentationAttestation

S’utilise quand vous souhaitez que l’utilisateur présente un autre justificatif vérifiable comme entrée pour un nouveau justificatif vérifiable émis. Le portefeuille permet à l’utilisateur de sélectionner le justificatif vérifiable lors de l’émission.

Propriété Type Description
mapping claimMapping (facultatif) règles pour mapper les revendications d’entrée en revendications de sortie dans les justificatifs vérifiables
credentialType chaîne (facultatif) type d’informations d’identification requis de l’entrée
required booléenne (false par défaut) indiquant si cette attestation est requise ou non
trustedIssuers chaîne (tableau) liste des DID autorisés à émettre les justificatifs vérifiables pour ce contrat. Le service est défini par défaut sur votre émetteur sous les couvertures. Il n’est donc pas nécessaire de fournir cette valeur vous-même.

type selfIssuedAttestation

Lorsque vous souhaitez que l’utilisateur entre des informations elles-mêmes. Ce type est également appelé entrée auto-attestée.

Propriété Type Description
mapping claimMapping (facultatif) règles pour mapper les revendications d’entrée en revendications de sortie dans les justificatifs vérifiables
required booléenne (false par défaut) indiquant si cette attestation est requise ou non

type claimMapping

Propriété Type Description
inputClaim string nom de la revendication à utiliser à partir de l’entrée
outputClaim string nom de la revendication dans les justificatifs vérifiables
indexed booléenne (false par défaut) indiquant si la valeur de cette revendication est utilisée pour la recherche ; un seul objet clientMapping est indexable pour un contrat donné
required booléenne (false par défaut) indiquant si ce mappage est obligatoire ou non
type chaîne (facultatif) type de revendication

vcType type

Propriété Type Description
type chaîne (tableau) liste de types de justificatifs vérifiables que ce contrat peut émettre

Exemple de définition de règles :

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

type displayModel

Propriété Type Description
locale string paramètres régionaux de cet affichage
credential displayCredential les propriétés d’affichage des justificatifs vérifiables
consent displayConsent données supplémentaires lorsque les justificatifs vérifiables sont émis
claims tableau displayClaims étiquettes pour les revendications incluses dans les justificatifs vérifiables

type displayCredential

Propriété Type Description
title string titre des informations d'identification
issuedBy string Le nom de l’émetteur des informations d'identification
backgroundColor nombre (hexadécimal) couleur d’arrière-plan des informations d’identification au format hex, par exemple, #FFAABB
textColor nombre (hexadécimal) couleur du texte des informations d’identification au format hex, par exemple, #FFAABB
description string Texte supplémentaire affiché à côté de chaque informations de connexion
logo displayCredentialLogo logo à utiliser pour les informations d’identification

type displayCredentialLogo

Propriété Type Description
uri string (url) URL du logo.
description string Description de logo

Type displayConsent

Propriété Type Description
title string titre du consentement
instructions string texte supplémentaire à utiliser lors de l’affichage du consentement

Type DisplayClaims

Propriété Type Description
label string étiquette de la revendication en affichage
claim string le nom de la revendication à laquelle l’étiquette s’applique. Pour le format JWT-VC, la valeur doit avoir le préfixe vc.credentialSubject..
type string type de la revendication
description chaîne (facultatif) description de la revendication

exemple de définition d’affichage :

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

Étapes suivantes