paloaltonetworks.panos.panos_admpwd module – change admin password of PAN-OS device using SSH with SSH key

Note

This module is part of the paloaltonetworks.panos collection (version 2.21.2).

To install it, use: ansible-galaxy collection install paloaltonetworks.panos. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: paloaltonetworks.panos.panos_admpwd.

New in paloaltonetworks.panos 1.0.0

Synopsis

  • Change the admin password of PAN-OS via SSH using a SSH key for authentication.

  • Useful for AWS instances where the first login should be done via SSH.

Requirements

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

  • paramiko

Parameters

Parameter

Comments

ip_address

string / required

IP address (or hostname) of PAN-OS device

key_filename

string / required

filename of the SSH Key to use for authentication

newpassword

string / required

password to configure for admin on the PAN-OS device

username

string

username for initial authentication

Default: :ansible-option-default:`"admin"`

Examples

# Tries for 10 times to set the admin password of 192.168.1.1 to "badpassword"
# via SSH, authenticating using key /tmp/ssh.key
- name: set admin password
  paloaltonetworks.panos.panos_admpwd:
    ip_address: "192.168.1.1"
    username: "admin"
    key_filename: "/tmp/ssh.key"
    newpassword: "badpassword"
  register: result
  until: result is not failed
  retries: 10
  delay: 30

Return Values

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

Key

Description

status

string

success status

Returned: success

Sample: :ansible-rv-sample-value:`"Last login: Fri Sep 16 11:09:20 2016 from 10.35.34.56.....Configuration committed successfully"`

Authors

  • Luigi Mori (@jtschichold), Ivan Bojer (@ivanbojer)