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 autenticar solicitações de ServiceNow.

Antes de Iniciar

• Solicitação IntegrationHub assinatura
• Ativar Adobe Experience Platform spoke
• Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

. Adobe Experience Platform spoke Também pode ser configurado 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 de armazenamento de chaves Java 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á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 Anexos ( ) E anexe um certificado JKS.
5. Clique em Valide 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 a chave de assinatura JWT de forma única. Por exemplo, Chaves JWT do 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	Nome para identificar exclusivamente o provedor de JWT. Por exemplo, Provedor de 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 do AEP .

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

7. Clique em Atualizar.

Resultado

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

Registre-se Adobe Experience Platform Como provedor OAuth

Use as informações geradas durante a criação e 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é 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 Conectar-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 AEP .
   ID de cliente	Chave do consumidor gerada durante a configuração da conta do Adobe ID.
   Segredo do cliente	O 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 de 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 do OAuth e preenche o. URL de redirecionamento .
   • O sistema é preenchido Perfil da entidade OAuth com Tipo de concessão como Portador do JWT . Por exemplo, Perfil da entidade OAuth é criado com o padrão Nome , AEP default_profile
6. Abra o registro do Perfil de entidade OAuth.
7. Selecione o registro do provedor de JWT para Provedor de JWT , por exemplo, Provedor de 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 do Spoke OAuth.

Crie registros de credencial para Adobe Experience Platform

Crie registros de credencial para a conta do Adobe ID que você criou. . Adobe Experience Platform spoke o 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 credenciais: 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 quando registrou o. Salesforce App conectado como um provedor de 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 credencial para Adobe Experience Platform spoke foi criado.

Criar registros de conexão para Adobe Experience Platform spoke

Crie registros de conexão para sua conta do Adobe ID. . Adobe Experience Platform spoke o alias de conexão e credencial 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 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 Platform API.

Procedimento

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

   Há dois registros de conexão e credencial; AEP e. AEP_ingestion . . AEP o registro serve 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 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 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 de 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 estes valores.
   • Nome interno da área restrita em Sandbox .
     Nota:

     Certifique-se de fornecer o nome interno da área de segurança necessária e não seu rótulo em Sandbox . Para obter o nome interno da área de segurança necessária, use a ação Obter todas as áreas de segurança.
   • 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 spoke está configurado e integrado ao ServiceNow instância.