Atualizar sua organização para alterações em Meu domínio

Crie um inventário de links e redirecionamentos que levam o usuário de uma organização do Salesforce diferente para a organização na qual você planeja alterar o Meu domínio. Pesquise em todas as suas organizações do Salesforce.

Por exemplo, um link embutido em código em uma página do Visualforce em uma sandbox leva um usuário a um URL de produção, como um arquivo ou outra página do Visualforce. Ou, se você tiver várias organizações de produção e usar redirecionamentos para direcionar os usuários para a organização correta, observe os locais no seu código onde esses redirecionamentos ocorrem.

Planeje atualizar esses links e redirecionamentos depois de implementar sua alteração do Meu domínio.

Se o redirecionamento incluir um parâmetro de redirecionamento em código ou em um URL, planeje também atualizar a lista de permissões de URLs confiáveis para redirecionamentos na organização que contém o redirecionamento. Para obter mais informações, consulte Redirecionamentos de confiança para suas outras organizações do Salesforce.

Páginas do Visualforce personalizadas ou aplicativos personalizados

Substitua as referências ao URL da instância da organização pelos URLs relativos e pelos nomes de host gerados dinamicamente. Observe quaisquer URLs que exigem uma referência embutida em código.

Para obter mais informações, consulte o artigo do Knowledge Atualizando referências embutidas em código.

Para pesquisar seu código do Salesforce, faça download dos metadados de cada uma das suas organizações do Salesforce usando uma ferramenta como o Salesforce CLI. Em seguida, use um editor de código, como o Microsoft Visual Studio, para pesquisar URLs que pertencem à organização em que você planeja alterar o Meu domínio.

Identifique as páginas da Web e os sites que usam seus chatbots para poder atualizá-los após a implementação da alteração.

Para cada bot, revise o campo Domínios permitidos nas configurações de implementação do chat. Como opção, você pode atualizar os domínios permitidos e atualizar o código de implementação antes de implementar a alteração de Meu domínio. Para obter mais informações, consulte Criar implantações do Chat.

Depois de implementar uma alteração no Meu domínio, o Salesforce redirecionará seus URLs anteriores do Meu domínio. Em alguns casos, as chamadas de software externas não podem processar o redirecionamento, e a chamada ao URL do Salesforce falha.

Antes de implementar sua alteração do Meu domínio, verifique se o software externo que usa seus URLs do Salesforce, incluindo os URLs do site, pode processar redirecionamentos. Se o software não puder processar esses redirecionamentos, trabalhe com o proprietário do software para colocar em vigor essa funcionalidade de redirecionamento ou planeje atualizar o uso do software com seus novos URLs depois de implementar a alteração.

Com um URL embutido em código, o URL existe como texto simples no seu código. Esses URLs exigem uma atualização manual quando o URL muda. Por isso, a Salesforce recomenda usar URLs criados de modo relativo e dinâmico em vez de URLs embutidos em código sempre que possível.

A primeira etapa para lidar com URLs embutidos em código é descobrir onde eles existem em suas organizações do Salesforce. Um inventário pode ajudar a concluir as atualizações necessárias em sua organização e incluir a funcionalidade relevante em seus testes.

Para pesquisar seu código do Salesforce, faça download dos metadados de cada uma das suas organizações do Salesforce usando uma ferramenta como o Salesforce CLI. Em seguida, use um editor de código, como o Microsoft Visual Studio, para pesquisar URLs que pertencem à organização em que você planeja alterar o Meu domínio. Para determinar o que pesquisar, você pode usar sua instância do Salesforce e fazer referência aos formatos de URL do Meu domínio.

Antes de implementar seu nome do Meu domínio, reduza o esforço pós-implementação substituindo links embutidos em código por URLs relativos e URLs gerados dinamicamente. Para gerar URLs do Meu domínio, use a Classe do DomainCreator no Apex.

Observe os URLs embutidos em código para atualizar após implementar sua alteração do Meu domínio.

Se algum método de autenticação usar seu URL de login, planeje atualizar a autenticação depois de implementar a alteração do Meu domínio. Recomendamos que você documente suas configurações existentes antes de implementar sua alteração de Meu domínio. Esse instantâneo de sua configuração anterior é uma referência valiosa para seu plano de reversão.

Para obter mais informações sobre as configurações a serem capturadas, consulte Determinar atualizações de autenticação obrigatórias após uma alteração no Meu domínio.

Identifique as páginas do Visualforce, as páginas da Web e outros locais que chamam seu aplicativo do Lightning Out. Identifique quem pode atualizar a marcação integrada nessas páginas.

Determine se os usuários autenticados podem acessar o Lightning Out e se o aplicativo conectado do Lightning Out usa o URL de login do Meu domínio.

• Trabalhe com seu provedor de telefonia para adicionar seus novos URLs às listas de permissões do provedor de telefonia.
• Revise sua configuração para obter referências embutidas em código nos URLs. Sempre que possível, atualize essas referências para URLs relativos. Para obter exemplos, confira o Artigo do Knowledge Domínios aprimorados e CTI aberta com Visualforce (Spring '23). Se você encontrar referências embutidas em código que não podem ser convertidas em um URL relativo, anote-as e prepare-as para atualizá-las depois de implementar seu novo Meu domínio.

Quando você habilita o Service Cloud Voice, o Salesforce usa seus URLs do Meu domínio para configurar o Single Sign On (SSO) com o seu provedor de telefonia. A ação necessária depende da sua configuração.

• Se você usar o Service Cloud Voice com Amazon Connect ou o Service Cloud Voice com Telefonia do parceiro do Amazon Connect, o Salesforce atualizará sua configuração, incluindo a lista de permissões do Amazon Connect, quando você implementar seu novo Meu domínio. Nenhuma ação é necessária antes de implementar o novo Meu domínio.
• Se você usa o Service Cloud Voice com Telefonia do parceiro, trabalhe com seu provedor de telefonia para adicionar seus novos URLs à lista de permissões. Além disso, identifique URLs de API de conexão embutidos em código, listas de permissões e referências aos URL de engajamento de Omni-Channel de última geração que termina em *.my.salesforce-scrt.com. Com seu provedor de telefonia, prepare-se para atualizar essas referências embutidas em código após implementar seu novo Meu domínio.

• Trabalhe com seu provedor de telefonia para adicionar seu novo URL do Visualforce às listas de permissões do provedor de telefonia.
• Revise sua configuração para obter referências embutidas em código para o URL do Visualforce. Sempre que possível, atualize essas referências para URLs relativos. Para obter exemplos, confira o Artigo do Knowledge Domínios aprimorados e CTI aberta com Visualforce (Spring '23). Se você encontrar referências embutidas em código que não podem ser convertidas em um URL relativo, anote-as e prepare-as para atualizá-las depois de implementar seu novo Meu domínio.

Se você usa o Service Cloud Voice com Telefonia do parceiro, trabalhe com seu provedor de telefonia para adicionar seu novo URL do Visualforce à lista de permissões. Identifique também as referências embutidas em código para seu URL do Visualforce em sua configuração. Com seu provedor de telefonia, prepare-se para atualizar essas referências embutidas em código após implementar seu novo Meu domínio.

Se você usar o Service Cloud Voice com Amazon Connect ou o Service Cloud Voice com Telefonia do parceiro do Amazon Connect, nenhuma ação será necessária. O Salesforce atualiza sua configuração quando você implementa seu novo Meu domínio.

Se algum método de autenticação usar seu URL de site, planeje atualizar a autenticação depois de implementar a alteração do Meu domínio. Recomendamos que você documente suas configurações existentes antes de implementar sua alteração de Meu domínio. Esse instantâneo de sua configuração anterior é uma referência valiosa para seu plano de reversão.

Para obter mais informações sobre as configurações a serem capturadas, consulte Determinar atualizações de autenticação obrigatórias após uma alteração no Meu domínio.

Para dar suporte aos redirecionamentos de seus URLs atuais do Meu domínio depois de implementar a alteração do Meu domínio, verifique sua versão de aplicativos Mobile Publisher para Experience Cloud. Se você estiver executando uma versão anterior à versão 10.0, siga as instruções no artigo do Knowledge Aplicativos Mobile Publisher para Experience Cloud e domínios aprimorados para fazer o upgrade para a versão mais recente antes de implementar a alteração no Meu domínio.

Se você usar um domínio personalizado, como https://www.example.com, para hospedar seu site do Experience Cloud e usar esse domínio personalizado para o aplicativo Mobile Publisher, essa tarefa não será aplicada. Além disso, essa tarefa não se aplica aos aplicativos do Mobile Publisher para Lightning.

Depois de implementar os domínios aprimorados, seu novo nome de host do site do Experience Cloud *.my.site.com tem suporte para IPv4 e IPv6. Se um perfil incluir restrições de IP e apenas endereços IPv4 forem permitidos, os usuários atribuídos a esse perfil poderão ver um erro quando acessarem seu site que termina em *.my.site.com por meio de IPv6. Para evitar esse erro, atualize suas listas de permissões de IP ou restrições para permitir endereços de origem IPv6 para usuários autorizados. Revise e atualize principalmente as restrições do intervalo de IP para login para os perfis relevantes, incluindo o perfil do guest user do site. Para obter mais informações sobre a configuração de restrições de IP no Salesforce, consulte o artigo do Knowledge Acesso de rede, configurações de sessão e restrições de IP baseado em perfil.

:: to ::fffe:ffff:ffff
0.0.0.0 to 255.255.255.255
::1:0:0:0 to ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff

Quando você implementa domínios aprimorados, seu novo domínio *.my.site.com do site do Experience Cloud gerenciado pelo sistema inclui a rede de entrega de conteúdo (CDN) do Experience Cloud, que usa o parceiro da CDN do Salesforce. Os endereços IP usados pelo parceiro da CDN do Salesforce não são publicados. Portanto, se as configurações da sua rede incluírem a lista de permissões de IP, os usuários poderão perder o acesso ao seu site que usa a CDN do Salesforce. Por exemplo, se os usuários fizerem login por meio de uma VPN que usa exclusivamente a lista de permissões de IP, os usuários nessa VPN não poderão acessar seu site, pois ele usa o endereço IP do parceiro da CDN do Salesforce.

Para garantir que os usuários possam acessar seu site do Experience Cloud na CDN do Salesforce, coloque o domínio do site na lista de permissões ou veicule o site por meio de um domínio personalizado. Para obter mais informações, leia o Artigo do Knowledge, Acessar sites do Experience por meio de uma VPN restrita por IP após a implementação de domínios aprimorados.

Se não puder permitir a lista de permissões do seu domínio no nível de rede ou configurar um domínio personalizado para atender ao seu site, planeje entrar em contato com o Suporte ao cliente da Salesforce para desabilitar a CDN do Salesforce para o URL do site *.my.site.com após implementar os domínios aprimorados.

Se o nível de proteção contra clickjack do seu site for Permitir quadros das páginas do site em domínios externos (proteção boa), revise e atualize a lista de domínios confiáveis. Certifique-se principalmente de que o *.my.salesforce.com seja confiável.

Para obter mais informações, consulte Habilitar proteção contra clickjack em sites do Experience Cloud e Habilitar proteção contra clickjack em Site.com.

Se você tiver implementado os domínios aprimorados, poderá remover os domínios que se aplicam apenas às organizações sem domínios aprimorados da lista de permissões. Porém, recomendamos que você mantenha esses domínios na lista de permissões para redirecionamento até que todos os usuários e integrações estejam usando seus novos domínios com sucesso.

Para obter a lista de domínios obrigatórios e suas finalidades, consulte Permitir os domínios obrigatórios.

Atualize as referências aos URLs do Meu domínio antigos em seus links e redirecionamentos entre organizações.

Se o redirecionamento incluir um parâmetro de redirecionamento em código ou em um URL, planeje também atualizar a lista de permissões de URLs confiáveis para redirecionamentos na organização que contém o redirecionamento. Para obter mais informações, consulte Redirecionamentos de confiança para suas outras organizações do Salesforce.

Páginas do Visualforce personalizadas ou aplicativos personalizados

Substitua referências integradas em código pelo URL instanciado da organização, como https://na170.salesforce.com, ou seu URL de login do Meu domínio pelo novo URL de login do Meu domínio.

Para obter mais informações, consulte o artigo do Knowledge Atualizando referências embutidas em código.

Atualize essas referências para os URLs do Meu domínio atual. O ideal é gerar os nomes de host por meio de um método dinâmico, como a Classe DomainCreator no Apex.

Se você tiver implementado domínios aprimorados, revise os redirecionamentos temporários de nomes de host. Se você encontrar algum desses formatos de nome de host na sua organização, atualize-os para o formato de domínio aprimorado.

Para obter mais informações sobre como atualizar referências embutidas em código, consulte o artigo do Knowledge Atualizando referências embutidas em código.

Integrações de API na sua organização

Verifique se o cliente da API faz uma referência ao ponto de extremidade do servidor. Para o cliente de API, use o valor de metadataServerUrl ou serverURL retornado por uma solicitação de login. Não use um URL de servidor fixado em código.

Depois de você implantar uma alteração do Meu domínio que afeta o URL de login, o Salesforce retorna o URL do servidor contendo seu novo nome ou sufixo do Meu domínio. Se sua organização tiver sido movida para outra instância ou você exigir que os logins da API SOAP usem seu Meu domínio em políticas de Meu domínio, as chamadas antigas a URLs instanciados falharão. Logins de API em uma organização do Hyperforce não podem usar um URL instanciado. Para evitar interrupções, use o valor retornado pelo Salesforce.

Modelos de email

Substitua as referências ao URL antigo pelo seu novo URL de login do Meu domínio. Se o modelo usar um URL embutido em código, que é mais comum em modelos de email criados no Salesforce Classic, recomendamos que você atualize o modelo para usar um URL gerado dinamicamente.

Atualize aplicativos conectados que usam o URL de login do Meu domínio.

Atualize a marcação do Lightning Out em páginas do Visualforce, páginas da Web e outros locais que chamam seu aplicativo do Lightning Out.

Se os usuários autenticados acessarem o Lightning Out, gere um novo ID de sessão ou token de autenticação para essas conexões.

Revise o campo de URL de suas credenciais nomeadas. Se uma credencial nomeada usar seu URL de login do Meu domínio, atualize o campo de URL com seu novo URL de login do Meu domínio. Para obter mais informações, consulte Atualizar credenciais nomeadas depois de uma alteração do Meu domínio.

Se os usuários acessarem funcionalidades que dependem de uma credencial nomeada atualizada, instrua-os a se autenticar novamente.

Se sua configuração do Account Engagement usa o Usuário do conector do Pardot, atualize o URL de login que o Account Engagement usa. No Account Engagement, atualize o usuário do conector do Pardot. Para usar o mesmo usuário, salve o usuário novamente no Account Engagement. Depois, faça logout e faça login novamente em sua organização para concluir o processo.

Se você estiver usando o Usuário de integração do Account Engagement, nenhuma alteração será necessária.

Quando você implementa domínios aprimorados, nenhuma alteração à configuração de domínio rastreador do Account Engagement será necessária.

• Verifique com seu provedor de telefonia se os novos URLs estão incluídos nas listas de permissões do provedor de telefonia. Como opção, trabalhe com o provedor para remover os URLs anteriores das suas listas de permissões.
• Atualize as referências embutidas em código em seus URLs antigos. Sempre que possível, atualize essas referências para URLs relativos. Para obter exemplos, confira o Artigo do Knowledge Domínios aprimorados e CTI aberta com Visualforce (Spring '23).

Quando você habilita o Service Cloud Voice, o Salesforce usa seus URLs do Meu domínio para configurar o Single Sign On (SSO) com o seu provedor de telefonia. A ação necessária depende da sua configuração.

• Se você usar o Service Cloud Voice com Amazon Connect ou o Service Cloud Voice com Telefonia do parceiro do Amazon Connect, nenhuma ação será necessária. O Salesforce atualiza sua configuração, incluindo a lista de permissões do Amazon Connect, quando você implementa seu novo Meu domínio. Como opção, remova seus formatos de URL antigos da lista de permissões do Amazon Connect.
• Se você usar o Service Cloud Voice com telefonia de parceiros, trabalhe com sua operadora de telefonia para atualizar sua configuração com seus novos URLs depois de implementar o novo Meu domínio. Em especial, atualize os URLs de API de conexão embutidos em código, as listas de permissão e as referências ao URL de engajamento de Omni-Channel de última geração que termina em *.my.salesforce-scrt.com. Como opção, trabalhe com seu provedor de telefonia para remover os formatos de URL anteriores da lista de permissões.

Para garantir a continuidade durante atualizações de instância e migrações de organização, recomendamos usar URLs do Meu domínio com a API de streaming. Se você seguir esta recomendação, substitua seu URL de login anterior do Meu domínio pelo seu novo URL de login.

Se ainda não seguir esta recomendação, use seu URL de login do Meu domínio com a API de streaming. Por exemplo, substitua https://login.salesforce.com e https://InstanceName.salesforce.com​/ por https://MyDomainName.my.salesforce.com​/.

Para obter mais informações sobre o login no Salesforce com o URL do Meu domínio, consulte Fazer login no Salesforce com código.

• Verifique se seu novo URL do Visualforce está incluído nas listas de permissões do provedor de telefonia. Como opção, trabalhe com o provedor para remover seu URL do Visualforce anterior de suas listas de permissões.
• Atualize as referências embutidas em código para o URL do Visualforce anterior. Sempre que possível, atualize essas referências para URLs relativos. Para obter exemplos, confira o Artigo do Knowledge Domínios aprimorados e CTI aberta com Visualforce (Spring '23).

Se você usa o Service Cloud Voice com Telefonia do parceiro, trabalhe com sua operadora de telefonia para atualizar sua configuração, incluindo listas de permissões, com seu novo URL do Visualforce. Opcionalmente, trabalhe com seu provedor de telefonia para remover o URL do Visualforce anterior da lista de permissões.

Se você usar o Service Cloud Voice com Amazon Connect ou o Service Cloud Voice com Telefonia do parceiro do Amazon Connect, nenhuma ação será necessária. O Salesforce atualiza sua configuração quando você implementa seu novo Meu domínio. Como opção, você pode atualizar sua lista de permissões do Amazon Connect para remover o formato de URL do Visualforce antigo.

Atualize todos os links embutidos em código para sites do Experience Cloud e Salesforce Sites em seus sites e páginas personalizadas. Por exemplo, se você hospeda artigos do Knowledge em um site do Experience Cloud, atualize os URLs que incluem seu URL do site antigo. Esses links são redirecionados para o URL do site atual equivalente até que você desabilite esses redirecionamentos ou até que o Salesforce interrompa esses redirecionamentos. Consulte Prepare-se para o fim dos redirecionamentos para domínios não aprimorados.

Ao atualizar esses links embutidos no código, use caminhos relativos e nomes de host gerados dinamicamente sempre que possível. Se o URL do site for alterado novamente no futuro, os caminhos relativos e os nomes de host gerados dinamicamente continuarão funcionando.

Atualize os aplicativos conectados que usam o URL do Experience Cloud.

Se os usuários autenticados acessarem o Lightning Out, gere um novo ID de sessão ou token de autenticação para essas conexões.

Atualize seu aplicativo para usar seu novo URL de sites do Experience Cloud antes que o Salesforce interrompa os redirecionamentos para o URL do site antigo. Para obter mais informações, consulte Preparação para o fim dos redirecionamentos para domínios não aprimorados e Mobile Publisher para Experience Cloud.

Se você usar um domínio personalizado, como https://www.example.com, para hospedar seu site do Experience Cloud e usar esse domínio personalizado para o aplicativo Mobile Publisher, essa tarefa não será aplicada. Além disso, essa tarefa não se aplica aos aplicativos do Mobile Publisher para Lightning.

Quando você implementa domínios aprimorados, seu novo domínio do site do Experience Cloud gerenciado pelo sistema *.my.site.com inclui a rede de entrega de conteúdo (CDN) do Experience Cloud, que usa o parceiro da CDN do Salesforce. Os endereços IP usados pelo parceiro da CDN do Salesforce não são publicados. Portanto, se as configurações da sua rede incluírem a lista de permissões de IP, os usuários poderão perder o acesso ao seu site que usa a CDN do Salesforce. Por exemplo, se os usuários fizerem login por meio de uma VPN que usa exclusivamente a lista de permissões de IP, os usuários nessa VPN não poderão acessar seu site, pois ele usa o endereço IP do parceiro da CDN do Salesforce.

Para garantir que os usuários possam acessar seu site do Experience Cloud na CDN do Salesforce, coloque o domínio do site na lista de permissões ou veicule o site por meio de um domínio personalizado. Para obter mais informações, leia o Artigo do Knowledge, Acessar sites do Experience por meio de uma VPN restrita por IP após a implementação de domínios aprimorados.

Se não puder permitir a lista de permissões do seu domínio no nível de rede ou configurar um domínio personalizado para atender ao seu site, entre em contato com o Suporte ao cliente do Salesforce para desabilitar a CDN do Salesforce para o URL do site *.my.site.com.