---
title: Informações do Certificado OpenSSL
slug: aiops-documentacao-tecnica/informacoes-do-certificado-openssl
docTags:
createdAt: 2024-07-18T21:07:58.192Z
---
## Resumo
- Este módulo permite consultar informações sobre certificados OpenSSL.
## Parâmetros
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ----------------------- | ---------- | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| content | string | | Conteúdo do certificado X.509 em formato PEM.
Qualquer *caminho* ou *conteúdo* deve ser especificado, mas não ambos. |
| path | path | | Caminho absoluto remoto de onde o arquivo de certificado é carregado.
Qualquer *caminho* ou *conteúdo* deve ser especificado, mas não ambos. |
| select\_crypto\_backend | string | Escolhas:
- auto(default)
- cryptography
- pyopenssl | Determina qual back-end criptográfico usar.
A escolha padrão é `auto`, que tenta usar, `cryptography` se disponível, e retorna a `pyopenssl`. |
| valid\_at | dictionary | | Um ditado de mapeamento de nomes para especificações de tempo. Cada vez aqui especificado será verificado se o certificado é válido neste momento. Veja o `valid_at` valor de retorno para informações sobre o resultado.
O tempo pode ser especificado como tempo relativo ou como carimbo de data / hora absoluto.
A hora sempre será interpretada como UTC.O formato válido é `[+-]timespec \| ASN.1 TIME` onde o timespec pode ser um inteiro + `[w \| d \| h \| m \| s]` (por exemplo `+32w1d2h`, e ASN.1 TIME (em outras palavras, padrão `YYYYMMDDHHMMSSZ`). Observe que todos os carimbos de data / hora serão tratados como sendo UTC. |
## Notas
Observação
- Todos os valores de timestamp são fornecidos no formato ASN.1 TIME, ou seja, seguindo o `YYYYMMDDHHMMSSZ` padrão. Eles estão todos em UTC.
- Suporta check\_mode.
## Exemplos
```yaml
# Generate a Self Signed OpenSSL certificate
openssl_certificate:
path: /etc/ssl/crt/atmosphere.com.crt
privatekey_path: /etc/ssl/private/atmosphere.com.pem
csr_path: /etc/ssl/csr/atmosphere.com.csr
provider: selfsigned
# Get information on the certificate
# Get information on generated certificate
openssl_certificate_info:
path: /etc/ssl/crt/atmosphere.com.crt
register: result
# Dump information
debug:
var: result
# Check whether the certificate is valid or not valid at certain times, fail
# if this is not the case. The first task (openssl_certificate_info) collects
# the information, and the second task (assert) validates the result and
# makes the playbook fail in case something is not as expected.
# Test whether that certificate is valid tomorrow and/or in three weeks
openssl_certificate_info:
path: /etc/ssl/crt/atmosphere.com.crt
valid_at:
point_1: "+1d"
point_2: "+3w"
register: result
# Validate that certificate is valid tomorrow, but not in three weeks
assert:
that:
- result.valid_at.point_1 # valid in one day
- not result.valid_at.point_2 # not valid in three weeks
```
## Valores Retornados
| **Chave** | **Tipo** | **Retornado quando** | `Descrição` | |
| -------------------------------------- | ---------------------- | ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| authority\_cert\_issuer | list / elements=string | sucesso e se o backend pyOpenSSL *não* for usado | O emissor do certificado da autoridade de certificação como uma lista de nomes gerais.
É `none` se a `AuthorityKeyIdentifier` extensão não estiver presente. | |
| authority\_cert\_serial\_number
| integer | sucesso e se o backend pyOpenSSL *não* for usado | O número de série do certificado da autoridade de certificação.
É `none` se a `AuthorityKeyIdentifier` extensão não estiver presente. | |
| authority\_key\_identifier | string | sucesso e se o backend pyOpenSSL *não* for usado | O identificador da chave da autoridade de certificação.
O identificador é retornado em hexadecimal, com `:` usado para separar bytes.
É `none` se a `AuthorityKeyIdentifier` extensão não estiver presente. | |
| basic\_constraints | list / elements=string | sucesso | Entradas na `basic_constraints` extensão ou `none` se a extensão não estiver presente. | |
| basic\_constraints\_critical | boolean | sucesso | Se a `basic_constraints` extensão é crítica.
| |
| expired | boolean | sucesso | Se o certificado expirou (em outras palavras, `notAfter` está no passado).
| |
| extended\_key\_usage | list / elements=string | sucesso | Entradas na `extended_key_usage` extensão ou nonese a extensão não estiver presente. | |
| extended\_key\_usage\_critical | boolean | sucesso | Se a `extended_key_usage` extensão é crítica.
| |
| extensions\_by\_oid | dictionary | sucesso | Retorna um dicionário para cada extensão OID. | |
| fingerprints | dictionary | sucesso | Impressões digitais da forma codificada por DER de todo o certificado.
Para cada algoritmo hash disponível, a impressão digital é calculada. | |
| issuer | dictionary | sucesso | O emissor do certificado.
Observe que para valores repetidos, apenas o último será retornado. | |
| issuer\_ordered | list / elements=list | sucesso | O emissor do certificado como uma lista ordenada de tuplas. | |
| key\_usage | string | sucesso | Entradas na `key_usage` extensão ou nonese a extensão não estiver presente. | |
| key\_usage\_critical | boolean | sucesso | Se a `key_usagee` xtensão é crítica.
| |
| not\_after | string | sucesso | `notAfter` data como ASN.1 TIME. | |
| not\_before | string | sucesso | `notBefore` data como ASN.1 TIME. | |
| ocsp\_must\_staple | boolean | sucesso | `yes` se a extensão OCSP Must Staple estiver presente, `none` caso contrário.
| |
| ocsp\_must\_staple\_critical | boolean | sucesso | Se a `ocsp_must_staple` extensão é crítica.
| |
| ocsp\_uri | string | sucesso | O URI do respondente OCSP, se incluído no certificado. Será `none` se nenhum URI respondente do OCSP for incluído.
| |
| public\_key | string | sucesso | Chave pública do certificado em formato PEM. | |
| public\_key\_fingerprints | dictionary | sucesso | Impressões digitais da chave pública do certificado.
Para cada algoritmo hash disponível, a impressão digital é calculada. | |
| serial\_number | integer | sucesso | O número de série do certificado. | |
| signature\_algorithm | string | sucesso | O algoritmo de assinatura usado para assinar o certificado. | |
| subject | dictionary | sucesso | O assunto do certificado como um dicionário.
Observe que para valores repetidos, apenas o último será retornado. | |
| subject\_alt\_name | list / elements=string | sucesso | Entradas na `subject_alt_name` extensão ou nonese a extensão não estiver presente. | |
| subject\_alt\_name\_critical | boolean | sucesso | Se a `subject_alt_name` extensão é crítica.
| |
| subject\_key\_identifier | string | sucesso e se o backend pyOpenSSL *não* for usado | O identificador da chave do assunto do certificado.
O identificador é retornado em hexadecimal, com `:` usado para separar bytes.
É `none` se a `SubjectKeyIdentifier` extensão não estiver presente. | |
| subject\_ordered | list / elements=list | sucesso | O assunto do certificado como uma lista ordenada de tuplas. | |
| valid\_at | dictionary | sucesso | Para cada carimbo de data / hora fornecido na opção *valid\_at* , um booleano se o certificado é válido naquele momento ou não.
| |
| version | integer | sucesso | A versão do certificado. | |
### Subopções da chave de retorno extensions\_by\_oid
| **Chave** | **Tipo** | **Retornado quando** | **Descrição** |
| --------- | -------- | -------------------- | ---------------------------------------------------------- |
| critical | boolean | sucesso | Se a extensão é crítica. |
| value | string | sucesso | O valor codificado em Base64 (no formato DER) da extensão. |