---
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`

## Request

- Base URL: `https://cloud-hom.bry.com.br`
- URL: `https://cloud-hom.bry.com.br/fw/v1/cms/pkcs12/assinaturas`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/docs/fw/v1/cms/pkcs12/assinaturas/post.ts> (a function with typed inputs; its response is checked against the schema)

⚠️ 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.dev/bry/apis/bry-easy-sign-api-rest.md) - [All operations](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/llms.txt) - [OpenAPI document](https://skmtc.dev/bry/apis/bry-easy-sign-api-rest/revisions/c87e026e87ac?raw)