Конфигурация

Tags:
Categories:

Конфигурация

session:
 secret: 'insecure_session_secret'
 name: 'authelia_session'
 same_site: 'lax'
 inactivity: '5m'
 expiration: '1h'
 remember_me: '1M'
 cookies:
   - domain: 'rabrain.ru'
     authelia_url: 'https://auth.rabrain.ru'
     default_redirection_url: 'https://www.rabrain.ru'
     name: 'authelia_session'
     same_site: 'lax'
     inactivity: '5m'
     expiration: '1h'
     remember_me: '1d'

Конфигурация

session:
  secret: 'insecure_session_secret'
  name: 'authelia_session'
  same_site: 'lax'
  inactivity: '5m'
  expiration: '1h'
  remember_me: '1M'
  cookies:
    - domain: 'rabrain.ru'
      authelia_url: 'https://auth.rabrain.ru'
      default_redirection_url: 'https://www.rabrain.ru'
      name: 'authelia_session'
      same_site: 'lax'
      inactivity: '5m'
      expiration: '1h'
      remember_me: '1d'

Провайдеры

В настоящее время существует два провайдера для хранения сессий (три, если считать Redis Sentinel отдельным провайдером):

  1. Memory (по умолчанию, с состоянием, без дополнительной настройки)
  2. Redis (без состояния).
  3. Redis Sentinel (без статических данных, высокая доступность).

Опции

name

Значение имени по умолчанию для всех конфигураций cookies.

same_site

Значение same_site по умолчанию для всех конфигураций cookies.

inactivity

Значение бездействия по умолчанию для всех конфигураций cookies.

expiration

Значение срока действия по умолчанию для всех конфигураций cookies.

remember_me

Значение remember_me по умолчанию для всех конфигураций cookies.

cookies

Список определенных доменов cookie, которые Authelia настроена обрабатывать. Домены, не настроенные должным образом, будут автоматически отклоняться Authelia. Список позволяет администраторам определить несколько конфигураций доменов cookie сеанса с индивидуальными настройками.

domain

Домен, для защиты которого назначается сессионный cookie. Он должен совпадать с доменом, на котором обслуживается Authelia, или корнем домена, и, следовательно, если настроен authelia_url, должен иметь возможность читать и записывать куки для этого домена.

Например, если Authelia доступна по URL https://auth.rabrain.ru, домен должен быть либо auth.rabrain.ru, либо rabrain.ru.

Значение не должно совпадать с доменом из списка публичных суффиксов, поскольку браузеры не разрешают веб-сайтам записывать файлы cookie для таких доменов. Это касается большинства служб динамического DNS, таких как duckdns.org. Вы должны использовать свой домен вместо duckdns.org для этого значения, например example.duckdns.org.

Следовательно, если у вас есть example.duckdns.org и example-auth.duckdns.org, вы не сможете обмениваться файлами cookie между этими доменами.

authelia_url

Это обязательный URL, который является корневым URL вашей установки Authelia для этого домена cookie, который может быть использован для создания соответствующего URL перенаправления, когда требуется аутентификация. Этот URL должен:

  • Уметь читать и записывать файлы cookie для настроенного домена.
  • Использовать схему https://.
  • Включать путь, если это необходимо (например, https://rabrain.ru/authelia, а не https://rabrain.ru, если вы используете опцию адреса сервера в authelia для указания подпути и если портал Authelia недоступен с https://rabrain.ru).

Соответствующий параметр запроса или заголовок для соответствующего прокси может отменить это поведение.

default_redirection_url

Это совершенно необязательный URL, который используется в качестве места перенаправления при прямом посещении Authelia. Эта опция отменяет глобальную опцию default_redirection_url.

name

Значение по умолчанию: Этот параметр принимает значение по умолчанию из настройки имени, приведенной выше.

Имя куки сеанса. По умолчанию устанавливается значение имени в основном разделе конфигурации сеанса.

same_site

Значение по умолчанию: Этот параметр принимает значение по умолчанию из настройки same_site, указанной выше.

Устанавливает значение cookies SameSite. До появления этого параметра по умолчанию было установлено значение None. Новое значение по умолчанию - Lax. Эта опция задается в нижнем регистре. Поэтому, например, если вы хотите установить значение Strict, то в конфигурации оно должно быть строгим.

Подробно о куках SameSite можно прочитать в MDN. Короче говоря, установка SameSite в значение Lax является наиболее предпочтительным вариантом для Authelia. None не рекомендуется, если только вы не знаете, что делаете, и не доверяете всем защищенным приложениям. Strict не будет работать во многих случаях, и мы не тестировали его в этом состоянии, но в любом случае он доступен как опция.

inactivity

Значение по умолчанию: Этот параметр принимает значение по умолчанию из настройки бездействия, приведенной выше.

Период времени, в течение которого пользователь может быть неактивен, пока сессия не будет уничтожена. Пригодится, если вам нужны длительные таймеры сеансов, но вы не хотите, чтобы неиспользуемые устройства были уязвимы.

expiration

Значение по умолчанию: Этот параметр принимает значение по умолчанию из настройки истечения срока действия, указанной выше.

Период времени до истечения срока действия cookie и уничтожения сессии. Это значение переопределяется параметром remember_me, если установлен флажок remember me.

remember_me

Значение по умолчанию: Этот параметр принимает значение по умолчанию из настройки remember_me, указанной выше.

Период времени до истечения срока действия куки и уничтожения сессии, когда установлен флажок remember me. Установка значения -1 полностью отключает эту функцию для данного домена сессионных cookie.