Модуль purestorage.flasharray.purefa_certs – управление сертификатами SSL FlashArray

Примечание

Этот модуль входит в коллекцию purestorage.flasharray (версия 1.42.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install purestorage.flasharray. Для работы с этим модулем могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: purestorage.flasharray.purefa_certs.

Добавлено в purestorage.flasharray 1.8.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Создание, удаление, импорт и экспорт сертификатов SSL FlashArray

Требования

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

python >= 3.3
purestorage >= 1.19
py-pure-client >= 1.26.0
netaddr
requests
pycountry
urllib3

Параметры

Параметр	Комментарии
api_token string	Токен API FlashArray для пользователя с привилегиями администратора.
certificate string	Обязательный параметр для действия import Действительный подписанный сертификат в формате PEM (кодировка Base64) Включает строки «-----BEGIN CERTIFICATE-----» и «-----END CERTIFICATE-----»
common_name string	Полное доменное имя (FQDN) текущего массива Например, общее имя для https://purearray.example.com — purearray.example.com, а для сертификата с подстановочными знаками — *.example.com Также это может быть IP-адрес управления массивом или его краткое имя. Максимум 64 символа Если значение не указано, по умолчанию используется краткое имя массива
country string	Двухбуквенный код ISO страны, в которой находится ваша организация
days integer	Срок действия создаваемого самоподписанного сертификата в днях Если параметр не указан, срок действия самоподписанного сертификата истекает через 3650 дней. По умолчанию: `3650`
disable_warnings boolean добавлено в purestorage.flasharray 1.29.0	Отключить предупреждения о небезопасном сертификате в журналах отладки Варианты: `false` ← (по умолчанию) `true`
email string	Адрес электронной почты для связи с вашей организацией
export_file string	Имя файла для сохранения запроса на подпись сертификата при `status sign` Имя файла для экспорта текущего сертификата SSL при `status export` Если файл уже существует, он будет перезаписан
fa_url string	IPv4-адрес или имя узла для управления FlashArray.
generate boolean	Создать новый закрытый ключ. Если параметр не выбран, для сертификата будет использоваться существующий ключ Варианты: `false` ← (по умолчанию) `true`
intermeadiate_cert string	Промежуточный сертификат, предоставленный центром сертификации
key string	Если запрос на подпись сертификата (CSR) был создан не на массиве или закрытый ключ изменился после создания запроса, укажите здесь новый закрытый ключ
key_size integer	Размер ключа в битах, если создается новый закрытый ключ Варианты: `1024` `2048` ← (по умолчанию) `4096`
locality string	Полное название города, в котором находится ваша организация
name string	Имя сертификата SSL По умолчанию: `"management"`
org_unit string	Подразделение вашей организации, отвечающее за сертификат
organization string	Полное официальное наименование вашей организации. Название организации не следует сокращать; необходимо указывать суффиксы, например Inc, Corp или LLC.
passphrase string	Парольная фраза, если закрытый ключ зашифрован
province string	Полное название штата или провинции, в которой находится ваша организация
state string	Действие, выполняемое модулем present создаст сертификат SSL или создаст его заново absent удалит существующий сертификат SSL sign сформирует запрос на подпись сертификата (CSR) export экспортирует существующий сертификат SSL import импортирует сертификат, предоставленный центром сертификации. Варианты: `"absent"` `"present"` ← (по умолчанию) `"import"` `"export"` `"sign"`

Примечания

Примечание

Для этого модуля требуются библиотеки Python purestorage и py-pure-client.
Для отдельных модулей могут потребоваться дополнительные библиотеки Python.
Если аргументы fa_url и api_token не передаются непосредственно модулю, необходимо задать переменные среды PUREFA_URL и PUREFA_API.

Примеры

- name: Create SSL certificate foo
  purestorage.flasharray.purefa_certs:
    name: foo
    key_size: 4096
    country: US
    province: FL
    locality: Miami
    organization: "Acme Inc"
    org_unit: "DevOps"
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Delete SSL certificate foo
  purestorage.flasharray.purefa_certs:
    name: foo
    state: absent
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Request CSR
  purestorage.flasharray.purefa_certs:
    state: sign
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Request CSR with updated fields
  purestorage.flasharray.purefa_certs:
    state: sign
    org_unit: Development
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Regenerate key for SSL foo
  purestorage.flasharray.purefa_certs:
    generate: true
    name: foo
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

- name: Import SSL Cert foo and Private Key
  purestorage.flasharray.purefa_certs:
    state: import
    name: foo
    certificate: "{{lookup('file', 'example.crt') }}"
    key: "{{lookup('file', 'example.key') }}"
    passphrase: password
    fa_url: 10.10.10.2
    api_token: e31060a7-21fc-e277-6240-25983c6c4592

Авторы

Команда Ansible Pure Storage (@sdodsley)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/purestorage/flasharray/purefa_certs_module.html