panos_admin - Add or modify PAN-OS user accounts password.

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

Synopsis

• PanOS module that allows changes to the user account passwords by doing API calls to the Firewall using pan-api as the protocol.

Requirements

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

• pan-python

Parameters

Parameter	Choices/Defaults	Comments
admin_password required		password for admin user
admin_username	Default: admin	username for admin user
commit	Default: yes	commit if changed
ip_address required		IP address (or hostname) of PAN-OS device
password required		password for authentication
role	Default: None	role for admin user
username	Default: admin	username for authentication

Examples

# Set the password of user admin to "badpassword"
# Doesn't commit the candidate config
  - name: set admin password
    panos_admin:
      ip_address: "192.168.1.1"
      password: "admin"
      admin_username: admin
      admin_password: "badpassword"
      commit: False

Return Values

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

Key	Returned	Description
status string	success	success status Sample: okey dokey

Status

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

Author

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