Просмотр рекомендованных рекомендаций по изменению «Моего домена»

Рекомендованные этапы перед изменением «Моего домена»

• Сохранить доступ: при изменении URL-адреса входа в «Мой домен» или URL-адреса сайта могут прекратить работу такие методы проверки подлинности, как единая регистрация (SSO) и многофакторная проверка подлинности (MFA). Прежде чем развертывать изменение в «Моем домене», сохраните доступ для входа администраторов и пользователей.
  

  Важно! Если вы не выполните эти рекомендации до развертывания изменения в URL-адресе входа «Моего домена», вы можете быть заблокированы в организации Salesforce.
• Подтвердите, что имя «Моего домена» отображает фирменный стиль: с помощью расширенных доменов все URL-адреса, размещаемые Salesforce для вашей организации, содержат имя «Моего домена», включая управляемые системой сайты Experience Cloud и URL-адреса сайтов Salesforce. Если изменение включает развертывание расширенных доменов, проверьте, чтобы имя «Моего домена» отражало ваш внешний фирменный стиль. В противном случае, можно переименовать «Мой домен» как часть изменения «Моего домена».
  

  Примечание Если вы используете настраиваемый домен, например, https://www.example.com, URL-адреса управляемого системой сайта не отображаются клиентам.
• Инициализация досрочно: чтобы развернуть изменения в расписании, сохраните нужное изменение «Моего домена» как минимум за 1 день до запланированного развертывания.

  После сохранения изменения в «Моем домене» Salesforce потом инициализирует домены. Другими словами, мы готовим новые URL-адреса «Моего домена» к активации. Процесс инициализации обычно заканчивается через несколько минут, но может занять до 24 часов. Проблемы с инициализацией редки, но иногда они требуют остановки процесса и повторного сохранения изменения «Моего домена», что перезапускает процесс.

  После завершения процесса инициализации администратор, запросивший изменение, получает электронное сообщение. Вы можете оставить новый «Мой домен» в статусе инициализации, сколько нужно. Или, если вы хотите не развертывать новый домен, вы можете отменить изменение.

  Самое главное, что до развертывания «Моего домена» пользовательские подключения не меняются. Если пользователь посещает новый URL-адрес входа «Моего домена», он перенаправляется на исходный URL-адрес входа «Моего домена». В противном случае, новые домены недоступны никому.

• «Понимание переадресаций после изменения «Моего домена» и отключение переадресаций во время тестирования—При каждом развертывании изменения сведений о «Моем домене» Salesforce перенаправляет предыдущие имена хостов «Моего домена» на имена хостов для текущего «Моего домена», если вы не отключите эти переадресации. Однако, если вы меняете «Мой домен» несколько раз, перенаправляется только последний набор URL-адресов «Моего домена» для вашей организации. Прежде чем развертывать изменение «Моего домена», ознакомьтесь с влиянием на любые существующие переадресации URL-адресов «Моего домена». Чтобы проверить наличие переадресаций для предыдущего «Моего домена», просмотрите раздел «Переадресации» на странице «Моего домена».

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

  Дополнительные сведения о переадресациях, управляющие ими параметры и способ регистрации переадресаций имени хоста «Моего домена» см. в разделе «Переадресации «Моего домена».

• Создайте запас жестко запрограммированных URL-адресов организации Salesforce: жестко запрограммированный URL-адрес используется в коде в виде обычного текста. Эти URL-адреса требуют обновления вручную при изменении URL-адреса, например, при изменении «Моего домена» или миграции организации. По этой причине Salesforce рекомендует использовать относительные и динамически созданные URL-адреса вместо жестко запрограммированных при любой возможности.

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

  Для поиска кода Salesforce загрузите метаданные для каждой организации Salesforce посредством такого инструмента, как Salesforce CLI. Потом используйте редактор кода, например, Microsoft Visual Studio, для поиска URL-адресов, принадлежащих организации, в которой вы планируете изменить «Мой домен». Чтобы определить, что искать, используйте URL-адрес экземпляра и ссылайтесь на форматы URL-адресов «Моего домена».

  Из-за времени, которое может потребоваться, рекомендуем создать запас на раннем этапе процесса изменения «Моего домена». Рекомендуем также, чтобы запас определил URL-адреса, указывающие на другую организацию Salesforce.

• Интеграции компьютерной телефонии (CTI), например, Open CTI и Service Cloud Voice: Взаимодействие с поставщиками телефонии: при развертывании расширенных доменов или развертывании изменения имени «Моего домена» URL-адреса, используемые в конфигурации Open CTI или Service Cloud Voice, меняются.

  Если вы используете Open CTI для интеграций, например, Salesforce Call Center и Click to Dial, обратитесь к поставщику телефонии для добавления новых URL-адресов к спискам разрешенных поставщика телефонии. Также просмотрите конфигурацию на наличие жестко запрограммированных ссылок на URL-адреса Salesforce. При любой возможности обновите жестко запрограммированные ссылки на относительные URL-адреса.

  Если вы используете Service Cloud Voice с Amazon Connect или Service Cloud Voice с партнерской телефонией от Amazon Connect, никаких действий не требуется. Salesforce обновляет конфигурацию при развертывании нового «Моего домена».

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

  Дополнительные сведения см. в разделе «Обновление организации и тестирование изменений «Моего домена».

• Обновление Mobile Publisher для приложений Experience Cloud: если вы настроили приложение Mobile Publisher для Experience Cloud, использующее URL-адрес сайта Experience Cloud .force.com, перед включением и развертыванием расширенных доменов в производстве обновите Mobile Publisher версии 10.0 или более поздней. Инструкции см. в разделе Mobile Publisher для приложений Experience Cloud и расширенных доменов

  Если вы используете настраиваемый домен, например, https:// www.example.com, для размещения сайта Experience Cloud и используете этот настраиваемый домен для приложения Mobile Publisher, это ограничение не применяется. Также это ограничение не распространяется на приложения Mobile Publisher для Lightning.

• Проверка конфигурации «Моего домена»—Изменение «Моего домена» — отличное время для проверки существующей конфигурации, ее записи для тестирования и проверки после развертывания и внесения изменений. Например, на странице входа в «Мой домен» обновите фирменный стиль или добавьте параметр входа посредством поставщика удостоверений. Чтобы просмотреть доступные параметры конфигурации, см. «Настройка параметров «Моего домена» и «Переадресации Моего домена».
• Документирование текущей конфигурации проверки подлинности—Если изменение «Моего домена» обновляет URL-адрес входа «Моего домена», URL-адрес сайтов Experience Cloud или URL-адрес сайтов Salesforce, рекомендуем задокументировать существующие параметры перед развертыванием изменения «Моего домена». Этот снимок является ценной справкой для вашего плана отката. Дополнительные сведения о параметрах для сбора см. в разделе Определение обязательных обновлений проверки подлинности после изменения «Моего домена».
• Замена ссылок на вход динамически созданными именами хостов—Для стабильности и дополнительного уровня безопасности рекомендуем использовать URL-адрес входа «Моего домена» для входа в Salesforce посредством кода. Чтобы оградить эти ссылки от будущих изменений «Моего домена», используйте Apex для извлечения URL-адреса. Чтобы получить имя хоста URL-адреса входа в «Мой домен» в Apex, используйте метод getOrgMyDomainHostname() класса System.DomainCreator. Если вы используете системное имя хоста для входа на сайт Experience Cloud, используйте метод getExperienceCloudSitesHostname() класса System.DomainCreator для получения этого имени хоста.

  Вы можете использовать динамически созданные имена хостов перед развертыванием изменения «Моего домена». При использовании динамически созданных имен хостов любое изменение соответствующего системного URL-адреса не влияет на связанный код. Этот метод уменьшает усилия после развертывания.

  Дополнительную информацию см. в разделе Вход в Salesforce посредством кода и класса DomainCreator в Руководстве разработчика Apex.

• Рассмотрите настраиваемый домен для обслуживания сайтов: настраиваемые домены позволяют использовать собственный домен (например, https://www.example.com) для обслуживания сайтов Experience Cloud и сайтов Salesforce. Хотя ваша организация Salesforce предоставляет содержимое, сайт обслуживается на настраиваемом домене, предоставляя пользователям четкий фирменный стиль. Поэтому Salesforce рекомендует обслуживать сайты на настраиваемом домене.

  Если вы рассматриваете настраиваемый домен, рекомендуем настроить настраиваемый домен до любых отложенных изменений «Моего домена», по возможности. Даже при изменении URL-адреса управляемого системой сайта клиенты продолжают использовать настраиваемый домен. Эта стабильность уменьшает количество обновлений, необходимых после изменения «Моего домена». Например, если вы ссылаетесь на URL-адрес сайта в маркетинговых материалах, сообщениях эл. почты, страницах социальных сетей и шаблонах, настраиваемый домен остается действительным.

  Дополнительную информацию см. в разделе «Настраиваемые домены».

• Рекомендуем проверить адреса пользователей—Изменение URL-адреса входа в «Мой домен» — отличное время для проверки пользователей в рамках развертывания нового URL-адреса входа. Используйте проверку асинхронной электронной почты для отправки сообщений эл. почты внутренним и внешним пользователям, чтобы обеспечить их регистрацию с действительным собственным адресом эл. почты. Асинхронные электронные сообщения содержат ссылку проверки (URL-адрес). Вы также можете создать фирменный стиль проверочных сообщений эл. почты, настроив шаблон эл. почты.

  Дополнительные сведения см. в разделе «Проверка адресов эл. почты посредством асинхронной электронной почты».

Понимание времени внесения обновлений в организацию

Чтобы создать план тестирования и реализации, ознакомьтесь с способами обновления организации с учетом изменения «Моего домена» и образцов контрольных списков для изменения «Моего домена».

Не все этапы применимы к каждой организации. При создании плана удалите неприменимые шаги для изменения «Моего домена». Потом расставьте приоритеты обновлений для внесения после развертывания изменения «Моего домена». Например, проверка подлинности и списки разрешенных обязательны для заполнения до начала тестирования основной массой пользователей.

Чтобы сократить простой в производстве, определите, какие обновления можно внести перед развертыванием изменения «Моего домена». Потом внесите как можно больше этих обновлений в производстве, прежде чем развертывать изменение.

Чтобы помочь вам оценить время, необходимое для развертывания производства, обратите внимание на обновления, требующие новых URL-адресов «Моего домена», и добавьте обновления в план внедрения.

Рекомендации плана тестирования

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

Ниже указаны рекомендации для плана тестирования изменения «Моего домена».

• Протестируйте изменения «Моего домена» в безопасной среде перед обновлением производственной среды. Невозможно тестировать в производстве, не влияя на пользователей. После развертывания изменения «Моего домена» оно немедленно применяется ко всем пользователям и третьим лицам, имеющим доступ к вашей организации.
• Расставьте приоритеты областей для тестирования. Если у вас есть автоматизированные тесты, выполните эти тесты перед началом тестирования конечного пользователя. Сосредоточьтесь на самом большом влиянии на ваше предприятие и областях, в которых решение проблемы может занять больше времени. Например, некоторые клиенты сначала тестируют общедоступные сайты и функции, приносящие доход. Или, чтобы предоставить больше времени для устранения неполадок, пока тестировщики заняты, можно расставить приоритеты сложных настроек. И поскольку решение проблем с функциями доставки пакета часто требует работы с разработчиком пакета, протестируйте важные функции пакета на раннем этапе.
• Если вы установили пакеты из AppExchange, добавьте функции и компоненты, доставленные пакетом, в тестирование. Сосредоточьтесь на компонентах со ссылками. Например, доставленная пакетом страница Visualforce может содержать ссылки на ваши сайты, содержимое или другие страницы Visualforce. Чтобы помочь распределить проблемы, рекомендуем отметить установленные пакеты и соответствующие функции в плане тестирования.

  В большинстве случаев эти доставленные пакетом компоненты невозможно отредактировать. И если вы можете обновить один из этих компонентов, будущее обновление пакета может перезаписать изменения.

  Рекомендуем разработчикам пакета AppExchange использовать относительные пути для создания любых ссылок. Если они придерживаются этого подхода, обновленные ссылки работают после изменения «Моего домена», например, включения расширенных доменов. Однако, не все разработчики пакета следуют этой рекомендации. Если вы обнаружите проблему с компонентами или функциями, предоставленными пакетом, исправление может потребовать обновленной версии пакета. Поэтому рекомендуем протестировать функции, предоставленные пакетом, на раннем этапе тестирования и встроить время в общий проект для исправления пакета.

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

Рекомендации по планам

План внедрения обеспечивает выполнение важных шагов при развертывании изменения в производстве.

Ниже указаны некоторые рекомендации для плана внедрения изменения «Моего домена».

• Добавьте шаги для инициализации изменения и проверки готовности изменения к развертыванию.
• Многие из этих изменений, например, обновление списков разрешенных и жестко запрограммированных URL-адресов, можно внести в производственную среду перед развертыванием нового «Моего домена». Чтобы сократить простой в производстве, внесите как можно больше изменений перед началом работы.
• Сведения о любых действиях, которые можно выполнить только после развертывания изменения «Моего домена». Внесите все другие изменения до окна развертывания производственной среды.
• Уточните ответственных и предлагаемое время для каждого этапа со всеми участниками.
• Запланируйте событие обслуживания для всех задействованных общедоступных сайтов.
• В рамках итоговой подготовки к запуску подтвердите доступность и контактные данные для всех участников.
• Добавьте соответствующие уведомления для пользователей и клиентов в план.
• Чтобы минимизировать влияние на пользователей и клиентов, разверните новый «Мой домен», когда ваша организация получает минимальный трафик, например, в выходные.
• Внедрите механизмы предоставления общего доступа к сайтам сразу после завершения связанного тестирования.

Пример действий высокого уровня см. в разделах «Подготовка к обновлению производства», «Обновление производства» и «Внедрение после развертывания» примера контрольного списка проекта «Изменение «Моего домена». Примеры действий, которые необходимо выполнить после развертывания изменения «Моего домена», см. в контрольных списках примеров задач перед развертыванием и после развертывания.

Рекомендации после развертывания

После развертывания изменения «Моего домена» Salesforce перенаправляет предыдущие имена хостов. Чтобы помочь пользователям обновить устаревшие закладки и ссылки, сообщите им о новом URL-адресе до его переадресации. Включите параметр «Мой домен» «Уведомлять пользователей перед переадресацией на текущий URL-адрес «Моего домена». См. Управление переадресациями «Моего домена».

Если вы включили и развернули расширенные домены, Salesforce остановил некоторые из этих переадресаций в выпуске Winter ’25 для безопасных сред, организаций Developer Edition, организаций исправления, стартовых организаций и рабочих областей Trailhead. В производственных и демонстрационных организациях эти переадресации прекращаются в выпуске Spring ’26. Просмотрите имена задействованных хостов и протестируйте потенциальное влияние этого изменения. Дополнительную информацию см. в разделе «Подготовка к окончанию переадресаций для нерасширенных доменов».

Чтобы обнаружить посещения старых имен хостов, рекомендуем включить регистрацию переадресации имен хостов. Потом, чтобы собрать журналы переадресации имени хоста на несколько дней, запланируйте ежедневный запрос типа события переадресации имени хоста посредством REST API. Например, можно настроить задание cron в Unix или запланированную задачу в Windows для выполнения запроса. Дополнительную информацию см. в разделе «Запись переадресаций имени хоста «Моего домена» и «Тип события переадресаций имени хоста» в ссылке на объект для Salesforce Platform.

Определите необходимость отключения всех предыдущих переадресаций. Например, если ваш фирменный стиль изменился, определите, хотите ли вы, чтобы пользователи имели доступ к вашей организации Salesforce или сайтам посредством ссылок на предыдущий «Мой домен». Дополнительные сведения о переадресациях см. в разделе «Переадресации «Моего домена». Если вы хотите удалить переадресации для предыдущих имен хостов, обрабатывайте их как второе изменение «Моего домена» для тестирования и связи.