Учётная запись и доступ разработчика

Чтобы создавать модули для платформы Tango Vision, вам нужна учётная запись разработчика. Она никак не связана с учётными записями клиентских организаций платформы — разработчики живут в собственной области идентификации (realm) и никогда не получают доступа к данным клиентов.

Сотрудникам Tango Vision: вход через корпоративную учётную запись

Если вы работаете в Tango Vision, учётная запись у вас уже есть — корпоративная учётная запись сотрудника, с которой вы входите в другие внутренние инструменты (хаб-realm на auth.tangovision.dev). Не запрашивайте и не регистрируйте отдельную учётную запись разработчика: на странице входа разработчиков нажмите Tango Vision staff, войдите с учётными данными сотрудника — и учётная запись разработчика будет создана автоматически и связана с вашей корпоративной.

1. Откройте портал разработчика и нажмите Войти.
2. На странице входа Tango Vision Developers («Вход в учетную запись») нажмите Tango Vision staff под строкой «Или войдите с помощью».
3. Войдите на странице «Tango.Vision Employees» с учётной записью сотрудника.
4. Один раз примите Условия использования для разработчиков.

Вы вернётесь в портал уже вошедшим. Email уже подтверждён (он доверенно передаётся из realm сотрудников), учётная запись получает роль developer, а поскольку корпоративный email находится на домене компании, вы попадаете на внутренний уровень квот — 20 одновременно активных песочниц вместо 3. Всё остальное работает так же, как у внешних разработчиков: выпускайте ключи в портале или выполните npx @tv/extension-sdk login и в открывшемся браузере нажмите ту же кнопку Tango Vision staff (вход через CLI).

Чего SSO не даёт

• Токен реестра. Пакеты @tv/* — включая SDK CLI, которым создаётся модуль, — приходят из приватного реестра, у которого нет SSO. Перед Началом работы запросите у платформенной команды токен Verdaccio (операторский runbook: registry-developer-credentials).
• Права администратора над ключами других разработчиков. Сессия сотрудника управляет только своей организацией. Межорганизационное управление ключами (просмотр или отзыв ключей внешнего разработчика, выпуск ключей для другой организации) требует роли developer_admin, которую выдают ревьюерам по запросу.

Вас уже приглашали как внешнего разработчика с тем же email до появления SSO? При первом входе через корпоративную учётную запись будет предложено связать две учётные записи — подтвердите существующим паролем разработчика и пользуйтесь одной.

Регистрация

Регистрация по приглашению на время превью

Самостоятельная регистрация сейчас закрыта, пока платформа разработчиков находится в превью. Чтобы получить учётную запись разработчика, напишите на developers@tango.vision — мы создадим учётную запись для вашего адреса, и вы получите письмо со ссылкой для подтверждения адреса и установки собственного пароля (минимум 12 символов; не должен совпадать с email).

При создании учётной записи последовательно происходят три вещи:

1. Подтверждение email. Мы отправляем вам ссылку — перейдите по ней, чтобы подтвердить, что адрес ваш. Войти до этого нельзя.
2. Условия использования. При первом входе вы должны принять Условия использования для разработчиков. Это однократное действие.
3. Роль developer. После подтверждения ваша учётная запись автоматически получает роль developer — именно она авторизует вас в сервисах для разработчиков.

Вход

После подтверждения войдите в той же области (realm; сотрудники — через кнопку Tango Vision staff, см. выше):

https://auth.k8s.tangovision.dev/realms/developers/account

Забыли пароль? Нажмите Забыли пароль? на странице входа — ссылка для сброса придёт на ваш подтверждённый email.

Получить API-ключ песочницы

Работа над модулем ведётся в песочнице по запросу, доступ к которой даёт API-ключ песочницы (bearer-токен вида tvk_… для sandbox-api.k8s.tangovision.dev).

Выпускайте ключи сами в портале разработчика: войдите с подтверждённой учётной записью и выпустите ключи в области своей организации — без переписки по email. Открытый токен вы получите один раз — сразу сохраните его в менеджере секретов. У ключей есть область действия (sandbox по умолчанию) и срок жизни 90 дней. До 5 активных ключей на организацию; отзыв — там же.

Нужно что-то нестандартное?

Двое разработчиков работают над одной песочницей — см. Два разработчика, одна песочница. Ключ внутреннего уровня или увеличенный лимит ключей — напишите контакту, указанному в приветственном сообщении, на почту или в Telegram; адрес developers@tango.vision доходит до тех же людей.

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

Что ваша учётная запись может и чего не может

• ✅ Регистрировать песочницы и разрабатывать в них модули.
• ✅ Хранить API-ключи провижионера песочниц в области своей организации.
• ❌ Получать доступ к любой клиентской организации в продакшене или к её данным. Область разработчика намеренно отделена от учётных записей клиентских организаций.