iosxr_user - Manage the aggregate of local users on Cisco IOS XR device

• Synopsis
  • Requirements
• Parameters
• Notes
• Examples
• Return Values
• Status
  • Support
  • Author

Synopsis

• This module provides declarative management of the local usernames configured on network devices. It allows playbooks to manage either individual usernames or the aggregate of usernames in the current running config. It also supports purging usernames from the configuration that are not explicitly defined.

Requirements

The below requirements are needed on the host that executes this module.

• base64 when using public_key_contents or public_key
• lxml >= 4.1.1 when using netconf
• ncclient >= 0.5.3 when using netconf
• paramiko when using public_key_contents or public_key

Parameters

Notes

Examples

- name: create a new user
  iosxr_user:
    name: ansible
    configured_password: mypassword
    state: present
- name: remove all users except admin
  iosxr_user:
    purge: True
- name: set multiple users to group sys-admin
  iosxr_user:
    aggregate:
      - name: netop
      - name: netend
    group: sysadmin
    state: present
- name: set multiple users to multiple groups
  iosxr_user:
    aggregate:
      - name: netop
      - name: netend
    groups:
      - sysadmin
      - root-system
    state: present
- name: Change Password for User netop
  iosxr_user:
    name: netop
    configured_password: "{{ new_password }}"
    update_password: always
    state: present
- name: Add private key authentication for user netop
  iosxr_user:
    name: netop
    state: present
    public_key_contents: "{{ lookup('file', '/home/netop/.ssh/id_rsa.pub' }}"

Return Values

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

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Support

For more information about Red Hat’s support of this module, please refer to this Knowledge Base article

Author

• Trishna Guha (@trishnaguha)
• Sebastiaan van Doesselaar (@sebasdoes)
• Kedar Kekan (@kedarX)