---
title: "Requisitos de certificados - Sessões de assinatura"
description: "Como restringir os certificados que o usuário pode escolher em uma sessão de assinatura do Rest PKI Core, com requisitos de certificado como CryptoDevice."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/certificate-requirements"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-07-22"
---

# Requisitos de certificados - Sessões de assinatura

Para restringir os certificados que o usuário poderá escolher durante uma [sessão de assinatura](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions), especifique uma lista de
**requisitos de certificado** ao criar a sessão. O usuário somente poderá escolher certificados que atendam a **todos** os critérios
especificados.

Cada requisito é composto por um **tipo** e, dependendo do tipo, um **argumento**. Por exemplo, digamos que a sua aplicação precisa que
as assinaturas sejam feitas com certificados A3, ficando vedado o uso de certificados A1, que é o que o requisito [CryptoDevice](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/certificate-requirements#crypto-device)
faz. Como esse requisito não recebe um argumento, precisamos apenas passar o tipo.

Em .NET:

```cs
var response = await restPkiService.CreateSignatureSessionAsync(new CreateSignatureSessionRequest() {
	...,
	CertificateRequirements = new List<CertificateRequirement> {
		new CertificateRequirement { Type = CertificateRequirementTypes.CryptoDevice }
	}
});
return Redirect(response.RedirectUrl);
```

Integração direta por API:

```plaintext
POST {endpoint}/api/signature-sessions
{
	...,
	"certificateRequirements": [
		{
			"type": "CryptoDevice"
		}
	]
}
```

Veja os requisitos suportados na próxima sessão.

## Requisitos suportados

Os seguintes tipos de requisito são atualmente suportados:

* [CryptoDevice](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/certificate-requirements#crypto-device): requer que o certificado tenha a chave privada protegida por dispositivo criptográfico (certificado A3 ou A4)
* [Cpf](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/signature-sessions/certificate-requirements#cpf): requer que o certificado tenha um determinado CPF

> **Observação**
>
> Se você precisar de um requisito diferente, contate-nos

### CryptoDevice

Use o requisito `CryptoDevice` para permitir apenas o uso de certificados cuja chave privada é protegida por dispositivo criptográfico (tipicamente
token ou smartcard). Em outras palavras, fica vedado o uso de certificados A1, podendo apenas serem utilizados certificados A3 ou A4. Este requisito
não recebe argumento.

### Cpf

Use o requisito `Cpf` para restringir o usuário a utilizar apenas certificados com um determinado CPF. Passe o CPF no argumento, com ou sem pontuação
(mas *com* zeros à esquerda).

> **Observação**
>
> Esse requisito tem o efeito colateral de melhorar a experiência do usuário no uso de certificado em nuvem, na medida em que permite que o sistema
> não precise solicitar ao usuário que digite seu CPF para consultar os certificados em nuvem disponíveis (o CPF é obtido a partir do requisito especificado).