Панель адміністратора платформи

Панель адміністратора платформи показує всі організації й облікові записи розгортання, використання відносно лімітів тарифу, нещодавні реєстрації та призупинення. Вона для людей, які обслуговують інстанс, а не для клієнтів.

Кожне розгортання має власну панель і список адміністраторів. Адміністратор на власному сервері бачить лише свій інстанс. У Railhook Cloud (railhook.io) список задано в середовищі розгортання сервісу, і облікових записів клієнтів у ньому немає.

Хто є адміністратором платформи

Людина є адміністратором платформи, якщо виконуються всі чотири умови. Сервер перевіряє їх під час кожного запиту до адмін-API:

• Її адреса електронної пошти є в PLATFORM_ADMIN_EMAILS.
• Адресу підтверджено.
• Обліковий запис активний, не вимкнений.
• Людина входила в систему менше ніж 12 годин тому. Після цього панель просить увійти ще раз.

Власник організації (OWNER) не є адміністратором платформи й не має доступу до жодної іншої організації.

Обережно

Вказуйте лише адреси, які ви контролюєте, і переконайтеся, що обліковий запис кожної людини захищений. Панель показує адреси учасників усіх організацій на розгортанні.

Увімкнення

Доки ви нікого не призначите, адміністраторів платформи немає. Перший зареєстрований обліковий запис адміністратором не стає: на публічному інстансі ним став би той, хто першим знайде сторінку реєстрації.

Призначте адміністраторів під час встановлення:

curl -fsSL https://railhook.io/install.sh | bash -s -- --domain hooks.example.com --admin-email ops@example.com

Кілька адрес указуйте через кому. Інсталятор відхиляє все, що не є адресою електронної пошти. Для вже наявного встановлення запустіть інсталятор із --refresh --dir <install dir> --admin-email <addresses>, а потім ./railhook start.

Щоб задати або змінити список вручну:

1. Зареєструйтеся або увійдіть на адресі вашого Railhook тим обліковим записом, який хочете використовувати, і підтвердьте адресу.

2. Додайте адресу в .env у каталозі встановлення: замініть наявний рядок або додайте новий:

   .env

   PLATFORM_ADMIN_EMAILS=ops@example.com,oncall@example.com

   Порівняння ігнорує регістр і пробіли довкола; збігаються лише повні адреси.

3. Перестворіть API, щоб він прочитав нове значення:

   ./railhook start

   ./railhook restart перезапускає контейнери, але не перечитує .env.

4. Увійдіть ще раз. Унизу бічної панелі з’явиться пункт Адміністратор платформи, що відкриває /admin/platform.

Обережно

Коли пошту вимкнено (типово), реєстрація позначає адресу підтвердженою, нічого не надсилаючи. Зареєструйте вказану адресу самі одразу після встановлення або ввімкніть пошту, щоб ніхто не зайняв її раніше.

У Kubernetes натомість задайте значення Helm:

values.yaml

platformAdmin:
  emails: "ops@example.com,oncall@example.com"

Порожня змінна (типово) вимикає панель: пункту меню ніхто не бачить, а адмін-API відмовляє кожному користувачеві, який увійшов.

Що показує панель

Розділ	Що в ньому
Огляд	Організації, облікові записи, реєстрації за сьогодні, за 7 і за 30 днів, події за сьогодні й за 30 днів, успішні та невдалі доставки за 24 години, активні тунелі, організації, що використали 80% або більше місячного ліміту подій, і останні реєстрації
Організації	Назва, тариф, адреса власника, дата створення, учасники, проєкти, події цього місяця відносно ліміту тарифу та статус. Пошук за назвою або за адресою учасника
Сторінка організації	Учасники з роллю, статусом і способом входу, проєкти, використання відносно тарифу, нещодавній журнал аудиту організації, а також призупинення чи відновлення
Користувачі	Кожен обліковий запис: адреса, чи її підтверджено, статус, способи входу, організації, дата створення та остання активність

Адміністраторів платформи позначено бейджем Адміністратор платформи у списку користувачів і серед учасників організації.

Коли білінг вимкнено (типово на власному сервері), кожна організація на безлімітному тарифі Self-Hosted, а використання показано як Без обмежень.

Панель ніколи не повертає хеші паролів, токени, матеріал API-ключів, секрети ендпоінтів чи вміст подій. Журнал аудиту організації показано без тіл запитів, які в ньому записано.

Призупинення організації

Призупинення та відновлення є єдиними змінами, які може зробити панель; решта лише для перегляду.

Призупинена організація не може нічого змінювати, зокрема приймати події, доки її не відновлять. Учасники й далі входять і переглядають дані та бачать вказану вами причину. Оплата не знімає призупинення.

Панель просить ввести назву організації та причину і записує вашу адресу як виконавця.

Що записується

Запити до адмін-API обмежено 120 на хвилину для кожного адміністратора. Кожен записується в журнал аудиту як PLATFORM_ADMIN_ACCESS з адміністратором, адресою джерела, організацією чи обліковим записом і результатом. Ці записи зберігаються окремо від журналів аудиту організацій. Призупинення чи відновлення також записується в журнал аудиту відповідної організації.

Токен оператора

PLATFORM_ADMIN_TOKEN є окремими обліковими даними для скриптів у заголовку X-Platform-Admin-Token. Токен дає доступ до того самого адмін-API і єдиний може ротувати ключі шифрування; адміністратор, що увійшов через панель, не може. Залиште змінну порожньою, якщо вона не потрібна. Обидві змінні є в довіднику конфігурації, кожен адмін-ендпоінт у довіднику API.