Перейти к содержимому

Администрирование22 окт. 2026 г.3 минуты чтения

Единый вход

В стандартной настройке Mitra работает для одного человека без входа, и этого достаточно, пока сервер доступен только вам. Чтобы пользоваться одним сервером вместе с семьёй или командой, подключите его к провайдеру OpenID Connect (OIDC). Тогда каждый будет входить с уже имеющимся аккаунтом и получит собственные календари, которые больше никто не видит.

Mitra работает с любым стандартным провайдером OIDC. Например, Mitra используют с Pocket ID, Authelia, Authentik, Keycloak и Google.

CAUTION

После включения входа каждый человек получает новый пустой аккаунт, в том числе и вы. Всё, что вы настроили в однопользовательском режиме, остаётся в старом аккаунте и не переносится: подключённые аккаунты, настройки и все записи в календарях Mitra. Подключённые аккаунты легко добавить снова, а записи из календарей Mitra за вами не последуют. Включите вход до того, как начнёте наполнять Mitra, или сначала переместите эти записи в подключённый календарь (Переместить записи в… в меню ⋯ календаря), а потом снова подключите этот аккаунт.

Задайте переменные OIDC для контейнера:

services:
mitra:
image: ghcr.io/a11delavar/mitra:latest
environment:
MITRA_URL: 'https://mitra.example.com' # the address people use to reach Mitra
MITRA_OIDC_ISSUER: 'https://auth.example.com' # your provider's issuer URL
MITRA_OIDC_CLIENT_ID: 'mitra'
MITRA_OIDC_CLIENT_SECRET: '…' # leave out for a public client

У провайдера зарегистрируйте в качестве адреса перенаправления MITRA_URL, за которым следует /auth/callback:

https://mitra.example.com/auth/callback

Больше провайдеру ничего не нужно. Перезапустите Mitra командой docker compose up -d, и всем будет предложено войти.

Вход включается именно переменной MITRA_OIDC_ISSUER, и вместе с ней нужны MITRA_OIDC_CLIENT_ID и MITRA_URL. Если какой-то из них не хватает, Mitra не запустится. Молча работать без входа было бы гораздо хуже.

Секрет клиента и области доступа

Section titled “Секрет клиента и области доступа”

Если вы зарегистрировали у провайдера секрет клиента, задайте MITRA_OIDC_CLIENT_SECRET. Если вы зарегистрировали публичный клиент, не указывайте его: это полностью поддерживается, поскольку Mitra всегда использует PKCE.

Mitra запрашивает области доступа (scopes) openid profile email. Область openid обязательна, а две другие сообщают Mitra имя и адрес электронной почты каждого человека. Меняйте их через MITRA_OIDC_SCOPES, только если вашему провайдеру нужно что-то другое.

Любой, кого пропускает ваш провайдер, получает аккаунт Mitra при первом входе. Списка пользователей, которым нужно управлять, в Mitra нет, поэтому решайте, кто может входить, на стороне провайдера: по группам, назначению приложений или другим способом, которым он управляет доступом. Имя и адрес электронной почты каждого человека обновляются из данных провайдера при каждом входе.

Сам вход происходит на сервере (поток authorization code с PKCE). Браузер получает только cookie, и никакие токены в его хранилище не сохраняются, так что вредоносному скрипту на странице нечего украсть.

Сеанс длится 30 дней с последнего использования Mitra. Cookie помечается как secure, если MITRA_URL начинается с https://, а издатель (issuer) с адресом http:// допускается для провайдеров в вашей собственной сети без HTTPS. Если провайдер это поддерживает, при выходе из Mitra вы выходите и у провайдера.

  • Mitra не запускается и называет отсутствующую переменную. Если задана MITRA_OIDC_ISSUER, должны быть заданы также MITRA_OIDC_CLIENT_ID и MITRA_URL.
  • Провайдер жалуется на адрес перенаправления. Он должен в точности совпадать с MITRA_URL, за которым следует /auth/callback.
  • В журнале сказано, что не удалось обнаружить провайдера (discovery). Mitra ищет провайдера при первом входе и пробует снова при следующем, поэтому, если провайдер запускается позже Mitra, всё наладится само. Если ошибка повторяется, установите уровень журналирования debug и проверьте URL издателя и то, может ли Mitra к нему подключиться.
  • После включения входа мои календари пропали. Так и должно быть: каждый начинает с нового аккаунта. Подключите свои аккаунты снова.