Integration overview and prerequisites

Estas informações mostram como criar uma integração entre o Adobe I/O e o Places Service.

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 ao Serviço de Locais e perfis de Experience Platform Launch em Obter acesso ao Serviçode Locais.

• 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 ao Serviço de Locais e perfis de Experience Platform Launch em Obter acesso ao Serviçode Locais.

  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 Adobe I/O 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 tokensda 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 daAdobe I/O.

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

Para criar uma integração com o Serviço de Locais, conclua as seguintes tarefas:

Gerar um par de chaves públicas e privadas

Para criar uma integração com o Serviço de Locais, você precisa de um par de chaves pública e privada. Esses pares podem ser comprados 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 depois de 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
   

   IMPORTANTE

   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.

   IMPORTANTE

   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 do Adobe I/O

Para criar uma integração com o Serviço de Locais:

1. Acesse https://console.adobe.io e faça logon com seu Adobe ID.

2. Na seção Start ​​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 de Experience Cloud, selecione a organização na lista suspensa na parte superior direita.

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. Na parte inferior da página, clique em 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.

Recursos do Business.Adobe.com

Enterprise Governance Customer Analytics Preference Centers Campaign Management Contribution Analysis Cohort Analysis