community.general.credstash – извлечение секретов из Credstash на AWS

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general.

Для использования в книге задач укажите: community.general.credstash.

Описание
Требования
Параметры
Примеры
Возвращаемые значения

Описание

Credstash — небольшая утилита для управления секретами с использованием KMS и DynamoDB AWS: https://github.com/fugue/credstash

Требования

Ниже перечислены требования к локальному контрольному узлу, на котором выполняется этот поиск.

credstash (библиотека python)

Параметры

Параметр	Варианты/Значения по умолчанию	Конфигурация	Комментарии
_terms список / элементы=строка / обязательно			имя термина или список терминов для поиска в хранилище данных
aws_access_key_id строка		env:AWS_ACCESS_KEY_ID	Идентификатор ключа доступа AWS
aws_secret_access_key строка		env:AWS_SECRET_ACCESS_KEY	Ключ доступа AWS
aws_session_token строка		env:AWS_SESSION_TOKEN	Токен сеанса AWS
profile_name строка		env:AWS_PROFILE	Профиль AWS для аутентификации
region строка			Регион AWS
table строка / обязательно	По умолчанию: "credential-store"		Имя таблицы credstash для запроса
version строка			Версия Credstash

Примеры

- name: first use credstash to store your secrets
  ansible.builtin.shell: credstash put my-github-password secure123

- name: "Test credstash lookup plugin -- get my github password"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'my-github-password') }}"

- name: "Test credstash lookup plugin -- get my other password from us-west-1"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'my-other-password', region='us-west-1') }}"

- name: "Test credstash lookup plugin -- get the company's github password"
  ansible.builtin.debug:
    msg: "Credstash lookup! {{ lookup('community.general.credstash', 'company-github-password', table='company-passwords') }}"

- name: Example play using the 'context' feature
  hosts: localhost
  vars:
    context:
      app: my_app
      environment: production
  tasks:

  - name: "Test credstash lookup plugin -- get the password with a context passed as a variable"
    ansible.builtin.debug:
      msg: "{{ lookup('community.general.credstash', 'some-password', context=context) }}"

  - name: "Test credstash lookup plugin -- get the password with a context defined here"
    ansible.builtin.debug:
      msg: "{{ lookup('community.general.credstash', 'some-password', context=dict(app='my_app', environment='production')) }}"

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие — поля, уникальные для этого поиска:

Ключ	Возвращаемое значение	Описание
_raw строка	успех	Значение(я), хранящееся(ие) в Credstash.

Авторы

Неизвестно (!UNKNOWN)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/credstash_lookup.html