trombik.cfssl

cfssl のための ansible ロールです。API サーバー（cfssl serve）がサポートされています。

すべてのユーザーへ

多くのディストリビューションがパッケージの中で API サーバーをサポートしていないため、cfssl_db_* のロール変数は変更される可能性があります。

cfssl をサーバーとして実行するには、ディストリビューションのパッケージが起動スクリプトや他の変更を提供する必要があります。私の知る限り、Ubuntu のものは提供していません。したがって、Debian 系では API サーバーのサポートは実装されていません。

要件

なし

ロール変数

cfssl_certs

これは辞書のリストです。要素は CSR を表します。

trombik.cfssl の含め方

タスクやロールからこのロールを含めることができます。vars を使用して、特定のロール変数を定義します。

- name: ロール trombik.cfssl を含める
  include_role:
    name: trombik.cfssl
  vars:
    cfssl_extra_packages:
      - zsh

ただし、ロール変数を含む単一の変数を渡したい場合は、特別な橋渡しロール変数 cfssl_vars にあなたの変数を渡す必要があります。

- name: ロール trombik.cfssl を含める
  include_role:
    name: trombik.cfssl
  vars:
    cfssl_vars: "{{ my_variable }}"

次の例は動作しません：

- name: ロール trombik.cfssl を含める
  include_role:
    name: trombik.cfssl
  vars: "{{ my_variable }}"

中間 CA を作成するためにロールを複数回含める tests/serverspec/intermediate.yml を参照してください。

Debian

FreeBSD

OpenBSD

依存関係

なし

例プレイブック

この例では cfssl を管理し、いくつかの証明書に署名します。

API サーバーの例は tests/serverspec/api.yml を参照してください。

ルート CA の下に複数の中間 CA を持つ例は tests/serverspec/intermediate.yml を参照してください。

---
- hosts: localhost
  roles:
    - role: ansible-role-cfssl
  vars:
    # このテストケースは
    # https://docs.sensu.io/sensu-go/latest/guides/generate-certificates/ に記載されている手順に従います。
    cfssl_certs:
      - name: agent1.example.com.json
        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

ライセンス

Copyright (c) 2020 Tomoyuki Sakurai <y@trombik.org>

このソフトウェアを、料金の有無にかかわらず、使用、複製、変更、配布する許可がここに与えられます。
上記の著作権表示とこの許可表示はすべてのコピーに表示されなければなりません。

このソフトウェアは「現状のまま」提供され、著作者はこのソフトウェアに関して、すべての保証を放棄します。
著作者は商業性や適合性を含むすべての暗黙の保証に対して責任を負いません。
著作者は、このソフトウェアの使用または性能に起因する特別、直接、間接、または結果的な損害やデータ、利益の損失に対して責任を負いません。

著者情報

Tomoyuki Sakurai y@trombik.org

この README は qansible によって作成されました。