community.general.utm_aaa_group_info – get info for reverse_proxy frontend entry in Sophos UTM

Note

This plugin is part of the community.general collection (version 2.5.1).

To install it use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.utm_aaa_group_info.

Synopsis

  • get info for a reverse_proxy frontend entry in SOPHOS UTM.

Parameters

Parameter Choices/Defaults Comments
headers
dictionary
A dictionary of additional headers to be sent to POST and PUT requests.
Is needed for some modules
name
string / required
The name of the object. Will be used to identify the entry
state
string
    Choices:
  • absent
  • present ←
The desired state of the object.
present will create or update an object
absent will delete an object if it was present
utm_host
string / required
The REST Endpoint of the Sophos UTM.
utm_port
integer
Default:
4444
The port of the REST interface.
utm_protocol
string
    Choices:
  • http
  • https ←
The protocol of the REST Endpoint.
utm_token
string / required
validate_certs
boolean
    Choices:
  • no
  • yes ←
Whether the REST interface's ssl certificate should be verified or not.

Examples

- name: Remove UTM aaa_group
  community.general.utm_aaa_group_info:
    utm_host: sophos.host.name
    utm_token: abcdefghijklmno1234
    name: TestAAAGroupEntry

Return Values

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

Key Returned Description
result
complex
success
The utm object that was created
 
_locked
boolean
success
Whether or not the object is currently locked
 
_ref
string
success
The reference name of the object
 
_type
string
success
The type of the object
 
adirectory_groups
string
success
List of Active Directory Groups
 
adirectory_groups_sids
list / elements=string
success
List of Active Directory Groups SIDS
 
backend_match
string
success
The backend to use
 
comment
string
success
The comment string
 
dynamic
string
success
Whether the group match is ipsec_dn or directory_group
 
edirectory_groups
string
success
List of eDirectory Groups
 
ipsec_dn
string
success
ipsec_dn identifier to match
 
ldap_attribute
string
success
The LDAP Attribute to match against
 
ldap_attribute_value
string
success
The LDAP Attribute Value to match against
 
members
list / elements=string
success
List of member identifiers of the group
 
name
string
success
The name of the object
 
network
string
success
The identifier of the network (network/aaa)
 
radius_group
string
success
The radius group identifier
 
tacacs_group
string
success
The tacacs group identifier


Authors

  • Johannes Brunswicker (@MatrixCrawler)