---
title: "Verifica a assinatura de um desafio e o certificado do assinante"
method: POST
path: "/api/authentication-service/v1/verify-challenge"
tags: ["Validação de Certificados"]
---

# Verifica a assinatura de um desafio e o certificado do assinante

`POST /api/authentication-service/v1/verify-challenge`

## Request body

- object
  - `certificate` string, 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]
  - `challenge` string, required — Desafio codificado em Base64.
  - `challengeSignature` string, required — Assinatura do desafio codificada em Base64.

## Response `200`

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

- object
  - `certificateReport` CertificateReport
    - `nonce` integer
    - `status` ChainVerificationStatus
      - `@type` string
      - `status` 'VALID' | 'VALID_WITH_ALERT' | 'INVALID' | 'INVALID_WITH_INTEGRITY_ERROR'
      - `infoStatus` InfoStatusVazio
        - `keyDescriptionList` object[]
          - `args` object[]
          - `description` string
          - `key` string
        - `statusType` string
      - `alertStatus` InfoStatusVazio
        - `keyDescriptionList` object[]
          - `args` object[]
          - `description` string
          - `key` string
        - `statusType` string
      - `errorStatus` InfoStatusVazio
        - `keyDescriptionList` object[]
          - `args` object[]
          - `description` string
          - `key` string
        - `statusType` string
      - `certificateStatusList` union[]
        - union
          - ChainCertificateVerificationStatus
            - `@type` string
            - `status` 'VALID' | 'VALID_WITH_ALERT' | 'INVALID' | 'INVALID_WITH_INTEGRITY_ERROR'
            - `infoStatus` InfoStatusVazio
              - …
            - `alertStatus` InfoStatusVazio
              - …
            - `errorStatus` InfoStatusVazio
              - …
            - `content` string
            - `pkiBrazil` boolean
            - `verificationReference` string, date-time
            - `verificationReferenceType` 'CERTIFIED' | 'ACTUAL' | 'DECLARED'
            - `certificateInfo` CertificateInfo
              - …
            - `statusType` 'SIGNATURE' | 'CERTIFICATE' | 'CHAIN' | 'TIMESTAMP' | 'SIGNATURE_POLICY' | 'CERTIFICATE_ATTRIBUTE'
          - FinalCertificateVerificationStatus
            - `@type` string
            - `status` 'VALID' | 'VALID_WITH_ALERT' | 'INVALID' | 'INVALID_WITH_INTEGRITY_ERROR'
            - `infoStatus` InfoStatusVazio
              - …
            - `alertStatus` InfoStatusVazio
              - …
            - `errorStatus` InfoStatusVazio
              - …
            - `content` string
            - `revocationStatus` CertificateRevocationStatus
              - …
            - `pkiBrazil` boolean
            - `certificateType` 'A1' | 'A2' | 'A3' | 'A4' | 'S1' | 'S2' | 'S3' | 'S4' | 'T3' | 'T4' | 'AC' | 'A_CF_E_SAT' | 'UNKNOWN'
            - `verificationReference` string, date-time
            - `verificationReferenceType` 'CERTIFIED' | 'ACTUAL' | 'DECLARED'
            - `certificateInfo` CertificateInfo
              - …
            - `keyInfo` KeyInfo
              - …
            - `cpf` string
            - `email` string
            - `extensions` Extensions
              - …
            - `extensionPki` IExtensionPkiBrazil
              - …
            - `crlinfo` CRLInfo
              - …
            - `statusType` 'SIGNATURE' | 'CERTIFICATE' | 'CHAIN' | 'TIMESTAMP' | 'SIGNATURE_POLICY' | 'CERTIFICATE_ATTRIBUTE'
  - `signatureVerified` string

## Other responses

- `400` — Resposta de erro da aplicação
- `default` — Para mais detalhes sobre as Respostas: [link para as respostas de erro](/openapi/validadores.html) ou [no formato properties](/openapi/validadoresErrors.properties)

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/revisions/c87e026e87ac/schema)