---
title: "Inicializa a assinatura CMS/CADES"
method: POST
path: "/fw/v1/cms/pkcs1/assinaturas/acoes/inicializar"
tags: ["Assinador CMS"]
---

# Inicializa a assinatura CMS/CADES

`POST /fw/v1/cms/pkcs1/assinaturas/acoes/inicializar`

## Request body

- object
  - `algoritmoHash` string, required — Algoritmo de HASH [SHA1, SHA256, SHA512], Default value : SHA256
  - `certificado` string, required — Certificado [conteúdo codificado em Base64]
  - `coAssinatura` boolean — Boolean representando se será realizado uma coassinatura. Valor padrão é false.
  - `formatoAssinatura` string, required — Formato do processamento dos documentos recebidos na lista de hashes. [Valores disponíveis: HASH, ATTACHED e DETACHED].
  - `formatoDadosEntrada` string, required — String indicando qual será o formato de codificação dos dados a serem assinados. [Valores disponíveis: Base64]
  - `formatoDadosSaida` string, required — String indicando qual será o formato de codificação dos dados da resposta. [Valores disponíveis: Base64]
  - `padrao` string, required — String representando o padrão de assinatura. [Valores disponíveis: CMS, CADES]
  - `perfil` string, required — String representando o tipo de perfil desejado para a assinatura a ser gerada. [Valores disponíveis: BASIC, TIMESTAMP, COMPLETE, ADRB, ADRT, ADRV, ADRC, ADRA, ETSI_B, ETSI_T, ETSI_LT e ETSI_LTA]. Aceita também os valores legados em português para os perfis de assinatura CMS básica.
  - `hashes` string[], required — Array de strings com os conteúdos a serem assinados. Atualmente se o formatoAssinatura for HASH deve ser enviado os resumos criptográficos (hashes) calculados a partir do documento original. Caso formatoAssinatura seja algum dos demais valores (ATTACHED ou DETACHED), deve ser enviado o conteúdo original do documento que se deseja assinar.
  - `nonces` string[], required — Array de strings com um conjunto de nonces gerados pela aplicação cliente para realizar o controle das assinaturas. Para cada arquivo encaminhado, deverá ser atribuído um nonce.
  - `comentarios` string[] — Array de strings com um conjunto de comentários que serão inseridos na assinatura. Parâmetro Opcional, mas se utilizado deve ser enviado um comentario para cada assinatura a ser realizada.
  - `nomeDocumentos` string[] — Array de strings com um conjunto de nomes que serão inseridos na assinatura como nome do documento. Parâmetro Opcional, mas se utilizado deve ser enviado um nome para cada assinatura a ser realizada.

## Response `200`

The initialization response

- object
  - `nonce` string
  - `formatoDadosEntrada` string
  - `formatoDadosSaida` string
  - `algoritmoHash` string
  - `assinaturasInicializadas` object[]
    - `messageDigest` string — Hash correspondente ao conteúdo que deve ser assinado. O conteúdo deste campo deve ser cifrado com a chave privada do certificado (por exemplo via Bry Extension) e então enviado à finalização.
    - `nonce` string — Nonce correspondente ao documento a ser assinado.

## Other responses

- `400` — Resposta de erro da aplicação
- `default` — Para mais detalhes sobre as Respostas: [link para as respostas de erro](/openapi/assinadoresCms.html) ou [no formato properties](/openapi/assinadoresCmsErrors.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)