Модуль community.postgresql.postgresql_user – Создание, изменение или удаление пользователя (роли) из экземпляра сервера PostgreSQL

ca_cert

aliases: ssl_rootcert

string

Указывает имя файла, содержащего сертификат(ы) центра сертификации (CA).

Если файл существует, проверяет, что сертификат сервера подписан одним из этих центров.

comment

string

added in community.postgresql 0.2.0

Добавляет комментарий к пользователю (эквивалентно оператору COMMENT ON ROLE).

Чтобы сбросить комментарий, передайте пустую строку.

configuration

dictionary

added in community.postgresql 3.5.0

Параметры конфигурации, специфичные для роли, которые в противном случае устанавливаются с помощью ALTER ROLE user SET variable TO value;.

Принимает словарь, где ключ — это имя параметра конфигурации. Если ключ содержит специальные символы, такие как . и -, его необходимо заключить в кавычки, чтобы YAML был валидным.

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

Удаляет любой параметр из пользователя, который не указан здесь.

Параметры, присутствующие в базе данных, но не включенные в этот список, будут только сброшены, если reset_unspecified_configuration=true.

Входы в user, а также ключи и значения в этом параметре заключаются в кавычки модулем. Если вам необходимо, чтобы пользователь содержал ", вам нужно удвоить его, иначе модуль выдаст ошибку. " и ' не допускаются в ключах конфигурации, и любые ' в значении конфигурации будут экранированы этим модулем. Кроме того, параметры и значения проверяются, если trust_input является false.

Default: {}

conn_limit

integer

Указывает лимит подключений пользователя (роли).

connect_params

dictionary

added in community.postgresql 2.3.0

Любые дополнительные параметры, которые необходимо передать в libpg.

Эти параметры имеют приоритет.

Default: {}

db

aliases: login_db

string

Имя базы данных для подключения и где предоставляются права пользователя.

Default: ""

encrypted

boolean

Хранится ли пароль в базе данных в хешированном виде.

Вы можете указать нехешированный пароль, и PostgreSQL гарантирует, что хранимый пароль будет хеширован, когда установлен параметр encrypted=true. Если вы указываете хешированный пароль, модуль использует его как есть, независимо от настройки encrypted.

Примечание: Postgresql 10 и новее не поддерживают нехешированные пароли.

До Ansible 2.6 это было false по умолчанию.

Choices:

• false
• true ← (default)

expires

string

Дата истечения срока действия пароля пользователя.

Если установлено значение 'infinity', пароль пользователя никогда не истекает.

Обратите внимание, что это значение должно быть допустимым типом даты и времени SQL.

fail_on_user

aliases: fail_on_role

boolean

Если true, происходит сбой, когда пользователя (роль) невозможно удалить. В противном случае просто регистрирует и продолжает.

Choices:

• false
• true ← (default)

login_host

aliases: host

string

Хост, на котором работает база данных.

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

Default: ""

login_password

string

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

Default: ""

login_unix_socket

aliases: unix_socket

string

Путь к сокету домена Unix для локальных подключений.

Default: ""

login_user

aliases: login

string

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

Default: "postgres"

name

aliases: user

string / required

Имя пользователя (роли) для добавления или удаления.

no_password_changes

boolean

Если true, не проверяет базу данных на наличие изменений пароля. Если пользователь уже существует, пропускает все проверки, связанные с паролем. Полезно, когда pg_authid недоступен (например, в AWS RDS). В противном случае, вносит необходимые изменения пароля.

Варианты:

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

password

string

Устанавливает пароль пользователя, до версии 1.4 это было обязательным.

Пароль может быть передан незахешированным или захешированным (MD5-хеш).

Незахешированный пароль автоматически хешируется при сохранении в базу данных, если установлен флаг encrypted, в противном случае он сохраняется в виде обычного текста.

При передаче MD5-хешированного пароля, необходимо сгенерировать его в формате 'str["md5"] + md5[ password + username ]', что в итоге даст 35 символов. Простой способ сделать это — echo "md5`echo -n 'verysecretpasswordJOE' | md5sum | awk '{print $1}'`".

Обратите внимание, что если предоставленная строка пароля уже находится в MD5-хешированном формате, то она используется как есть, независимо от параметра encrypted.

port

алиасы: login_port

integer

Порт базы данных для подключения.

Значение по умолчанию: 5432

priv

string

Этот параметр был устарел и будет удален в community.postgresql 4.0.0. Пожалуйста, используйте модуль community.postgresql.postgresql_privs для предоставления/отзыва прав вместо этого.

Разделенная слешами строка привилегий PostgreSQL: priv1/priv2, где можно определить привилегии пользователя для базы данных (допустимые параметры — ‘CREATE’, ‘CONNECT’, ‘TEMPORARY’, ‘TEMP’, ‘ALL’. Например, CONNECT ) или для таблицы (допустимые параметры — ‘SELECT’, ‘INSERT’, ‘UPDATE’, ‘DELETE’, ‘TRUNCATE’, ‘REFERENCES’, ‘TRIGGER’, ‘ALL’. Например, table:SELECT ). Смешанный пример этой строки: CONNECT/CREATE/table1:SELECT/table2:INSERT.

Когда priv содержит таблицы, модуль использует схему public по умолчанию. Если необходимо указать другую схему, используйте обозначение schema_name.table_name, например, pg_catalog.pg_stat_database:SELECT.

reset_unspecified_configuration

boolean

добавлено в community.postgresql 3.5.0

Если установлено значение true, параметры конфигурации пользователя по умолчанию будут сброшены, если они не включены в configuration, в противном случае существующие параметры не будут изменены, если они не включены в configuration.

Варианты:

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

role_attr_flags

string

Строка атрибутов пользователя PostgreSQL в формате: CREATEDB,CREATEROLE,SUPERUSER.

Обратите внимание, что ‘[NO]CREATEUSER’ устарел.

Для создания простой роли для использования её как группы, используйте флаг NOLOGIN.

Полный список поддерживаемых флагов см. в документации к вашей версии PostgreSQL.

Значение по умолчанию: ""

session_role

string

Переключиться на роль сессии после подключения.

Указанная роль сессии должна быть ролью, членом которой является текущий login_user.

Проверка прав для SQL-команд выполняется так, как будто роль сессии была той, которая вошла в систему изначально.

ssl_cert

path

добавлено в community.postgresql 2.4.0

Указывает имя файла клиентского SSL-сертификата.

ssl_key

path

добавлено в community.postgresql 2.4.0

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

ssl_mode

string

Определяет, как ведется согласование сеанса SSL с сервером.

См. https://www.postgresql.org/docs/current/static/libpq-ssl.html для получения дополнительной информации о режимах.

Значение по умолчанию prefer соответствует значению по умолчанию libpq.

Варианты:

• "allow"
• "disable"
• "prefer" ← (по умолчанию)
• "require"
• "verify-ca"
• "verify-full"

state

string

Состояние пользователя (роли).

Варианты:

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

trust_input

boolean

добавлено в community.postgresql 0.2.0

Если false, проверяет, являются ли значения параметров name, password, privs, expires, role_attr_flags, comment, session_role потенциально опасными.

Использование false целесообразно только тогда, когда возможны SQL-инъекции через параметры.

Варианты:

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