Documentação Commerce Guia de sistemas do administrador

Integrações

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

Iniciante
Intermediário
Administrador
Desenvolvedor

A definição de uma integração no Administrador do Commerce estabelece a localização das credenciais do OAuth e o URL de redirecionamento para integrações de terceiros e identifica os recursos de API disponíveis que são necessários para a integração. Para obter informações mais detalhadas sobre o processo de registro da integração, consulte Autenticação baseada em OAuth na documentação do desenvolvedor do Commerce.

Integrações

Fluxo de trabalho de integração

Autorizar a integração - Vá para a página System > Extensions>Integrations, localize a integração relevante e autorize.
Verificar e estabelecer logon - Quando solicitado, aceite o acesso solicitado. Se redirecionado a terceiros, faça logon no sistema ou crie uma conta. Após um logon bem-sucedido, você retorna à página de integração.
Receber confirmação de integração autorizada - O sistema envia uma notificação de que a integração foi autorizada com êxito. Depois de configurar uma integração e receber as credenciais, não é mais necessário fazer chamadas para acessar ou solicitar tokens.

Adicionar uma integração

Na barra lateral Admin, vá para System > Extensions>Integrations.

{width="600" modal="regular"}

Insira as seguintes informações de integração:

Insira o Name da integração e o endereço Email do contato.
Insira o Callback URL para onde as credenciais do OAuth podem ser enviadas ao usar o OAuth para troca de token. É altamente recomendado usar https://.
Digite o Identity Link URL para redirecionar os usuários para uma conta de terceiros com essas credenciais de integração do Adobe Commerce ou Magento Open Source.

note note
NOTE
O rótulo de aviso `Integration not secure` é exibido próximo a cada nome de integração na grade Integrations como lembrete, até que as URLs HTTPS sejam salvas nos campos Callback URL e Identity Link URL.

Quando solicitado, digite sua senha para confirmar sua identidade.

No painel esquerdo, escolha API e faça o seguinte:
- Defina Resource Access como um dos seguintes:
  - All
  - Custom
- Para obter acesso personalizado, marque a caixa de seleção de cada recurso necessário.
  
  {width="600" modal="regular"}
Quando terminar, clique em Save.

Ativar uma integração

Por padrão, uma integração salva é exibida na grade com um status Inactive. Para ativá-la, conclua as seguintes etapas:

Na barra lateral Admin, vá para System > Extensions>Integrations.
Localize a integração recém-criada e clique no link Activate.
No canto superior direito, clique em Allow.

Essa ação exibe os Tokens de integração para extensões. Copie essas informações em um local seguro e criptografado para uso com sua integração.

{width="600" modal="regular"}
No canto superior direito, clique em Done.

Reautorizar uma integração

Para gerar um novo Token de acesso de integração e Segredo do Token de acesso, a integração do Administrador foi reautorizada:

Na barra lateral Admin, vá para System > Extensions>Integrations.
Encontre a integração com o status Active.
Na coluna Activate, clique em Reauthorize.
Clique em Reauthorize para aprovar o acesso aos recursos da API.
Salve os novos tokens de integração para extensões e clique em Done.

Alterar a configuração de segurança de acesso de convidado à API

Por padrão, o sistema não permite acesso de convidado anônimo ao CMS, ao catálogo e a outros recursos de armazenamento. Se precisar alterar a configuração, faça o seguinte: