ansible-guacamole

Ansible role for installing and configuring Guacamole.

Build Status

GitHub Actions

Requirements

For required Ansible roles, check: requirements.yml

Role Variables

Check defaults/main.yml for the available variables.

TOTP Configuration

To enable Two-Factor Authentication, create a variable called guacamole_totp:

guacamole_totp:
  issuer: 'guacamole.example.com'
  period: 60

OpenID Configuration

To enable OpenID Authentication, create the following:

guacamole_openid_auth: true
guacamole_openid:
  authorization-endpoint: https://idp.xxx.xx/realms/yyy/protocol/openid-connect/auth
  jwks-endpoint: https://idp.xxx.xx/realms/yyy/protocol/openid-connect/certs
  issuer: https://idp.xxx.xx/realms/yyy
  client-id: remote
  redirect-uri: https://remote.xxx.xx/guacamole

guacd Configuration

guacd is the server-side proxy for the Apache Guacamole web application. If you want to run Guacamole or any application using its core APIs, you need to have guacd running.

guacd is installed by default. To turn it off, set guacd_config.install to false:

guacd_config:
  install: false

Dependencies

Example Playbook

Check playbook.yml for an example.

License

MIT

Author Information

Larry Smith Jr.

• @mrlesmithjr
• [email protected]
• https://everythingshouldbevirtual.com

NOTE: This repo was created and updated using https://github.com/mrlesmithjr/cookiecutter-ansible-role as a template.