Compartilhar via


Criar credenciais verificáveis para declarações autodeclaradas

Uma definição de regras que usa o atestado autoemitido produz um fluxo de emissão em que você é obrigado a inserir valores manualmente para as declarações no Microsoft Authenticator.

Criar uma credencial personalizada com o tipo de atestado autoemitido

No portal do Azure, ao selecionar Adicionar credencial, você obtém a opção de iniciar dois guias de início rápido. Selecione credencial personalizada e Avançar.

Captura de tela do guia de início rápido Emitir credenciais para criar uma credencial personalizada.

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

Captura de tela da página Criar uma credencial, exibindo exemplos de JSON dos arquivos de exibição e de regras.

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

A definição de exibição JSON é quase a mesma, independentemente do tipo de atestado. Você só precisa ajustar os rótulos de acordo com as declarações que a credencial verificável apresenta. O JSON esperado para as definições de exibição é o conteúdo interno da coleção de exibições. O JSON é uma coleção, portanto, se você quiser dar 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.displayName",
        "label": "Name",
        "type": "String"
      },
      {
        "claim": "vc.credentialSubject.companyName",
        "label": "Company",
        "type": "String"
      }
    ]
}

Definições de regras JSON de exemplo

A definição de atestado JSON deve conter o nome autoemitido e a seção de mapeamento de declarações. Como as declarações são autoemitidas, o valor é o mesmo para outputClaim e inputClaim. O JSON esperado para as definições de regras é o conteúdo interno do atributo de regras, que começa com o atributo de atestado.

{
  "attestations": {
    "selfIssued": {
      "mapping": [
        {
          "outputClaim": "displayName",
          "required": true,
          "inputClaim": "displayName",
          "indexed": true
        },
        {
          "outputClaim": "companyName",
          "required": true,
          "inputClaim": "companyName",
          "indexed": false
        }
      ],
      "required": false
    }
  },
  "validityInterval": 2592000,
  "vc": {
    "type": [
      "VerifiedCredentialExpert"
    ]
  }
}

Entrada de declarações durante a emissão

Durante a emissão, o Authenticator solicita que você insira valores para as declarações especificadas. A entrada de usuário não é validada.

Captura de tela da entrada de reivindicações autoemitidas.

Configurar as amostras para emitir e verificar a credencial personalizada

Para configurar o código de exemplo para emitir e verificar a credencial personalizada, você precisa do seguinte:

  • DID (identificador descentralizado) do emissor do locatário
  • O tipo de credencial
  • A URL do manifesto para a credencial

A maneira mais fácil de encontrar essas informações para uma credencial personalizada é acessar a credencial no portal do Azure. Selecione Emitir credencial. Em seguida, você tem acesso a uma caixa de texto com um conteúdo JSON para a API do Serviço de Solicitação. Substitua os valores de espaço reservado pelas informações do ambiente. O DID do emissor é o valor da autoridade.

Captura de tela do Início Rápido de emissão de credencial personalizada.

Próximas etapas

Confira a Referência de regras e definições de exibição.