Configurar Adobe Experience Platform spoke.

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.

Anexe 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é Tudo > 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álida 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 Anexos ( E anexe um certificado JKS.
5. Clique em Validar armazenamentos/certificados .

Resultado

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

Crie uma chave de assinatura JWT para 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é Tudo > 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 JWT AEP .
   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 a ser assinado 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.

Crie um provedor JWT para 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é Tudo > 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 JWT AEP .
   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 JWT AEP .

4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
   As listas relacionadas Declarações padrão e Declarações personalizadas são exibidas.
5. Insira valores para iss , sub e aud Na lista relacionada Declarações padrão.
   Consulte 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/entdataservice_sdk
   Tipo de valor da declaração	verdadeiro|falso
   Valor do sinistro	verdadeiro

7. Clique em Atualizar.

Resultado

O provedor JWT é adicionado ao seu ServiceNow instância.

Registre-se Adobe Experience PlatformComo provedor OAuth

Use as informações geradas durante a criação e configuração da conta do Adobe ID para registrar Adobe Experience PlatformComo 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é Tudo > OAuth de Sistema > Registro de aplicações.
2. Clique em Nova.
   O sistema exibe a mensagem Que tipo de aplicação OAuth?
3. Selecione Conecte-se a um provedor OAuth de terceiros .
   O sistema exibe um formulário 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 OAuth do AEP .
   ID de cliente	Chave do consumidor que você gerou 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 do 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 o PKCE para uma autorização. 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 fica acessível.
   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.
   Redirecional URL	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 exige que um perfil de autenticação mútua seja especificado.
   Enviar Credenciais	As credenciais do cliente estão 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 OAuth e preenche o. URL de redirecionamento .
   • O sistema é preenchido Perfil de entidade OAuth com Tipo de concessão . Portador JWT . Por exemplo, Perfil de entidade OAuth criado com padrão Nome , Default_profile do AEP
6. Abra o registro do perfil de entidade OAuth.
7. Selecione o registro do Provedor JWT para 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.

Crie registros de credencial para Adobe Experience Platform

Crie registros de credencial para a conta do Adobe ID que você criou. . Adobe Experience Platform spokeo alias de conexão e credencial 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 gestão de entrada de dados e ingestão em lote e outro para coleta de dados.

Procedimento

1. Navegar até Tudo > 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 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 gestão de entrada de dados e ingestão em 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. SalesforceAplicativo conectado 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 em Obter token OAuth Link relacionado para gerar o token OAuth.

Resultado

Os registros de credencial do Adobe Experience Platform spokecriado.

Criar registros de conexão para Adobe Experience Platform spoke

Crie registros de conexão para sua conta do Adobe ID. . Adobe Experience Platform spokeo alias de conexão e credencial usa essas conexões para executar ações no 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 gestão de entrada de dados e ingestão em lote e outro para coleta de dados. Execute estas etapas para associar cada alias ao respectivo Adobe Experience PlatformAPI.

Procedimento

1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
2. Abra o necessário Adobe Experience Platform spokeregistro.
   Nota:

   Há dois registros de conexão e credencial; AEP e. AEP_ingestion . . AEP o registro é para gestão de entrada de dados e ingestão em lote, e. AEP_ingestion é para coleta de dados.
3. Em Conexões clique em Novo .
   O sistema exibe um formulário 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 Plataforma AEP para gestão de entrada de dados e ingestão em 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 Adobe Experience Platform. Se o registro de conexão for para gestão de entrada de dados e ingestão em 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 a conexão ativamente.
   Domínio	Domínio em que a ação ou atividade é executada.

5. Em Atributos insira esses valores.
   • Nome interno da área restrita em Sandbox .
     Nota:

     Forneça o nome interno da área restrita necessária e não seu rótulo em Sandbox . 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 em lote, insira Chave de API e. ID da organização .
   • Se o registro de conexão for para ingestão de streaming insira ID da organização .
6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

Resultado

. Adobe Experience Platform spokeestá configurado e integrado ao ServiceNow instância.