v1

latestOpenAPI 3.0.0MIT2026-08-0414772502.0 KB

Validação de Certificados

Verifica a assinatura de um desafio e o certificado do assinante

post/api/authentication-service/v1/verify-challenge

Headers

Token de acesso aos serviços BRy emitido no BRy Cloud. É obrigatório em todas as requisições ao HUB. Para utilizar esta documentação é necessário inserir o token em Authorize.

Request body

certificatestring required

Certificado do assinante do desafio.

mode'BASIC' | 'CHAIN' required

Modo de retorno da validação do certificado. BASIC retorna apenas as informações do certificado final, CHAIN retorna as informações de toda a cadeia.

hashAlgorithm'SHA1' | 'SHA256' | 'SHA512' required

Algoritmo de hash (resumo criptográfico) utilizado na assinatura do desafio. Valores disponíveis: [SHA1, SHA256, SHA512]

challengestring required

Desafio codificado em Base64.

challengeSignaturestring required

Assinatura do desafio codificada em Base64.

Response

Relatório incluindo resultado da verificação da assinatura e do certificado do assinante

signatureVerifiedstring

Example response

{
  "certificateReport": {
    "status": {
      "infoStatus": {
        "keyDescriptionList": [
          {
            "args": [
              {}
            ],
            "description": "string",
            "key": "string"
          }
        ],
        "statusType": "SIGNATURE"
      },
      "alertStatus": {
        "keyDescriptionList": [
          {
            "args": [
              {}
            ],
            "description": "string",
            "key": "string"
          }
        ],
        "statusType": "SIGNATURE"
      },
      "errorStatus": {
        "keyDescriptionList": [
          {
            "args": [
              {}
            ],
            "description": "string",
            "key": "string"
          }
        ],
        "statusType": "SIGNATURE"
      },
      "certificateStatusList": [
        {
          "infoStatus": {
            "keyDescriptionList": [
              {
                "args": [
                  {}
                ],
                "description": "string",
                "key": "string"
              }
            ],
            "statusType": "SIGNATURE"
          },
          "alertStatus": {
            "keyDescriptionList": [
              {
                "args": [
                  {}
                ],
                "description": "string",
                "key": "string"
              }
            ],
            "statusType": "SIGNATURE"
          },
          "errorStatus": {
            "keyDescriptionList": [
              {
                "args": [
                  {}
                ],
                "description": "string",
                "key": "string"
              }
            ],
            "statusType": "SIGNATURE"
          }
        }
      ]
    }
  }
}