2021-04-11 11:25:03 +00:00
|
|
|
# yamllint disable rule:comments-indentation
|
|
|
|
---
|
|
|
|
###############################################################################
|
|
|
|
# Authelia Configuration #
|
|
|
|
###############################################################################
|
2017-01-22 16:54:45 +00:00
|
|
|
|
2021-12-02 04:50:05 +00:00
|
|
|
## Note: the container by default expects to find this file at /config/configuration.yml.
|
|
|
|
|
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.
|
2021-11-15 08:37:58 +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
|
|
|
|
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
|
|
|
## The theme to display: light, dark, grey, auto.
|
2021-01-20 12:07:40 +00:00
|
|
|
theme: light
|
|
|
|
|
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
|
2021-08-02 11:55:30 +00:00
|
|
|
jwt_secret: a_very_important_secret
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
default_redirection_url: https://home.example.com/
|
|
|
|
|
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.
|
|
|
|
default_2fa_method: ""
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
##
|
|
|
|
## Server Configuration
|
|
|
|
##
|
2020-04-30 02:03:05 +00:00
|
|
|
server:
|
2021-08-03 09:55:21 +00:00
|
|
|
|
2021-08-02 11:55:30 +00:00
|
|
|
## The address to listen on.
|
|
|
|
host: 0.0.0.0
|
|
|
|
|
|
|
|
## The port to listen on.
|
|
|
|
port: 9091
|
|
|
|
|
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.
|
|
|
|
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.
|
|
|
|
# asset_path: /config/assets/
|
|
|
|
|
2021-06-01 04:09:50 +00:00
|
|
|
## Enables the pprof endpoint.
|
|
|
|
enable_pprof: false
|
|
|
|
|
|
|
|
## Enables the expvars endpoint.
|
|
|
|
enable_expvars: false
|
|
|
|
|
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.
|
|
|
|
key: ""
|
|
|
|
|
|
|
|
## The path to the DER base64/PEM format public certificate.
|
|
|
|
certificate: ""
|
|
|
|
|
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.
|
|
|
|
csp_template: ""
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
## Read timeout.
|
2022-10-07 02:52:01 +00:00
|
|
|
# read: 6s
|
2022-08-08 21:50:12 +00:00
|
|
|
|
|
|
|
## Write timeout.
|
2022-10-07 02:52:01 +00:00
|
|
|
# write: 6s
|
2022-08-08 21:50:12 +00:00
|
|
|
|
|
|
|
## Idle timeout.
|
|
|
|
# idle: 30s
|
|
|
|
|
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.
|
2021-06-01 04:09:50 +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.
|
|
|
|
# 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.
|
|
|
|
# file_path: /config/authelia.log
|
2017-01-22 17:18:19 +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
|
|
|
|
|
|
|
|
## The address to listen on for metrics. This should be on a different port to the main server.port value.
|
2022-07-05 04:43:12 +00:00
|
|
|
address: tcp://0.0.0.0: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:
|
|
|
|
|
|
|
|
## Read timeout.
|
2022-10-07 02:52:01 +00:00
|
|
|
# read: 6s
|
2022-08-08 21:50:12 +00:00
|
|
|
|
|
|
|
## Write timeout.
|
2022-10-07 02:52:01 +00:00
|
|
|
# write: 6s
|
2022-08-08 21:50:12 +00:00
|
|
|
|
|
|
|
## Idle timeout.
|
|
|
|
# idle: 30s
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
##
|
|
|
|
## TOTP Configuration
|
|
|
|
##
|
|
|
|
## Parameters used for TOTP generation.
|
2018-08-19 08:59:47 +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.
|
2018-08-19 08:59:47 +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
|
2021-12-01 12:11:29 +00:00
|
|
|
algorithm: sha1
|
|
|
|
|
|
|
|
## 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.
|
2020-03-25 01:48:20 +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.
|
2020-03-25 01:48:20 +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.
|
2018-08-19 08:59:47 +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:
|
|
|
|
## Disable Webauthn.
|
|
|
|
disable: false
|
|
|
|
|
|
|
|
## Adjust the interaction timeout for Webauthn dialogues.
|
|
|
|
timeout: 60s
|
|
|
|
|
|
|
|
## The display name the browser should show the user for when using Webauthn to login/register.
|
|
|
|
display_name: Authelia
|
|
|
|
|
|
|
|
## Conveyance preference controls if we collect the attestation statement including the AAGUID from the device.
|
|
|
|
## Options are none, indirect, direct.
|
|
|
|
attestation_conveyance_preference: indirect
|
|
|
|
|
|
|
|
## User verification controls if the user must make a gesture or action to confirm they are present.
|
|
|
|
## Options are required, preferred, discouraged.
|
|
|
|
user_verification: preferred
|
|
|
|
|
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
|
|
|
|
# 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
|
2022-10-21 09:17:30 +00:00
|
|
|
# secret_key: 1234567890abcdefghifjkl
|
|
|
|
# enable_self_enrollment: false
|
2019-03-24 14:15:49 +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:
|
|
|
|
## NTP server address.
|
|
|
|
address: "time.cloudflare.com:123"
|
|
|
|
|
|
|
|
## NTP version.
|
|
|
|
version: 4
|
|
|
|
|
|
|
|
## Maximum allowed time offset between the host and the NTP server.
|
|
|
|
max_desync: 3s
|
|
|
|
|
|
|
|
## 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.
|
2018-08-26 08:30:43 +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.
|
|
|
|
custom_url: ""
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The amount of time to wait before we refresh data from the authentication backend. Uses duration notation.
|
|
|
|
## 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
|
|
|
## Duration Notation docs: https://www.authelia.com/c/common#duration-notation-format
|
|
|
|
## Refresh Interval docs: https://www.authelia.com/c/1fa#refresh-interval
|
2020-05-04 19:39:25 +00:00
|
|
|
refresh_interval: 5m
|
|
|
|
|
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:
|
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:
|
|
|
|
## - 'activedirectory' - For Microsoft Active Directory.
|
|
|
|
## - 'custom' - For custom specifications of attributes and filters.
|
|
|
|
## 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
|
2022-10-21 09:17:30 +00:00
|
|
|
# implementation: custom
|
2020-11-27 09:59:22 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The url to the ldap server. Format: <scheme>://<address>[:<port>].
|
|
|
|
## Scheme can be ldap or ldaps in the format (port optional).
|
2022-10-21 09:17:30 +00:00
|
|
|
# url: ldap://127.0.0.1
|
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:30:00 +00:00
|
|
|
## The dial timeout for LDAP.
|
2022-10-21 09:17:30 +00:00
|
|
|
# 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
|
2020-12-03 05:23:52 +00:00
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
# tls:
|
2021-04-11 11:25:03 +00:00
|
|
|
## Server Name for certificate validation (in case it's not set correctly in the URL).
|
2021-01-04 10:28:55 +00:00
|
|
|
# server_name: ldap.example.com
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## Skip verifying the server certificate (to allow a self-signed certificate).
|
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
|
|
|
## In preference to setting this we strongly recommend you add the public portion of the certificate to the
|
|
|
|
## certificates directory which is defined by the `certificates_directory` option at the top of the config.
|
2022-10-21 09:17:30 +00:00
|
|
|
# skip_verify: false
|
2021-01-04 10:28:55 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## Minimum TLS version for either Secure LDAP or LDAP StartTLS.
|
2022-10-21 09:17:30 +00:00
|
|
|
# minimum_version: TLS1.2
|
2020-12-03 05:23:52 +00:00
|
|
|
|
2022-10-21 08:41:33 +00:00
|
|
|
## Maximum TLS version for either Secure LDAP or LDAP StartTLS.
|
2022-10-21 09:17:30 +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-----
|
|
|
|
# MIIC5jCCAc6gAwIBAgIRAK4Sj7FiN6PXo/urPfO4E7owDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAPKv3pSyP4ozGEiVLJ14dIWFCEGEgq7WUMI0SZZqQA2ID0L59U/Q
|
|
|
|
# /Usyy7uC9gfMUzODTpANtkOjFQcQAsxlR1FOjVBrX5QgjSvXwbQn3DtwMA7XWSl6
|
|
|
|
# LuYx2rBYSlMSN5UZQm/RxMtXfLK2b51WgEEYDFi+nECSqKzR4R54eOPkBEWRfvuY
|
|
|
|
# 91AMjlhpivg8e4JWkq4LVQUKbmiFYwIdK8XQiN4blY9WwXwJFYs5sQ/UYMwBFi0H
|
|
|
|
# kWOh7GEjfxgoUOPauIueZSMSlQp7zqAH39N0ZSYb6cS0Npj57QoWZSY3ak87ebcR
|
|
|
|
# Nf4rCvZLby7LoN7qYCKxmCaDD3x2+NYpWH8CAwEAAaM1MDMwDgYDVR0PAQH/BAQD
|
|
|
|
# AgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcN
|
|
|
|
# AQELBQADggEBAHSITqIQSNzonFl3DzxHPEzr2hp6peo45buAAtu8FZHoA+U7Icfh
|
|
|
|
# /ZXjPg7Xz+hgFwM/DTNGXkMWacQA/PaNWvZspgRJf2AXvNbMSs2UQODr7Tbv+Fb4
|
|
|
|
# lyblmMUNYFMCFVAMU0eIxXAFq2qcwv8UMcQFT0Z/35s6PVOakYnAGGQjTfp5Ljuq
|
|
|
|
# wsdc/xWmM0cHWube6sdRRUD7SY20KU/kWzl8iFO0VbSSrDf1AlEhnLEkp1SPaxXg
|
|
|
|
# OdBnl98MeoramNiJ7NT6Jnyb3zZ578fjaWfThiBpagItI8GZmG4s4Ovh2JbheN8i
|
|
|
|
# ZsjNr9jqHTjhyLVbDRlmJzcqoj4JhbKs6/I^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIDBDCCAeygAwIBAgIRALJsPg21kA0zY4F1wUCIuoMwDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAMXHBvVxUzYk0u34/DINMSF+uiOekKOAjOrC6Mi9Ww8ytPVO7t2S
|
|
|
|
# zfTvM+XnEJqkFQFgimERfG/eGhjF9XIEY6LtnXe8ATvOK4nTwdufzBaoeQu3Gd50
|
|
|
|
# 5VXr6OHRo//ErrGvFXwP3g8xLePABsi/fkH3oDN+ztewOBMDzpd+KgTrk8ysv2ou
|
|
|
|
# kNRMKFZZqASvCgv0LD5KWvUCnL6wgf1oTXG7aztduA4oSkUP321GpOmBC5+5ElU7
|
|
|
|
# ysoRzvD12o9QJ/IfEaulIX06w9yVMo60C/h6A3U6GdkT1SiyTIqR7v7KU/IWd/Qi
|
|
|
|
# Lfftcj91VhCmJ73Meff2e2S2PrpjdXbG5FMCAwEAAaNTMFEwDgYDVR0PAQH/BAQD
|
|
|
|
# AgKkMA8GA1UdJQQIMAYGBFUdJQAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
|
|
|
|
# Z7AtA3mzFc0InSBA5fiMfeLXA3owDQYJKoZIhvcNAQELBQADggEBAEE5hm1mtlk/
|
|
|
|
# kviCoHH4evbpw7rxPxDftIQlqYTtvMM4eWY/6icFoSZ4fUHEWYyps8SsPu/8f2tf
|
|
|
|
# 71LGgZn0FdHi1QU2H8m0HHK7TFw+5Q6RLrLdSyk0PItJ71s9en7r8pX820nAFEHZ
|
|
|
|
# HkOSfJZ7B5hFgUDkMtVM6bardXAhoqcMk4YCU96e9d4PB4eI+xGc+mNuYvov3RbB
|
|
|
|
# D0s8ICyojeyPVLerz4wHjZu68Z5frAzhZ68YbzNs8j2fIBKKHkHyLG1iQyF+LJVj
|
|
|
|
# 2PjCP+auJsj6fQQpMGoyGtpLcSDh+ptcTngUD8JsWipzTCjmaNqdPHAOYmcgtf4b
|
|
|
|
# qocikt3WAdU^invalid DO NOT USE=
|
|
|
|
# -----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: |
|
2022-10-21 09:17:30 +00:00
|
|
|
# -----BEGIN RSA PRIVATE KEY-----
|
|
|
|
# MIIEpAIBAAKCAQEA8q/elLI/ijMYSJUsnXh0hYUIQYSCrtZQwjRJlmpADYgPQvn1
|
|
|
|
# T9D9SzLLu4L2B8xTM4NOkA22Q6MVBxACzGVHUU6NUGtflCCNK9fBtCfcO3AwDtdZ
|
|
|
|
# KXou5jHasFhKUxI3lRlCb9HEy1d8srZvnVaAQRgMWL6cQJKorNHhHnh44+QERZF+
|
|
|
|
# +5j3UAyOWGmK+Dx7glaSrgtVBQpuaIVjAh0rxdCI3huVj1bBfAkVizmxD9RgzAEW
|
|
|
|
# LQeRY6HsYSN/GChQ49q4i55lIxKVCnvOoAff03RlJhvpxLQ2mPntChZlJjdqTzt5
|
|
|
|
# txE1/isK9ktvLsug3upgIrGYJoMPfHb41ilYfwIDAQABAoIBAQDTOdFf2JjHH1um
|
|
|
|
# aPgRAvNf9v7Nj5jytaRKs5nM6iNf46ls4QPreXnMhqSeSwj6lpNgBYxOgzC9Q+cc
|
|
|
|
# Y4ob/paJJPaIJTxmP8K/gyWcOQlNToL1l+eJ20eQoZm23NGr5fIsunSBwLEpTrdB
|
|
|
|
# ENqqtcwhW937K8Pxy/Q1nuLyU2bc6Tn/ivLozc8n27dpQWWKh8537VY7ancIaACr
|
|
|
|
# LJJLYxKqhQpjtBWAyCDvZQirnAOm9KnvIHaGXIswCZ4Xbsu0Y9NL+woARPyRVQvG
|
|
|
|
# jfxy4EmO9s1s6y7OObSukwKDSNihAKHx/VIbvVWx8g2Lv5fGOa+J2Y7o9Qurs8t5
|
|
|
|
# BQwMTt0BAoGBAPUw5Z32EszNepAeV3E2mPFUc5CLiqAxagZJuNDO2pKtyN29ETTR
|
|
|
|
# Ma4O1cWtGb6RqcNNN/Iukfkdk27Q5nC9VJSUUPYelOLc1WYOoUf6oKRzE72dkMQV
|
|
|
|
# R4bf6TkjD+OVR17fAfkswkGahZ5XA7j48KIQ+YC4jbnYKSxZTYyKPjH/AoGBAP1i
|
|
|
|
# tqXt36OVlP+y84wWqZSjMelBIVa9phDVGJmmhz3i1cMni8eLpJzWecA3pfnG6Tm9
|
|
|
|
# ze5M4whASleEt+M00gEvNaU9ND+z0wBfi+/DwJYIbv8PQdGrBiZFrPhTPjGQUldR
|
|
|
|
# lXccV2meeLZv7TagVxSi3DO6dSJfSEHyemd5j9mBAoGAX8Hv+0gOQZQCSOTAq8Nx
|
|
|
|
# 6dZcp9gHlNaXnMsP9eTDckOSzh636JPGvj6m+GPJSSbkURUIQ3oyokMNwFqvlNos
|
|
|
|
# fTaLhAOfjBZI9WnDTTQxpugWjphJ4HqbC67JC/qIiw5S6FdaEvGLEEoD4zoChywZ
|
|
|
|
# 9oGAn+fz2d/0/JAH/FpFPgsCgYEAp/ipZgPzziiZ9ov1wbdAQcWRj7RaWnssPFpX
|
|
|
|
# jXwEiXT3CgEMO4MJ4+KWIWOChrti3qFBg6i6lDyyS6Qyls7sLFbUdC7HlTcrOEMe
|
|
|
|
# rBoTcCI1GqZNlqWOVQ65ZIEiaI7o1vPBZo2GMQEZuq8mDKFsOMThvvTrM5cAep84
|
|
|
|
# n6HJR4ECgYABWcbsSnr0MKvVth/inxjbKapbZnp2HUCuw87Ie5zK2Of/tbC20wwk
|
|
|
|
# yKw3vrGoE3O1t1g2m2tn8UGGASeZ842jZWjIODdSi5+icysQGuULKt86h/woz2SQ
|
|
|
|
# 27GoE2i5mh6Yez6VAYbUuns3FcwIsMyWLq043Tu2DNkx9ijOOAuQzw^invalid..
|
|
|
|
# DO NOT USE==
|
|
|
|
# -----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.
|
2022-10-21 09:17:30 +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
|
|
|
|
## follow https://www.ietf.org/rfc/rfc2307.txt.
|
2020-11-27 09:59:22 +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.
|
2022-10-21 09:17:30 +00:00
|
|
|
# additional_users_dn: ou=users
|
2020-03-15 07:10:25 +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))
|
2022-10-21 09:17:30 +00:00
|
|
|
# users_filter: (&({username_attribute}={input})(objectClass=person))
|
2020-03-15 07:10:25 +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.
|
2022-10-21 09:17:30 +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))
|
2022-10-21 09:17:30 +00:00
|
|
|
# groups_filter: (&(member={dn})(objectClass=groupOfNames))
|
2020-05-04 19:39:25 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The attribute holding the name of the group.
|
2020-11-27 09:59:22 +00:00
|
|
|
# group_name_attribute: cn
|
2020-05-04 19:39:25 +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.
|
2020-11-27 09:59:22 +00:00
|
|
|
# mail_attribute: mail
|
2020-05-04 19:39:25 +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.
|
2021-08-05 04:17:07 +00:00
|
|
|
# display_name_attribute: displayName
|
2020-06-19 10:50:21 +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.
|
2022-10-21 09:17:30 +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
|
2022-10-21 09:17:30 +00:00
|
|
|
# password: password
|
2017-09-02 20:38:26 +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:
|
2022-10-21 09:17:30 +00:00
|
|
|
# path: /config/users_database.yml
|
|
|
|
# watch: false
|
|
|
|
# search:
|
|
|
|
# email: false
|
|
|
|
# case_insensitive: false
|
|
|
|
# password:
|
|
|
|
# algorithm: argon2
|
|
|
|
# argon2:
|
|
|
|
# variant: argon2id
|
|
|
|
# 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:
|
|
|
|
# variant: sha512
|
|
|
|
# iterations: 310000
|
|
|
|
# salt_length: 16
|
|
|
|
# sha2crypt:
|
|
|
|
# variant: sha512
|
|
|
|
# iterations: 50000
|
|
|
|
# salt_length: 16
|
|
|
|
# bcrypt:
|
|
|
|
# variant: standard
|
|
|
|
# cost: 12
|
2022-10-17 10:51:59 +00:00
|
|
|
|
2021-04-11 11:25:03 +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
|
|
|
|
|
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.
|
2017-03-25 14:17:21 +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.
|
2017-09-03 13:22:09 +00:00
|
|
|
default_policy: deny
|
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
# networks:
|
|
|
|
# - name: internal
|
|
|
|
# networks:
|
|
|
|
# - 10.10.0.0/16
|
|
|
|
# - 192.168.2.0/24
|
|
|
|
# - name: VPN
|
|
|
|
# networks: 10.9.0.0/16
|
2021-01-04 10:55:23 +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'
|
|
|
|
# policy: bypass
|
2019-03-27 22:09:01 +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$'
|
2022-04-01 11:38:49 +00:00
|
|
|
# policy: one_factor
|
2022-04-02 05:41:16 +00:00
|
|
|
# - domain_regex: '^(?P<Group>\w+)\.example\.com$'
|
2022-04-01 11:38:49 +00:00
|
|
|
# policy: one_factor
|
|
|
|
# - domain_regex:
|
2022-10-21 09:17:30 +00:00
|
|
|
# - '^appgroup-.*\.example\.com$'
|
|
|
|
# - '^appgroup2-.*\.example\.com$'
|
2022-04-01 11:38:49 +00:00
|
|
|
# policy: one_factor
|
2022-04-02 05:41:16 +00:00
|
|
|
# - domain_regex: '^.*\.example\.com$'
|
2022-04-01 11:38:49 +00:00
|
|
|
# policy: two_factor
|
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
# - domain: 'secure.example.com'
|
|
|
|
# policy: one_factor
|
|
|
|
## Network based rule, if not provided any network matches.
|
|
|
|
# networks:
|
|
|
|
# - internal
|
|
|
|
# - VPN
|
|
|
|
# - 192.168.1.0/24
|
|
|
|
# - 10.0.0.1
|
|
|
|
|
|
|
|
# - domain:
|
|
|
|
# - 'secure.example.com'
|
|
|
|
# - 'private.example.com'
|
|
|
|
# policy: two_factor
|
2019-03-27 22:09:01 +00:00
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
# - domain: 'singlefactor.example.com'
|
|
|
|
# policy: one_factor
|
2018-10-23 22:29:09 +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'
|
|
|
|
# policy: deny
|
|
|
|
|
|
|
|
# - domain: '*.example.com'
|
|
|
|
# subject:
|
|
|
|
# - 'group:admins'
|
|
|
|
# - 'group:moderators'
|
|
|
|
# policy: two_factor
|
2018-10-23 22:29:09 +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'
|
|
|
|
# policy: two_factor
|
2018-10-23 22:29:09 +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'
|
|
|
|
# policy: two_factor
|
2018-10-23 22:29:09 +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'
|
|
|
|
# policy: two_factor
|
2018-10-23 22:29:09 +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'
|
|
|
|
# policy: two_factor
|
|
|
|
# - domain: 'dev.example.com'
|
|
|
|
# resources:
|
|
|
|
# - '^/users/bob/.*$'
|
|
|
|
# subject: 'user:bob'
|
|
|
|
# policy: two_factor
|
2017-03-25 14:17:21 +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.
|
2017-01-22 16:54:45 +00:00
|
|
|
session:
|
2021-04-11 11:25:03 +00:00
|
|
|
## The name of the session cookie.
|
2018-08-19 11:07:00 +00:00
|
|
|
name: authelia_session
|
|
|
|
|
2021-04-18 00:02:04 +00:00
|
|
|
## The domain to protect.
|
|
|
|
## Note: the authenticator must also be in that domain.
|
|
|
|
## If empty, the cookie is restricted to the subdomain of the issuer.
|
|
|
|
domain: example.com
|
|
|
|
|
|
|
|
## Sets the Cookie SameSite value. Possible options are none, lax, or strict.
|
2022-06-15 07:51:47 +00:00
|
|
|
## Please read https://www.authelia.com/c/session#same_site
|
2021-04-18 00:02:04 +00:00
|
|
|
same_site: lax
|
|
|
|
|
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
|
2020-04-03 23:11:33 +00:00
|
|
|
secret: insecure_session_secret
|
2018-10-23 22:29:09 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The value for expiration, inactivity, and remember_me_duration are in seconds or the duration notation format.
|
2022-06-15 07:51:47 +00:00
|
|
|
## See: https://www.authelia.com/c/common#duration-notation-format
|
2021-04-11 11:25:03 +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 time before the cookie expires and the session is destroyed if remember me IS NOT selected.
|
2020-04-05 12:37:21 +00:00
|
|
|
expiration: 1h
|
2017-09-02 23:25:43 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## 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.
|
2020-04-05 12:37:21 +00:00
|
|
|
inactivity: 5m
|
2017-10-16 22:38:10 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The time before the cookie expires and the session is destroyed if remember me IS selected.
|
2022-03-09 22:01:04 +00:00
|
|
|
## Value of -1 disables remember me.
|
2020-04-03 23:11:33 +00:00
|
|
|
remember_me_duration: 1M
|
|
|
|
|
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:
|
|
|
|
# host: 127.0.0.1
|
|
|
|
# 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
|
2020-05-18 02:45:47 +00:00
|
|
|
# host: /var/run/redis/redis.sock
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## Username used for redis authentication. This is optional and a new feature in redis 6.0.
|
|
|
|
# username: authelia
|
2020-05-18 02:45:47 +00:00
|
|
|
|
2022-06-15 07:51:47 +00:00
|
|
|
## Password can also be set using a secret: https://www.authelia.com/c/secrets
|
2022-10-21 09:17:30 +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
|
2017-01-22 16:54:45 +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:
|
|
|
|
## Server Name for certificate validation (in case you are using the IP or non-FQDN in the host option).
|
|
|
|
# server_name: myredis.example.com
|
|
|
|
|
|
|
|
## Skip verifying the server certificate (to allow a self-signed certificate).
|
|
|
|
## In preference to setting this we strongly recommend you add the public portion of the certificate to the
|
|
|
|
## certificates directory which is defined by the `certificates_directory` option at the top of the config.
|
|
|
|
# skip_verify: false
|
|
|
|
|
|
|
|
## Minimum TLS version for the connection.
|
|
|
|
# minimum_version: TLS1.2
|
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
## Maximum TLS version for the connection.
|
|
|
|
# maximum_version: TLS1.3
|
|
|
|
|
|
|
|
## The certificate chain used with the private_key if the server requests TLS Client Authentication
|
|
|
|
## i.e. Mutual TLS.
|
|
|
|
# certificate_chain: |
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIC5jCCAc6gAwIBAgIRAK4Sj7FiN6PXo/urPfO4E7owDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAPKv3pSyP4ozGEiVLJ14dIWFCEGEgq7WUMI0SZZqQA2ID0L59U/Q
|
|
|
|
# /Usyy7uC9gfMUzODTpANtkOjFQcQAsxlR1FOjVBrX5QgjSvXwbQn3DtwMA7XWSl6
|
|
|
|
# LuYx2rBYSlMSN5UZQm/RxMtXfLK2b51WgEEYDFi+nECSqKzR4R54eOPkBEWRfvuY
|
|
|
|
# 91AMjlhpivg8e4JWkq4LVQUKbmiFYwIdK8XQiN4blY9WwXwJFYs5sQ/UYMwBFi0H
|
|
|
|
# kWOh7GEjfxgoUOPauIueZSMSlQp7zqAH39N0ZSYb6cS0Npj57QoWZSY3ak87ebcR
|
|
|
|
# Nf4rCvZLby7LoN7qYCKxmCaDD3x2+NYpWH8CAwEAAaM1MDMwDgYDVR0PAQH/BAQD
|
|
|
|
# AgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcN
|
|
|
|
# AQELBQADggEBAHSITqIQSNzonFl3DzxHPEzr2hp6peo45buAAtu8FZHoA+U7Icfh
|
|
|
|
# /ZXjPg7Xz+hgFwM/DTNGXkMWacQA/PaNWvZspgRJf2AXvNbMSs2UQODr7Tbv+Fb4
|
|
|
|
# lyblmMUNYFMCFVAMU0eIxXAFq2qcwv8UMcQFT0Z/35s6PVOakYnAGGQjTfp5Ljuq
|
|
|
|
# wsdc/xWmM0cHWube6sdRRUD7SY20KU/kWzl8iFO0VbSSrDf1AlEhnLEkp1SPaxXg
|
|
|
|
# OdBnl98MeoramNiJ7NT6Jnyb3zZ578fjaWfThiBpagItI8GZmG4s4Ovh2JbheN8i
|
|
|
|
# ZsjNr9jqHTjhyLVbDRlmJzcqoj4JhbKs6/I^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIDBDCCAeygAwIBAgIRALJsPg21kA0zY4F1wUCIuoMwDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAMXHBvVxUzYk0u34/DINMSF+uiOekKOAjOrC6Mi9Ww8ytPVO7t2S
|
|
|
|
# zfTvM+XnEJqkFQFgimERfG/eGhjF9XIEY6LtnXe8ATvOK4nTwdufzBaoeQu3Gd50
|
|
|
|
# 5VXr6OHRo//ErrGvFXwP3g8xLePABsi/fkH3oDN+ztewOBMDzpd+KgTrk8ysv2ou
|
|
|
|
# kNRMKFZZqASvCgv0LD5KWvUCnL6wgf1oTXG7aztduA4oSkUP321GpOmBC5+5ElU7
|
|
|
|
# ysoRzvD12o9QJ/IfEaulIX06w9yVMo60C/h6A3U6GdkT1SiyTIqR7v7KU/IWd/Qi
|
|
|
|
# Lfftcj91VhCmJ73Meff2e2S2PrpjdXbG5FMCAwEAAaNTMFEwDgYDVR0PAQH/BAQD
|
|
|
|
# AgKkMA8GA1UdJQQIMAYGBFUdJQAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
|
|
|
|
# Z7AtA3mzFc0InSBA5fiMfeLXA3owDQYJKoZIhvcNAQELBQADggEBAEE5hm1mtlk/
|
|
|
|
# kviCoHH4evbpw7rxPxDftIQlqYTtvMM4eWY/6icFoSZ4fUHEWYyps8SsPu/8f2tf
|
|
|
|
# 71LGgZn0FdHi1QU2H8m0HHK7TFw+5Q6RLrLdSyk0PItJ71s9en7r8pX820nAFEHZ
|
|
|
|
# HkOSfJZ7B5hFgUDkMtVM6bardXAhoqcMk4YCU96e9d4PB4eI+xGc+mNuYvov3RbB
|
|
|
|
# D0s8ICyojeyPVLerz4wHjZu68Z5frAzhZ68YbzNs8j2fIBKKHkHyLG1iQyF+LJVj
|
|
|
|
# 2PjCP+auJsj6fQQpMGoyGtpLcSDh+ptcTngUD8JsWipzTCjmaNqdPHAOYmcgtf4b
|
|
|
|
# qocikt3WAdU^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
|
|
|
|
## The private key used with the certificate_chain if the server requests TLS Client Authentication
|
|
|
|
## i.e. Mutual TLS.
|
|
|
|
# private_key: |
|
|
|
|
# -----BEGIN RSA PRIVATE KEY-----
|
|
|
|
# MIIEpAIBAAKCAQEA8q/elLI/ijMYSJUsnXh0hYUIQYSCrtZQwjRJlmpADYgPQvn1
|
|
|
|
# T9D9SzLLu4L2B8xTM4NOkA22Q6MVBxACzGVHUU6NUGtflCCNK9fBtCfcO3AwDtdZ
|
|
|
|
# KXou5jHasFhKUxI3lRlCb9HEy1d8srZvnVaAQRgMWL6cQJKorNHhHnh44+QERZF+
|
|
|
|
# +5j3UAyOWGmK+Dx7glaSrgtVBQpuaIVjAh0rxdCI3huVj1bBfAkVizmxD9RgzAEW
|
|
|
|
# LQeRY6HsYSN/GChQ49q4i55lIxKVCnvOoAff03RlJhvpxLQ2mPntChZlJjdqTzt5
|
|
|
|
# txE1/isK9ktvLsug3upgIrGYJoMPfHb41ilYfwIDAQABAoIBAQDTOdFf2JjHH1um
|
|
|
|
# aPgRAvNf9v7Nj5jytaRKs5nM6iNf46ls4QPreXnMhqSeSwj6lpNgBYxOgzC9Q+cc
|
|
|
|
# Y4ob/paJJPaIJTxmP8K/gyWcOQlNToL1l+eJ20eQoZm23NGr5fIsunSBwLEpTrdB
|
|
|
|
# ENqqtcwhW937K8Pxy/Q1nuLyU2bc6Tn/ivLozc8n27dpQWWKh8537VY7ancIaACr
|
|
|
|
# LJJLYxKqhQpjtBWAyCDvZQirnAOm9KnvIHaGXIswCZ4Xbsu0Y9NL+woARPyRVQvG
|
|
|
|
# jfxy4EmO9s1s6y7OObSukwKDSNihAKHx/VIbvVWx8g2Lv5fGOa+J2Y7o9Qurs8t5
|
|
|
|
# BQwMTt0BAoGBAPUw5Z32EszNepAeV3E2mPFUc5CLiqAxagZJuNDO2pKtyN29ETTR
|
|
|
|
# Ma4O1cWtGb6RqcNNN/Iukfkdk27Q5nC9VJSUUPYelOLc1WYOoUf6oKRzE72dkMQV
|
|
|
|
# R4bf6TkjD+OVR17fAfkswkGahZ5XA7j48KIQ+YC4jbnYKSxZTYyKPjH/AoGBAP1i
|
|
|
|
# tqXt36OVlP+y84wWqZSjMelBIVa9phDVGJmmhz3i1cMni8eLpJzWecA3pfnG6Tm9
|
|
|
|
# ze5M4whASleEt+M00gEvNaU9ND+z0wBfi+/DwJYIbv8PQdGrBiZFrPhTPjGQUldR
|
|
|
|
# lXccV2meeLZv7TagVxSi3DO6dSJfSEHyemd5j9mBAoGAX8Hv+0gOQZQCSOTAq8Nx
|
|
|
|
# 6dZcp9gHlNaXnMsP9eTDckOSzh636JPGvj6m+GPJSSbkURUIQ3oyokMNwFqvlNos
|
|
|
|
# fTaLhAOfjBZI9WnDTTQxpugWjphJ4HqbC67JC/qIiw5S6FdaEvGLEEoD4zoChywZ
|
|
|
|
# 9oGAn+fz2d/0/JAH/FpFPgsCgYEAp/ipZgPzziiZ9ov1wbdAQcWRj7RaWnssPFpX
|
|
|
|
# jXwEiXT3CgEMO4MJ4+KWIWOChrti3qFBg6i6lDyyS6Qyls7sLFbUdC7HlTcrOEMe
|
|
|
|
# rBoTcCI1GqZNlqWOVQ65ZIEiaI7o1vPBZo2GMQEZuq8mDKFsOMThvvTrM5cAep84
|
|
|
|
# n6HJR4ECgYABWcbsSnr0MKvVth/inxjbKapbZnp2HUCuw87Ie5zK2Of/tbC20wwk
|
|
|
|
# yKw3vrGoE3O1t1g2m2tn8UGGASeZ842jZWjIODdSi5+icysQGuULKt86h/woz2SQ
|
|
|
|
# 27GoE2i5mh6Yez6VAYbUuns3FcwIsMyWLq043Tu2DNkx9ijOOAuQzw^invalid..
|
|
|
|
# DO NOT USE==
|
|
|
|
# -----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.
|
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
|
|
|
# sentinel_name: mysentinel
|
|
|
|
|
2021-10-31 03:26:58 +00:00
|
|
|
## Specific username for Redis Sentinel. The node username and password is configured above.
|
|
|
|
# sentinel_username: sentinel_specific_user
|
|
|
|
|
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.
|
|
|
|
# sentinel_password: sentinel_specific_pass
|
|
|
|
|
|
|
|
## 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:
|
2022-10-21 09:17:30 +00:00
|
|
|
# - host: sentinel-node1
|
|
|
|
# port: 6379
|
|
|
|
# - host: sentinel-node2
|
|
|
|
# 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.
|
2017-09-02 23:25:43 +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.
|
2017-09-02 23:25:43 +00:00
|
|
|
max_retries: 3
|
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The time range during which the user can attempt login before being banned. The user is banned if the
|
|
|
|
## authentication failed 'max_retries' times in a 'find_time' seconds window. Find Time accepts duration notation.
|
2022-06-15 07:51:47 +00:00
|
|
|
## See: https://www.authelia.com/c/common#duration-notation-format
|
2020-04-05 12:37:21 +00:00
|
|
|
find_time: 2m
|
2017-09-02 23:25:43 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## The length of time before a banned user can login again. Ban Time accepts duration notation.
|
2022-06-15 07:51:47 +00:00
|
|
|
## See: https://www.authelia.com/c/common#duration-notation-format
|
2020-04-05 12:37:21 +00:00
|
|
|
ban_time: 5m
|
2017-09-02 23:25:43 +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
|
|
|
|
## length of 20. Please see the docs if you configure this with an undesirable key and need to change it.
|
|
|
|
# encryption_key: you_must_generate_a_random_string_of_more_than_twenty_chars_and_configure_this
|
|
|
|
|
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.
|
|
|
|
# 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:
|
|
|
|
# host: 127.0.0.1
|
|
|
|
# port: 3306
|
|
|
|
# database: authelia
|
|
|
|
# username: authelia
|
2022-06-15 07:51:47 +00:00
|
|
|
## Password can also be set using a secret: https://www.authelia.com/c/secrets
|
2022-10-21 09:17:30 +00:00
|
|
|
# password: mypassword
|
|
|
|
# timeout: 5s
|
2019-11-16 19:50:58 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
##
|
|
|
|
## PostgreSQL (Storage Provider)
|
|
|
|
##
|
2019-11-16 19:50:58 +00:00
|
|
|
# postgres:
|
2022-10-21 09:17:30 +00:00
|
|
|
# host: 127.0.0.1
|
|
|
|
# port: 5432
|
|
|
|
# database: authelia
|
|
|
|
# schema: public
|
|
|
|
# username: authelia
|
|
|
|
## Password can also be set using a secret: https://www.authelia.com/c/secrets
|
|
|
|
# password: mypassword
|
|
|
|
# timeout: 5s
|
|
|
|
# ssl:
|
|
|
|
# mode: disable
|
|
|
|
# root_certificate: disable
|
|
|
|
# certificate: disable
|
|
|
|
# key: disable
|
2017-01-28 18:59:15 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
##
|
|
|
|
## Notification Provider
|
|
|
|
##
|
2022-03-03 11:20:43 +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.
|
2017-01-22 16:54:45 +00:00
|
|
|
notifier:
|
2021-04-11 11:25:03 +00:00
|
|
|
## You can disable the notifier startup check by setting this to true.
|
[FEATURE] Notifier Startup Checks (#889)
* implement SMTP notifier startup check
* check dial, starttls, auth, mail from, rcpt to, reset, and quit
* log the error on failure
* implement mock
* misc optimizations, adjustments, and refactoring
* implement validate_skip config option
* fix comments to end with period
* fix suites that used smtp notifier without a smtp container
* add docs
* add file notifier startup check
* move file mode into const.go
* disable gosec linting on insecureskipverify since it's intended, warned, and discouraged
* minor PR commentary adjustment
* apply suggestions from code review
Co-Authored-By: Amir Zarrinkafsh <nightah@me.com>
2020-04-21 04:59:38 +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:
|
2022-10-21 09:17:30 +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:
|
2021-08-10 00:52:41 +00:00
|
|
|
## The SMTP host to connect to.
|
2022-10-21 09:17:30 +00:00
|
|
|
# host: 127.0.0.1
|
2021-08-10 00:52:41 +00:00
|
|
|
|
|
|
|
## The port to connect to the SMTP host on.
|
2022-10-21 09:17:30 +00:00
|
|
|
# port: 1025
|
2021-08-10 00:52:41 +00:00
|
|
|
|
|
|
|
## The connection timeout.
|
2022-10-21 09:17:30 +00:00
|
|
|
# timeout: 5s
|
2021-08-10 00:52:41 +00:00
|
|
|
|
|
|
|
## The username used for SMTP authentication.
|
2022-10-21 09:17:30 +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
|
2022-10-21 09:17:30 +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.
|
2022-10-21 09:17:30 +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.
|
2022-10-21 09:17:30 +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.
|
2022-10-21 09:17:30 +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.
|
2022-10-21 09:17:30 +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
|
2020-02-01 13:17:39 +00:00
|
|
|
|
2022-10-21 09:17:30 +00:00
|
|
|
# tls:
|
2021-04-11 11:25:03 +00:00
|
|
|
## Server Name for certificate validation (in case you are using the IP or non-FQDN in the host option).
|
2021-01-04 10:28:55 +00:00
|
|
|
# server_name: smtp.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
|
|
|
## Skip verifying the server certificate (to allow a self-signed certificate).
|
|
|
|
## In preference to setting this we strongly recommend you add the public portion of the certificate to the
|
|
|
|
## certificates directory which is defined by the `certificates_directory` option at the top of the config.
|
2022-10-21 09:17:30 +00:00
|
|
|
# skip_verify: false
|
2021-01-04 10:28:55 +00:00
|
|
|
|
2021-04-11 11:25:03 +00:00
|
|
|
## Minimum TLS version for either StartTLS or SMTPS.
|
2022-10-21 09:17:30 +00:00
|
|
|
# minimum_version: TLS1.2
|
|
|
|
|
|
|
|
## Maximum TLS version for either StartTLS or SMTPS.
|
|
|
|
# maximum_version: TLS1.3
|
|
|
|
|
|
|
|
## The certificate chain used with the private_key if the server requests TLS Client Authentication
|
|
|
|
## i.e. Mutual TLS.
|
|
|
|
# certificate_chain: |
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIC5jCCAc6gAwIBAgIRAK4Sj7FiN6PXo/urPfO4E7owDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAPKv3pSyP4ozGEiVLJ14dIWFCEGEgq7WUMI0SZZqQA2ID0L59U/Q
|
|
|
|
# /Usyy7uC9gfMUzODTpANtkOjFQcQAsxlR1FOjVBrX5QgjSvXwbQn3DtwMA7XWSl6
|
|
|
|
# LuYx2rBYSlMSN5UZQm/RxMtXfLK2b51WgEEYDFi+nECSqKzR4R54eOPkBEWRfvuY
|
|
|
|
# 91AMjlhpivg8e4JWkq4LVQUKbmiFYwIdK8XQiN4blY9WwXwJFYs5sQ/UYMwBFi0H
|
|
|
|
# kWOh7GEjfxgoUOPauIueZSMSlQp7zqAH39N0ZSYb6cS0Npj57QoWZSY3ak87ebcR
|
|
|
|
# Nf4rCvZLby7LoN7qYCKxmCaDD3x2+NYpWH8CAwEAAaM1MDMwDgYDVR0PAQH/BAQD
|
|
|
|
# AgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcN
|
|
|
|
# AQELBQADggEBAHSITqIQSNzonFl3DzxHPEzr2hp6peo45buAAtu8FZHoA+U7Icfh
|
|
|
|
# /ZXjPg7Xz+hgFwM/DTNGXkMWacQA/PaNWvZspgRJf2AXvNbMSs2UQODr7Tbv+Fb4
|
|
|
|
# lyblmMUNYFMCFVAMU0eIxXAFq2qcwv8UMcQFT0Z/35s6PVOakYnAGGQjTfp5Ljuq
|
|
|
|
# wsdc/xWmM0cHWube6sdRRUD7SY20KU/kWzl8iFO0VbSSrDf1AlEhnLEkp1SPaxXg
|
|
|
|
# OdBnl98MeoramNiJ7NT6Jnyb3zZ578fjaWfThiBpagItI8GZmG4s4Ovh2JbheN8i
|
|
|
|
# ZsjNr9jqHTjhyLVbDRlmJzcqoj4JhbKs6/I^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIDBDCCAeygAwIBAgIRALJsPg21kA0zY4F1wUCIuoMwDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAMXHBvVxUzYk0u34/DINMSF+uiOekKOAjOrC6Mi9Ww8ytPVO7t2S
|
|
|
|
# zfTvM+XnEJqkFQFgimERfG/eGhjF9XIEY6LtnXe8ATvOK4nTwdufzBaoeQu3Gd50
|
|
|
|
# 5VXr6OHRo//ErrGvFXwP3g8xLePABsi/fkH3oDN+ztewOBMDzpd+KgTrk8ysv2ou
|
|
|
|
# kNRMKFZZqASvCgv0LD5KWvUCnL6wgf1oTXG7aztduA4oSkUP321GpOmBC5+5ElU7
|
|
|
|
# ysoRzvD12o9QJ/IfEaulIX06w9yVMo60C/h6A3U6GdkT1SiyTIqR7v7KU/IWd/Qi
|
|
|
|
# Lfftcj91VhCmJ73Meff2e2S2PrpjdXbG5FMCAwEAAaNTMFEwDgYDVR0PAQH/BAQD
|
|
|
|
# AgKkMA8GA1UdJQQIMAYGBFUdJQAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
|
|
|
|
# Z7AtA3mzFc0InSBA5fiMfeLXA3owDQYJKoZIhvcNAQELBQADggEBAEE5hm1mtlk/
|
|
|
|
# kviCoHH4evbpw7rxPxDftIQlqYTtvMM4eWY/6icFoSZ4fUHEWYyps8SsPu/8f2tf
|
|
|
|
# 71LGgZn0FdHi1QU2H8m0HHK7TFw+5Q6RLrLdSyk0PItJ71s9en7r8pX820nAFEHZ
|
|
|
|
# HkOSfJZ7B5hFgUDkMtVM6bardXAhoqcMk4YCU96e9d4PB4eI+xGc+mNuYvov3RbB
|
|
|
|
# D0s8ICyojeyPVLerz4wHjZu68Z5frAzhZ68YbzNs8j2fIBKKHkHyLG1iQyF+LJVj
|
|
|
|
# 2PjCP+auJsj6fQQpMGoyGtpLcSDh+ptcTngUD8JsWipzTCjmaNqdPHAOYmcgtf4b
|
|
|
|
# qocikt3WAdU^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
|
|
|
|
## The private key used with the certificate_chain if the server requests TLS Client Authentication
|
|
|
|
## i.e. Mutual TLS.
|
|
|
|
# private_key: |
|
|
|
|
# -----BEGIN RSA PRIVATE KEY-----
|
|
|
|
# MIIEpAIBAAKCAQEA8q/elLI/ijMYSJUsnXh0hYUIQYSCrtZQwjRJlmpADYgPQvn1
|
|
|
|
# T9D9SzLLu4L2B8xTM4NOkA22Q6MVBxACzGVHUU6NUGtflCCNK9fBtCfcO3AwDtdZ
|
|
|
|
# KXou5jHasFhKUxI3lRlCb9HEy1d8srZvnVaAQRgMWL6cQJKorNHhHnh44+QERZF+
|
|
|
|
# +5j3UAyOWGmK+Dx7glaSrgtVBQpuaIVjAh0rxdCI3huVj1bBfAkVizmxD9RgzAEW
|
|
|
|
# LQeRY6HsYSN/GChQ49q4i55lIxKVCnvOoAff03RlJhvpxLQ2mPntChZlJjdqTzt5
|
|
|
|
# txE1/isK9ktvLsug3upgIrGYJoMPfHb41ilYfwIDAQABAoIBAQDTOdFf2JjHH1um
|
|
|
|
# aPgRAvNf9v7Nj5jytaRKs5nM6iNf46ls4QPreXnMhqSeSwj6lpNgBYxOgzC9Q+cc
|
|
|
|
# Y4ob/paJJPaIJTxmP8K/gyWcOQlNToL1l+eJ20eQoZm23NGr5fIsunSBwLEpTrdB
|
|
|
|
# ENqqtcwhW937K8Pxy/Q1nuLyU2bc6Tn/ivLozc8n27dpQWWKh8537VY7ancIaACr
|
|
|
|
# LJJLYxKqhQpjtBWAyCDvZQirnAOm9KnvIHaGXIswCZ4Xbsu0Y9NL+woARPyRVQvG
|
|
|
|
# jfxy4EmO9s1s6y7OObSukwKDSNihAKHx/VIbvVWx8g2Lv5fGOa+J2Y7o9Qurs8t5
|
|
|
|
# BQwMTt0BAoGBAPUw5Z32EszNepAeV3E2mPFUc5CLiqAxagZJuNDO2pKtyN29ETTR
|
|
|
|
# Ma4O1cWtGb6RqcNNN/Iukfkdk27Q5nC9VJSUUPYelOLc1WYOoUf6oKRzE72dkMQV
|
|
|
|
# R4bf6TkjD+OVR17fAfkswkGahZ5XA7j48KIQ+YC4jbnYKSxZTYyKPjH/AoGBAP1i
|
|
|
|
# tqXt36OVlP+y84wWqZSjMelBIVa9phDVGJmmhz3i1cMni8eLpJzWecA3pfnG6Tm9
|
|
|
|
# ze5M4whASleEt+M00gEvNaU9ND+z0wBfi+/DwJYIbv8PQdGrBiZFrPhTPjGQUldR
|
|
|
|
# lXccV2meeLZv7TagVxSi3DO6dSJfSEHyemd5j9mBAoGAX8Hv+0gOQZQCSOTAq8Nx
|
|
|
|
# 6dZcp9gHlNaXnMsP9eTDckOSzh636JPGvj6m+GPJSSbkURUIQ3oyokMNwFqvlNos
|
|
|
|
# fTaLhAOfjBZI9WnDTTQxpugWjphJ4HqbC67JC/qIiw5S6FdaEvGLEEoD4zoChywZ
|
|
|
|
# 9oGAn+fz2d/0/JAH/FpFPgsCgYEAp/ipZgPzziiZ9ov1wbdAQcWRj7RaWnssPFpX
|
|
|
|
# jXwEiXT3CgEMO4MJ4+KWIWOChrti3qFBg6i6lDyyS6Qyls7sLFbUdC7HlTcrOEMe
|
|
|
|
# rBoTcCI1GqZNlqWOVQ65ZIEiaI7o1vPBZo2GMQEZuq8mDKFsOMThvvTrM5cAep84
|
|
|
|
# n6HJR4ECgYABWcbsSnr0MKvVth/inxjbKapbZnp2HUCuw87Ie5zK2Of/tbC20wwk
|
|
|
|
# yKw3vrGoE3O1t1g2m2tn8UGGASeZ842jZWjIODdSi5+icysQGuULKt86h/woz2SQ
|
|
|
|
# 27GoE2i5mh6Yez6VAYbUuns3FcwIsMyWLq043Tu2DNkx9ijOOAuQzw^invalid..
|
|
|
|
# DO NOT USE==
|
|
|
|
# -----END RSA PRIVATE KEY-----
|
2021-01-04 10:28:55 +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
|
2021-05-04 22:06:05 +00:00
|
|
|
# hmac_secret: this_is_a_secret_abc123abc123abc
|
|
|
|
|
2022-10-02 02:07:40 +00:00
|
|
|
## The issuer_certificate_chain is an optional PEM encoded certificate chain. It's used in conjunction with the
|
|
|
|
## issuer_private_key to sign JWT's. All certificates in the chain must be within the validity period, and every
|
|
|
|
## certificate included must be signed by the certificate immediately after it if provided.
|
|
|
|
# issuer_certificate_chain: |
|
2022-10-21 09:17:30 +00:00
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIC5jCCAc6gAwIBAgIRAK4Sj7FiN6PXo/urPfO4E7owDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAPKv3pSyP4ozGEiVLJ14dIWFCEGEgq7WUMI0SZZqQA2ID0L59U/Q
|
|
|
|
# /Usyy7uC9gfMUzODTpANtkOjFQcQAsxlR1FOjVBrX5QgjSvXwbQn3DtwMA7XWSl6
|
|
|
|
# LuYx2rBYSlMSN5UZQm/RxMtXfLK2b51WgEEYDFi+nECSqKzR4R54eOPkBEWRfvuY
|
|
|
|
# 91AMjlhpivg8e4JWkq4LVQUKbmiFYwIdK8XQiN4blY9WwXwJFYs5sQ/UYMwBFi0H
|
|
|
|
# kWOh7GEjfxgoUOPauIueZSMSlQp7zqAH39N0ZSYb6cS0Npj57QoWZSY3ak87ebcR
|
|
|
|
# Nf4rCvZLby7LoN7qYCKxmCaDD3x2+NYpWH8CAwEAAaM1MDMwDgYDVR0PAQH/BAQD
|
|
|
|
# AgWgMBMGA1UdJQQMMAoGCCsGAQUFBwMBMAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcN
|
|
|
|
# AQELBQADggEBAHSITqIQSNzonFl3DzxHPEzr2hp6peo45buAAtu8FZHoA+U7Icfh
|
|
|
|
# /ZXjPg7Xz+hgFwM/DTNGXkMWacQA/PaNWvZspgRJf2AXvNbMSs2UQODr7Tbv+Fb4
|
|
|
|
# lyblmMUNYFMCFVAMU0eIxXAFq2qcwv8UMcQFT0Z/35s6PVOakYnAGGQjTfp5Ljuq
|
|
|
|
# wsdc/xWmM0cHWube6sdRRUD7SY20KU/kWzl8iFO0VbSSrDf1AlEhnLEkp1SPaxXg
|
|
|
|
# OdBnl98MeoramNiJ7NT6Jnyb3zZ578fjaWfThiBpagItI8GZmG4s4Ovh2JbheN8i
|
|
|
|
# ZsjNr9jqHTjhyLVbDRlmJzcqoj4JhbKs6/I^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
|
|
|
# -----BEGIN CERTIFICATE-----
|
|
|
|
# MIIDBDCCAeygAwIBAgIRALJsPg21kA0zY4F1wUCIuoMwDQYJKoZIhvcNAQELBQAw
|
|
|
|
# EzERMA8GA1UEChMIQXV0aGVsaWEwHhcNNzAwMTAxMDAwMDAwWhcNNzEwMTAxMDAw
|
|
|
|
# MDAwWjATMREwDwYDVQQKEwhBdXRoZWxpYTCCASIwDQYJKoZIhvcNAQEBBQADggEP
|
|
|
|
# ADCCAQoCggEBAMXHBvVxUzYk0u34/DINMSF+uiOekKOAjOrC6Mi9Ww8ytPVO7t2S
|
|
|
|
# zfTvM+XnEJqkFQFgimERfG/eGhjF9XIEY6LtnXe8ATvOK4nTwdufzBaoeQu3Gd50
|
|
|
|
# 5VXr6OHRo//ErrGvFXwP3g8xLePABsi/fkH3oDN+ztewOBMDzpd+KgTrk8ysv2ou
|
|
|
|
# kNRMKFZZqASvCgv0LD5KWvUCnL6wgf1oTXG7aztduA4oSkUP321GpOmBC5+5ElU7
|
|
|
|
# ysoRzvD12o9QJ/IfEaulIX06w9yVMo60C/h6A3U6GdkT1SiyTIqR7v7KU/IWd/Qi
|
|
|
|
# Lfftcj91VhCmJ73Meff2e2S2PrpjdXbG5FMCAwEAAaNTMFEwDgYDVR0PAQH/BAQD
|
|
|
|
# AgKkMA8GA1UdJQQIMAYGBFUdJQAwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQU
|
|
|
|
# Z7AtA3mzFc0InSBA5fiMfeLXA3owDQYJKoZIhvcNAQELBQADggEBAEE5hm1mtlk/
|
|
|
|
# kviCoHH4evbpw7rxPxDftIQlqYTtvMM4eWY/6icFoSZ4fUHEWYyps8SsPu/8f2tf
|
|
|
|
# 71LGgZn0FdHi1QU2H8m0HHK7TFw+5Q6RLrLdSyk0PItJ71s9en7r8pX820nAFEHZ
|
|
|
|
# HkOSfJZ7B5hFgUDkMtVM6bardXAhoqcMk4YCU96e9d4PB4eI+xGc+mNuYvov3RbB
|
|
|
|
# D0s8ICyojeyPVLerz4wHjZu68Z5frAzhZ68YbzNs8j2fIBKKHkHyLG1iQyF+LJVj
|
|
|
|
# 2PjCP+auJsj6fQQpMGoyGtpLcSDh+ptcTngUD8JsWipzTCjmaNqdPHAOYmcgtf4b
|
|
|
|
# qocikt3WAdU^invalid DO NOT USE=
|
|
|
|
# -----END CERTIFICATE-----
|
2022-10-02 02:07:40 +00:00
|
|
|
|
2021-05-04 22:06:05 +00:00
|
|
|
## The issuer_private_key is used to sign the JWT forged by OpenID Connect.
|
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-----
|
|
|
|
# MIIEpAIBAAKCAQEA8q/elLI/ijMYSJUsnXh0hYUIQYSCrtZQwjRJlmpADYgPQvn1
|
|
|
|
# T9D9SzLLu4L2B8xTM4NOkA22Q6MVBxACzGVHUU6NUGtflCCNK9fBtCfcO3AwDtdZ
|
|
|
|
# KXou5jHasFhKUxI3lRlCb9HEy1d8srZvnVaAQRgMWL6cQJKorNHhHnh44+QERZF+
|
|
|
|
# +5j3UAyOWGmK+Dx7glaSrgtVBQpuaIVjAh0rxdCI3huVj1bBfAkVizmxD9RgzAEW
|
|
|
|
# LQeRY6HsYSN/GChQ49q4i55lIxKVCnvOoAff03RlJhvpxLQ2mPntChZlJjdqTzt5
|
|
|
|
# txE1/isK9ktvLsug3upgIrGYJoMPfHb41ilYfwIDAQABAoIBAQDTOdFf2JjHH1um
|
|
|
|
# aPgRAvNf9v7Nj5jytaRKs5nM6iNf46ls4QPreXnMhqSeSwj6lpNgBYxOgzC9Q+cc
|
|
|
|
# Y4ob/paJJPaIJTxmP8K/gyWcOQlNToL1l+eJ20eQoZm23NGr5fIsunSBwLEpTrdB
|
|
|
|
# ENqqtcwhW937K8Pxy/Q1nuLyU2bc6Tn/ivLozc8n27dpQWWKh8537VY7ancIaACr
|
|
|
|
# LJJLYxKqhQpjtBWAyCDvZQirnAOm9KnvIHaGXIswCZ4Xbsu0Y9NL+woARPyRVQvG
|
|
|
|
# jfxy4EmO9s1s6y7OObSukwKDSNihAKHx/VIbvVWx8g2Lv5fGOa+J2Y7o9Qurs8t5
|
|
|
|
# BQwMTt0BAoGBAPUw5Z32EszNepAeV3E2mPFUc5CLiqAxagZJuNDO2pKtyN29ETTR
|
|
|
|
# Ma4O1cWtGb6RqcNNN/Iukfkdk27Q5nC9VJSUUPYelOLc1WYOoUf6oKRzE72dkMQV
|
|
|
|
# R4bf6TkjD+OVR17fAfkswkGahZ5XA7j48KIQ+YC4jbnYKSxZTYyKPjH/AoGBAP1i
|
|
|
|
# tqXt36OVlP+y84wWqZSjMelBIVa9phDVGJmmhz3i1cMni8eLpJzWecA3pfnG6Tm9
|
|
|
|
# ze5M4whASleEt+M00gEvNaU9ND+z0wBfi+/DwJYIbv8PQdGrBiZFrPhTPjGQUldR
|
|
|
|
# lXccV2meeLZv7TagVxSi3DO6dSJfSEHyemd5j9mBAoGAX8Hv+0gOQZQCSOTAq8Nx
|
|
|
|
# 6dZcp9gHlNaXnMsP9eTDckOSzh636JPGvj6m+GPJSSbkURUIQ3oyokMNwFqvlNos
|
|
|
|
# fTaLhAOfjBZI9WnDTTQxpugWjphJ4HqbC67JC/qIiw5S6FdaEvGLEEoD4zoChywZ
|
|
|
|
# 9oGAn+fz2d/0/JAH/FpFPgsCgYEAp/ipZgPzziiZ9ov1wbdAQcWRj7RaWnssPFpX
|
|
|
|
# jXwEiXT3CgEMO4MJ4+KWIWOChrti3qFBg6i6lDyyS6Qyls7sLFbUdC7HlTcrOEMe
|
|
|
|
# rBoTcCI1GqZNlqWOVQ65ZIEiaI7o1vPBZo2GMQEZuq8mDKFsOMThvvTrM5cAep84
|
|
|
|
# n6HJR4ECgYABWcbsSnr0MKvVth/inxjbKapbZnp2HUCuw87Ie5zK2Of/tbC20wwk
|
|
|
|
# yKw3vrGoE3O1t1g2m2tn8UGGASeZ842jZWjIODdSi5+icysQGuULKt86h/woz2SQ
|
|
|
|
# 27GoE2i5mh6Yez6VAYbUuns3FcwIsMyWLq043Tu2DNkx9ijOOAuQzw^invalid..
|
|
|
|
# DO NOT USE==
|
|
|
|
# -----END RSA PRIVATE KEY-----
|
2021-05-04 22:06:05 +00:00
|
|
|
|
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
|
|
|
## The lifespans configure the expiration for these token types.
|
|
|
|
# access_token_lifespan: 1h
|
|
|
|
# authorize_code_lifespan: 1m
|
|
|
|
# id_token_lifespan: 1h
|
|
|
|
# refresh_token_lifespan: 90m
|
|
|
|
|
|
|
|
## 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.
|
|
|
|
# enforce_pkce: public_clients_only
|
|
|
|
|
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:
|
2022-10-21 09:17:30 +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:
|
2022-10-21 09:17:30 +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.
|
|
|
|
# id: myapp
|
|
|
|
|
|
|
|
## The description to show to users when they end up on the consent screen. Defaults to the ID above.
|
|
|
|
# description: My Application
|
|
|
|
|
|
|
|
## The client secret is a shared secret between Authelia and the consumer of this client.
|
|
|
|
# secret: this_is_a_secret
|
|
|
|
|
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.
|
|
|
|
# sector_identifier: example.com
|
|
|
|
|
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
|
|
|
|
|
2021-05-04 22:06:05 +00:00
|
|
|
## The policy to require for this client; one_factor or two_factor.
|
|
|
|
# authorization_policy: two_factor
|
|
|
|
|
2022-10-20 02:16:36 +00:00
|
|
|
## The consent mode controls how consent is obtained.
|
|
|
|
# consent_mode: auto
|
|
|
|
|
|
|
|
## This value controls the duration a consent on this client remains remembered when the consent mode is
|
|
|
|
## configured as 'auto' or 'pre-configured'.
|
|
|
|
# pre_configured_consent_duration: 1w
|
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:
|
|
|
|
# - openid
|
|
|
|
# - groups
|
|
|
|
# - email
|
|
|
|
# - profile
|
|
|
|
|
2021-05-04 22:06:05 +00:00
|
|
|
## Redirect URI's specifies a list of valid case-sensitive callbacks for this client.
|
|
|
|
# redirect_uris:
|
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
|
|
|
# - https://oidc.example.com:8080/oauth2/callback
|
2021-05-04 22:06:05 +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:
|
2021-07-15 11:02:03 +00:00
|
|
|
# - refresh_token
|
|
|
|
# - 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:
|
2021-07-15 11:02:03 +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:
|
2021-07-15 11:02:03 +00:00
|
|
|
# - form_post
|
|
|
|
# - query
|
|
|
|
# - fragment
|
2021-07-10 04:56:33 +00:00
|
|
|
|
|
|
|
## The algorithm used to sign userinfo endpoint responses for this client, either none or RS256.
|
|
|
|
# userinfo_signing_algorithm: none
|
2021-04-11 11:25:03 +00:00
|
|
|
...
|