DocumentaçãoKCS da Experience Cloud

O token de acesso IMS não funciona em vários ambientes Adobe Commerce

Última atualização: 21 de junho de 2026

Os tokens de acesso IMS gerados usando as credenciais de servidor para servidor do OAuth funcionam com sucesso em um ambiente do Adobe Commerce, mas falham com um erro 401 Não autorizado em outro. Esse comportamento ocorre porque cada ambiente do Commerce requer sua própria configuração IMS e permissões explícitas para a conta técnica associada ao token. Para corrigir isso, configure a integração do IMS por ambiente, crie credenciais OAuth separadas e atribua as permissões de Administrador necessárias à conta técnica em cada instância do Commerce.

Descrição description

Ambiente

  • Produto: Adobe Commerce Cloud
  • Versão: 2.4.7
  • Tipo de autenticação: servidor a servidor OAuth com integração de IMS

Problema/Sintomas

  • Um token de acesso IMS funciona para chamadas REST API em um ambiente Commerce, como produção.
  • O mesmo token falha com um erro 401 Não autorizado em outro ambiente, como preparo ou controle de qualidade.
  • A resposta da API REST inclui a mensagem de erro: o consumidor não está autorizado a acessar %resources.

Resolução resolution

Siga estas etapas para corrigir o problema:

  1. Habilite e configure a integração do Adobe IMS em cada ambiente do Commerce em que o acesso REST API é necessário.
  2. Crie credenciais OAuth de servidor para servidor separadas para cada ambiente no Adobe Developer Console. Para obter orientações detalhadas sobre como configurar credenciais OAuth de servidor para servidor específicas do ambiente e gerar tokens de acesso IMS, consulte a Autenticação de servidor para servidor.
  3. Gere um token de acesso IMS usando a ID do cliente e o segredo do cliente específico desse ambiente.
  4. Adicione a conta técnica associada ao token IMS como um usuário administrador no Administrador do Commerce para esse ambiente.
  5. Atribua a função de administrador e as permissões necessárias à conta técnica.
  6. Use o token de acesso IMS correto ao fazer chamadas REST API para cada ponto de extremidade do ambiente.
  7. Confirme se as solicitações de REST API foram concluídas com êxito sem um 401 Erro não autorizado.

Leitura relacionada

recommendation-more-help
experience-cloud-kcs-help-kbarticles