Создание проекта

Проект является основной единицей организации приложений в Авторизе.

Именно проект определяет:

• границы Single Sign-On (SSO);
• пространство профилей пользователей;
• набор приложений, работающих совместно;
• границы изоляции данных.

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

Когда создавать новый проект

Создавайте новый проект, если:

• это отдельный продукт (эко-система) с собственной пользовательской базой;
• пользователи не должны иметь SSO с другими системами;
• требуется полная изоляция данных пользователей;
• тестовое или staging окружение должно быть отделено от production;
• разные клиенты/бренды с независимыми пользователями.

Например:

• интернет-магазин;
• тестовое окружение интернет-магазина;
• образовательная платформа;
• корпоративный портал.

Каждый из этих сервисов должен использовать отдельный проект.

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

НЕ создавайте новый проект, если:

• это разные части одного продукта (например: web + mobile + admin);
• пользователи должны входить один раз и использовать все приложения;
• требуется единая учетная запись между сервисами.

Когда создавать приложение внутри существующего проекта

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

Например:

Проект "Интернет-магазин"
│
├── Веб-приложение
├── Мобильное приложение
├── API
└── Административная панель

В этом случае:

• все приложения используют общие профили пользователей;
• пользователь проходит аутентификацию один раз;
• Single Sign-On действует между всеми приложениями проекта.

Создавать отдельный проект для мобильного приложения или API в таком сценарии не требуется.

Параметры проекта

При создании проекта необходимо указать следующие данные.

Project ID

Уникальный идентификатор проекта внутри вашей учетной записи.

Используется системой для внутренней идентификации проекта.

Требования:

• только латинские символы в нижнем регистре (a-z);
• цифры (0-9);
• допускаются символы ., _, -;
• не может начинаться или заканчиваться специальным символом;
• у клиента не должно существовать проекта с таким же ID;
• максимальная длина — 100 символов.

Примеры:

my-project
my_shop
my-shop.dev
company_portal

После создания значение Project ID можно изменить.

Название проекта

Отображаемое имя проекта.

Используется в панели управления и может отображаться пользователям во время аутентификации.

Примеры:

Интернет-магазин
Корпоративный портал
Tapo4ki.ru

Максимальная длина — 100 символов.

Описание

Необязательное описание проекта.

Может использоваться для документирования назначения проекта и удобства администрирования.

Максимальная длина — 200 символов.

Создание проекта

Для создания проекта:

1. Откройте раздел Проекты.
2. Нажмите Создать проект.
3. Укажите Project ID.
4. Укажите название проекта.
5. При необходимости заполните описание.
6. Нажмите Создать.

После создания проект будет доступен в списке проектов.

На этом этапе проект еще не содержит приложений и не может использоваться для аутентификации пользователей.

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

Удаление проекта

Удаление проекта является необратимой операцией.

При удалении проекта:

• удаляются все приложения проекта;
• удаляются все профили пользователей проекта;
• прекращается работа всех интеграций, использующих данный проект.

Профили пользователей из других проектов при этом не затрагиваются.