win_credential – Управление учетными данными Windows в диспетчере учетных данных

Новое в версии 2.8.

Обзор
Параметры
Примечания
См. также
Примеры
Статус

Обзор

Используется для создания и удаления учетных данных Windows в диспетчере учетных данных.
Этот модуль может управлять как стандартными учетными данными (имя пользователя/пароль), так и учетными данными сертификатов.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
alias строка			Добавляет псевдоним для учетной записи. Обычно это имя NetBIOS хоста, если name задано в формате DNS.
attributes -			Список словарей, задающих атрибуты, специфичные для приложения, для учетной записи. При установке существующие атрибуты сравниваются с полным списком; любые различия означают, что все атрибуты будут заменены.
	data строка		Значение атрибута.
	data_format строка	Варианты: base64 text ←	Управляет типом ввода для data. Если `text`, data — текстовая строка, закодированная в UTF-16LE в байты. Если `base64`, data — строка base64, декодированная в байты из base64.
	name строка / обязательно		Ключ атрибута. Это не уникальный идентификатор, так как несколько атрибутов могут иметь один и тот же ключ.
comment строка			Пользовательский комментарий к учетной записи.
name строка / обязательно			Целевой объект, идентифицирующий сервер или серверы, для которых должна быть использована учетная запись. Если значение может быть именем NetBIOS, именем DNS-сервера, префиксом имени DNS-хоста с символом подстановки (``), именем NetBIOS или именем DNS-домена, содержащим последовательность символов подстановки, или звездочкой. См. `TargetName` в https://docs.microsoft.com/en-us/windows/desktop/api/wincred/ns-wincred-_credentiala для получения более подробной информации о том, чем может быть это значение. Используется вместе с type* для создания уникальной учетной записи.
persistence строка		Варианты: enterprise local ←	Определяет сохранение учетной записи. Если `local`, учетная запись будет сохраняться для всех входов того же пользователя на том же хосте. `enterprise` — то же самое, что и `local`, но учетная запись будет видна тому же пользователю домена при запуске на других хостах, а не только на localhost.
secret строка			Секрет учетной записи. Если опущено, то для учетной записи не используется секрет при создании новой учетной записи. Если type — тип пароля, это пароль для username. Если type — тип сертификата, это пин-код для сертификата.
secret_format строка		Варианты: base64 text ←	Управляет типом ввода для secret. Если `text`, secret — текстовая строка, закодированная в UTF-16LE в байты. Если `base64`, secret — строка base64, декодированная в байты из base64.
state строка		Варианты: absent present ←	При `absent`, учетная запись, заданная name и type, удаляется. При `present`, учетная запись, заданная name и type, удаляется.
type строка / обязательно		Варианты: domain_certificate domain_password generic_certificate generic_password	Тип учетной записи для хранения. Используется вместе с name для создания уникальной учетной записи. Когда тип — тип `domain`, учетная запись используется пакетами аутентификации Microsoft, такими как Negotiate. Когда тип — тип `generic`, учетная запись не используется ни одним конкретным пакетом аутентификации. Рекомендуется использовать тип `domain`, так как только поставщики аутентификации могут получить доступ к секрету.
update_secret строка		Варианты: always ← on_create	При `always`, секрет всегда будет обновляться, если они отличаются. При `on_create`, секрет будет проверяться/обновляться только при первом создании. Если секрет не может быть извлечен, а это значение установлено в `always`, модуль всегда приведет к изменению.
username строка			Если type — тип пароля, то это имя пользователя для хранения учетной записи. Если type — тип учетной записи, то это отпечаток (thumbprint) сертификата в виде шестнадцатеричной строки. При `type=domain_password`, это должно быть в формате Netlogon (DOMAIN\Username) или UPN (username@DOMAIN). Если используется отпечаток сертификата, сертификат должен существовать в хранилище сертификатов `CurrentUser\My` для выполняющего пользователя.

Примечания

Примечание

Для работы с этим модулем требуется запуск с become для доступа к хранилищу учетных данных пользователя.
Может быть только одна учетная запись на хост и тип. Если вторая учетная запись определяется с использованием того же хоста и типа, то исходная учетная запись перезаписывается.

См. также

win_user_right – Управление правами пользователя Windows: Официальная документация модуля win_user_right.
win_whoami – Получение информации о текущем пользователе и процессе: Официальная документация модуля win_whoami.

Примеры

- name: Create a local only credential
  win_credential:
    name: server.domain.com
    type: domain_password
    username: DOMAIN\username
    secret: Password01
    state: present

- name: Remove a credential
  win_credential:
    name: server.domain.com
    type: domain_password
    state: absent

- name: Create a credential with full values
  win_credential:
    name: server.domain.com
    type: domain_password
    alias: server
    username: username@DOMAIN.COM
    secret: Password01
    comment: Credential for server.domain.com
    persistence: enterprise
    attributes:
    - name: Source
      data: Ansible
    - name: Unique Identifier
      data: Y3VzdG9tIGF0dHJpYnV0ZQ==
      data_format: base64

- name: Create a certificate credential
  win_credential:
    name: '*.domain.com'
    type: domain_certificate
    username: 0074CC4F200D27DC3877C24A92BA8EA21E6C7AF4
    state: present

- name: Create a generic credential
  win_credential:
    name: smbhost
    type: generic_password
    username: smbuser
    password: smbuser
    state: present

- name: Remove a generic credential
  win_credential:
    name: smbhost
    type: generic_password
    state: absent

Статус

Интерфейс этого модуля не гарантируется обратной совместимостью. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Jordan Borean (@jborean93)

Подсказка

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

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