Chave pública OpenSSL

5 min

Resumo

Gere uma chave pública OpenSSL a partir de sua chave privada.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
backup	boolean	Escolhas: - false (default) - true	Crie um arquivo de backup incluindo data/hora para que você possa obter a chave pública original de volta caso a substitua por uma diferente por acidente.
force	boolean	Escolhas: - false (default) - true	Se a chave deve ser reescrita mesmo se já existir.
format	string	Escolhas: - OpenSSH - PEM (default)	O formato da chave pública.
path - required	path		Nome do arquivo no qual a chave pública TLS / SSL gerada será gravada.
privatekey_passphrase	string		A frase secreta da chave privada.
privatekey_path	path		Caminho para a chave privada TLS / SSL a partir da qual gerar a chave pública. É necessário especificar privatekey_path ou privatekey_content, mas não ambos. Se o state estiver present, um deles será necessário.
select_crypto_backend	string	Escolhas: - auto (default) - cryptography - pyopenssl	Determina qual back-end de criptografia usar. A escolha padrão é auto, que tenta usar criptografia, se disponível, e retorna para pyopenssl. Se definido como pyopenssl, tentará usar a biblioteca pyOpenSSL. Se definido como cryptography, tentará usar o biblioteca de criptografia.
state	string	Escolhas: - present (default) - absent	Se a chave pública deve existir ou não, agir se o state for diferente do que é declarado.

Observações

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

# Exemplo: Gere uma chave pública OpenSSL no formato PEM
- openssl_publickey:
    path: /etc/ssl/public/example.com.pem
    privatekey_path: /etc/ssl/private/example.com.pem

# Exemplo: Gere uma chave pública OpenSSL no formato OpenSSH v2
- openssl_publickey:
    path: /etc/ssl/public/example.com.pem
    privatekey_path: /etc/ssl/private/example.com.pem
    format: OpenSSH

# Exemplo: Gere uma chave pública OpenSSL com uma chave privada protegida por senha
- openssl_publickey:
    path: /etc/ssl/public/example.com.pem
    privatekey_path: /etc/ssl/private/example.com.pem
    privatekey_passphrase: example

# Exemplo: Força a reescrita de uma chave pública OpenSSL se ela já existir
- openssl_publickey:
    path: /etc/ssl/public/example.com.pem
    privatekey_path: /etc/ssl/private/example.com.pem
    force: yes

# Exemplo: Remova uma chave pública OpenSSL
- openssl_publickey:
    path: /etc/ssl/public/example.com.pem
    privatekey_path: /etc/ssl/private/example.com.pem
    state: absent

Valores retornados

Chave	Tipo	Retornado quando	Descrição
backup_file	string	Sucesso e backup é "sim"	Nome do arquivo de backup criado.
filename	string	Sucesso	Caminho para o arquivo de chave pública TLS / SSL gerado.
fingerprint	dictionary	Sucesso	A impressão digital da chave pública. A impressão digital será gerada para cada hashlib.algorithms available.
format	string	Sucesso	O formato da chave pública (PEM, OpenSSH, ...).
privatekey	string	Sucesso	Caminho para a chave privada TLS / SSL a partir da qual a chave pública foi gerada. Será nenhum se a chave privada tiver sido fornecida em privatekey_content.
publickey	string	Se o state for "present" e return_content é sim.	O conteúdo da chave pública (atual ou gerada).