iam_cert - Управление сертификатами сервера для использования на ELB и CloudFront

Новая версия 2.0.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
- Автор

Обзор

Позволяет управлять сертификатами сервера

Требования

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

boto
python >= 2.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
aws_access_key	Значение по умолчанию: None	Ключ доступа AWS. Если не задан, используется значение переменной окружения AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY или EC2_ACCESS_KEY. псевдонимы: ec2_access_key, access_key
aws_secret_key	Значение по умолчанию: None	Секретный ключ AWS. Если не задан, используется значение переменной окружения AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY или EC2_SECRET_KEY. псевдонимы: ec2_secret_key, secret_key
cert		Путь к телу сертификата или его содержимое в формате PEM. С версии 2.4 поддерживается ввод содержимого. Если параметр не является файлом, предполагается, что это содержимое.
cert_chain		Путь к цепочке сертификатов CA или ее содержимое в формате PEM. С версии 2.4 поддерживается ввод содержимого. Если параметр не является файлом, предполагается, что это содержимое.
dup_ok	Значение по умолчанию: no	По умолчанию модуль не загружает сертификат, который уже загружен в AWS. Если задано значение True, сертификат будет загружен, если имя уникально.
ec2_url	Значение по умолчанию: None	URL для подключения к EC2 или вашему облаку Eucalyptus (по умолчанию модуль использует конечные точки EC2). Игнорируется для модулей, где требуется регион. Должен быть указан для всех остальных модулей, если регион не используется. Если не задан, используется значение переменной окружения EC2_URL, если таковое есть.
key		Путь к закрытому ключу или его содержимое в формате PEM. С версии 2.4 поддерживается ввод содержимого. Если параметр не является файлом, предполагается, что это содержимое.
name обязательно		Имя сертификата для добавления, обновления или удаления.
new_name		При наличии параметра state, это обновит имя сертификата. Параметры cert, key и cert_chain будут проигнорированы, если задано это значение.
new_path		При наличии параметра state, это обновит путь сертификата. Параметры cert, key и cert_chain будут проигнорированы, если задано это значение.
path	Значение по умолчанию: /	При создании или обновлении укажите желаемый путь к сертификату.
profile (добавлен в 1.6)	Значение по умолчанию: None	Использует профиль boto. Работает только с boto >= 2.24.0.
region		AWS регион для использования. Если не указан, используется значение переменной окружения AWS_REGION или EC2_REGION, если таковое есть. См. http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region псевдонимы: aws_region, ec2_region
security_token (добавлен в 1.6)	Значение по умолчанию: None	AWS STS security token. Если не задан, используется значение переменной окружения AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN. псевдонимы: access_token
state обязательно	Варианты: present absent	Создать (или обновить) или удалить сертификат. Если new_path или new_name заданы, задание present будет пытаться произвести обновление.
validate_certs (добавлен в 1.5)	Варианты: no yes ←	При установке в "no", SSL сертификаты не будут проверены для boto версий >= 2.6.0.

Примечания

Примечание

Если параметры не заданы в модуле, следующие переменные окружения могут быть использованы в порядке убывания приоритета AWS_URL или EC2_URL, AWS_ACCESS_KEY_ID или AWS_ACCESS_KEY или EC2_ACCESS_KEY, AWS_SECRET_ACCESS_KEY или AWS_SECRET_KEY или EC2_SECRET_KEY, AWS_SECURITY_TOKEN или EC2_SECURITY_TOKEN, AWS_REGION или EC2_REGION
Ansible использует конфигурационный файл boto (обычно ~/.boto), если учетные данные не предоставлены. См. http://boto.readthedocs.org/en/latest/boto_config_tut.html
AWS_REGION или EC2_REGION могут использоваться для указания AWS региона, когда это необходимо, но это также может быть настроено в конфигурационном файле boto

Примеры

# Basic server certificate upload from local file
- iam_cert:
    name: very_ssl
    state: present
    cert: "{{ lookup('file', 'path/to/cert') }}"
    key: "{{ lookup('file', 'path/to/key') }}"
    cert_chain: "{{ lookup('file', 'path/to/certchain') }}"

# Basic server certificate upload
- iam_cert:
    name: very_ssl
    state: present
    cert: path/to/cert
    key: path/to/key
    cert_chain: path/to/certchain

# Server certificate upload using key string
- iam_cert:
    name: very_ssl
    state: present
    path: "/a/cert/path/"
    cert: body_of_somecert
    key: vault_body_of_privcertkey
    cert_chain: body_of_myverytrustedchain

# Basic rename of existing certificate
- iam_cert:
    name: very_ssl
    new_name: new_very_ssl
    state: present

Статус

Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.

Автор

Jonathan I. Davila

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/iam_cert_module.html