Show Menu
TÓPICOS×

Visão geral e pré-requisitos da integração

Estas informações mostram como criar uma integração de E/S da Adobe e de um Serviço de Locais.

Pré-requisitos para acesso do usuário

Verifique com o administrador do sistema de sua organização se as seguintes tarefas foram concluídas:
  • O Local Core Service é exibido no console de administração da sua organização.
  • Você foi adicionado à organização.
  • Você foi adicionado como um Usuário ao Serviço Principal do Places em sua organização.
    Para obter mais informações, consulte Adicionar um usuário ou desenvolvedor aos seus perfis de Serviço e Inicialização da plataforma Experience em Obter acesso ao Serviço Places.
  • Você foi adicionado como desenvolvedor ao Places Core Service em sua organização.
    Para obter mais informações sobre como adicionar desenvolvedores, consulte Adicionar um usuário ou desenvolvedor aos seus perfis de Serviço e Inicialização da plataforma Experience em Obter acesso ao Serviço Local.
    Para obter mais informações sobre a função de desenvolvedor, consulte Gerenciar desenvolvedores .

Solicitações REST API

Cada solicitação para a API REST do Places Service requer os seguintes itens:
  • Uma ID da organização
  • Uma chave de API
  • Um token do portador
Uma integração com a E/S da Adobe fornece esses itens e uma maneira de solicitar o token do portador usando um JSON Web Token (JWT).
  • Para obter mais informações sobre JWTs, consulte Introdução aos tokens da Web JSON.
  • Para criar uma integração para o Serviço de Locais, consulte a seção Criação de um Serviço de Integração de Locais abaixo.
  • Para entender a integração de chave da API, gerando um JWT e certificados de chave pública, consulte Visão geral da autenticação de E/S da Adobe.
Se não conseguir fazer logon no console de E/S da Adobe ou se o Serviço de Locais não for uma opção na página ** Criar integrações, consulte Requisitos da organização na visão geral da API de serviços da Web.

Criar uma integração com o Serviço de Locais

Para criar uma integração com o Places Service, conclua as seguintes tarefas:

Gerar um par de chaves públicas e privadas

Para criar uma integração com o Serviço de Locais, é necessário um par de chaves pública e privada. Esses pares podem ser adquiridos ou você pode gerar suas próprias chaves autoassinadas.
Para gerar suas próprias chaves autoassinadas:
  1. Em uma janela de terminal, copie e cole cada uma das seguintes linhas e pressione **Enter**após colar cada linha:
       mkdir keys
       cd keys
       openssl req -x509 -sha256 -nodes -days 365 -newkey rsa:2048 -keyout places_integration_test_private.key -out    places_integration_test_public.crt
    
    
    Recomendamos que você nomeie suas chaves para facilitar a referência e armazene-as em uma pasta. Se você criar várias integrações, poderá identificar e gerenciar facilmente quais chaves pertencem a qual integração.
  2. Digite as informações solicitadas pelo OpenSSL:
    Country Name (2 letter code:  // Example: US
    State or Province Name (full name):  // Example: California
    Locality Name (eg, city):  // Example: San Jose
    Organization Name (eg, company):  // Example: Places
    Organizational Unit Name (eg, section):  // Example: Engineering
    Common Name (eg, fully qualified host name):  // Example: places.com
    Email Address:  // Example:  poi@places.com
    
    
    Para obter mais informações sobre o OpenSSL, consulte OpenSSL .
    As informações fornecidas são incorporadas às chaves.
  3. Navegue até o diretório onde os arquivos .key e .crt .
    Por exemplo, no MacOS, vá para Macintosh HD > users > (your user name) > Keys .
O vídeo a seguir guia você pelo processo de geração do par de chaves:

Criar uma integração do Serviço de Locais no console de E/S da Adobe

Para criar uma integração com o Serviço de Locais:
  1. Acesse https://console.adobe.io e faça logon com sua Adobe ID.
  2. Na seção Início rápido, clique em Criar integração .
  3. Selecione Access an API e clique em Continue .
    **Access an API**é o local padrão.
  4. Se você tiver acesso a mais de uma organização da Experience Cloud, selecione-a na lista suspensa no canto superior direito.
  5. Under Experience Cloud , select**Places Service** as the Adobe service to which you want to integrate and click Continue .
  6. Selecione New integration e clique em Continue .
  7. Na tela Criar uma nova integração, digite um nome e uma descrição.
  8. Arraste e solte seu xxxx_public.crt arquivo, criado acima, na área **Public keys certificates**solta.
  9. Selecione um perfil de produto.
    Se não tiver certeza de qual perfil selecionar, entre em contato com o administrador do sistema.
  10. At the bottom of the page, click Create integration .
  11. Após alguns segundos, na tela Integração criada , verifique se a seguinte mensagem é exibida:
    Your integration has been created.
  12. A página de detalhes da integração é exibida com o nome da integração na parte superior.
    A **Overview**guia é exibida por padrão e exibe a chave da API, a ID da organização, a ID da conta técnica e outros detalhes sobre as integrações.

Registre a ID da empresa e a chave da API

  1. Na página de detalhes da integração, clique na Services guia e confirme se ela Places Service é exibida em Configured Services .
  2. Na **Overview**guia, localize e registre a chave da API (ID do cliente) e a ID da organização.
    Essas IDs são necessárias para cada solicitação de API REST do Places Service.

Gerar um token JWT

Na página de detalhes da integração, clique na **JWT**guia para que você possa testar sua integração gerando um JWT e fornecendo o URL de troca.
Para gerar um token JWT:
  1. Em um editor de texto, abra seu private.key arquivo criado acima.
  2. On the JWT tab, copy the contents of the key and paste it in the Paste private key field.
  3. Clique em Generate JWT .
  4. In the Sample CURL command section, click Copy and paste the contents in your command prompt or terminal window.
  5. Execute o comando pressionando **Enter**no teclado.
  6. Localize o "token_type": "bearer" e o "access_token" valor.
    O valor do token de acesso do portador é o que você usará nas solicitações da API do Places Service.
Os tokens de acesso da Adobe são válidos apenas por 24 horas, portanto, salve o comando CURL de amostra (etapa 5). Se o token de acesso não for mais válido, é necessário regenerar o token.