Переход на URL-адреса доступа для отдельных аккаунтов

В рамках постоянной работы над улучшением пользовательского опыта и повышением безопасности аккаунтам dbt назначаются индивидуальные URL-адреса доступа. Каждый аккаунт получит собственные уникальные URL-адреса доступа к dbt platform и API, которые заменят прежние региональные URL-адреса, используемые сейчас несколькими аккаунтами. Индивидуальный URL-адрес доступа начинается с уникального для вашего аккаунта префикса, например ab123.

Развертывание	Прежний региональный URL-адрес (общий)	Индивидуальный URL-адрес доступа
Мультиарендное (Северная Америка)	cloud.getdbt.com	ab123.us1.dbt.com
Мультиарендное (EMEA)	emea.dbt.com	ab123.eu1.dbt.com
Мультиарендное (APAC)	au.dbt.com	ab123.au1.dbt.com
Одноарендное	acme.getdbt.com	ab123.acme.dbt.com

Что это значит для меня?

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

Если вашему аккаунту еще не назначен новый URL-адрес доступа, вы получите уведомления по электронной почте и в приложении с запланированной датой его активации. Когда изменение вступит в силу, вы будете автоматически перенаправлены на индивидуальный URL-адрес доступа вашего аккаунта. Процесс входа в аккаунт останется прежним. Интеграции будут поддерживаться как по новому URL-адресу доступа, так и по прежнему региональному URL-адресу в соответствии с датами в графике перехода. Большинство интеграций можно обновить в любое время до даты окончания поддержки, но сетевые правила необходимо подготовить до даты назначения нового адреса. Краткая сводка приведена в контрольном списке обновлений по срокам.

Обновите сетевые правила до даты назначения нового адреса

Если ваша организация использует сетевые списки разрешений или ограничения по IP-адресам, обновите следующие настройки до даты назначения нового адреса, чтобы избежать перебоев с доступом:

• Списки разрешений — добавьте новый URL-адрес доступа и URL-адреса доступа к API вашего аккаунта. Формат URL-адресов для каждого региона приведен в разделе Доступ к аккаунту.
• IP-адреса — для мультиарендных аккаунтов IP-адреса изменились. См. раздел Доступ, регионы и IP-адреса. IP-адреса одноарендных аккаунтов не меняются.
• Правила VPN, прокси-сервера и межсетевого экрана — проверьте новый URL-адрес до даты назначения, следуя инструкциям в разделе Проверка ограничений по IP-адресам.

Если ваш аккаунт использует частное подключение для входящего трафика (ingress PrivateLink), служба поддержки dbt свяжется с вами до назначения нового адреса и предоставит рекомендации для вашей конфигурации.

График перехода

Новые URL-адреса доступа назначаются аккаунтам во всех регионах и у всех поставщиков услуг. Прежние региональные URL-адреса будут поддерживать интеграции до даты окончания поддержки для вашего аккаунта.

Этап	Статус	Сроки
Назначение индивидуальных URL-адресов доступа мультиарендным аккаунтам	✅ Завершено	Январь 2026 г.
Назначение индивидуальных URL-адресов доступа одноарендным аккаунтам	В процессе	Апрель 2026 г. — март 2027 г.
Окончание поддержки прежних региональных URL-адресов (мультиарендные аккаунты)	Запланировано	3 февраля 2027 г.
Окончание поддержки прежних региональных URL-адресов (одноарендные аккаунты)	Запланировано	Указано в уведомлении о назначении нового адреса

Контрольный список интеграций

Ознакомьтесь со следующим контрольным списком до даты окончания поддержки прежнего регионального URL-адреса, указанной в графике перехода. Обновите каждую интеграцию, использующую URL-адрес доступа к dbt. Если вашей интеграции нет в этом списке, обратитесь в ИТ-отдел или другую ответственную команду, чтобы определить, требуются ли какие-либо действия.

Управляемое приложение dbt для GitHub, приложение Slack и вебхуки GitLab обновляются автоматически. Это не распространяется на самостоятельно управляемые приложения GitHub Enterprise и входящие сервисные хуки Azure DevOps.

Управление идентификацией и доступом

Интеграция	Необходимое действие
SAML 2.0 SSO	Изменять приложение поставщика удостоверений не требуется. Обновите все ссылки для входа, инициируемого поставщиком удостоверений, указав новый URL-адрес доступа.
Google Workspace SSO	Обновите или добавьте клиент OAuth
SCIM (Okta)	Обновите базовый URL-адрес SCIM в Okta

Поставщики Git

Репозитории GitLab и Azure DevOps, подключенные до назначения аккаунту индивидуального URL-адреса доступа, продолжают использовать прежний региональный URL-адрес для OAuth, пока вы их не обновите. Репозитории, подключенные после этого, уже используют новый URL-адрес доступа.

Для GitLab администраторы аккаунта могут обновить существующее приложение GitLab в dbt platform, указав новый URL-адрес доступа к аккаунту. См. раздел Обновление URI перенаправления в dbt platform. Обновление существующего репозитория Azure DevOps пока недоступно. Вместо этого создайте репозиторий заново, чтобы сформировать URI перенаправления на основе нового URL-адреса доступа к аккаунту.

Интеграция	Необходимое действие
GitLab (управляемое приложение)	Добавьте новый URI перенаправления в приложение группы GitLab, затем обновите его в dbt platform
GitLab (собственное приложение)	Добавьте новый URI перенаправления в приложение группы GitLab, затем обновите его в dbt platform
Azure DevOps (субъект-служба)	Обновите или добавьте регистрацию приложения
GitHub Enterprise (самостоятельно управляемое приложение)	До даты назначения нового адреса добавьте в приложение GitHub URL-адрес обратного вызова из электронного письма с уведомлением о назначении. До даты окончания поддержки обновите URL-адреса вебхуков, указав новый URL-адрес доступа.

Подключения к платформам данных

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

Администраторы аккаунта могут обновить старые подключения OAuth к Snowflake, Databricks и BigQuery непосредственно в dbt platform, указав новый URL-адрес доступа. См. раздел Обновление URI перенаправления в dbt platform.

Интеграция	Необходимое действие
Snowflake OAuth	Добавьте новый URI перенаправления в интеграцию безопасности, затем обновите его в dbt platform
Snowflake External OAuth	Обновите URI перенаправления в приложении поставщика удостоверений (IdP)
Databricks OAuth	Добавьте новый URI перенаправления в приложение OAuth Databricks, затем обновите его в dbt platform
BigQuery OAuth	Добавьте новый URI перенаправления в клиент OAuth Google Cloud, затем обновите его в dbt platform
Redshift External OAuth	Обновите URI перенаправления в приложении поставщика удостоверений (IdP)

Обновление URI перенаправления в dbt platform

Если у вашего аккаунта есть индивидуальный URL-адрес доступа, dbt platform отмечает все подключения OAuth к Snowflake, Databricks и BigQuery, а также приложения GitLab, которые по-прежнему используют прежний URI перенаправления. Для обновления подключений требуется набор разрешений Account Admin или Project Creator. Для обновления приложения GitLab требуется набор разрешений Account Admin.

1. В разделе Account settings в dbt platform перейдите в Connections (или Integrations для GitLab) и выберите отмеченный элемент. На странице отобразится новый URI перенаправления.
2. Добавьте новый URI перенаправления в конфигурацию OAuth вашей платформы данных или GitLab, сохранив существующий. Существующий URI продолжит работать, пока вы его не удалите.
3. В dbt platform нажмите Update redirect URI.
4. Проверьте подключения к платформам данных, повторно выполнив вход с учетными данными для разработки. Для GitLab повторите процедуру персональной авторизации в GitLab в разделе Account settings > Personal profile > Linked accounts. Прежде чем удалять старый URI перенаправления, убедитесь, что соответствующая процедура OAuth успешно завершается возвратом в dbt platform.

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

Если после обновления войти не удается, у вас есть 7 дней, чтобы отменить это изменение. Откройте подключение или приложение GitLab и нажмите Revert to previous URI, чтобы восстановить прежний URI перенаправления на время устранения проблемы. Убедившись, что все интеграции работают с новым URI, удалите старый URI из вашей платформы данных или GitLab.

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

Сеть и API

Интеграция	Необходимое действие
Сетевые списки разрешений	Добавьте новый URL-адрес доступа и URL-адреса доступа к API в политики списков разрешений до даты назначения нового адреса. См. примечание о сетевых правилах.
Входящие вебхуки	Обновите URL-адреса доступа в конфигурациях вебхуков
Интеграции с API	Обновите URL-адреса доступа в клиентах API
Провайдер Terraform	Обновите URL-адреса доступа в конфигурации Terraform
Закладки браузера	Обновите личные и общие закладки

Проверка ограничений по IP-адресам

Если вы получили уведомление о назначении нового URL-адреса доступа и у вас включены ограничения по IP-адресам, проверьте сетевые правила, в которых явно указан прежний региональный URL-адрес. К ним относятся правила раздельного туннелирования VPN, правила прокси-сервера (PAC) и правила исходящего трафика межсетевого экрана. Обновите эти правила для нового URL-адреса доступа до запланированной даты его назначения аккаунту, чтобы избежать перебоев с доступом.

Чтобы убедиться, что новый URL-адрес доступа доступен, отправьте тестовый запрос из той же сети, которую вы обычно используете для доступа к прежнему региональному URL-адресу. Замените NEW_ACCESS_URL новым URL-адресом доступа вашего аккаунта, а ACCOUNT_ID — идентификатором аккаунта:

• Браузер: перейдите по адресу https://NEW_ACCESS_URL/api/v2/accounts/ACCOUNT_ID/
• Терминал: выполните curl https://NEW_ACCESS_URL/api/v2/accounts/ACCOUNT_ID/

Результат	Содержимое ответа	Что это означает
✅ Проверка пройдена	{ ... "detail": "Authentication credentials were not provided." ... }	Запрос достиг API и прошел проверку ограничений по IP-адресам. Аутентифицированный сеанс отсутствует, что ожидаемо для этого теста.
⚠️ Доступ заблокирован	{ ... "user_message": "Forbidden: Access denied" ... }	IP-адрес запроса отсутствует в вашем списке разрешений. Обновите сетевые правила исходящего трафика для нового URL-адреса доступа и повторите проверку.

Часто задаваемые вопросы

 Почему меняются URL-адреса доступа?

Мы переходим от общих региональных URL-адресов к индивидуальным URL-адресам аккаунтов, чтобы улучшить пользовательский опыт и повысить безопасность. Это изменение делает URL-адреса более информативными, упрощая управление URL-адресами dbt, и позволяет применять более строгие политики для файлов cookie и токенов, чтобы защитить данные аккаунтов.

 Как узнать, назначены ли моему аккаунту новые URL-адреса доступа?

Войдите в свой аккаунт dbt platform. Если адрес в браузере начинается с префикса аккаунта, например ab123.us1.dbt.com, вашему аккаунту назначен новый URL-адрес доступа. Если в браузере отображается прежний региональный URL-адрес, например cloud.getdbt.com, emea.dbt.com или au.dbt.com, вашему аккаунту еще не назначен новый URL-адрес доступа. Дополнительные сведения см. в разделе URL-адреса доступа к API.

 Где найти новые URL-адреса доступа моего аккаунта?

См. раздел URL-адреса доступа к API.

 Что нужно обновить до и после даты назначения нового адреса?

Когда	Что обновить
До даты назначения нового адреса	Сетевые списки разрешений, правила VPN, прокси-сервера и межсетевого экрана для ограничений по IP-адресам, а также URL-адреса обратного вызова для самостоятельно управляемых приложений GitHub Enterprise
После даты назначения нового адреса, но до даты окончания поддержки	URI перенаправления OAuth для подключений к платформам данных и поставщиков Git, настройки управления идентификацией и доступом, клиенты API, конфигурации Terraform, входящие вебхуки и закладки

 Что произойдет, если я не обновлю интеграции до даты окончания поддержки?

После даты окончания поддержки прежние региональные URL-адреса больше не будут активно поддерживаться. Обновите интеграции до этой даты, чтобы избежать перебоев в работе. За помощью обратитесь в службу поддержки dbt.

 Продолжат ли работать мои токены API и вызовы API?

Да. Персональные токены доступа и сервисные токены работают как с прежним региональным URL-адресом, так и с новым URL-адресом доступа. Запросы API к прежним региональным URL-адресам обрабатываются напрямую, без перенаправления, поэтому обновите клиенты API, указав новый URL-адрес доступа, до даты окончания поддержки.

 На что не повлияет переход на новые URL-адреса доступа?

Переход не затронет:

• Код, модели и конфигурации вашего проекта dbt
• Учетные данные для платформы данных (для подключений OAuth необходимо обновить URI перенаправления; см. раздел Подключения к платформам данных)
• Настройки аккаунта, среды, задания и расписания
• Управляемое приложение dbt для GitHub, приложение Slack и вебхуки GitLab
• Частные подключения для исходящего трафика
• Основные функциональные возможности dbt platform

Если у вас есть вопросы или нужна помощь, обратитесь в службу поддержки dbt.

Нашли ошибку?

Создать GitHub Issue