2021-04-11 11:25:03 +00:00
# yamllint disable rule:comments-indentation
---
###############################################################################
# Authelia Configuration #
###############################################################################
2021-02-21 23:07:06 +00:00
2023-04-19 04:27:10 +00:00
##
## Notes:
##
## - the default location of this file is assumed to be configuration.yml unless otherwise noted
## - when using docker the container expects this by default to be at /config/configuration.yml
## - the default location where this file is loaded from can be overridden with the X_AUTHELIA_CONFIG environment var
## - the comments in this configuration file are helpful but users should consult the official documentation on the
2023-05-11 06:45:20 +00:00
## website at https://www.authelia.com/ or https://www.authelia.com/configuration/prologue/introduction/
2023-04-19 04:27:10 +00:00
## - this configuration file template is not automatically updated
##
2021-12-02 04:50:05 +00:00
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## Certificates directory specifies where Authelia will load trusted certificates (public portion) from in addition to
## the system certificates store.
## They should be in base64 format, and have one of the following extensions: *.cer, *.crt, *.pem.
2023-05-07 06:39:17 +00:00
# certificates_directory: '/config/certificates/'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2021-06-17 06:42:03 +00:00
## The theme to display: light, dark, grey, auto.
2023-05-07 06:39:17 +00:00
theme : 'light'
2021-02-21 23:07:06 +00:00
2021-08-02 11:55:30 +00:00
## The secret used to generate JWT tokens when validating user identity by email confirmation. JWT Secret can also be
2022-06-15 07:51:47 +00:00
## set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
jwt_secret : 'a_very_important_secret'
2021-08-02 11:55:30 +00:00
## Default redirection URL
##
## If user tries to authenticate without any referer, Authelia does not know where to redirect the user to at the end
## of the authentication process. This parameter allows you to specify the default redirection URL Authelia will use
## in such a case.
##
## Note: this parameter is optional. If not provided, user won't be redirected upon successful authentication.
2023-05-07 06:39:17 +00:00
default_redirection_url : 'https://home.example.com/'
2021-08-02 11:55:30 +00:00
2022-04-17 23:58:24 +00:00
## Set the default 2FA method for new users and for when a user has a preferred method configured that has been
## disabled. This setting must be a method that is enabled.
## Options are totp, webauthn, mobile_push.
2023-05-07 06:39:17 +00:00
default_2fa_method : ''
2022-04-17 23:58:24 +00:00
2021-04-11 11:25:03 +00:00
##
## Server Configuration
##
2021-02-21 23:07:06 +00:00
server :
2023-05-07 06:39:17 +00:00
## The address for the Main server to listen on in the address common syntax.
## Formats:
## - [<scheme>://]<hostname>[:<port>]
## - [<scheme>://][hostname]:<port>
## Square brackets indicate optional portions of the format. Scheme must be 'tcp', 'tcp4', 'tcp6', or 'unix'.
## The default scheme is 'unix' if the address is an absolute path otherwise it's 'tcp'. The default port is '9091'.
address : 'tcp://:9091'
2021-08-02 11:55:30 +00:00
2021-08-03 09:55:21 +00:00
## Set the single level path Authelia listens on.
## Must be alphanumeric chars and should not contain any slashes.
2023-05-07 06:39:17 +00:00
path : ''
2021-08-02 11:55:30 +00:00
2021-11-15 08:37:58 +00:00
## Set the path on disk to Authelia assets.
## Useful to allow overriding of specific static assets.
2023-05-07 06:39:17 +00:00
# asset_path: '/config/assets/'
2021-11-15 08:37:58 +00:00
2021-08-05 04:02:07 +00:00
## Disables writing the health check vars to /app/.healthcheck.env which makes healthcheck.sh return exit code 0.
## This is disabled by default if either /app/.healthcheck.env or /app/healthcheck.sh do not exist.
disable_healthcheck : false
2021-08-03 09:55:21 +00:00
## Authelia by default doesn't accept TLS communication on the server port. This section overrides this behaviour.
tls :
## The path to the DER base64/PEM format private key.
2023-05-07 06:39:17 +00:00
key : ''
2021-08-03 09:55:21 +00:00
## The path to the DER base64/PEM format public certificate.
2023-05-07 06:39:17 +00:00
certificate : ''
2021-08-03 09:55:21 +00:00
2022-04-04 23:57:47 +00:00
## The list of certificates for client authentication.
client_certificates : [ ]
2022-02-20 23:14:09 +00:00
## Server headers configuration/customization.
headers :
## The CSP Template. Read the docs.
2023-05-07 06:39:17 +00:00
csp_template : ''
2022-02-20 23:14:09 +00:00
2022-08-08 21:50:12 +00:00
## Server Buffers configuration.
# buffers:
## Buffers usually should be configured to be the same value.
## Explanation at https://www.authelia.com/c/server#buffer-sizes
## Read buffer size adjusts the server's max incoming request size in bytes.
## Write buffer size does the same for outgoing responses.
## Read buffer.
# read: 4096
## Write buffer.
# write: 4096
## Server Timeouts configuration.
# timeouts:
2023-05-08 03:51:17 +00:00
## Read timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# read: '6s'
2022-08-08 21:50:12 +00:00
2023-05-08 03:51:17 +00:00
## Write timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# write: '6s'
2022-08-08 21:50:12 +00:00
2023-05-08 03:51:17 +00:00
## Idle timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# idle: '30s'
2022-08-08 21:50:12 +00:00
2023-01-25 09:36:40 +00:00
## Server Endpoints configuration.
## This section is considered advanced and it SHOULD NOT be configured unless you've read the relevant documentation.
# endpoints:
## Enables the pprof endpoint.
# enable_pprof: false
## Enables the expvars endpoint.
# enable_expvars: false
## Configure the authz endpoints.
# authz:
# forward-auth:
2023-05-07 06:39:17 +00:00
# implementation: 'ForwardAuth'
2023-01-25 09:36:40 +00:00
# authn_strategies: []
# ext-authz:
2023-05-07 06:39:17 +00:00
# implementation: 'ExtAuthz'
2023-01-25 09:36:40 +00:00
# authn_strategies: []
# auth-request:
2023-05-07 06:39:17 +00:00
# implementation: 'AuthRequest'
2023-01-25 09:36:40 +00:00
# authn_strategies: []
# legacy:
2023-05-07 06:39:17 +00:00
# implementation: 'Legacy'
2023-01-25 09:36:40 +00:00
# authn_strategies: []
2021-08-03 09:55:21 +00:00
##
## Log Configuration
##
2021-06-08 13:15:43 +00:00
log :
## Level of verbosity for logs: info, debug, trace.
2023-05-07 06:39:17 +00:00
level : 'debug'
2021-04-11 11:25:03 +00:00
2021-06-01 04:09:50 +00:00
## Format the logs are written as: json, text.
2023-05-07 06:39:17 +00:00
# format: 'json'
2021-04-11 11:25:03 +00:00
2021-06-01 04:09:50 +00:00
## File path where the logs will be written. If not set logs are written to stdout.
2023-05-07 06:39:17 +00:00
# file_path: '/config/authelia.log'
2021-02-21 23:07:06 +00:00
2021-06-01 04:09:50 +00:00
## Whether to also log to stdout when a log_file_path is defined.
# keep_stdout: false
2021-05-31 04:02:54 +00:00
2022-06-14 07:20:13 +00:00
##
## Telemetry Configuration
##
telemetry :
##
## Metrics Configuration
##
metrics :
## Enable Metrics.
enabled : false
2023-05-07 06:39:17 +00:00
## The address for the Metrics server to listen on in the address common syntax.
## Formats:
## - [<scheme>://]<hostname>[:<port>]
## - [<scheme>://][hostname]:<port>
## Square brackets indicate optional portions of the format. Scheme must be 'tcp', 'tcp4', 'tcp6', or 'unix'.
## The default scheme is 'unix' if the address is an absolute path otherwise it's 'tcp'. The default port is '9959'.
address : 'tcp://:9959'
2022-06-14 07:20:13 +00:00
2022-08-08 21:50:12 +00:00
## Metrics Server Buffers configuration.
# buffers:
## Read buffer.
# read: 4096
## Write buffer.
# write: 4096
## Metrics Server Timeouts configuration.
# timeouts:
2023-05-08 03:51:17 +00:00
## Read timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# read: '6s'
2022-08-08 21:50:12 +00:00
2023-05-08 03:51:17 +00:00
## Write timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# write: '6s'
2022-08-08 21:50:12 +00:00
2023-05-08 03:51:17 +00:00
## Idle timeout in the duration common syntax.
2023-05-07 06:39:17 +00:00
# idle: '30s'
2022-08-08 21:50:12 +00:00
2021-04-11 11:25:03 +00:00
##
## TOTP Configuration
##
## Parameters used for TOTP generation.
2021-02-21 23:07:06 +00:00
totp :
2022-03-03 11:20:43 +00:00
## Disable TOTP.
disable : false
2021-12-01 12:11:29 +00:00
## The issuer name displayed in the Authenticator application of your choice.
2023-05-07 06:39:17 +00:00
issuer : 'authelia.com'
2021-12-01 12:11:29 +00:00
## The TOTP algorithm to use.
## It is CRITICAL you read the documentation before changing this option:
2022-06-15 07:51:47 +00:00
## https://www.authelia.com/c/totp#algorithm
2023-05-07 06:39:17 +00:00
algorithm : 'sha1'
2021-12-01 12:11:29 +00:00
## The number of digits a user has to input. Must either be 6 or 8.
## Changing this option only affects newly generated TOTP configurations.
## It is CRITICAL you read the documentation before changing this option:
2022-06-15 07:51:47 +00:00
## https://www.authelia.com/c/totp#digits
2021-12-01 12:11:29 +00:00
digits : 6
## The period in seconds a one-time password is valid for.
## Changing this option only affects newly generated TOTP configurations.
2021-02-21 23:07:06 +00:00
period : 30
2021-12-01 12:11:29 +00:00
2021-04-11 11:25:03 +00:00
## The skew controls number of one-time passwords either side of the current one that are valid.
## Warning: before changing skew read the docs link below.
2021-02-21 23:07:06 +00:00
skew : 1
2022-06-15 07:51:47 +00:00
## See: https://www.authelia.com/c/totp#input-validation to read
## the documentation.
2021-02-21 23:07:06 +00:00
2022-04-07 23:01:01 +00:00
## The size of the generated shared secrets. Default is 32 and is sufficient in most use cases, minimum is 20.
secret_size : 32
2022-03-03 11:20:43 +00:00
##
## WebAuthn Configuration
##
## Parameters used for WebAuthn.
webauthn :
2023-04-14 16:04:42 +00:00
## Disable WebAuthn.
2022-03-03 11:20:43 +00:00
disable : false
2023-05-08 03:51:17 +00:00
## The interaction timeout for WebAuthn dialogues in the duration common syntax.
2023-05-07 06:39:17 +00:00
timeout : '60s'
2022-03-03 11:20:43 +00:00
2023-04-14 16:04:42 +00:00
## The display name the browser should show the user for when using WebAuthn to login/register.
2023-05-07 06:39:17 +00:00
display_name : 'Authelia'
2022-03-03 11:20:43 +00:00
## Conveyance preference controls if we collect the attestation statement including the AAGUID from the device.
## Options are none, indirect, direct.
2023-05-07 06:39:17 +00:00
attestation_conveyance_preference : 'indirect'
2022-03-03 11:20:43 +00:00
## User verification controls if the user must make a gesture or action to confirm they are present.
## Options are required, preferred, discouraged.
2023-05-07 06:39:17 +00:00
user_verification : 'preferred'
2022-03-03 11:20:43 +00:00
2021-04-11 11:25:03 +00:00
##
## Duo Push API Configuration
##
## Parameters used to contact the Duo API. Those are generated when you protect an application of type
## "Partner Auth API" in the management panel.
2022-10-21 09:17:30 +00:00
# duo_api:
# disable: false
2023-05-07 06:39:17 +00:00
# hostname: 'api-123456789.example.com'
# integration_key: 'ABCDEF'
2022-06-15 07:51:47 +00:00
## Secret can also be set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
# secret_key: '1234567890abcdefghifjkl'
2022-10-21 09:17:30 +00:00
# enable_self_enrollment: false
2021-02-21 23:07:06 +00:00
2021-09-17 04:44:35 +00:00
##
## NTP Configuration
##
## This is used to validate the servers time is accurate enough to validate TOTP.
ntp :
2023-05-07 06:39:17 +00:00
## The address of the NTP server to connect to in the address common syntax.
## Format: [<scheme>://]<hostname>[:<port>].
## Square brackets indicate optional portions of the format. Scheme must be 'udp', 'udp4', or 'udp6'.
## The default scheme is 'udp'. The default port is '123'.
address : 'udp://time.cloudflare.com:123'
2021-09-17 04:44:35 +00:00
## NTP version.
version : 4
2023-05-08 03:51:17 +00:00
## Maximum allowed time offset between the host and the NTP server in the duration common syntax.
2023-05-07 06:39:17 +00:00
max_desync : '3s'
2021-09-17 04:44:35 +00:00
## Disables the NTP check on startup entirely. This means Authelia will not contact a remote service at all if you
## set this to true, and can operate in a truly offline mode.
disable_startup_check : false
## The default of false will prevent startup only if we can contact the NTP server and the time is out of sync with
## the NTP server more than the configured max_desync. If you set this to true, an error will be logged but startup
## will continue regardless of results.
disable_failure : false
2021-04-11 11:25:03 +00:00
##
## Authentication Backend Provider Configuration
##
## Used for verifying user passwords and retrieve information such as email address and groups users belong to.
##
## The available providers are: `file`, `ldap`. You must use only one of these providers.
2021-02-21 23:07:06 +00:00
authentication_backend :
2022-06-28 07:28:49 +00:00
2022-04-04 07:46:55 +00:00
## Password Reset Options.
password_reset :
2022-06-28 03:15:50 +00:00
## Disable both the HTML element and the API for reset password functionality.
disable : false
2022-04-04 07:46:55 +00:00
## External reset password url that redirects the user to an external reset portal. This disables the internal reset
## functionality.
2023-05-07 06:39:17 +00:00
custom_url : ''
2022-04-04 07:46:55 +00:00
2023-05-08 03:51:17 +00:00
## The amount of time to wait before we refresh data from the authentication backend in the duration common syntax.
2021-04-11 11:25:03 +00:00
## To disable this feature set it to 'disable', this will slightly reduce security because for Authelia, users will
## always belong to groups they belonged to at the time of login even if they have been removed from them in LDAP.
## To force update on every request you can set this to '0' or 'always', this will increase processor demand.
## See the below documentation for more information.
2022-06-15 07:51:47 +00:00
## Refresh Interval docs: https://www.authelia.com/c/1fa#refresh-interval
2023-05-08 03:51:17 +00:00
refresh_interval : '5m'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## LDAP (Authentication Provider)
##
## This is the recommended Authentication Provider in production
## because it allows Authelia to offload the stateful operations
## onto the LDAP service.
2022-10-21 09:17:30 +00:00
# ldap:
2023-05-07 06:39:17 +00:00
## The address of the LDAP server to connect to in the address common syntax.
## Format: [<scheme>://]<hostname>[:<port>].
## Square brackets indicate optional portions of the format. Scheme must be 'ldap', 'ldaps', or 'ldapi`.
## The default scheme is 'ldapi' if the address is an absolute path otherwise it's 'ldaps'.
## The default port is '636', unless the scheme is 'ldap' in which case it's '389'.
# address: 'ldaps://127.0.0.1:636'
2021-04-11 11:25:03 +00:00
## The LDAP implementation, this affects elements like the attribute utilised for resetting a password.
## Acceptable options are as follows:
2022-12-21 10:07:00 +00:00
## - 'activedirectory' - for Microsoft Active Directory.
## - 'freeipa' - for FreeIPA.
2022-12-21 10:51:25 +00:00
## - 'lldap' - for lldap.
2022-12-21 10:07:00 +00:00
## - 'custom' - for custom specifications of attributes and filters.
2021-04-11 11:25:03 +00:00
## This currently defaults to 'custom' to maintain existing behaviour.
##
## Depending on the option here certain other values in this section have a default value, notably all of the
## attribute mappings have a default value that this config overrides, you can read more about these default values
2022-06-15 07:51:47 +00:00
## at https://www.authelia.com/c/ldap#defaults
2023-05-07 06:39:17 +00:00
# implementation: 'custom'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2023-05-07 06:39:17 +00:00
## The dial timeout for LDAP in the duration common syntax.
# timeout: '5s'
2021-08-05 04:30:00 +00:00
2021-04-11 11:25:03 +00:00
## Use StartTLS with the LDAP connection.
2022-10-21 09:17:30 +00:00
# start_tls: false
2021-02-21 23:07:06 +00:00
2022-10-21 09:17:30 +00:00
# tls:
2022-10-22 08:27:59 +00:00
## The server subject name to check the servers certificate against during the validation process.
2023-05-07 06:39:17 +00:00
## This option is not required if the certificate has a SAN which matches the address options hostname.
# server_name: 'ldap.example.com'
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## Skip verifying the server certificate entirely. In preference to setting this we strongly recommend you add the
## certificate or the certificate of the authority signing the certificate to the certificates directory which is
## defined by the `certificates_directory` option at the top of the configuration.
## It's important to note the public key should be added to the directory, not the private key.
## This option is strongly discouraged but may be useful in some self-signed situations where validation is not
## important to the administrator.
2022-10-21 09:17:30 +00:00
# skip_verify: false
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## Minimum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# minimum_version: 'TLS1.2'
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## Maximum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# maximum_version: 'TLS1.3'
2022-10-21 08:41:33 +00:00
## The certificate chain used with the private_key if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# certificate_chain: |
2022-10-21 09:17:30 +00:00
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
2022-10-21 08:41:33 +00:00
## The private key used with the certificate_chain if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# private_key: |
2023-04-19 04:27:10 +00:00
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END RSA PRIVATE KEY-----
2022-10-21 08:41:33 +00:00
2021-04-11 11:25:03 +00:00
## The distinguished name of the container searched for objects in the directory information tree.
## See also: additional_users_dn, additional_groups_dn.
2023-05-07 06:39:17 +00:00
# base_dn: 'dc=example,dc=com'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2021-04-11 11:25:03 +00:00
## The attribute holding the username of the user. This attribute is used to populate the username in the session
2022-10-22 04:25:12 +00:00
## information. For your information, Microsoft Active Directory usually uses 'sAMAccountName' and OpenLDAP usually
## uses 'uid'. Beware that this attribute holds the unique identifiers for the users binding the user and the
## configuration stored in database. Therefore only single value attributes are allowed and the value must never be
## changed once attributed to a user otherwise it would break the configuration for that user. Technically,
## non-unique attributes like 'mail' can also be used but we don't recommend using them, we instead advise to use
## a filter to perform alternative lookups and the attributes mentioned above (sAMAccountName and uid) to
2023-02-05 07:11:30 +00:00
## follow https://datatracker.ietf.org/doc/html/rfc2307.
2023-05-07 06:39:17 +00:00
# username_attribute: 'uid'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2021-04-11 11:25:03 +00:00
## The additional_users_dn is prefixed to base_dn and delimited by a comma when searching for users.
## i.e. with this set to OU=Users and base_dn set to DC=a,DC=com; OU=Users,DC=a,DC=com is searched for users.
2023-05-07 06:39:17 +00:00
# additional_users_dn: 'ou=users'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## The users filter used in search queries to find the user profile based on input filled in login form.
2021-08-05 04:17:07 +00:00
## Various placeholders are available in the user filter which you can read about in the documentation which can
2022-06-15 07:51:47 +00:00
## be found at: https://www.authelia.com/c/ldap#users-filter-replacements
2021-04-11 11:25:03 +00:00
##
## Recommended settings are as follows:
## - Microsoft Active Directory: (&({username_attribute}={input})(objectCategory=person)(objectClass=user))
## - OpenLDAP:
## - (&({username_attribute}={input})(objectClass=person))
## - (&({username_attribute}={input})(objectClass=inetOrgPerson))
##
## To allow sign in both with username and email, one can use a filter like
## (&(|({username_attribute}={input})({mail_attribute}={input}))(objectClass=person))
2023-05-07 06:39:17 +00:00
# users_filter: '(&({username_attribute}={input})(objectClass=person))'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## The additional_groups_dn is prefixed to base_dn and delimited by a comma when searching for groups.
## i.e. with this set to OU=Groups and base_dn set to DC=a,DC=com; OU=Groups,DC=a,DC=com is searched for groups.
2023-05-07 06:39:17 +00:00
# additional_groups_dn: 'ou=groups'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2021-08-05 04:17:07 +00:00
## The groups filter used in search queries to find the groups based on relevant authenticated user.
## Various placeholders are available in the groups filter which you can read about in the documentation which can
2022-06-15 07:51:47 +00:00
## be found at: https://www.authelia.com/c/ldap#groups-filter-replacements
2021-04-11 11:25:03 +00:00
##
## If your groups use the `groupOfUniqueNames` structure use this instead:
2021-08-05 04:17:07 +00:00
## (&(uniqueMember={dn})(objectClass=groupOfUniqueNames))
2023-05-07 06:39:17 +00:00
# groups_filter: '(&(member={dn})(objectClass=groupOfNames))'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## The attribute holding the name of the group.
2023-05-07 06:39:17 +00:00
# group_name_attribute: 'cn'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## The attribute holding the mail address of the user. If multiple email addresses are defined for a user, only the
## first one returned by the LDAP server is used.
2023-05-07 06:39:17 +00:00
# mail_attribute: 'mail'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## The attribute holding the display name of the user. This will be used to greet an authenticated user.
2023-05-07 06:39:17 +00:00
# display_name_attribute: 'displayName'
2021-02-21 23:07:06 +00:00
2022-05-02 01:51:38 +00:00
## Follow referrals returned by the server.
## This is especially useful for environments where read-only servers exist. Only implemented for write operations.
2022-10-21 09:17:30 +00:00
# permit_referrals: false
2022-05-02 01:51:38 +00:00
2021-04-11 11:25:03 +00:00
## The username and password of the admin user.
2023-04-19 04:27:10 +00:00
# user: 'cn=admin,dc=example,dc=com'
2022-06-15 07:51:47 +00:00
## Password can also be set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
# password: 'password'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## File (Authentication Provider)
##
## With this backend, the users database is stored in a file which is updated when users reset their passwords.
## Therefore, this backend is meant to be used in a dev environment and not in production since it prevents Authelia
## to be scaled to more than one instance. The options under 'password' have sane defaults, and as it has security
## implications it is highly recommended you leave the default values. Before considering changing these settings
## please read the docs page below:
2022-06-15 07:51:47 +00:00
## https://www.authelia.com/r/passwords#tuning
2021-04-11 11:25:03 +00:00
##
2022-06-15 07:51:47 +00:00
## Important: Kubernetes (or HA) users must read https://www.authelia.com/t/statelessness
2021-04-11 11:25:03 +00:00
##
# file:
2023-05-07 06:39:17 +00:00
# path: '/config/users_database.yml'
2022-10-21 09:17:30 +00:00
# watch: false
# search:
# email: false
# case_insensitive: false
# password:
2023-05-07 06:39:17 +00:00
# algorithm: 'argon2'
2022-10-21 09:17:30 +00:00
# argon2:
2023-05-07 06:39:17 +00:00
# variant: 'argon2id'
2022-10-21 09:17:30 +00:00
# iterations: 3
# memory: 65536
# parallelism: 4
# key_length: 32
# salt_length: 16
# scrypt:
# iterations: 16
# block_size: 8
# parallelism: 1
# key_length: 32
# salt_length: 16
# pbkdf2:
2023-05-07 06:39:17 +00:00
# variant: 'sha512'
2022-10-21 09:17:30 +00:00
# iterations: 310000
# salt_length: 16
# sha2crypt:
2023-05-07 06:39:17 +00:00
# variant: 'sha512'
2022-10-21 09:17:30 +00:00
# iterations: 50000
# salt_length: 16
# bcrypt:
2023-05-07 06:39:17 +00:00
# variant: 'standard'
2022-10-21 09:17:30 +00:00
# cost: 12
2022-10-17 10:51:59 +00:00
2022-04-03 00:48:26 +00:00
##
## Password Policy Configuration.
##
password_policy :
## The standard policy allows you to tune individual settings manually.
standard :
enabled : false
2022-04-03 11:58:27 +00:00
## Require a minimum length for passwords.
2022-04-03 00:48:26 +00:00
min_length : 8
2022-04-03 11:58:27 +00:00
## Require a maximum length for passwords.
2022-04-03 00:48:26 +00:00
max_length : 0
2022-04-03 11:58:27 +00:00
## Require uppercase characters.
2022-04-03 00:48:26 +00:00
require_uppercase : true
2022-04-03 11:58:27 +00:00
## Require lowercase characters.
2022-04-03 00:48:26 +00:00
require_lowercase : true
2022-04-03 11:58:27 +00:00
## Require numeric characters.
2022-04-03 00:48:26 +00:00
require_number : true
2022-04-03 11:58:27 +00:00
## Require special characters.
2022-04-03 00:48:26 +00:00
require_special : true
## zxcvbn is a well known and used password strength algorithm. It does not have tunable settings.
zxcvbn :
enabled : false
2022-04-15 09:30:51 +00:00
## Configures the minimum score allowed.
min_score : 3
2023-01-22 08:58:07 +00:00
##
## Privacy Policy Configuration
##
## Parameters used for displaying the privacy policy link and drawer.
privacy_policy :
## Enables the display of the privacy policy using the policy_url.
enabled : false
## Enables the display of the privacy policy drawer which requires users accept the privacy policy
## on a per-browser basis.
require_user_acceptance : false
## The URL of the privacy policy document. Must be an absolute URL and must have the 'https://' scheme.
## If the privacy policy enabled option is true, this MUST be provided.
policy_url : ''
2021-04-11 11:25:03 +00:00
##
## Access Control Configuration
##
## Access control is a list of rules defining the authorizations applied for one resource to users or group of users.
##
## If 'access_control' is not defined, ACL rules are disabled and the 'bypass' rule is applied, i.e., access is allowed
## to anyone. Otherwise restrictions follow the rules defined.
##
## Note: One can use the wildcard * to match any subdomain.
2022-10-01 11:47:09 +00:00
## It must stand at the beginning of the pattern. (example: *.example.com)
2021-04-11 11:25:03 +00:00
##
## Note: You must put patterns containing wildcards between simple quotes for the YAML to be syntactically correct.
##
## Definition: A 'rule' is an object with the following keys: 'domain', 'subject', 'policy' and 'resources'.
##
## - 'domain' defines which domain or set of domains the rule applies to.
##
## - 'subject' defines the subject to apply authorizations to. This parameter is optional and matching any user if not
## provided. If provided, the parameter represents either a user or a group. It should be of the form
## 'user:<username>' or 'group:<groupname>'.
##
## - 'policy' is the policy to apply to resources. It must be either 'bypass', 'one_factor', 'two_factor' or 'deny'.
##
## - 'resources' is a list of regular expressions that matches a set of resources to apply the policy to. This parameter
## is optional and matches any resource if not provided.
##
## Note: the order of the rules is important. The first policy matching (domain, resource, subject) applies.
2021-02-21 23:07:06 +00:00
access_control :
2021-04-11 11:25:03 +00:00
## Default policy can either be 'bypass', 'one_factor', 'two_factor' or 'deny'. It is the policy applied to any
## resource if there is no policy to be applied to the user.
2023-05-07 06:39:17 +00:00
default_policy : 'deny'
2021-02-21 23:07:06 +00:00
2022-10-21 09:17:30 +00:00
# networks:
2023-05-07 06:39:17 +00:00
# - name: 'internal'
2022-10-21 09:17:30 +00:00
# networks:
2023-05-07 06:39:17 +00:00
# - '10.10.0.0/16'
# - '192.168.2.0/24'
2023-04-19 04:27:10 +00:00
# - name: 'VPN'
2023-05-07 06:39:17 +00:00
# networks: '10.9.0.0/16'
2021-02-21 23:07:06 +00:00
2022-10-21 09:17:30 +00:00
# rules:
2021-04-11 11:25:03 +00:00
## Rules applied to everyone
2022-10-21 09:17:30 +00:00
# - domain: 'public.example.com'
2023-05-07 06:39:17 +00:00
# policy: 'bypass'
2021-02-21 23:07:06 +00:00
2022-04-01 11:38:49 +00:00
## Domain Regex examples. Generally we recommend just using a standard domain.
2022-04-02 05:41:16 +00:00
# - domain_regex: '^(?P<User>\w+)\.example\.com$'
2023-05-07 06:39:17 +00:00
# policy: 'one_factor'
2022-04-02 05:41:16 +00:00
# - domain_regex: '^(?P<Group>\w+)\.example\.com$'
2023-05-07 06:39:17 +00:00
# policy: 'one_factor'
2022-04-01 11:38:49 +00:00
# - domain_regex:
2022-10-21 09:17:30 +00:00
# - '^appgroup-.*\.example\.com$'
# - '^appgroup2-.*\.example\.com$'
2023-05-07 06:39:17 +00:00
# policy: 'one_factor'
2022-04-02 05:41:16 +00:00
# - domain_regex: '^.*\.example\.com$'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2022-04-01 11:38:49 +00:00
2022-10-21 09:17:30 +00:00
# - domain: 'secure.example.com'
2023-05-07 06:39:17 +00:00
# policy: 'one_factor'
2022-10-21 09:17:30 +00:00
## Network based rule, if not provided any network matches.
# networks:
2023-05-07 06:39:17 +00:00
# - 'internal'
# - 'VPN'
# - '192.168.1.0/24'
# - '10.0.0.1'
2022-10-21 09:17:30 +00:00
# - domain:
# - 'secure.example.com'
# - 'private.example.com'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2022-10-21 09:17:30 +00:00
# - domain: 'singlefactor.example.com'
2023-05-07 06:39:17 +00:00
# policy: 'one_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Rules applied to 'admins' group
2022-10-21 09:17:30 +00:00
# - domain: 'mx2.mail.example.com'
# subject: 'group:admins'
2023-05-07 06:39:17 +00:00
# policy: 'deny'
2022-10-21 09:17:30 +00:00
# - domain: '*.example.com'
# subject:
# - 'group:admins'
# - 'group:moderators'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Rules applied to 'dev' group
2022-10-21 09:17:30 +00:00
# - domain: 'dev.example.com'
# resources:
# - '^/groups/dev/.*$'
# subject: 'group:dev'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Rules applied to user 'john'
2022-10-21 09:17:30 +00:00
# - domain: 'dev.example.com'
# resources:
# - '^/users/john/.*$'
# subject: 'user:john'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Rules applied to user 'harry'
2022-10-21 09:17:30 +00:00
# - domain: 'dev.example.com'
# resources:
# - '^/users/harry/.*$'
# subject: 'user:harry'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Rules applied to user 'bob'
2022-10-21 09:17:30 +00:00
# - domain: '*.mail.example.com'
# subject: 'user:bob'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2022-10-21 09:17:30 +00:00
# - domain: 'dev.example.com'
# resources:
# - '^/users/bob/.*$'
# subject: 'user:bob'
2023-05-07 06:39:17 +00:00
# policy: 'two_factor'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## Session Provider Configuration
##
## The session cookies identify the user once logged in.
## The available providers are: `memory`, `redis`. Memory is the provider unless redis is defined.
2021-02-21 23:07:06 +00:00
session :
2021-04-11 11:25:03 +00:00
## The secret to encrypt the session data. This is only used with Redis / Redis Sentinel.
2022-06-15 07:51:47 +00:00
## Secret can also be set using a secret: https://www.authelia.com/c/secrets
2023-01-12 10:57:44 +00:00
secret : 'insecure_session_secret'
## Cookies configures the list of allowed cookie domains for sessions to be created on.
## Undefined values will default to the values below.
# cookies:
# -
## The name of the session cookie.
# name: 'authelia_session'
## The domain to protect.
## Note: the Authelia portal must also be in that domain.
# domain: 'example.com'
## Optional. The fully qualified URI of the portal to redirect users to on proxies that support redirections.
## Rules:
## - MUST use the secure scheme 'https://'
## - The above domain MUST either:
## - Match the host portion of this URI.
## - Match the suffix of the host portion when prefixed with '.'.
# authelia_url: 'https://auth.example.com'
## Sets the Cookie SameSite value. Possible options are none, lax, or strict.
## Please read https://www.authelia.com/c/session#same_site
# same_site: 'lax'
2023-05-07 06:39:17 +00:00
## The value for inactivity, expiration, and remember_me are in seconds or the duration common syntax.
2023-01-12 10:57:44 +00:00
## All three of these values affect the cookie/session validity period. Longer periods are considered less secure
## because a stolen cookie will last longer giving attackers more time to spy or attack.
## The inactivity time before the session is reset. If expiration is set to 1h, and this is set to 5m, if the user
## does not select the remember me option their session will get destroyed after 1h, or after 5m since the last
## time Authelia detected user activity.
# inactivity: '5m'
## The time before the session cookie expires and the session is destroyed if remember me IS NOT selected by the
## user.
# expiration: '1h'
## The time before the cookie expires and the session is destroyed if remember me IS selected by the user. Setting
2023-04-19 04:27:10 +00:00
## this value to -1 disables remember me for this session cookie domain. If allowed and the user uses the remember
## me checkbox this overrides the expiration option and disables the inactivity option.
2023-01-12 10:57:44 +00:00
# remember_me: '1M'
2023-05-08 03:51:17 +00:00
## Cookie Session Domain default 'name' value.
2023-01-12 10:57:44 +00:00
name : 'authelia_session'
2023-05-08 03:51:17 +00:00
## Cookie Session Domain default 'same_site' value.
2023-01-12 10:57:44 +00:00
same_site : 'lax'
2023-05-08 03:51:17 +00:00
## Cookie Session Domain default 'inactivity' value.
2023-01-12 10:57:44 +00:00
inactivity : '5m'
2021-02-21 23:07:06 +00:00
2023-05-08 03:51:17 +00:00
## Cookie Session Domain default 'expiration' value.
2023-01-12 10:57:44 +00:00
expiration : '1h'
2021-02-21 23:07:06 +00:00
2023-05-08 03:51:17 +00:00
## Cookie Session Domain default 'remember_me' value.
2023-01-12 10:57:44 +00:00
remember_me : '1M'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## Redis Provider
##
2022-06-15 07:51:47 +00:00
## Important: Kubernetes (or HA) users must read https://www.authelia.com/t/statelessness
2021-04-11 11:25:03 +00:00
##
2022-10-21 09:17:30 +00:00
# redis:
2023-05-07 06:39:17 +00:00
# host: '127.0.0.1'
2022-10-21 09:17:30 +00:00
# port: 6379
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## Use a unix socket instead
2023-05-07 06:39:17 +00:00
# host: '/var/run/redis/redis.sock'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
## Username used for redis authentication. This is optional and a new feature in redis 6.0.
2023-05-07 06:39:17 +00:00
# username: 'authelia'
2021-02-21 23:07:06 +00:00
2022-06-15 07:51:47 +00:00
## Password can also be set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
# password: 'authelia'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## This is the Redis DB Index https://redis.io/commands/select (sometimes referred to as database number, DB, etc).
2022-10-21 09:17:30 +00:00
# database_index: 0
2021-02-21 23:07:06 +00:00
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## The maximum number of concurrent active connections to Redis.
2022-10-21 09:17:30 +00:00
# maximum_active_connections: 8
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## The target number of idle connections to have open ready for work. Useful when opening connections is slow.
2022-10-21 09:17:30 +00:00
# minimum_idle_connections: 0
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## The Redis TLS configuration. If defined will require a TLS connection to the Redis instance(s).
# tls:
2022-10-22 08:27:59 +00:00
## The server subject name to check the servers certificate against during the validation process.
## This option is not required if the certificate has a SAN which matches the host option.
2023-05-07 06:39:17 +00:00
# server_name: 'myredis.example.com'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2022-10-22 08:27:59 +00:00
## Skip verifying the server certificate entirely. In preference to setting this we strongly recommend you add the
## certificate or the certificate of the authority signing the certificate to the certificates directory which is
## defined by the `certificates_directory` option at the top of the configuration.
## It's important to note the public key should be added to the directory, not the private key.
## This option is strongly discouraged but may be useful in some self-signed situations where validation is not
## important to the administrator.
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
# skip_verify: false
## Minimum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# minimum_version: 'TLS1.2'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2022-10-21 09:17:30 +00:00
## Maximum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# maximum_version: 'TLS1.3'
2022-10-21 09:17:30 +00:00
## The certificate chain used with the private_key if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
## The private key used with the certificate_chain if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# private_key: |
2023-04-19 04:27:10 +00:00
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END RSA PRIVATE KEY-----
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## The Redis HA configuration options.
## This provides specific options to Redis Sentinel, sentinel_name must be defined (Master Name).
# high_availability:
2021-04-11 11:25:03 +00:00
## Sentinel Name / Master Name.
2023-05-07 06:39:17 +00:00
# sentinel_name: 'mysentinel'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
2021-10-31 03:26:58 +00:00
## Specific username for Redis Sentinel. The node username and password is configured above.
2023-05-07 06:39:17 +00:00
# sentinel_username: 'sentinel_specific_user'
2021-10-31 03:26:58 +00:00
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## Specific password for Redis Sentinel. The node username and password is configured above.
2023-05-07 06:39:17 +00:00
# sentinel_password: 'sentinel_specific_pass'
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## The additional nodes to pre-seed the redis provider with (for sentinel).
## If the host in the above section is defined, it will be combined with this list to connect to sentinel.
## For high availability to be used you must have either defined; the host above or at least one node below.
# nodes:
2023-05-07 06:39:17 +00:00
# - host: 'sentinel-node1'
2022-10-21 09:17:30 +00:00
# port: 6379
2023-05-07 06:39:17 +00:00
# - host: 'sentinel-node2'
2022-10-21 09:17:30 +00:00
# port: 6379
feat(session): add redis sentinel provider (#1768)
* feat(session): add redis sentinel provider
* refactor(session): use int for ports as per go standards
* refactor(configuration): adjust tests and validation
* refactor(configuration): add err format consts
* refactor(configuration): explicitly map redis structs
* refactor(session): merge redis/redis sentinel providers
* refactor(session): add additional checks to redis providers
* feat(session): add redis cluster provider
* fix: update config for new values
* fix: provide nil certpool to affected tests/mocks
* test: add additional tests to cover uncovered code
* docs: expand explanation of host and nodes relation for redis
* ci: add redis-sentinel to suite highavailability, add redis-sentinel quorum
* fix(session): sentinel password
* test: use redis alpine library image for redis sentinel, use expose instead of ports, use redis ip, adjust redis ip range, adjust redis config
* test: make entrypoint.sh executable, fix entrypoint.sh if/elif
* test: add redis failover tests
* test: defer docker start, adjust sleep, attempt logout before login, attempt visit before login and tune timeouts, add additional logging
* test: add sentinel integration test
* test: add secondary node failure to tests, fix password usage, bump test timeout, add sleep
* feat: use sentinel failover cluster
* fix: renamed addrs to sentineladdrs upstream
* test(session): sentinel failover
* test: add redis standard back into testing
* test: move redis standalone test to traefik2
* fix/docs: apply suggestions from code review
2021-03-09 23:03:05 +00:00
## Choose the host with the lowest latency.
# route_by_latency: false
## Choose the host randomly.
# route_randomly: false
2021-04-11 11:25:03 +00:00
##
## Regulation Configuration
##
## This mechanism prevents attackers from brute forcing the first factor. It bans the user if too many attempts are made
## in a short period of time.
2021-02-21 23:07:06 +00:00
regulation :
2021-04-11 11:25:03 +00:00
## The number of failed login attempts before user is banned. Set it to 0 to disable regulation.
2021-02-21 23:07:06 +00:00
max_retries : 3
2023-05-08 03:51:17 +00:00
## The time range during which the user can attempt login before being banned in the duration common syntax. The user
## is banned if the authentication failed 'max_retries' times in a 'find_time' seconds window.
2023-05-07 06:39:17 +00:00
find_time : '2m'
2021-02-21 23:07:06 +00:00
2023-05-08 03:51:17 +00:00
## The length of time before a banned user can login again in the duration common syntax.
2023-05-07 06:39:17 +00:00
ban_time : '5m'
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## Storage Provider Configuration
##
## The available providers are: `local`, `mysql`, `postgres`. You must use one and only one of these providers.
2022-10-21 09:17:30 +00:00
# storage:
2021-11-25 01:56:58 +00:00
## The encryption key that is used to encrypt sensitive information in the database. Must be a string with a minimum
2022-11-25 12:44:55 +00:00
## length of 20. Please see the docs if you configure this with an undesirable key and need to change it, you MUST use
## the CLI to change this in the database if you want to change it from a previously configured value.
2023-05-07 06:39:17 +00:00
# encryption_key: 'you_must_generate_a_random_string_of_more_than_twenty_chars_and_configure_this'
2021-11-25 01:56:58 +00:00
2021-04-11 11:25:03 +00:00
##
## Local (Storage Provider)
##
## This stores the data in a SQLite3 Database.
## This is only recommended for lightweight non-stateful installations.
##
2022-06-15 07:51:47 +00:00
## Important: Kubernetes (or HA) users must read https://www.authelia.com/t/statelessness
2021-04-11 11:25:03 +00:00
##
# local:
2022-10-21 09:17:30 +00:00
## Path to the SQLite3 Database.
2023-05-07 06:39:17 +00:00
# path: '/config/db.sqlite3'
2021-04-11 11:25:03 +00:00
##
## MySQL / MariaDB (Storage Provider)
##
2022-10-21 09:17:30 +00:00
# mysql:
2023-05-07 06:39:17 +00:00
## The address of the MySQL server to connect to in the address common syntax.
## Format: [<scheme>://]<hostname>[:<port>].
## Square brackets indicate optional portions of the format. Scheme must be 'tcp', 'tcp4', 'tcp6', or 'unix`.
## The default scheme is 'unix' if the address is an absolute path otherwise it's 'tcp'. The default port is '3306'.
# address: 'tcp://127.0.0.1:3306'
## The database name to use.
# database: 'authelia'
## The username used for SQL authentication.
# username: 'authelia'
## The password used for SQL authentication.
## Can also be set using a secret: https://www.authelia.com/c/secrets
# password: 'mypassword'
## The connection timeout in the duration common syntax.
# timeout: '5s'
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## MySQL TLS settings. Configuring this requires TLS.
# tls:
## The server subject name to check the servers certificate against during the validation process.
2023-05-07 06:39:17 +00:00
## This option is not required if the certificate has a SAN which matches the address options hostname.
# server_name: 'mysql.example.com'
2022-10-22 08:27:59 +00:00
## Skip verifying the server certificate entirely. In preference to setting this we strongly recommend you add the
## certificate or the certificate of the authority signing the certificate to the certificates directory which is
## defined by the `certificates_directory` option at the top of the configuration.
## It's important to note the public key should be added to the directory, not the private key.
## This option is strongly discouraged but may be useful in some self-signed situations where validation is not
## important to the administrator.
# skip_verify: false
## Minimum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# minimum_version: 'TLS1.2'
2022-10-22 08:27:59 +00:00
## Maximum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# maximum_version: 'TLS1.3'
2022-10-22 08:27:59 +00:00
2022-10-22 20:42:19 +00:00
## The certificate chain used with the private_key if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-22 20:42:19 +00:00
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-22 20:42:19 +00:00
# -----END CERTIFICATE-----
## The private key used with the certificate_chain if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# private_key: |
2023-04-19 04:27:10 +00:00
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
2022-10-22 20:42:19 +00:00
# -----END RSA PRIVATE KEY-----
2022-10-22 08:27:59 +00:00
2021-04-11 11:25:03 +00:00
##
## PostgreSQL (Storage Provider)
##
2021-02-21 23:07:06 +00:00
# postgres:
2023-05-07 06:39:17 +00:00
## The address of the PostgreSQL server to connect to in the address common syntax.
## Format: [<scheme>://]<hostname>[:<port>].
## Square brackets indicate optional portions of the format. Scheme must be 'tcp', 'tcp4', 'tcp6', or 'unix`.
## The default scheme is 'unix' if the address is an absolute path otherwise it's 'tcp'. The default port is '5432'.
# address: 'tcp://127.0.0.1:5432'
## The database name to use.
# database: 'authelia'
## The schema name to use.
# schema: 'public'
## The username used for SQL authentication.
# username: 'authelia'
## The password used for SQL authentication.
## Can also be set using a secret: https://www.authelia.com/c/secrets
# password: 'mypassword'
## The connection timeout in the duration common syntax.
# timeout: '5s'
2022-10-22 08:27:59 +00:00
## PostgreSQL TLS settings. Configuring this requires TLS.
# tls:
## The server subject name to check the servers certificate against during the validation process.
2023-05-07 06:39:17 +00:00
## This option is not required if the certificate has a SAN which matches the address options hostname.
# server_name: 'postgres.example.com'
2022-10-22 08:27:59 +00:00
## Skip verifying the server certificate entirely. In preference to setting this we strongly recommend you add the
## certificate or the certificate of the authority signing the certificate to the certificates directory which is
## defined by the `certificates_directory` option at the top of the configuration.
## It's important to note the public key should be added to the directory, not the private key.
## This option is strongly discouraged but may be useful in some self-signed situations where validation is not
## important to the administrator.
# skip_verify: false
## Minimum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# minimum_version: 'TLS1.2'
2022-10-22 08:27:59 +00:00
## Maximum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# maximum_version: 'TLS1.3'
2022-10-22 08:27:59 +00:00
## The certificate chain used with the private_key if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-22 08:27:59 +00:00
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-22 08:27:59 +00:00
# -----END CERTIFICATE-----
## The private key used with the certificate_chain if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# private_key: |
2023-04-19 04:27:10 +00:00
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
# -----END RSA PRIVATE KEY-----
2021-02-21 23:07:06 +00:00
2021-04-11 11:25:03 +00:00
##
## Notification Provider
##
2023-04-14 16:04:42 +00:00
## Notifications are sent to users when they require a password reset, a WebAuthn registration or a TOTP registration.
2021-04-11 11:25:03 +00:00
## The available providers are: filesystem, smtp. You must use only one of these providers.
2021-02-21 23:07:06 +00:00
notifier :
2021-04-11 11:25:03 +00:00
## You can disable the notifier startup check by setting this to true.
2021-02-21 23:07:06 +00:00
disable_startup_check : false
2021-04-11 11:25:03 +00:00
##
## File System (Notification Provider)
##
2022-06-15 07:51:47 +00:00
## Important: Kubernetes (or HA) users must read https://www.authelia.com/t/statelessness
2021-04-11 11:25:03 +00:00
##
# filesystem:
2023-05-07 06:39:17 +00:00
# filename: '/config/notification.txt'
2021-04-11 11:25:03 +00:00
##
## SMTP (Notification Provider)
##
## Use a SMTP server for sending notifications. Authelia uses the PLAIN or LOGIN methods to authenticate.
## [Security] By default Authelia will:
## - force all SMTP connections over TLS including unauthenticated connections
## - use the disable_require_tls boolean value to disable this requirement
## (only works for unauthenticated connections)
## - validate the SMTP server x509 certificate during the TLS handshake against the hosts trusted certificates
## (configure in tls section)
2022-10-21 09:17:30 +00:00
# smtp:
2023-05-07 06:39:17 +00:00
## The address of the SMTP server to connect to in the address common syntax.
# address: 'smtp://127.0.0.1:25'
2021-08-10 00:52:41 +00:00
2023-05-07 06:39:17 +00:00
## The connection timeout in the duration common syntax.
# timeout: '5s'
2021-08-10 00:52:41 +00:00
## The username used for SMTP authentication.
2023-05-07 06:39:17 +00:00
# username: 'test'
2021-08-10 00:52:41 +00:00
## The password used for SMTP authentication.
2022-06-15 07:51:47 +00:00
## Can also be set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
# password: 'password'
2021-08-10 00:52:41 +00:00
2021-11-30 11:15:21 +00:00
## The sender is used to is used for the MAIL FROM command and the FROM header.
## If this is not defined and the username is an email, we use the username as this value. This can either be just
## an email address or the RFC5322 'Name <email address>' format.
2023-05-07 06:39:17 +00:00
# sender: 'Authelia <admin@example.com>'
2021-08-10 00:52:41 +00:00
2021-04-11 11:25:03 +00:00
## HELO/EHLO Identifier. Some SMTP Servers may reject the default of localhost.
2023-05-07 06:39:17 +00:00
# identifier: 'localhost'
2021-08-10 00:52:41 +00:00
2021-04-11 11:25:03 +00:00
## Subject configuration of the emails sent. {title} is replaced by the text from the notifier.
2023-05-07 06:39:17 +00:00
# subject: '[Authelia] {title}'
2021-08-10 00:52:41 +00:00
2021-04-11 11:25:03 +00:00
## This address is used during the startup check to verify the email configuration is correct.
## It's not important what it is except if your email server only allows local delivery.
2023-05-07 06:39:17 +00:00
# startup_check_address: 'test@authelia.com'
2021-08-10 00:52:41 +00:00
## By default we require some form of TLS. This disables this check though is not advised.
2022-10-21 09:17:30 +00:00
# disable_require_tls: false
2021-08-10 00:52:41 +00:00
## Disables sending HTML formatted emails.
2022-10-21 09:17:30 +00:00
# disable_html_emails: false
2021-02-21 23:07:06 +00:00
2022-10-21 09:17:30 +00:00
# tls:
2022-10-22 08:27:59 +00:00
## The server subject name to check the servers certificate against during the validation process.
2023-05-07 06:39:17 +00:00
## This option is not required if the certificate has a SAN which matches the address options hostname.
# server_name: 'smtp.example.com'
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## Skip verifying the server certificate entirely. In preference to setting this we strongly recommend you add the
## certificate or the certificate of the authority signing the certificate to the certificates directory which is
## defined by the `certificates_directory` option at the top of the configuration.
## It's important to note the public key should be added to the directory, not the private key.
## This option is strongly discouraged but may be useful in some self-signed situations where validation is not
## important to the administrator.
2022-10-21 09:17:30 +00:00
# skip_verify: false
2021-02-21 23:07:06 +00:00
2022-10-22 08:27:59 +00:00
## Minimum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# minimum_version: 'TLS1.2'
2022-10-21 09:17:30 +00:00
2022-10-22 08:27:59 +00:00
## Maximum TLS version for the connection.
2023-05-07 06:39:17 +00:00
# maximum_version: 'TLS1.3'
2022-10-21 09:17:30 +00:00
## The certificate chain used with the private_key if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
2023-04-19 04:27:10 +00:00
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END CERTIFICATE-----
## The private key used with the certificate_chain if the server requests TLS Client Authentication
## i.e. Mutual TLS.
# private_key: |
2023-04-19 04:27:10 +00:00
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END RSA PRIVATE KEY-----
2021-02-21 23:07:06 +00:00
2021-05-04 22:06:05 +00:00
##
## Identity Providers
##
# identity_providers:
##
## OpenID Connect (Identity Provider)
##
## It's recommended you read the documentation before configuration of this section:
2022-06-15 07:51:47 +00:00
## https://www.authelia.com/c/oidc
2021-05-04 22:06:05 +00:00
# oidc:
## The hmac_secret is used to sign OAuth2 tokens (authorization code, access tokens and refresh tokens).
2022-06-15 07:51:47 +00:00
## HMAC Secret can also be set using a secret: https://www.authelia.com/c/secrets
2023-05-07 06:39:17 +00:00
# hmac_secret: 'this_is_a_secret_abc123abc123abc'
2021-05-04 22:06:05 +00:00
2023-04-19 04:27:10 +00:00
## Issuer JWKS configures multiple JSON Web Keys. It's required that at least one of these is RS256 or the
## option issuer_private_key is configured. There must only be one key per algorithm at this time.
## For RSA keys the minimum is a 2048 bit key.
# issuer_private_keys:
# -
## Key ID embedded into the JWT header for key matching. Must be an alphanumeric string with 7 or less characters.
## This value is automatically generated if not provided. It's recommended to not configure this.
# key_id: 'example'
## The key algorithm used with this key.
# algorithm: 'RS256'
## The key use expected with this key. Currently only 'sig' is supported.
# use: 'sig'
## Required Private Key in PEM DER form.
# key: |
# -----BEGIN RSA PRIVATE KEY-----
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
# -----END RSA PRIVATE KEY-----
2022-10-02 02:07:40 +00:00
2023-04-19 04:27:10 +00:00
## Optional matching certificate chain in PEM DER form that matches the key. All certificates within the chain
## must be valid and current, and from top to bottom each certificate must be signed by the subsequent one.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
# -----END CERTIFICATE-----
## The issuer_private_key is used to sign the JWT forged by OpenID Connect. This is in addition to the
## issuer_private_keys option. Assumed to use the RS256 algorithm, and must not be specified if any of the
## keys in issuer_private_keys also has the algorithm RS256 or are an RSA key without an algorithm.
2022-06-15 07:51:47 +00:00
## Issuer Private Key can also be set using a secret: https://www.authelia.com/c/secrets
2021-05-04 22:06:05 +00:00
# issuer_private_key: |
2022-10-21 09:17:30 +00:00
# -----BEGIN RSA PRIVATE KEY-----
2023-04-19 04:27:10 +00:00
# MIIBPAIBAAJBAK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZF
# p7aTcToHMf00z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAQJBAJdpB0+RQ9ZFwy9Uk38P
# 5zZpUB8cL8ZFeEFluQeVbt0vyNa+cPLvDLouY87onduXtMz5AKIatLaTOjuG2thh
# SKECIQDY6G8gvsYJdXCE9UJ7ukoLrRHxt/frhAtmSY5lVAPuMwIhAMzuDrJo73LH
# ZyEaqIXc5pIiX3Sag43csPDHfuXdtT2NAiEAhyRKGJzDxiDlefFU+sGWYK/z/iYg
# 0Rvz/kbV8UvnJwECIQDAYN6VJ6NZmc27qv33JIejOfdoTEEhZMMKVg1PlxE0ZQIg
# HFpJiFxZES3QvVPr8deBXORPurqD5uU85NKsf61AdRsDO_NOT_USE=
2022-10-21 09:17:30 +00:00
# -----END RSA PRIVATE KEY-----
2021-05-04 22:06:05 +00:00
2023-04-19 04:27:10 +00:00
## Optional matching certificate chain in PEM DER form that matches the issuer_private_key. All certificates within
## the chain must be valid and current, and from top to bottom each certificate must be signed by the next
## certificate in the chain if provided.
# issuer_certificate_chain: |
# -----BEGIN CERTIFICATE-----
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
# -----END CERTIFICATE-----
2023-05-08 03:51:17 +00:00
## The lifespans configure the expiration for these token types in the duration common syntax.
2023-05-07 06:39:17 +00:00
# access_token_lifespan: '1h'
# authorize_code_lifespan: '1m'
# id_token_lifespan: '1h'
# refresh_token_lifespan: '90m'
feat(oidc): add additional config options, accurate token times, and refactoring (#1991)
* This gives admins more control over their OIDC installation exposing options that had defaults before. Things like lifespans for authorize codes, access tokens, id tokens, refresh tokens, a option to enable the debug client messages, minimum parameter entropy. It also allows admins to configure the response modes.
* Additionally this records specific values about a users session indicating when they performed a specific authz factor so this is represented in the token accurately.
* Lastly we also implemented a OIDC key manager which calculates the kid for jwk's using the SHA1 digest instead of being static, or more specifically the first 7 chars. As per https://datatracker.ietf.org/doc/html/draft-ietf-jose-json-web-key#section-8.1.1 the kid should not exceed 8 chars. While it's allowed to exceed 8 chars, it must only be done so with a compelling reason, which we do not have.
2021-07-03 23:44:30 +00:00
## Enables additional debug messages.
# enable_client_debug_messages: false
2022-06-17 11:03:47 +00:00
## SECURITY NOTICE: It's not recommended changing this option and values below 8 are strongly discouraged.
feat(oidc): add additional config options, accurate token times, and refactoring (#1991)
* This gives admins more control over their OIDC installation exposing options that had defaults before. Things like lifespans for authorize codes, access tokens, id tokens, refresh tokens, a option to enable the debug client messages, minimum parameter entropy. It also allows admins to configure the response modes.
* Additionally this records specific values about a users session indicating when they performed a specific authz factor so this is represented in the token accurately.
* Lastly we also implemented a OIDC key manager which calculates the kid for jwk's using the SHA1 digest instead of being static, or more specifically the first 7 chars. As per https://datatracker.ietf.org/doc/html/draft-ietf-jose-json-web-key#section-8.1.1 the kid should not exceed 8 chars. While it's allowed to exceed 8 chars, it must only be done so with a compelling reason, which we do not have.
2021-07-03 23:44:30 +00:00
# minimum_parameter_entropy: 8
2022-03-02 04:44:05 +00:00
## SECURITY NOTICE: It's not recommended changing this option, and highly discouraged to have it set to 'never'
## for security reasons.
2023-05-07 06:39:17 +00:00
# enforce_pkce: 'public_clients_only'
2022-03-02 04:44:05 +00:00
2022-04-07 00:58:51 +00:00
## Cross-Origin Resource Sharing (CORS) settings.
# cors:
## List of endpoints in addition to the metadata endpoints to permit cross-origin requests on.
# endpoints:
2023-05-07 06:39:17 +00:00
# - 'authorization'
# - 'token'
# - 'revocation'
# - 'introspection'
# - 'userinfo'
2022-04-07 00:58:51 +00:00
## List of allowed origins.
## Any origin with https is permitted unless this option is configured or the
## allowed_origins_from_client_redirect_uris option is enabled.
# allowed_origins:
2023-05-07 06:39:17 +00:00
# - 'https://example.com'
2022-04-07 00:58:51 +00:00
## Automatically adds the origin portion of all redirect URI's on all clients to the list of allowed_origins,
## provided they have the scheme http or https and do not have the hostname of localhost.
# allowed_origins_from_client_redirect_uris: false
2021-05-04 22:06:05 +00:00
## Clients is a list of known clients and their configuration.
# clients:
# -
## The ID is the OpenID Connect ClientID which is used to link an application to a configuration.
2023-05-07 06:39:17 +00:00
# id: 'myapp'
2021-05-04 22:06:05 +00:00
## The description to show to users when they end up on the consent screen. Defaults to the ID above.
2023-05-07 06:39:17 +00:00
# description: 'My Application'
2021-05-04 22:06:05 +00:00
## The client secret is a shared secret between Authelia and the consumer of this client.
2023-05-07 06:39:17 +00:00
# yamllint disable-line rule:line-length
# secret: '$pbkdf2-sha512$310000$c8p78n7pUMln0jzvd4aK4Q$JNRBzwAo0ek5qKn50cFzzvE9RXV88h1wJn5KGiHrD0YKtZaR/nCb2CJPOsKaPK0hjf.9yHxzQGZziziccp6Yng' # The digest of 'insecure_secret'.
2021-05-04 22:06:05 +00:00
2022-04-07 06:13:01 +00:00
## Sector Identifiers are occasionally used to generate pairwise subject identifiers. In most cases this is not
## necessary. Read the documentation for more information.
## The subject identifier must be the host component of a URL, which is a domain name with an optional port.
2023-05-07 06:39:17 +00:00
# sector_identifier: 'example.com'
2022-04-07 06:13:01 +00:00
2021-07-15 11:02:03 +00:00
## Sets the client to public. This should typically not be set, please see the documentation for usage.
# public: false
2023-01-03 15:03:23 +00:00
## Redirect URI's specifies a list of valid case-sensitive callbacks for this client.
# redirect_uris:
2023-05-07 06:39:17 +00:00
# - 'https://oidc.example.com:8080/oauth2/callback'
2022-04-08 05:35:21 +00:00
2021-07-15 11:02:03 +00:00
## Audience this client is allowed to request.
# audience: []
## Scopes this client is allowed to request.
# scopes:
2023-05-07 06:39:17 +00:00
# - 'openid'
# - 'groups'
# - 'email'
# - 'profile'
2021-07-15 11:02:03 +00:00
2023-04-19 04:27:10 +00:00
## Grant Types configures which grants this client can obtain.
## It's not recommended to define this unless you know what you're doing.
# grant_types:
# - 'authorization_code'
2021-05-04 22:06:05 +00:00
## Response Types configures which responses this client can be sent.
## It's not recommended to define this unless you know what you're doing.
# response_types:
2023-05-07 06:39:17 +00:00
# - 'code'
feat(oidc): add additional config options, accurate token times, and refactoring (#1991)
* This gives admins more control over their OIDC installation exposing options that had defaults before. Things like lifespans for authorize codes, access tokens, id tokens, refresh tokens, a option to enable the debug client messages, minimum parameter entropy. It also allows admins to configure the response modes.
* Additionally this records specific values about a users session indicating when they performed a specific authz factor so this is represented in the token accurately.
* Lastly we also implemented a OIDC key manager which calculates the kid for jwk's using the SHA1 digest instead of being static, or more specifically the first 7 chars. As per https://datatracker.ietf.org/doc/html/draft-ietf-jose-json-web-key#section-8.1.1 the kid should not exceed 8 chars. While it's allowed to exceed 8 chars, it must only be done so with a compelling reason, which we do not have.
2021-07-03 23:44:30 +00:00
## Response Modes configures which response modes this client supports.
# response_modes:
2023-05-07 06:39:17 +00:00
# - 'form_post'
# - 'query'
2023-04-13 10:58:18 +00:00
2023-04-19 04:27:10 +00:00
## The policy to require for this client; one_factor or two_factor.
# authorization_policy: 'two_factor'
2021-07-10 04:56:33 +00:00
2023-04-19 04:27:10 +00:00
## The consent mode controls how consent is obtained.
# consent_mode: 'auto'
2023-04-15 10:55:38 +00:00
2023-04-19 04:27:10 +00:00
## This value controls the duration a consent on this client remains remembered when the consent mode is
## configured as 'auto' or 'pre-configured' in the duration common syntax.
# pre_configured_consent_duration: '1w'
2023-04-15 10:55:38 +00:00
2023-04-19 04:27:10 +00:00
## Enforces the use of Pushed Authorization Requests for this client when set to true.
# enforce_par: false
2023-01-03 15:03:23 +00:00
## Enforces the use of PKCE for this client when set to true.
# enforce_pkce: false
## Enforces the use of PKCE for this client when configured, and enforces the specified challenge method.
## Options are 'plain' and 'S256'.
2023-05-07 06:39:17 +00:00
# pkce_challenge_method: 'S256'
2023-01-03 15:03:23 +00:00
2023-04-19 04:27:10 +00:00
## The permitted client authentication method for the Token Endpoint for this client.
# token_endpoint_auth_method: 'client_secret_basic'
## The permitted client authentication signing algorithm for the Token Endpoint for this client when using
## the 'client_secret_jwt' or 'private_key_jwt' token_endpoint_auth_method.
# token_endpoint_auth_signing_alg: 'RS256'
## The signing algorithm which must be used for request objects. A client JWK with a matching algorithm must be
## included if configured.
# request_object_signing_alg: 'RS256'
## The signing algorithm used for ID Tokens. Am issuer JWK with a matching algorithm must be included.
# id_token_signing_alg: 'RS256'
2021-07-10 04:56:33 +00:00
## The algorithm used to sign userinfo endpoint responses for this client, either none or RS256.
2023-05-11 06:45:20 +00:00
# userinfo_signing_alg: 'none'
2023-01-03 15:03:23 +00:00
2023-04-19 04:27:10 +00:00
## Trusted public keys configuration for request object signing for things such as private_key_jwt
# public_keys:
## URL of the HTTPS endpoint which serves the keys. It's recommended to manually configure them in the
## values option below. Please note the URL and the individual values are mutually exclusive.
# uri: 'https://app.example.com/jwks.json'
## Values from the individual keys.
# values:
# -
## Key ID used to match the JWT's to an individual identifier. This option is required if configured.
# key_id: 'example'
## The key algorithm expected with this key.
# algorithm: 'RS256'
## The key use expected with this key. Currently only 'sig' is supported.
# use: 'sig'
## Required Public Key in PEM DER form.
# key: |
# -----BEGIN RSA PUBLIC KEY-----
# MEgCQQDAwV26ZA1lodtOQxNrJ491gWT+VzFum9IeZ+WTmMypYWyW1CzXKwsvTHDz
# 9ec+jserR3EMQ0Rr24lj13FL1ib5AgMBAAE=
# -----END RSA PUBLIC KEY----
## The matching certificate chain in PEM DER form that matches the key if available.
# certificate_chain: |
# -----BEGIN CERTIFICATE-----
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
# -----END CERTIFICATE-----
# -----BEGIN CERTIFICATE-----
# MIIBWzCCAQWgAwIBAgIQYAKsXhJOXKfyySlmpKicTzANBgkqhkiG9w0BAQsFADAT
# MREwDwYDVQQKEwhBdXRoZWxpYTAeFw0yMzA0MjEwMDA3NDRaFw0yNDA0MjAwMDA3
# NDRaMBMxETAPBgNVBAoTCEF1dGhlbGlhMFwwDQYJKoZIhvcNAQEBBQADSwAwSAJB
# AK2i7RlJEYo/Xa6mQmv9zmT0XUj3DcEhRJGPVw2qMyadUFxNg/ZFp7aTcToHMf00
# z6T3b7mwdBkCFQOL3Kb7WRcCAwEAAaM1MDMwDgYDVR0PAQH/BAQDAgWgMBMGA1Ud
# JQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADQQB8
# Of2iM7fPadmtChCMna8lYWH+lEplj6BxOJlRuGRawxszLwi78bnq0sCR33LU6xMx
# 1oAPwIHNaJJwC4z6oG9E_DO_NOT_USE=
# -----END CERTIFICATE-----
2021-04-11 11:25:03 +00:00
...