---
title: OpenSSL CSR Info
slug: aiops-documentacao-tecnica/openssl-csr-info
docTags:
createdAt: 2024-07-18T21:09:19.994Z
---
## Resumo
- Fornece informações de solicitações de assinatura de certificado OpenSSL (CSR).
## Parâmetros
| **Parâmetro** | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários** |
| ------------------------ | -------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| path - *required* | path | | Caminho absoluto remoto de onde o arquivo CSR é 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 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. |
## 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 uma solicitação de assinatura de certificado OpenSSL
- openssl_csr:
path: /etc/ssl/csr/www.exemplo.com.csr
privatekey_path: /etc/ssl/private/exemplo.com.pem
common_name: www.exemplo.com
# Exemplo: Obtenha informações sobre o CSR
- openssl_csr_info:
path: /etc/ssl/csr/www.exemplo.com.csr
register: result
# Exemplo: Retornar informações
- debug:
var: result
```
## Valores retornados
| **Chave** | **Tipo** | **Retornado quando** | **Descrição** |
| -------------------------------------------- | ---------------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| signature\_valid | boolean | Sucesso | Se a assinatura do CSR é válida. Caso a verificação retorne (false), o módulo irá falhar. |
| basic\_constraints | list / elements=string | Sucesso | Entradas na extensão (basic\_constraints) ou (nenhuma) se a extensão não estiver presente. |
| basic\_constraints\_critical | boolean | Sucesso | Se a extensão (basic\_constraints) é crítica. |
| extended\_key\_usage | list / elements=string | Sucesso | Entradas na extensão (extended\_key\_usage) ou (none) se a extensão não estiver presente. |
| extended\_key\_usage\_critical | boolean | Sucesso | Se a extensão (extended\_key\_usage) é crítica. |
| extensions\_by\_oid
(Possíveis valores) | dictionary | Sucesso | Retorna um dicionário para cada extensão OID |
| key\_usage | string | Sucesso | Entradas na extensão (key\_usage) ou (none) se a extensão não estiver presente. |
| key\_usage\_critical | boolean | Sucesso | Se a extensão (key\_usage) é crítica. |
| subject\_alt\_name | list / elements=string | Sucesso | Entradas na extensão (subject\_alt\_name) ou (none) se a extensão não estiver presente. |
| subject\_alt\_name\_critical | boolean | Sucesso | Se a extensão (subject\_alt\_name) é crítica. |
| ocsp\_must\_staple | boolean | Sucesso | (true) se a extensão OCSP deve grampear estiver presente, (none) caso contrário. |
| ocsp\_must\_staple\_critical | boolean | Sucesso | Se a extensão (ocsp\_must\_staple) é crítica. |
| subject | dictionary | Sucesso | O assunto do CSR como um dicionário. Observe que para valores repetidos, apenas o último será retornado. |
| subject\_ordered | list / elements=list | Sucesso | O assunto do CSR como uma lista ordenada de tuplas. |
| public\_key | string | Sucesso | Chave pública do CSR no formato PEM. |
| public\_key\_fingerprints | dictionary | Sucesso | Impressões digitais da chave pública do CSR. Para cada algoritmo hash disponível, a impressão digital é calculada. |
| subject\_key\_identifier | string | Sucesso e se o backend pyOpenSSL não é usado | O identificador de chave do assunto do CSR. O identificador é retornado em hexadecimal, com (:) usado para separar bytes. É (none) se a extensão (SubjectKeyIdentifier) não estiver presente. |
| authority\_key\_identifier | string | Sucesso e se o backend pyOpenSSL não é usado | O identificador da chave de autoridade do CSR. O identificador é retornado em hexadecimal, com (:) usado para separar bytes. É (none) se a extensão (AuthorityKeyIdentifier) não estiver presente. |
| authority\_cert\_issuer | list / elements=string | Sucesso e se o backend pyOpenSSL não é usado | O emissor do certificado de autoridade do CSR como uma lista de nomes gerais. É (none) se a extensão (AuthorityKeyIdentifier) não estiver presente. |
| authority\_cert\_serial\_number | integer | Sucesso e se o backend pyOpenSSL não é usado | O número de série do certificado de autoridade do CSR. É (none) se a extensão (AuthorityKeyIdentifier) não estiver presente. |
## 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. |