Перейти к основному контенту

🔐 ETN Authenticator

Категория: Платформы экосистемы и инструменты разработчика Аудитория: Сторонние разработчики, Интеграторы

Обзор​

ETN Authenticator — это бэкенд-инфраструктура, питающая экосистему ETN. Она сокращает разрыв между удобством Web2 и безопасностью Web3, предлагая разработчикам гибкие способы верификации пользователей и обработки платежей.

"Правило входа" в экосистему​

Чтобы опубликовать приложение в магазине приложений экосистемы ETN (App Store), разработчики должны следовать одному из двух путей интеграции:

  1. Путь Идентичности: Интеграция ETN Authenticator для обеспечения безопасного и верифицированного управления пользователями.
  2. Путь Экономики: Интеграция ETN Pay в качестве единственного принятого способа оплаты внутри приложения.

Путь 1: Опции интеграции идентичности​

Мы понимаем, что не каждый разработчик готов изучать сложные блокчейн-библиотеки. ETN Authenticator предлагает два различных метода интеграции:

Опция A: Стандартный OAuth 2.0 (для Web2) 🚀​

Лучше всего для: Разработчиков, которые хотят опыт в стиле "Войти через Google" без управления кодом блокчейна.

  • Управляемые сессии и обновление токенов: Аутентификатор обрабатывает весь жизненный цикл сессии за вас. Он выпускает безопасные Session IDs и автоматически управляет Token Refreshers, гарантируя, что ваши пользователи остаются в системе без необходимости создавать сложную логику поддержки сессии.
  • Не требуются блокчейн-библиотеки: Вам не нужно устанавливать @ton/core или изучать TON SDK.
  • Стандартная реализация: Используйте любую стандартную библиотеку OAuth 2.0 / OIDC для вашего языка (Node.js, Python, PHP и т.д.) для перенаправления пользователей на нашу страницу авторизации.

Поток:

  1. Перенаправьте пользователя на https://account.etnecosystem.org/oauth/authorize.
  2. Пользователь безопасно входит на нашей платформе (через Кошелек или ETN Number).
  3. Мы возвращаем стандартный code авторизации на ваш callback URL.
  4. Вы обмениваете код на профиль пользователя, токен доступа и токен обновления.

Опция B: Нативный Web3 (TON Connect) 💎​

Лучше всего для: DApps и платформ, требующих криптографической верификации на стороне клиента.

  • Криптографическая верификация: Требует установки Библиотек TON для верификации нагрузок ton_proof и signData напрямую.
  • Прямое взаимодействие: Позволяет вашему фронтенду запрашивать подписи напрямую у кошелька пользователя без перенаправления на хостинговую страницу.

Путь 2: Интеграция экономики (ETN Pay) 💳​

ETN Pay — это безопасный платежный шлюз для ETN Jetton на блокчейне TON. Он разработан для суверенитета, стабильности и простоты использования, отделяя сложную логику блокчейна от вашего процесса оформления заказа.

Статус: Закрытая Бета

Почему стоит выбрать ETN Pay?​

  • Упрощенная интеграция: Мерчанты используют простой API. На вашем сервере не требуются сложные блокчейн-библиотеки или TON SDK.
  • Надежность прежде всего:
    • Сервис Оракула цен: Мы кэшируем курсы ETN/USD каждые 5 минут. Создание вашего счета считывает данные из этого локального кэша, обеспечивая нулевое время простоя, даже если внешние API цен отключатся.
    • Атомарное разделение: Идеально для моделей платформ. Мы поддерживаем разделение платежей (например, 99.5% Мерчанту, 0.5% Платформе) в одной атомарной блокчейн-транзакции.
  • Гарантированная сверка: Наш сервис TON Listener мониторит блокчейн на наличие уникальных мемо транзакций, гарантируя, что каждый платеж отслеживается, проверяется и сообщается вам через подписанные вебхуки.

Поток оплаты​

  1. Счет: Вы отправляете POST-запрос с суммой в USD. Мы конвертируем ее в ETN и возвращаем уникальный счет.
  2. Оплата: Пользователь перенаправляется на Хостинговый фронтенд ETN Pay для подключения кошелька и оплаты.
  3. Расчет: Наша система обнаруживает транзакцию в чейне, помечает счет как PAID и отправляет вебхук, верифицированный X-ETN-Signature, на ваш бэкенд.

Ответственность разработчика​

Независимо от выбранного пути интеграции (Идентичность или Экономика), все разработчики должны придерживаться стандартов доверия экосистемы:

  • KYC разработчика: Должны подтвердить личность (Государственное удостоверение / Лицензия на бизнес) для получения учетных данных API.
  • Обязывающие соглашения: Должны криптографически подписать Соглашение Разработчика, создавая юридически обязывающее обязательство соблюдать конфиденциальность данных пользователей.

Доступ к API и Ценообразование​

  • API Аутентификации: Доступ к ETN Authenticator (OAuth или Web3) предоставляется партнерам экосистемы.
  • Доступ к протоколам Web3: Расширенный доступ к конкретным протоколам Web3 (например, Блокчейн-телефония, SMS-центр) может повлечь расходы в зависимости от использования, оплачиваемые в $ETN.