############################################################### # Authelia configuration # ############################################################### # The port to listen on port: 8080 # Log level # # Level of verbosity for logs logs_level: debug # 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:8080/ # TOTP Issuer Name # # This will be the issuer name displayed in Google Authenticator # See: https://github.com/google/google-authenticator/wiki/Key-Uri-Format for more info on issuer names totp: issuer: authelia.com # The authentication backend to use for verifying user passwords # and retrieve information such as email address and groups # users belong to. # # There are two supported backends: `ldap` and `file`. authentication_backend: # LDAP backend configuration. # # This backend allows Authelia to be scaled to more # than one instance and therefore is recommended for # production. ldap: # The url of the ldap server url: ldap://openldap # The base dn for every entries base_dn: dc=example,dc=com # An additional dn to define the scope to all users additional_users_dn: ou=users # The users filter used to find the user DN # {0} is a matcher replaced by username. # 'cn={0}' by default. users_filter: cn={0} # An additional dn to define the scope of groups additional_groups_dn: ou=groups # The groups filter used for retrieving groups of a given user. # {0} is a matcher replaced by username. # {dn} is a matcher replaced by user DN. # 'member={dn}' by default. groups_filter: (&(member={dn})(objectclass=groupOfNames)) # The attribute holding the name of the group group_name_attribute: cn # The attribute holding the mail address of the user mail_attribute: mail # The username and password of the admin user. user: cn=admin,dc=example,dc=com password: password # File backend configuration. # # 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. # ## file: ## path: ./users_database.yml # Authentication methods # # Authentication methods can be defined per subdomain. # There are currently two available methods: "single_factor" and "two_factor" # # Note: by default a domain uses "two_factor" method. # # Note: 'per_subdomain_methods' is a dictionary where keys must be subdomains and # values must be one of the two possible methods. # # Note: 'per_subdomain_methods' is optional. # # Note: authentication_methods is optional. If it is not set all sub-domains # are protected by two factors. authentication_methods: default_method: two_factor per_subdomain_methods: single_factor.example.com: single_factor # Access Control # # Access control is a set of rules you can use to restrict user access to certain # resources. # Any (apply to anyone), per-user or per-group rules can be defined. # # If 'access_control' is not defined, ACL rules are disabled and the `allow` default # policy 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. # It must stand at the beginning of the pattern. (example: *.mydomain.com) # # Note: You must put the pattern in simple quotes when using the wildcard for the YAML # to be syntaxically correct. # # Definition: A `rule` is an object with the following keys: `domain`, `policy` # and `resources`. # - `domain` defines which domain or set of domains the rule applies to. # - `policy` is the policy to apply to resources. It must be either `allow` or `deny`. # - `resources` is a list of regular expressions that matches a set of resources to # apply the policy to. # # Note: Rules follow an order of priority defined as follows: # In each category (`any`, `groups`, `users`), the latest rules have the highest # priority. In other words, it means that if a given resource matches two rules in the # same category, the latest one overrides the first one. # Each category has also its own priority. That is, `users` has the highest priority, then # `groups` and `any` has the lowest priority. It means if two rules in different categories # match a given resource, the one in the category with the highest priority overrides the # other one. # access_control: # Default policy can either be `allow` or `deny`. # It is the policy applied to any resource if it has not been overriden # in the `any`, `groups` or `users` category. default_policy: deny # The rules that apply to anyone. # The value is a list of rules. any: - domain: public.example.com policy: allow # Group-based rules. The key is a group name and the value # is a list of rules. groups: admin: # All resources in all domains - domain: '*.example.com' policy: allow # Except mx2.mail.example.com (it restricts the first rule) - domain: 'mx2.mail.example.com' policy: deny dev: - domain: dev.example.com policy: allow resources: - '^/groups/dev/.*$' # User-based rules. The key is a user name and the value # is a list of rules. users: john: - domain: dev.example.com policy: allow resources: - '^/users/john/.*$' harry: - domain: dev.example.com policy: allow resources: - '^/users/harry/.*$' bob: - domain: '*.mail.example.com' policy: allow - domain: 'dev.example.com' policy: allow resources: - '^/users/bob/.*$' # Configuration of session cookies # # The session cookies identify the user once logged in. session: # The name of the session cookie. (default: authelia_session). name: authelia_session # The secret to encrypt the session cookie. secret: unsecure_session_secret # The time in ms before the cookie expires and session is reset. expiration: 3600000 # 1 hour # The inactivity time in ms before the session is reset. inactivity: 300000 # 5 minutes # 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 # The redis connection details redis: host: redis port: 6379 # Configuration of the authentication regulation mechanism. # # This mechanism prevents attackers from brute forcing the first factor. # It bans the user if too many attempts are done in a short period of # time. regulation: # The number of failed login attempts before user is banned. # Set it to 0 to disable regulation. max_retries: 3 # The time range during which the user can attempt login before being banned. # The user is banned if the authenticaction failed `max_retries` times in a `find_time` seconds window. find_time: 120 # The length of time before a banned user can login again. ban_time: 300 # Configuration of the storage backend used to store data and secrets. # # You must use only an available configuration: local, mongo storage: # The directory where the DB files will be saved ## local: ## path: /var/lib/authelia/store # Settings to connect to mongo server mongo: url: mongodb://mongo database: authelia # Configuration of the notification system. # # Notifications are sent to users when they require a password reset, a u2f # registration or a TOTP registration. # Use only an available configuration: filesystem, gmail notifier: # For testing purpose, notifications can be sent in a file ## filesystem: ## filename: /tmp/authelia/notification.txt # Use your email account to send the notifications. You can use an app password. # List of valid services can be found here: https://nodemailer.com/smtp/well-known/ ## email: ## username: user@example.com ## password: yourpassword ## sender: admin@example.com ## service: gmail # Use a SMTP server for sending notifications smtp: username: test password: password secure: false host: 'smtp' port: 1025 sender: admin@example.com