Configuração Adobe Experience Platform spoke

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 8 min. de leitura

    • Integre sua conta Adobe Experience Platform à sua instância do ServiceNow. Crie uma aplicação OAuth personalizada em Adobe Experience Platform e autentique as solicitações de ServiceNow.

    Antes de Iniciar

    • Solicite a assinatura do IntegrationHub.
    • Como ativar Adobe Experience Platform spoke
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    O Adobe Experience Platform spoke também pode ser definido usando os modelos de configuração de conexão e credencial. No entanto, usando modelos, somente um conjunto de registros de alias pode ser usado por vez.

    Anexar um certificado Java Key Store ao Adobe Experience Platform spoke

    Habilite a autenticação de token de Concessão do Portador JWT anexando um certificado Java KeyStore (JKS) válido ao Adobe Experience Platform spoke.

    Antes de Iniciar

    • Certificado Java KeyStore válido
    • Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Certificados.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Campos do formulário da certificação X.509
      Campo Descrição
      Nome Nome para identificar exclusivamente o registro. Por exemplo, Certificado AEP.
      Notificação de expiração Opção para enviar uma notificação quando o certificado estiver prestes a expirar.
      Notificar no vencimento Usuários a serem notificados quando o certificado expirar.
      Aviso emitido antes do vencimento (em dias) Número de dias para enviar uma notificação antes que o certificado expire.
      Ativo Opção para usar ativamente o certificado.
      Formato Formato do certificado. A instância suporta os formatos PEM e DER.
      Tipo Tipo de certificado. Selecione Armazenamento de chaves Java.
      Válido de Data a partir da qual o certificado é válido.
      Expira Data em que o certificado expira.
      Dias até o vencimento Número de dias até o certificado expirar.
      Senha do armazenamento de chaves Senha associada ao certificado.
      Descrição resumida Resumo sobre o certificado.
      Certificado PEM Conteúdo do certificado X509.
    4. Clique no ícone de anexos (ícone de anexos) e anexe um certificado JKS.
    5. Clique em Validar armazenamentos/certificados.

    Resultado

    O certificado JKS é criado e anexado ao Adobe Experience Platform spoke.

    Criar uma chave de assinatura JWT para o Adobe Experience Platform spoke

    Crie uma chave de assinatura JSON Web Token (JWT) para atribuir ao seu certificado Java KeyStore.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Chaves de JWT.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 2. Campos do formulário de chaves de JWT
      Campo Descrição
      Nome Nome para identificar exclusivamente a chave de assinatura JWT. Por exemplo, Chaves AEP JWT.
      Armazenamento de chaves de assinatura Certificado JKS válido anexado na tarefa anterior. Por exemplo, Certificado AEP.
      ID de chave ID da chave para identificar qual chave é usada quando várias chaves são usadas para assinar tokens.
      Aplicação Escopo da aplicação que contém este registro. Selecione Adobe Experience Platform spoke.
      Algoritmo de assinatura Algoritmo para assinar com a chave JWT.
      Senha da chave de assinatura Senha associada à chave de assinatura.
      Ativo Opção para usar ativamente o certificado.
    4. Clique em Enviar.

    Resultado

    A chave JWT é criada e atribuída ao certificado JKS.

    Criar um provedor JWT para o Adobe Experience Platform spoke

    Adicione um provedor JSON Web Token (JWT) à sua instância da ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Provedores JWT.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 3. Campos de formulário do Provedor JWT
      Campo Descrição
      Nome Nname para identificar exclusivamente o provedor JWT. Por exemplo, Provedor AEP JWT.
      Intervalo de vencimento (s) Número em segundos para definir a vida útil dos tokens do provedor JWT.
      Configuração de Assinatura Chave de assinatura JWT da etapa anterior. Por exemplo, Chaves AEP JWT.
    4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      As listas relacionadas a Declarações padrão e Declarações personalizadas são exibidas.
    5. Insira valores para iss, sube aud na lista relacionada Declarações padrão.
      Veja o Adobe Experience Platform documentação para obter instruções.
    6. Insira esses valores na lista relacionada Declarações personalizadas.
      Campo valor
      Nome da declaração https://ims-na1.adobelogin com/s/entdataservices_sdk
      Tipo de Valor de Declaração verdadeiro|falso
      Valor da declaração verdadeiro
    7. Clique em Atualizar.

    Resultado

    O provedor JWT é adicionado à sua instância ServiceNow.

    Registrar Adobe Experience Platform como provedor OAuth

    Use as informações geradas durante a criação e a configuração da conta do Adobe ID para registrar Adobe Experience Platform como um provedor OAuth e permitir que a instância solicite tokens OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de aplicação OAuth?
    3. Selecione Conectar a um provedor OAuth de terceiros.
      O sistema exibe um formulário de Registros de aplicações em branco.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira AEP OAuth.
      ID de cliente Chave do consumidor gerada durante a configuração da conta do Adobe ID.
      Segredo do cliente Segredo do consumidor gerado durante a configuração da conta do Adobe ID.
      Script do API da OAuth Script para personalizar a solicitação e a resposta. Selecione OAuthUtilAEP.
      Tipo de concessão padrão Tipo de concessão usado para estabelecer o token. Selecione Portador JWT.
      Tempo de vida do token de atualização Tempo, em segundos, em que o token de atualização é válido. O tempo padrão é 8.640.0000 segundos.
      PKCE necessário Opção para permitir que clientes públicos exijam uma autorização do PKCE.
      Nota:
      Você pode usar somente o Código de autorização como o tipo de concessão padrão quando o PKCE estiver habilitado.
      Aplicação Escopo da aplicação que contém este registro. Selecione Adobe Experience Platform.
      Acessível de Escopo da aplicação a partir do qual este registro pode ser acessado.
      Ativo Opção para usar ativamente o registro da aplicação.
      URL de Autorização Este campo deve ser deixado em branco.
      URL do token Endpoint do token do servidor OAuth. Insira https://ims-na1.adobelogin.com/ims/exchange/jwt/.
      URL de revogação do token Este campo deve ser deixado em branco.
      URL de redirecionamento Este campo deve ser deixado em branco.
      Usar autenticação mútua Opção de usar autenticação mútua para solicitação e revogação de token. Esta opção requer que um perfil de autenticação mútua seja especificado.
      Enviar Credenciais Credenciais do cliente na solicitação.
    5. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      • O sistema valida as credenciais do OAuth e preenche o URL de redirecionamento.
      • O sistema preenche o perfil de entidade OAuth com o tipo de concessão como portador JWT. Por exemplo, o perfil de entidade OAuth é criado com o nomepadrão , AEP default_profile
    6. Abra o registro do perfil de entidade OAuth.
    7. Selecione o registro do Provedor JWT para o Provedor JWT, por exemplo, Provedor JWT AEP.
    8. Clique em Atualizar.

    Resultado

    A instância pode solicitar tokens OAuth 2.0 para o spoke.
    Nota:
    Quando um token OAuth expira, o spoke gera automaticamente um novo token na maioria dos casos. Se um token expirar e não for gerado novamente, um administrador poderá gerar novamente o token OAuth do spoke.

    Criar registros de credenciais para o Adobe Experience Platform

    Crie registros de credencial para a conta do Adobe ID que você criou. O alias de conexão e credencial Adobe Experience Platform spoke usa essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você deve criar dois registros de credencial; um para gerenciamento de entrada de dados e ingestão de lote e outro para coleta de dados.

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais OAuth 2.0.
      A janela pop-up exibe um formulário de Credenciais do OAuth 2.0 em branco.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira AEP para gerenciamento de entrada de dados e ingestão de lote e AEP_Ingestion para coleta de dados.
      Ativo Opção de usar ativamente o registro de credencial.
      Perfil de Entidade OAuth Perfil OAuth que você criou ao registrar o aplicativo conectado Salesforce como um provedor OAuth. Por exemplo, selecione AEP OAuth default_profile.
      Aplica-se a Este campo não é aplicável.
      Ordem A ordem na qual aplicar esta credencial. Por exemplo, insira 100.
    5. Salve o registro.
    6. Clique no link relacionado Obter token OAuth para gerar o token OAuth.

    Resultado

    Os registros de credenciais para Adobe Experience Platform spoke são criados.

    Criar registros de conexão para o Adobe Experience Platform spoke

    Crie registros de conexão para sua conta do Adobe ID. O alias de conexão e credencial Adobe Experience Platform spoke usa essas conexões para executar ações em Adobe Experience Platform.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Dois registros de alias de conexão e credencial estão disponíveis por padrão; um para gerenciamento de entrada de dados e ingestão de lote e outro para coleta de dados. Execute estas etapas para associar cada alias à respectiva API Adobe Experience Platform.

    Procedimento

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro Adobe Experience Platform spoke necessário.
      Nota:
      Existem dois registros de conexão e de credencial; AEP e AEP_Ingestion. O registro AEP é para gerenciamento de entrada de dados e ingestão de lote, e AEP_Ingestion é para coleta de dados.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Nome para identificar o registro da conexão com exclusividade. Por exemplo, insira AEP Platform para gerenciamento de entrada de dados e ingestão de lote e AEP dcs para coleta de dados.
      Credencial Registro de credencial que você criou para Adobe Experience Platform. Por exemplo, selecione AEP e AEP_Ingestion.
      Alias de conexão Registro de alias associado a esta conexão.
      Construtor de URL
      Nota:
      Não marque a caixa de seleção.
      URL de conexão URL base para se conectar a Adobe Experience Platform.
      • Se o registro de conexão for para gestão de entrada de dados e ingestão de lote, insira https://platform.adobe.io/.
      • Se o registro de conexão for para coleta de dados, insira https://dcs.adobedc.net.
      Usar MID Server Este campo não é aplicável.
      Ativo Opção para usar ativamente a conexão.
      Domínio Domínio no qual a ação ou atividade é executada.
    5. Na guiaAtributos, insira esses valores.
      • Nome interno da área restrita no Sandbox.
        Nota:
        Certifique-se de fornecer o nome interno da área restrita necessária e não seu rótulo na área restrita. Para obter o nome interno da área restrita necessária, use a ação Obter todas as áreas restritas.
      • Se o registro de conexão for para gestão de entrada de dados e ingestão de lote, insira a chave de API e o ID da organização.
      • Se o registro de conexão for para ingestão de streaming, insira o ID da organização.
    6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

    Resultado

    O Adobe Experience Platform spoke está configurado e integrado à instância ServiceNow.