Один проект.
Одна идентичность.
Проект объединяет входы связанных сайтов и приложений. Вы сами определяете, где пользователь должен оставаться одним и тем же пользователем.
Что такое проект
Проект — общая область идентификации пользователей, а вход — конкретное подключённое приложение с собственным отображаемым именем и адресом возврата. Например, основной сайт, магазин и служба поддержки могут быть тремя входами одного проекта.
Создавайте отдельный проект для независимого продукта. Используйте один проект для приложений, которые должны узнавать одного пользователя по общему PrxID. Название проекта помогает ориентироваться в кабинете; оно не заменяет отображаемое имя конкретного входа.
Как связаны идентификаторы
один общий usr_…другой usr_…После успешного входа PrxID возвращает идентификатор пользователя с префиксом usr_. Сохраняйте его и используйте для поиска пользователя при повторных входах в пределах проекта.
Общий идентификатор позволяет сопоставлять записи одного пользователя между своими приложениями. Однако каждый сайт создаёт собственную сессию: совпадение ID не означает общую cookie, автоматический вход на другом домене или передачу всех данных аккаунта.
Разные проекты получают разные ID того же человека. Не используйте ID из одного проекта для поиска пользователя в другом и не считайте email или телефон заменой этой границы.
Как создать проект
- Войдите в Cloud через PrxID и откройте раздел PrxID в боковой панели.
- Нажмите «Создать проект» и прочитайте объяснение о секретном ключе.
- Удерживайте квадратную кнопку непрерывно пять секунд. Она заполняется синим, показывает обратный отсчёт, затем галочку. При раннем отпускании отсчёт сбрасывается. Поддерживаются мышь, касание, Space и Enter.
- На следующем шаге введите имя проекта. После создания откроется страница его входов.
После создания проекта добавьте входы ваших приложений и настройте их callback-адреса.
Как добавить вход
Внутри проекта нажмите «+». Введите отображаемое имя приложения и полный Redirect URL. Пользователь увидит это имя при подтверждении доступа на PrxID.
Redirect URL — адрес backend вашего приложения, который принимает code и state. Для публичного сайта используйте HTTPS. Для локального теста допустим HTTP на localhost или loopback-адресе.
https://example.com/auth/prxid/callbackАдрес сохраняется точно как введён: схема, домен, путь, параметры и завершающий слеш участвуют в проверке. В запросе входа и обмене кода передавайте то же значение.
Если подключение к PrxID ещё не готово, карточка получает статус «Ожидает подключения». Запись уже сохранена локально, но рабочие реквизиты ещё не выдаются. Кнопка повторного подключения использует ту же запись, а не создаёт новый вход.
Какие данные выдаются
| Значение | Для чего нужно | Где хранить |
|---|---|---|
idpart_link | Публичный ID конкретного входа, параметр ссылки /auth | Можно использовать в клиенте |
api_key | Токен для серверного обмена одноразового кода | Только на backend |
prxid_url | Базовый адрес PrxID из настроек Cloud | В конфигурации интеграции |
Каждый вход имеет собственный API-токен и idpart_link. Используйте реквизиты именно того входа, к которому относится callback вашего приложения.
Рабочие реквизиты появляются после успешного подключения входа. Токен в карточке скрыт; его можно показать или скопировать. Не публикуйте его в Git, frontend-коде, аналитике и журналах.
Границы и ограничения
- Проект и его входы доступны только владельцу в Cloud.
- Имя и фамилию в аккаунте Cloud можно заполнить самостоятельно: текущий партнёрский API PrxID их не передаёт.
- Баланс пока равен нулю, пополнение недоступно — сервисы на текущем этапе бесплатны.
- Входы ещё не поддерживают фотографии. Смена секретов, удаление проектов и отзыв токенов через Cloud пока не реализованы.