community.general.keyring – grab secrets from the OS keyring

• Synopsis
• Requirements
• Examples
• Return Values

Synopsis

• Allows you to access data stored in the OS provided keyring/keychain.

Requirements

The below requirements are needed on the local controller node that executes this lookup.

• keyring (python library)

Examples

- name : output secrets to screen (BAD IDEA)
  ansible.builtin.debug:
    msg: "Password: {{item}}"
  with_community.general.keyring:
    - 'servicename username'

- name: access mysql with password from keyring
  mysql_db: login_password={{lookup('community.general.keyring','mysql joe')}} login_user=joe

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Key	Returned	Description
_raw list / elements=string	success	Secrets stored.

Authors

• Samuel Boucher (!UNKNOWN) <boucher.samuel.c@gmail.com>