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

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

Проекты изолированы друг от друга. Пользователи одного проекта не становятся автоматически доступны другим проектам.

Внутри одного проекта можно подключить несколько приложений и использовать общую систему входа пользователей.

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

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

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

Например:

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

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

Не создавайте отдельный проект, если это разные части одного продукта.

Например:

• веб-приложение;
• мобильное приложение;
• административная панель;
• API.

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

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

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

Чтобы создать проект, в кабинете Авторизы нажмите «Создать проект».

Авториза сразу создаёт готовый проект с минимальными настройками.

Вместе с проектом автоматически создаётся первое подключение типа Public.

Новый проект
     │
     ├── настройки проекта
     │
     └── первое подключение
             │
             └── тип Public

Созданный проект уже доступен для дальнейшей настройки.

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

Настройка созданного проекта

После создания проекта можно изменить его настройки.

Например:

• название;
• описание;
• другие параметры проекта, доступные в кабинете.

Начальные значения используются для того, чтобы проект можно было создать одним действием и сразу перейти к его настройке.

Настройка подключения

Вместе с проектом создаётся первое подключение типа Public.

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

Такое подключение не использует client_secret.

Для первого подключения обычно необходимо изменить Redirect URI.

Redirect URI — адрес страницы вашего приложения, на которую Авториза должна вернуть пользователя после входа.

Например:

https://example.com/auth/callback

Если приложение работает локально:

http://localhost:3000/auth/callback

После указания Redirect URI подключение готово для использования приложением.

Подробнее:

Настройка Redirect URI.

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

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

Project ID

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

Используется системой для построения ссылок и внутренней идентификации в рамках вашего личного кабинета. Этот идентификатор виден только вам.

Требования:

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

Примеры:

my-project
my_shop
my-shop.dev
company_portal

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

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

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

Примеры:

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

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

Описание

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

Используйте его, чтобы указать назначение проекта или другую информацию, полезную при администрировании.

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

Добавление других подключений

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

Это необходимо, если одному проекту требуется несколько независимых конфигураций, например для:

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

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

Подробнее:

Выбор типа приложения.

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

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

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

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

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