---
title: "Assinar CMS/CAdES utilizando certificado em arquivo (Passo único)  ⚠️"
method: POST
path: "/fw/v1/cms/pkcs12/assinaturas"
tags: ["Assinador CMS"]
---

# Assinar CMS/CAdES utilizando certificado em arquivo (Passo único)  ⚠️

`POST /fw/v1/cms/pkcs12/assinaturas`

⚠️ Disponível somente para implantação on-premises

## Request body

- object
  - `signatario` string, required — Nome do arquivo pfx/p12
  - `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.
  - `formatoDados` string, required — String indicando qual será o formato de codificação dos dados a serem assinados. [Valores disponíveis: Base64]
  - `algoritmoHash` string, required — String que representa o algoritmo de hash que será utilizado para gerar a assinatura. [Valores disponíveis: SHA1, SHA256 e SHA512].
  - `formatoAssinatura` string, required — Formato do processamento dos documentos recebidos na lista de hashes. [Valores disponíveis: HASH, ATTACHED e DETACHED].
  - `coAssinatura` boolean — Boolean representando se será realizado uma coassinatura. Valor padrão é false.
  - `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.
  - `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.
  - `oidPolitica` string — Quando enviado, este parâmetro define o OID da política de assinatura a ser usada com perfil de assinatura selecionado.

## Response `200`

Signature response

- object
  - `padrao` string
  - `assinaturas` string[]

## 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)