# Переход на URL-адреса доступа для отдельных аккаунтов Платформа dbt В рамках постоянной работы над улучшением пользовательского опыта и повышением безопасности аккаунтам dbt назначаются индивидуальные URL-адреса доступа. Каждый аккаунт получит собственные уникальные URL-адреса доступа к dbt platform и [API](https://docs.getdbt.tech/docs/dbt-apis/overview.md), которые заменят прежние региональные 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-адрес доступа, ознакомьтесь с [графиком перехода](#migration-timeline) и обновите внешние интеграции аккаунта, используя [контрольный список интеграций](#integration-checklist). Если вашему аккаунту еще не назначен новый URL-адрес доступа, вы получите уведомления по электронной почте и в приложении с запланированной датой его активации. Когда изменение вступит в силу, вы будете автоматически перенаправлены на индивидуальный URL-адрес доступа вашего аккаунта. Процесс входа в аккаунт останется прежним. Интеграции будут поддерживаться как по новому URL-адресу доступа, так и по прежнему региональному URL-адресу в соответствии с датами в [графике перехода](#migration-timeline). Большинство интеграций можно обновить в любое время до даты окончания поддержки, но сетевые правила необходимо подготовить до даты назначения нового адреса. Краткая сводка приведена в [контрольном списке обновлений по срокам](#what-do-i-need-to-update-before-and-after-my-assignment-date). Обновите сетевые правила до даты назначения нового адреса Если ваша организация использует сетевые списки разрешений или [ограничения по IP-адресам](https://docs.getdbt.tech/docs/platform/secure/ip-restrictions.md), обновите следующие настройки до даты назначения нового адреса, чтобы избежать перебоев с доступом: * **Списки разрешений** — добавьте новый URL-адрес доступа и [URL-адреса доступа к API](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md#api-access-urls) вашего аккаунта. Формат URL-адресов для каждого региона приведен в разделе [Доступ к аккаунту](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md#accessing-your-account). * **IP-адреса** — для мультиарендных аккаунтов IP-адреса изменились. См. раздел [Доступ, регионы и IP-адреса](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md). IP-адреса одноарендных аккаунтов не меняются. * **Правила VPN, прокси-сервера и межсетевого экрана** — проверьте новый URL-адрес до даты назначения, следуя инструкциям в разделе [Проверка ограничений по IP-адресам](#validating-ip-restrictions). Если ваш аккаунт использует частное подключение для входящего трафика (ingress PrivateLink), [служба поддержки dbt](mailto:support@getdbt.com) свяжется с вами до назначения нового адреса и предоставит рекомендации для вашей конфигурации. ## График перехода Новые URL-адреса доступа назначаются аккаунтам во всех регионах и у всех поставщиков услуг. Прежние региональные URL-адреса будут поддерживать интеграции до даты окончания поддержки для вашего аккаунта. | Этап | Статус | Сроки | | ------------------------------------------------------------------------------ | ------------- | ------------------------------------------------ | | Назначение индивидуальных URL-адресов доступа мультиарендным аккаунтам | ✅ Завершено | Январь 2026 г. | | Назначение индивидуальных URL-адресов доступа одноарендным аккаунтам | В процессе | Апрель 2026 г. — март 2027 г. | | Окончание поддержки прежних региональных URL-адресов (мультиарендные аккаунты) | Запланировано | 3 февраля 2027 г. | | Окончание поддержки прежних региональных URL-адресов (одноарендные аккаунты) | Запланировано | Указано в уведомлении о назначении нового адреса | ## Контрольный список интеграций Ознакомьтесь со следующим контрольным списком до даты окончания поддержки прежнего регионального URL-адреса, указанной в [графике перехода](#migration-timeline). Обновите каждую интеграцию, использующую URL-адрес доступа к dbt. Если вашей интеграции нет в этом списке, обратитесь в ИТ-отдел или другую ответственную команду, чтобы определить, требуются ли какие-либо действия. Управляемое приложение dbt для GitHub, приложение Slack и вебхуки GitLab обновляются автоматически. Это не распространяется на самостоятельно управляемые приложения GitHub Enterprise и входящие сервисные хуки Azure DevOps. ### Управление идентификацией и доступом | Интеграция | Необходимое действие | | --------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | [SAML 2.0 SSO](https://docs.getdbt.tech/docs/platform/manage-access/set-up-sso-saml-2.0.md) | Изменять приложение поставщика удостоверений не требуется. Обновите все ссылки для входа, инициируемого поставщиком удостоверений, указав новый URL-адрес доступа. | | [Google Workspace SSO](https://docs.getdbt.tech/docs/platform/manage-access/set-up-sso-google-workspace.md#creating-credentials) | Обновите или добавьте клиент OAuth | | [SCIM (Okta)](https://docs.getdbt.tech/docs/platform/manage-access/scim.md#set-up-dbt-cloud) | Обновите базовый URL-адрес SCIM в Okta | ### Поставщики Git Репозитории GitLab и Azure DevOps, подключенные до назначения аккаунту индивидуального URL-адреса доступа, продолжают использовать прежний региональный URL-адрес для OAuth, пока вы их не обновите. Репозитории, подключенные после этого, уже используют новый URL-адрес доступа. Для GitLab администраторы аккаунта могут обновить существующее приложение GitLab в dbt platform, указав новый URL-адрес доступа к аккаунту. См. раздел [Обновление URI перенаправления в dbt platform](#update-redirect-uris-in-dbt-platform). Обновление существующего репозитория Azure DevOps пока недоступно. Вместо этого создайте репозиторий заново, чтобы сформировать URI перенаправления на основе нового URL-адреса доступа к аккаунту. | Интеграция | Необходимое действие | | -------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [GitLab (управляемое приложение)](https://docs.getdbt.tech/docs/platform/git/connect-gitlab.md#setting-up-a-gitlab-oauth-application) | Добавьте новый URI перенаправления в приложение группы GitLab, затем [обновите его в dbt platform](#update-redirect-uris-in-dbt-platform) | | [GitLab (собственное приложение)](https://docs.getdbt.tech/docs/platform/git/connect-gitlab.md#setting-up-a-gitlab-oauth-application) | Добавьте новый URI перенаправления в приложение группы GitLab, затем [обновите его в dbt platform](#update-redirect-uris-in-dbt-platform) | | [Azure DevOps (субъект-служба)](https://docs.getdbt.tech/docs/platform/git/setup-service-principal.md) | Обновите или добавьте регистрацию приложения | | GitHub Enterprise (самостоятельно управляемое приложение) | До даты назначения нового адреса добавьте в приложение GitHub URL-адрес обратного вызова из электронного письма с уведомлением о назначении. До даты окончания поддержки обновите URL-адреса вебхуков, указав новый URL-адрес доступа. | ### Подключения к платформам данных Подключения к платформам данных, созданные до назначения аккаунту индивидуального URL-адреса доступа, продолжают использовать прежний региональный URL-адрес для OAuth, пока вы их не обновите. Подключения, созданные после этого, уже используют новый URL-адрес доступа, поэтому менять их не требуется. Администраторы аккаунта могут обновить старые подключения OAuth к Snowflake, Databricks и BigQuery непосредственно в dbt platform, указав новый URL-адрес доступа. См. раздел [Обновление URI перенаправления в dbt platform](#update-redirect-uris-in-dbt-platform). | Интеграция | Необходимое действие | | --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | [Snowflake OAuth](https://docs.getdbt.tech/docs/platform/manage-access/set-up-snowflake-oauth.md#subdomain-migration) | Добавьте новый URI перенаправления в интеграцию безопасности, затем [обновите его в dbt platform](#update-redirect-uris-in-dbt-platform) | | [Snowflake External OAuth](https://docs.getdbt.tech/docs/platform/manage-access/snowflake-external-oauth.md#identity-provider-configuration) | Обновите URI перенаправления в приложении поставщика удостоверений (IdP) | | [Databricks OAuth](https://docs.getdbt.tech/docs/platform/manage-access/set-up-databricks-oauth.md) | Добавьте новый URI перенаправления в приложение OAuth Databricks, затем [обновите его в dbt platform](#update-redirect-uris-in-dbt-platform) | | [BigQuery OAuth](https://docs.getdbt.tech/docs/platform/manage-access/set-up-bigquery-oauth.md) | Добавьте новый URI перенаправления в клиент OAuth Google Cloud, затем [обновите его в dbt platform](#update-redirect-uris-in-dbt-platform) | | [Redshift External OAuth](https://docs.getdbt.tech/docs/platform/manage-access/redshift-external-oauth.md) | Обновите URI перенаправления в приложении поставщика удостоверений (IdP) | ### Обновление URI перенаправления в dbt platform Если у вашего аккаунта есть индивидуальный URL-адрес доступа, dbt platform отмечает все подключения OAuth к Snowflake, Databricks и BigQuery, а также приложения GitLab, которые по-прежнему используют прежний URI перенаправления. Для обновления подключений требуется [набор разрешений](https://docs.getdbt.tech/docs/platform/manage-access/enterprise-permissions.md) 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](https://docs.getdbt.tech/docs/platform/git/connect-gitlab.md#personally-authenticating-with-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 в политики списков разрешений до даты назначения нового адреса. См. [примечание о сетевых правилах](#what-does-this-mean-for-me). | | Входящие вебхуки | Обновите URL-адреса доступа в конфигурациях вебхуков | | [Интеграции с API](https://docs.getdbt.tech/docs/dbt-apis/overview.md) | Обновите URL-адреса доступа в клиентах API | | [Провайдер Terraform](https://registry.terraform.io/providers/dbt-labs/dbtcloud/latest/docs) | Обновите 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](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md#api-access-urls).  Где найти новые URL-адреса доступа моего аккаунта? См. раздел [URL-адреса доступа к API](https://docs.getdbt.tech/docs/platform/about-platform/access-regions-ip-addresses.md#api-access-urls).  Что нужно обновить до и после даты назначения нового адреса? | Когда | Что обновить | | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | До даты назначения нового адреса | [Сетевые списки разрешений](#what-does-this-mean-for-me), правила VPN, прокси-сервера и межсетевого экрана для [ограничений по IP-адресам](#validating-ip-restrictions), а также URL-адреса обратного вызова для самостоятельно управляемых приложений GitHub Enterprise | | После даты назначения нового адреса, но до даты окончания поддержки | URI перенаправления OAuth для [подключений к платформам данных](#data-platform-connections) и [поставщиков Git](#git-providers), настройки [управления идентификацией и доступом](#identity-and-access-management), клиенты API, конфигурации Terraform, входящие вебхуки и закладки |  Что произойдет, если я не обновлю интеграции до даты окончания поддержки? После даты окончания поддержки прежние региональные URL-адреса больше не будут активно поддерживаться. Обновите интеграции до этой даты, чтобы избежать перебоев в работе. За помощью обратитесь в [службу поддержки dbt](mailto:support@getdbt.com).  Продолжат ли работать мои токены API и вызовы API? Да. Персональные токены доступа и сервисные токены работают как с прежним региональным URL-адресом, так и с новым URL-адресом доступа. Запросы API к прежним региональным URL-адресам обрабатываются напрямую, без перенаправления, поэтому обновите клиенты API, указав новый URL-адрес доступа, до даты окончания поддержки.  На что не повлияет переход на новые URL-адреса доступа? Переход не затронет: * Код, модели и конфигурации вашего проекта dbt * Учетные данные для платформы данных (для подключений OAuth необходимо обновить URI перенаправления; см. раздел [Подключения к платформам данных](#data-platform-connections)) * Настройки аккаунта, среды, задания и расписания * Управляемое приложение dbt для GitHub, приложение Slack и вебхуки GitLab * Частные подключения для исходящего трафика * Основные функциональные возможности dbt platform Если у вас есть вопросы или нужна помощь, обратитесь в [службу поддержки dbt](mailto:support@getdbt.com).