---
title: Pacote OpenSSL Pkcs12
slug: aiops-documentacao-tecnica/pacote-openssl-pkcs12
docTags: 
createdAt: 2024-07-18T21:09:53.999Z
---

## Resumo

- Gerar arquivos OpenSSL PKCS#12.

## Parâmetros

| **Parâmetro**                                                                     | **Tipo**             | **Escolhas \| Valor Padrão**                          | **Comentários**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------- | -------------------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| action                                                                            | string               | Escolhas:<br />- export<br />(default)<br />- parse   | Exportar ou parsear (analisar) um arquivo PKCS#12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| backup                                                                            | boolean              | Escolhas:<br />- false<br />(default)<br />- true     | Crie um arquivo de backup incluindo data/hora para que você possa obter o arquivo de saída original de volta se você o substituir por um novo acidentalmente.                                                                                                                                                                                                                                                                                                                                                                                                   |
| certificate\_path                                                                 | path                 |                                                       | O caminho para ler certificados e chaves privadas. Deve estar no formato PEM.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| force                                                                             | boolean              | Escolhas:<br />- false<br />(default)<br />- true     | Se o arquivo deve ser gerado novamente, mesmo que já exista.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| friendly\_name <br /><br />aliases: name                                          | string               |                                                       | Especifica o nome do certificado e da chave privada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| iter\_size                                                                        | integer              | 2048<br />(default)                                   | Número de vezes para repetir a etapa de encryption.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| maciter\_size                                                                     | integer              | 1<br />(default)                                      | Número de vezes para repetir a etapa MAC.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| mode                                                                              | raw                  |                                                       | As permissões que o arquivo ou diretório resultante deve ter. Para aqueles usados para /usr/bin/chmod, lembre-se de que os modos são, na verdade, números octais. Você deve adicionar um zero à esquerda para que o analisador YAML do Atmosphere saiba que é um número octal (como 0644 ou 01777) ou citá-lo (como '644' ou '1777') para que o Atmosphere receba uma string e possa fazer sua própria conversão da string em número. Dar ao Atmosphere um número sem seguir uma dessas regras terminará com um número decimal que terá resultados inesperados. |
| other\_certificates <br /><br /><br /><br /><br /><br />aliases: ca\_certificates | list / elements=path |                                                       | Lista de outros certificados a serem incluídos.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| passphrase                                                                        | string               |                                                       | A senha PKCS#12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| path - *required*                                                                 | path                 |                                                       | Nome do arquivo no qual gravar o arquivo PKCS#12.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| privatekey\_passphrase                                                            | string               |                                                       | Senha para descriptografar quaisquer chaves privadas de entrada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| privatekey\_path                                                                  | path                 |                                                       | Arquivo para ler a chave privada.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| src                                                                               | path                 |                                                       | Caminho do arquivo PKCS#12 para análise.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| state                                                                             | string               | Escolhas:<br />- present<br />(default)<br />- absent | Se o arquivo deve existir ou não. Todos os parâmetros, exceto o path, são ignorados quando o estado está absent.                                                                                                                                                                                                                                                                                                                                                                                                                                                |

## Notas

- Para que você aproveite o máximo desse módulo, é necessário que o mesmo esteja funcionando em uma máquina remota ou host, que contenha os arquivos solicitados pelos parâmetros.

## Exemplos

```yaml
# Exemplo: Gerar arquivo PKCS#12
- openssl_pkcs12:
    action: export
    path: /opt/certs/example.p12
    friendly_name: raclette
    privatekey_path: /opt/certs/keys/key.pem
    certificate_path: /opt/certs/cert.pem
    state: present

# Exemplo: Alterar permissão de arquivo PKCS#12
- openssl_pkcs12:
    action: export
    path: /opt/certs/example.p12
    friendly_name: raclette
    privatekey_path: /opt/certs/keys/key.pem
    certificate_path: /opt/certs/cert.pem
    state: present
    mode: '0600'

# Exemplo: Forçar reescrita do arquivo PKCS#12
- openssl_pkcs12:
    action: export
    src: /opt/certs/example.p12
    path: /opt/certs/example.p12
    friendly_name: raclette
    privatekey_path: /opt/certs/keys/key.pem
    certificate_path: /opt/certs/cert.pem
    state: present
    mode: '0600'
    force: yes

# Exemplo: Dump/Parse o arquivo PKCS # 12
- openssl_pkcs12:
    action: parse
    src: /opt/certs/example.p12
    path: /opt/certs/example.pem
    state: present

# Exemplo: Remover arquivo PKCS#12
- openssl_pkcs12:
    path: /opt/certs/example.p12
    state: absent
```

## Valores retornados

| **Chave**     | **Tipo** | **Retornado quando**         | **Descrição**                                                                     |
| ------------- | -------- | ---------------------------- | --------------------------------------------------------------------------------- |
| backup\_file  | string   | Modificado e backup for true | Nome do arquivo de backup criado.                                                 |
| filename      | string   | Modificado ou sucesso        | Caminho para gerar o arquivo PKCS#12.                                             |
| privatekey    | string   | Modificado ou sucesso        | Caminho para a chave privada TLS/SSL a partir da qual a chave pública foi gerada. |