Модуль netapp.ontap.na_ontap_security_certificates — управление сертификатами безопасности NetApp ONTAP.

algorithm

string

добавлено в netapp.ontap 23.5.0

Алгоритм асимметричного шифрования.

Варианты:

• "rsa" ← (по умолчанию)
• "ec"

cert_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу сертификата SSL-клиента (.pem).

Не поддерживается в Python 2.6.

common_name

string

Общее имя сертификата.

Обязателен для создания и установки.

Если указан параметр name, при подписании и удалении игнорируется.

Если параметр name отсутствует или игнорируется, он обязателен для подписания и удаления.

expiry_time

string

Время истечения срока действия сертификата. При создании сертификата рекомендуется указывать время истечения срока действия.

Можно указать при подписании сертификата.

extended_key_usages

list / элементы=string

добавлено в netapp.ontap 23.5.0

Список расширений для использования ключа.

Варианты:

• "serverauth"
• "clientauth"
• "timestamping"
• "dvcs"
• "ocspsigning"
• "codesigning"
• "emailprotection"
• "anyextendedkeyusage"
• "critical"

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включение или отключение новой функции.

Можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

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

force_ontap_version

string

добавлено в netapp.ontap 21.23.0

Переопределяет версию ONTAP кластера при использовании REST.

Поведение не определено, если указанная версия не соответствует целевому кластеру.

Этот параметр предназначен для обхода проблемы, возникающей, когда из-за проблем с разрешениями не удается прочитать версию кластера. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues.

Значение должно иметь формат 9.10 или 9.10.1, причем каждый компонент должен быть целым числом.

Если для use_rest установлено значение auto, в зависимости от версии и возможностей платформы может быть принудительно выбран ZAPI.

Игнорируется при использовании ZAPI.

generate_csr

boolean

добавлено в netapp.ontap 23.5.0

Создать запрос на подписание сертификата (CSR) вместо создания или установки сертификата.

Если значение равно true, CSR создается на основе указанных параметров и возвращается в выходных данных.

Варианты:

• false ← (по умолчанию)
• true

hash_function

string

Хеш-функция. Можно указать при создании самоподписанного сертификата, подписании сертификата или создании запроса на подписание сертификата.

Допустимые значения: sha1, sha224, sha256, sha384 и sha512.

Варианты:

• "sha1"
• "sha224"
• "sha256" ← (по умолчанию)
• "sha384"
• "sha512"

hostname

string / обязательный

Имя узла или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределяет порт по умолчанию (80 или 443).

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, так как поддерживается только HTTPS.

Игнорируется при использовании аутентификации с помощью сертификата SSL, поскольку для нее требуется SSL.

Варианты:

• false ← (по умолчанию)
• true

ignore_name_if_not_supported

boolean

добавлено в netapp.ontap 20.8.0

REST API в ONTAP 9.6 и 9.7 не поддерживает параметр name.

Если задано значение true, при наличии параметра name ошибка не возникает, а сам параметр name не используется.

Варианты:

• false
• true ← (по умолчанию)

intermediate_certificates

list / элементы=string

Цепочка промежуточных сертификатов в формате PEM.

Допустимо только при установке сертификата.

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа SSL-клиента.

key_size

integer

Размер ключа сертификата в битах. При создании сертификата рекомендуется указывать надежный размер ключа.

Игнорируется при подписании и удалении.

key_usages

list / элементы=string

добавлено в netapp.ontap 23.5.0

Список расширений для использования ключа.

Варианты:

• "digitalsignature"
• "nonrepudiation"
• "keyencipherment"
• "dataencipherment"
• "keyagreement"
• "keycertsign"
• "crlsign"
• "encipheronly"
• "decipheronly"
• "critical"

name

string

Уникальное имя сертификата безопасности в пределах SVM.

Этот параметр не поддерживается в ONTAP 9.6 и 9.7, поскольку REST API его не поддерживает.

Если параметр указан для ONTAP 9.6 или 9.7, по умолчанию он игнорируется; см. ignore_name_if_not_supported.

Для более новых выпусков ONTAP настоятельно рекомендуется использовать параметр name.

ontapi

integer

Версия API ONTAP, которую следует использовать.

password

псевдонимы: pass

string

Пароль указанного пользователя.

private_key

string

Сертификат с закрытым ключом в формате PEM.

Обязателен при установке сертификата, подписанного центром сертификации. В остальных случаях игнорируется.

public_certificate

string

Сертификат с открытым ключом в формате PEM.

Обязателен при установке сертификата. В остальных случаях игнорируется.

security_strength

integer

добавлено в netapp.ontap 23.5.0

Криптостойкость сертификата в битах.

Варианты:

• 112 ← (по умолчанию)
• 128
• 192

signing_request

string

Если параметр указан, для подписания запроса используется сертификат, определяемый параметрами name и svm.

Возвращается подписанный сертификат.

state

string

Указывает, должен ли указанный сертификат безопасности существовать.

Варианты:

• "present" ← (по умолчанию)
• "absent"

subject_alternatives

dictionary

добавлено в netapp.ontap 23.5.0

Альтернативные имена субъекта сертификата.

dns

list / элементы=string

Список альтернативных DNS-имен субъекта.

email

list / элементы=string

Список альтернативных адресов электронной почты субъекта.

ip

list / элементы=string

Список альтернативных IP-адресов субъекта.

uri

list / элементы=string

Список альтернативных URI субъекта.

subject_name

string

добавлено в netapp.ontap 23.5.0

Сведения об имени субъекта сертификата. Формат — список пар «ключ=значение», разделенных запятыми.

svm

псевдонимы: vserver

string

Имя SVM (vserver).

Если параметр указан, сертификат устанавливается в SVM.

Если параметр не указан, сертификат устанавливается в кластере.

type

string

Тип сертификата.

Обязателен для создания и установки.

Если указан параметр name, при подписании и удалении игнорируется.

Если параметр name отсутствует или игнорируется, он обязателен для подписания и удаления.

Варианты:

• "client"
• "server"
• "client_ca"
• "server_ca"
• "root_ca"

use_lambda

boolean

добавлено в netapp.ontap 23.2.0

Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP.

Поддерживается только с REST.

Варианты:

• false ← (по умолчанию)
• true

use_rest

string

Указывает, следует ли использовать REST или ZAPI.

always — всегда использовать REST API, если модуль его поддерживает. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, выдается ошибка.

never — всегда использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI.

auto — попытаться использовать REST API, если модуль его поддерживает и параметры модуля совместимы с ним. В противном случае выполняется переход на ZAPI.

По умолчанию: "always"

username

псевдонимы: user

string

Учетная запись может быть на уровне кластера или SVM — в зависимости от того, требуется API уровня кластера или уровня SVM.

Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

Поддерживаются два метода аутентификации:

1. Базовая аутентификация с использованием имени пользователя и пароля.
2. Аутентификация с помощью сертификата SSL с использованием файла сертификата SSL-клиента и, при необходимости, файла закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.

validate_certs

boolean

Если задано значение no, SSL-сертификаты не проверяются.

Устанавливайте это значение только для False на сайтах, контролируемых лично вами и использующих самоподписанные сертификаты.

Варианты:

• false
• true ← (по умолчанию)

ontap_info

dictionary

При подписании возвращает public_certificate; при создании, установке и удалении возвращает пустое значение.

Возвращается: всегда

Пример: {"ontap_info": {"public_certificate": "-----BEGIN CERTIFICATE----- ........-----END CERTIFICATE----- "}}