ROLE ICINGA2_WEB

This role sets up and configures Icinga Web 2.

Requirements

To use this role, you need to have a web server installed. At Adfinis, we use:

• adfinis-sygroup.nginx

Role Dependencies

This role depends on the following:

roles:
- name: 'adfinis.icinga2_agent'

collections:
  - ansible.posix
  - community.general
  - community.mysql
  - robertdebock.roles

To install these dependencies correctly, you should create a requirements.yml file in your project with the above content.

Role Variables

# Password for the Icinga Web 2 admin
icinga2_web_admin_pass: 'passw0rd'

# Icinga API details
icinga2_web_api_host: 127.0.0.1
icinga2_web_api_port: 5665
icinga2_web_api_user: icingaweb2
icinga2_web_api_pass: 'passw0rd'

# Database settings for Icinga Web 2
icinga2_web_icingaweb2_database_name: icingaweb2
icinga2_web_icingaweb2_database_user: icingaweb2
icinga2_web_icingaweb2_database_pass: 'passw0rd'
icinga2_web_icingaweb2_database_host: 127.0.0.1
icinga2_web_icingaweb2_database_port: 3306

# Database settings for Icinga 2
icinga2_web_icinga2_database_name: icinga2
icinga2_web_icinga2_database_host: 127.0.0.1
icinga2_web_icinga2_database_port: 3306
icinga2_web_icinga2_database_user: icinga2
icinga2_web_icinga2_database_pass: 'passw0rd'

LDAP Authentication

To set up LDAP authentication, you need to define the following variables. You can enable multiple configurations.

# Configure Icinga Web 2 for LDAP authentication
# For more details, check the official documentation
# https://icinga.com/docs/icingaweb2/latest/doc/04-Resources/#ldap
#icinga2_web_ldap:
#  - name: res_ldap_example_com
#    host: ldap.example.com
#    port: 636
#    encryption: ldaps
#    root_dn: 'cn=accounts,dc=ldap,dc=example,dc=com'
#    bind_dn: 'uid=icingaweb2.auth,cn=systems,dc=ldap,dc=example,dc=com'
#    bind_pw: 'ldap password'
#    timeout: 5

# LDAP User Configuration
# For full details, refer to the official documentation
# https://icinga.com/docs/icingaweb2/latest/doc/05-Authentication/#ldap
#
#icinga2_web_ldap_userconf:
#  - name: user_ldap_example_com # required
#    resource: 'res_ldap_example_com' # required
#    user_class: 'inetOrgPerson' # required
#    user_name_attribute: 'uid' # required
#    base_dn: 'cn=accounts,dc=ldap,dc=example,dc=com' # optional
#    filter: "(somefilter)" # optional

icinga2_web_ldap_userconf: []

# LDAP Group Configuration
# For more information, refer to the official documentation
# https://icinga.com/docs/icingaweb2/latest/doc/05-Authentication/#ldap-groups
#
#icinga2_web_ldap_groupconf:
#  - name: group_ldap_example_com # required
#    resource: 'res_ldap_example_com' # required
#    user_backend = "user_ldap_examle_com" # required
#    user_class: 'user' # optional
#    user_name_attribute: 'uid' # optional
#    group_class: 'group' # optional
#    group_name_attribute: 'gid' # optional
#    group_member_attribute: 'memberUid' # optional
#    group_filter: '(somefilter)' # optional

Icinga Web 2 Permissions

# Permissions configuration for Icinga 2
# For further details, refer to the official documentation
# https://icinga.com/docs/icingaweb2/latest/doc/06-Security/#configuration
#
#icinga2_web_permissions:
#  - name: Administrators
#    users:
#      - admin
#    groups:
#      - Administrators
#    permissions:
#      '*'
#    object_filter: ""
#  - name: customer
#    users:
#      - customer1
#    permissions:
#      'monitoring/command/*,module/*'
#    object_filter: 'host_name=*.customer.example.com"'

Example Playbook

- hosts: servers
  roles:
     - { role: adfinis.icinga2_web }

License

GPL-3.0

Author Information

The Icinga 2 Web role was created by:

• Adfinis AG | Website | Twitter | GitHub