trombik.cfssl

Rol de ansible para cfssl. El servidor API (cfssl serve) es compatible.

Para todos los usuarios

Como pocas distribuciones admiten el servidor API en sus paquetes, las variables de rol cfssl_db_* están sujetas a cambios.

Para ejecutar cfssl como servidor, el paquete de tu distribución debe proporcionar un script de inicio y otras modificaciones al paquete. Hasta donde sé, el de Ubuntu no lo hace. Por lo tanto, el soporte para el servidor API no se ha implementado para variantes de Debian.

Requisitos

Ninguno

Variables de Rol

cfssl_certs

Esta es una lista de diccionarios. Un elemento representa un CSR.

Incluir trombik.cfssl

Puedes incluir el rol desde tus tareas o roles. Usa vars para definir variables de rol específicas.

- name: Incluir rol trombik.cfssl
  include_role:
    name: trombik.cfssl
  vars:
    cfssl_extra_packages:
      - zsh

Sin embargo, cuando quieras pasar una única variable que incluya las variables del rol, necesitas pasar tu variable a una variable puente especial, cfssl_vars.

- name: Incluir rol trombik.cfssl
  include_role:
    name: trombik.cfssl
  vars:
    cfssl_vars: "{{ my_variable }}"

El siguiente ejemplo NO funciona:

- name: Incluir rol trombik.cfssl
  include_role:
    name: trombik.cfssl
  vars: "{{ my_variable }}"

Consulta tests/serverspec/intermediate.yml, que incluye el rol múltiples veces para crear CAs intermedias.

Debian

FreeBSD

OpenBSD

Dependencias

Ninguna

Ejemplo de Playbook

Este ejemplo gestiona cfssl y firma algunos certificados.

Para un ejemplo de servidor API, consulta tests/serverspec/api.yml.

Para un ejemplo de múltiples CAs intermedias bajo una CA raíz, consulta tests/serverspec/intermediate.yml.

---
- hosts: localhost
  roles:
    - role: ansible-role-cfssl
  vars:
    # este caso de prueba sigue los mismos pasos descritos en
    # https://docs.sensu.io/sensu-go/latest/guides/generate-certificates/
    cfssl_certs:
      - name: agent1.example.com.json
        # Nombre Alternativo del Sujeto, o SAN en corto
        SAN: []
        profile: agent
        owner: nobody
        json:
          CN: agent1.example.com
          hosts:
            - ""
          key:
            algo: rsa
            size: 2048
      - name: backend-1.example.com.json
        SAN:
          - localhost
          - 127.0.0.1
          - 10.0.0.1
          - backend-1
        profile: backend
        json:
          CN: backend-1.example.com
          hosts:
            - ""
          key:
            algo: rsa
            size: 2048
      - name: backend-2.example.com.json
        SAN:
          - localhost
          - 127.0.0.1
          - 10.0.0.2
          - backend-2
        profile: backend
        json:
          CN: backend-2.example.com
          hosts:
            - ""
          key:
            algo: rsa
            size: 2048
      - name: backend-3.example.com.json
        SAN:
          - localhost
          - 127.0.0.1
          - 10.0.0.3
          - backend-3
        profile: backend
        json:
          CN: backend-3.example.com
          hosts:
            - ""
          key:
            algo: rsa
            size: 2048
    cfssl_ca_config:
      signing:
        default:
          expiry: 17520h
          usages:
            - signing
            - key encipherment
            - client auth
        profiles:
          backend:
            expiry: 4320h
            usages:
              - signing
              - key encipherment
              - server auth
          agent:
            expiry: 4320h
            usages:
              - signing
              - key encipherment
              - client auth

    cfssl_ca_csr_config:
      CN: Sensu Test CA
      key:
        algo: rsa
        size: 2048

Licencia

Copyright (c) 2020 Tomoyuki Sakurai <[email protected]>

Se concede permiso para usar, copiar, modificar y distribuir este software para cualquier propósito, con o sin cuota, siempre que el aviso de copyright anterior y este aviso de permiso aparezcan en todas las copias.

EL SOFTWARE SE PROPORCIONA "TAL CUAL" Y EL AUTOR RENUNCIA A TODAS LAS GARANTÍAS RELATIVAS A ESTE SOFTWARE, INCLUYENDO TODAS LAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD Y ADECUACIÓN. EN NINGÚN CASO EL AUTOR SERÁ RESPONSABLE DE CUALQUIER DAÑO ESPECIAL, DIRECTO, INDIRECTO O CONSECUENTE O CUALQUIER DAÑO RESULTANTE DE LA PÉRDIDA DE USO, DATOS O BENEFICIOS, YA SEA EN UNA ACCIÓN DE CONTRATO, NEGLIGENCIA U OTRA ACCIÓN TORTUOSA, QUE SURJA DE O EN RELACIÓN CON EL USO O EL RENDIMIENTO DE ESTE SOFTWARE.

Información del Autor

Tomoyuki Sakurai y@trombik.org

Este README fue creado por qansible