Crie credenciais verificáveis para dica de token de ID

Uma definição de regras que usa o atestado idTokenHint produz um fluxo de emissão em que o aplicativo de terceira parte confiável passa valores de declaração na carga útil da solicitação de emissão. É responsabilidade do aplicativo de terceira parte confiável garantir que os valores de declaração necessários sejam passados na solicitação. A forma como os valores dos sinistros são recolhidos depende do pedido.

Criar uma credencial personalizada

No portal do Azure, ao selecionar Adicionar credencial, você tem a opção de iniciar dois inícios rápidos. Selecione credencial personalizada e, em seguida, selecione Avançar.

Na página Criar uma nova credencial, insira o código JSON para as regras e definições de exibição. Na caixa Nome da credencial , dê à credencial um nome de tipo. Para criar a credencial, selecione Criar.

Definições de exibição JSON de exemplo

O JSON esperado para as definições de exibição é o conteúdo interno da coleção de displays. O JSON é uma coleção, portanto, se você quiser oferecer suporte a várias localidades, adicione várias entradas, com uma vírgula como separador.

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

Definições de regras JSON de exemplo

O JSON esperado para as definições de regras é o conteúdo interno do atributo rules, que começa com o atributo attestation.

{
      "attestations": {
        "idTokenHints": [
          {
            "mapping": [
              {
                "outputClaim": "firstName",
                "required": true,
                "inputClaim": "$.given_name",
                "indexed": false
              },
              {
                "outputClaim": "lastName",
                "required": true,
                "inputClaim": "$.family_name",
                "indexed": true
              }
            ],
            "required": false
          }
        ]
      },
      "validityInterval":  2592000,
      "vc": {
        "type": [
          "VerifiedCredentialExpert"
        ]
      }
}

Configure os exemplos para emitir e verificar sua credencial personalizada

Antes de configurar seu código de exemplo para emitir e verificar usando credenciais personalizadas, você precisa:

• Identificador descentralizado do emissor do seu inquilino (DID)
• O tipo de credencial
• O URL do manifesto para sua credencial

A maneira mais fácil de encontrar essas informações para uma credencial personalizada é ir para sua credencial no portal do Azure. Selecione Emitir credencial. Lá você tem acesso a uma caixa de texto com uma carga JSON para a API do Serviço de Solicitação. Substitua os valores de espaço reservado pelas informações do seu ambiente. O DID do emitente é o valor da autoridade.

Próximos passos

Para obter mais informações, consulte:

• Referência de regras e definições de exibição