---
title: "Comando do utilitário cliente: **sign**"
description: "Comando sign do rpkitool: assina um documento com um certificado do usuário, escolhido por CPF ou thumbprint, em outro arquivo ou sobre o original."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/integration/client-tool/sign"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-07-22"
---

# Comando do utilitário cliente: **sign**

## Nome

`sign` - Assina um documento utilizando um dos certificados do usuário

## Sintaxe

```sh
rpkitool sign <input-file> [options]
```

O comando recebe um único argumento, o caminho do arquivo a ser assinado.

Opções:

* `--cert-cpf <cert-cpf>`: CPF do certificado a ser utilizado
* `--cert-thumb <cert-thumb>`: *Thumbprint* do certificado a ser utilizado
* `--output-file <output-file>`: Caminho do arquivo de saída
* `--document-key <document-key>`: Chave de validação do documento
* `--overwrite`: Sobrescreve arquivo de entrada
* `--name <name>`: Especifica um nome de arquivo diferente a ser usado nas chamadas à API

O arquivo assinado pode ser escrito em um outro caminho, especificado com o parâmetro `--output-file`, ou pode ser escrito sobre o arquivo de entrada
especificando o parâmetro `--overwrite`.

O certificado a ser utilizado pode ser especificado pelo CPF do usuário com o parâmetro `--cert-cpf` ou pelo *thumbprint* do certificado. Nesse último caso,
a aplicação chamaria primeiro o comando [list-certs](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/client-tool/list-certs) para obter a lista dos certificados disponíveis e exibir ao usuário. O *thumbprint* do certificado
escolhido pelo usuário deve então ser especificado com o parâmetro `--cert-thumb`.

## Exemplos

Para assinar o arquivo `document.pdf` com qualquer certificado de CPF `11111111111` que seja encontrado, sobrescrevendo o arquivo de entrada com o arquivo assinado:

```sh
rpkitool sign document.pdf --cert-cpf 11111111111 --overwrite
```

Para assinar o mesmo arquivo porém com um certificado específico, determinado por seu *thumbprint* (escolhido pelo usuário dentre as opções retornadas pelo comando
[list-certs](https://docs.lacunasoftware.com/articles/rest-pki/core/integration/client-tool/list-certs)), escrevendo o documento assinado no arquivo `signed.pdf`:

```sh
rpkitool sign document.pdf --cert-thumb AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA --output-file signed.pdf
```

## Saída

O `documentId` é escrito no `stdout`, que pode ser utilizado posteriormente para referenciar o documento.