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)