мета-данные страницы
  •  

Это старая версия документа!

Общее

Поддержка работы приложения с системой авторизации Authelia в режиме проксирования через nginx. Теоретически, модуль может использоваться и с другими системами авторизации, выставляющими заголовки с идентификационными данными пользователя.

Исключения

Имя Родитель Описание
AHError Error Базовый класс исключений модуля адаптера Authelia
AHAuthError AHError Проблемы с авторизацией пользователя

Классы объектов

Имя Описание
AHUser Представление в качестве объекта идентификационных данных
AutheliaHelper Адаптер авторизации, выполняющий разбор заголовков и их интерпретацию

AHUser

Представляет собой namedtuple с полями:

  • uname - Имя УЗ
  • groups - Группы пользователя
  • email - E-Mail пользователя
  • name - Имя пользователя, которым его стоит обозначать в приложении.

AutheliaHelper

Конструктор

Параметр Тип По умолчанию Описание
group_filter List[str] None Фильтр передаваемый системой аутентификации групп, которые интересны нам. Ели None группы, передаваемые в заголовке не фильтруются
header_user str Remote-User Имя заголовка с именем УЗ пользователя
header_groups str Remote-Groups Имя заголовка с группами пользователя
header_email str Remote-Email Имя заголовка c e-mail пользователя
header_name str Remote-Name Имя заголовка с именем пользователя

Вызов объекта

Выполняет разбор заголовков и извлечение данных пользователя.

Параметр Тип По умолчанию Описание
request bottle.BaseRequest bottle.request Обрабатываемый запрос

Возвращает: объект AHUser, если заголовки заполнены. В случае если заголовок с именем пользователя не задан, возбуждается исключение AHAuthError

Пример: 

ah = AutheliaHelper(group_filter=[
  'app_admin',
  'app_user',
])
 
user = ah()