4.5 KiB
Аутентификация Reverse Proxy
Этот метод аутентификации часто используется для SSO (Технология единого входа), особенно удобно в больших организациях.
Аутентификация выполняется с помощью другой системы, поэтому Канборд не знает вашего пароля и допускает вас к приложению, так как вы уже прошли аутентификацию.
Требования¶
- Правильно сконфигурированный reverse proxy
или
- Apache Auth на том же сервере
Как это работает?¶
-
Ваш reverse proxy аутентифицирует пользователя и посылает имя пользователя через заголовок HTTP.
-
Канборд извлекает имя пользователя из запроса
-
Пользователь создается в Канборд автоматически (опция настраивается)
-
Открывается новая сессия Канборд (дополнительная аутентификация в Канборд не нужна)
-
Инструкция по установке¶
Настройка вашего reverse proxy¶
В рамках данной документации не рассматривается установка и настройка reverse proxy. Вы должны убедится, что логин пользователя отправляется с reverse proxy в заголовке HTTP.
Настройки Канборда¶
Создайте свой файл конфигурации config.php или скопируйте конфигурацию из файла config.default.php:
<?php
// Enable/disable reverse proxy authentication
define('REVERSE_PROXY_AUTH', true); // Set this value to true
// The HTTP header to retrieve. If not specified, REMOTE_USER is the default
define('REVERSE_PROXY_USER_HEADER', 'REMOTE_USER');
// The default Kanboard admin for your organization.
// Since everything should be filtered by the reverse proxy,
// you should want to have a bootstrap admin user.
define('REVERSE_PROXY_DEFAULT_ADMIN', 'myadmin');
// The default domain to assume for the email address.
// In case the username is not an email address, it
// will be updated automatically as USER@mydomain.com
define('REVERSE_PROXY_DEFAULT_DOMAIN', 'mydomain.com');
Примечание:
-
Если proxy находится на том же сервере, что и Канборд, то в соответствии с протоколом <http://www.ietf.org/rfc/rfc3875>`__ имя заголовка будет
REMOTE_USER. Например, Apache добавляетREMOTE_USERпо умолчанию, если установленоRequire valid-user. -
Если Apache служит reverse proxy для другого Apache выполняющего Канборд, то заголовок
REMOTE_USERне установлен (это же относится к IIS и Nginx). -
Если у вас имеется действующий reverse proxy, то проект HTTP ICAP предполагает, что заголовок должен быть
X-Authenticated-User. Этот стандарт де-факто был принят разными инструментами.