19.3 Configure seu ambiente ServiceNow

OBSERVAÇÃO

As etapas de implementação abaixo são inspiradas pela documentação disponível no portal ServiceNow. Você pode encontrar essa documentação aqui. No entanto, siga as etapas abaixo.

Primeiro, verifique se você fez login com êxito na sua instância do ServiceNow.

ServiceNow

19.3.1 Certificados

Nesta etapa, é necessário anexar um armazenamento de chave Java válido. Você criou este Java Key Store no exercício anterior, o nome do arquivo Java Key Store que você criou é aep.jks.

Em ServiceNow, no Navegador de Filtro, informe o termo de pesquisa Certificados. Clique em Certificados em Definição ​do sistema.

ServiceNow

Você verá isso. Clique em Novo.

ServiceNow

Em seguida, você verá um formulário vazio. Preencha os campos do formulário da seguinte maneira:

  • Nome: Certificado AEP
  • Formato: PEM
  • Tipo: abra a lista suspensa e selecione Java Key Store.

(para os outros campos, mantenha a seleção padrão)

ServiceNow

Depois de selecionar Java Key Store, você verá isso. Clique no ícone de anexo na parte superior direita da tela.

ServiceNow

No pop-up, clique em Escolher arquivo.

ServiceNow

No pop-up, navegue até a pasta JKS na área de trabalho e selecione o arquivo aep.jks. Clique em Abrir.

ServiceNow

Você verá isso, clique no X para fechar o pop-up.

ServiceNow

Em seguida, digite a senha do armazenamento de chave Java no campo Key Store Password (Senha do armazenamento de chave Java).

ServiceNow

Em seguida, clique em Validar armazenamentos/certificados.

ServiceNow

Em seguida, você deverá ver a mensagem Valid key_store.

ServiceNow

O certificado Java Key Store agora está anexado à sua instância ServiceNow.

19.3.2 Teclas JWT

Agora, você criará uma chave de assinatura JSON Web Token (JWT) para atribuir ao seu certificado Java Key Store.

Em ServiceNow, no Navegador de Filtro, informe o termo de pesquisa Chaves ​JWT. Clique em Teclas JWT.

ServiceNow

Você verá isso. Clique em Novo.

ServiceNow

Em seguida, você verá um formulário vazio.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: Chaves JWT AEP
  • Armazenamento de chaves de assinatura: selecione o certificado anexado na etapa anterior, denominado Certificado AEP
  • Senha da chave de assinatura: digite a senha do Java Key Store que você digitou ao criar o Java Key Store no exercício 19.2

(para os outros campos, mantenha a seleção padrão)

Agora você deve ter isto:

ServiceNow

Clique em Enviar. Você será redirecionado para a visão geral das chaves ​JWT.

ServiceNow

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

19.3.3 Provedores JWT

Agora você adicionará um provedor JSON Web Token (JWT) à sua instância ServiceNow.

Em ServiceNow, no Navegador de Filtro, informe o termo de pesquisa Provedores ​JWT. Clique em Provedores ​JWT.

ServiceNow

Você verá isso. Clique em Novo.

ServiceNow

Em seguida, você verá um formulário vazio.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: Provedor JWT AEP
  • Configuração de assinatura: selecione a Chave JWT criada na etapa anterior, que foi chamada de Chaves JWT AEP

(para os outros campos, mantenha a seleção padrão)

Em seguida, clique com o botão direito do mouse no cabeçalho do formulário, conforme indicado na captura de tela. Clique em Salvar.

ServiceNow

Você verá isso.

ServiceNow

Agora é necessário atualizar os valores para is, sub e aud. Você pode encontrá-los em seu projeto Adobe I/O.

Vá para o seu projeto da Adobe I/O, que ainda deve estar aberto em outra guia do navegador, e clique em Gerar JWT.

ServiceNow

Você verá isso. Na Carga JWT, você encontrará os valores necessários para inserir no ServiceNow.

ServiceNow

Insira esses valores na tela ServiceNow JWT Provider, conforme indicado abaixo.

  • aud: https://ims-na1.adobelogin.com/c/f2bea01fc9414913bae8e0564e6c81cd (este URL é usado para autenticação na Adobe I/O e faz referência à ID do cliente)

  • is: A71C5A0C536804740A490D44@AdobeOrg (esta é a sua ID organizacional IMS)

  • sub: CF2377955F96EBC90A495E88@techacct.adobe.com (esta é a ID da conta técnica do seu projeto Adobe I/O)

Você deveria ter isso agora.

ServiceNow

Em seguida, clique com o botão direito do mouse no cabeçalho do formulário, conforme indicado na captura de tela. Clique em Salvar.

ServiceNow

Depois de salvar, clique em Reivindicações ​personalizadas, conforme indicado na captura de tela acima. Você verá isso.

ServiceNow

Clique com o duplo em cada coluna da linha que tem o texto Inserir uma nova linha….

ServiceNow

Insira os seguintes valores:

  • Nome da solicitação: https://ims-na1.adobelogin.com/s/ent_dataservices_sdk
  • Tipo de Valor da Reivindicação: true|false
  • Valor da solicitação: true

Você deveria ter isso agora. Click Update to save your changes.

ServiceNow

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

19.3.4 Provedor OAuth

Agora você registrará a Adobe Experience Platform como um provedor OAuth e permitirá que a instância solicite tokens OAuth 2.0.

Em ServiceNow, no Navegador de Filtro, informe o termo de pesquisa Registro do Aplicativo. Clique em Application Registry (Registro de aplicativos).

ServiceNow

Você verá isso. Clique em Novo.

ServiceNow

Clique em Conectar-se a um provedor OAuth de terceiros.

ServiceNow

Em seguida, você verá um formulário vazio.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: inserir OAuth AEP

  • ID do cliente: copiar/colar a ID do cliente do projeto da Adobe I/O

  • Segredo do cliente: copiar/colar o segredo do cliente do seu projeto da Adobe I/O

    FYI: você pode encontrar sua ID do cliente e o segredo do cliente aqui, em seu projeto da Adobe I/O.

    ServiceNow

  • Script da API OAuth: selecione OAuthUtilAEP

  • Tipo de concessão padrão: selecione Portador JWT

  • URL do token: insira https://ims-na1.adobelogin.com/ims/exchange/jwt/ (para alterar o URL do token), primeiro desbloqueie o campo URL do token clicando no ícone de cadeado no lado direito do campo, conforme indicado na captura de tela acima

  • Enviar credenciais: No corpo da solicitação (codificado no URL do formulário)

(para os outros campos, mantenha a seleção padrão)

Você deveria ter isso agora.

ServiceNow

Em seguida, clique com o botão direito do mouse no cabeçalho do formulário, conforme indicado na captura de tela. Clique em Salvar.

ServiceNow

Depois de clicar em Salvar, você verá esta mensagem de erro:

Sua configuração tem registros de provedor JWT ausentes em um ou mais perfis de entidade: AEP OAuth default_perfil. Um registro de provedor JWT deve ser mapeado para o registro de perfil da entidade quando o tipo de concessão for o JWT Bearer.

Isso é normal, e você atualizará a configuração agora para corrigir isso.

ServiceNow

Role para baixo e clique no campo AEP OAuth default_perfil , conforme indicado abaixo.

ServiceNow

Você verá isso.

ServiceNow

No campo Provedor JWT, selecione o Provedor JWT que você criou anteriormente, que se chama Provedor JWT AEP. Em seguida, clique em Atualizar.

ServiceNow

Depois de clicar em Atualizar, você voltará à tela OAuth Provider e a mensagem de erro que estava lá agora desaparecerá. Click Update to save your changes.

ServiceNow

Sua instância do ServiceNow agora pode solicitar tokens OAuth 2.0 para o spoke.

19.3.5 Registros de credenciais

Em ServiceNow, no Navegador de Filtro, informe o termo de pesquisa Credenciais. Clique em Credenciais.

ServiceNow

Você verá isso. Agora você precisa criar dois registros de credenciais, um para a entrada de dados e outro para a assimilação de dados.

AEP_Ingestion

Clique em Novo.

ServiceNow

Clique em Credenciais OAuth 2.0.

ServiceNow

Em seguida, você verá um formulário vazio.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: AEP_Ingestion
  • Perfil de entidade OAuth: selecione AEP OAuth default_perfil

(para os outros campos, mantenha a seleção padrão)

Você deveria ter isso agora.

ServiceNow

Em seguida, clique com o botão direito do mouse no cabeçalho do formulário, conforme indicado na captura de tela. Clique em Salvar.

ServiceNow

Você verá isso. A mensagem de erro é esperada. Para localizar a mensagem de erro, clique em Obter token OAuth.

ServiceNow

Você verá esse pop-up que deve ter a mensagem Fluxo de token OAuth concluído com êxito.

ServiceNow

AEP

Clique em Novo.

ServiceNow

Clique em Credenciais OAuth 2.0.

ServiceNow

Em seguida, você verá um formulário vazio.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: AEP
  • Perfil de entidade OAuth: selecione AEP OAuth default_perfil

(para os outros campos, mantenha a seleção padrão)

Você deveria ter isso agora.

ServiceNow

Em seguida, clique com o botão direito do mouse no cabeçalho do formulário, conforme indicado na captura de tela. Clique em Salvar.

ServiceNow

Você verá isso. A mensagem de erro é esperada. Para corrigir a mensagem de erro, clique em Obter token OAuth.

ServiceNow

Você verá esse pop-up que deve ter a mensagem Fluxo de token OAuth concluído com êxito.

ServiceNow

Os registros de credenciais do Adobe Experience Platform spoke agora são criados na sua instância ServiceNow, e o ServiceNow agora é capaz de autenticar com êxito no Adobe I/O e agora pode interagir com o Adobe Experience Platform.

19.3.6 Registros de conexão

Em ServiceNow, no Navegador de Filtro, digite o termo de pesquisa Conexão e Aliases de Credenciais. Clique em Conexão e alias de credenciais.

ServiceNow

Você verá isso. Você já verá dois registros de conexão existentes, AEP e AEP_Ingestion.

ServiceNow

Em seguida, abra o registro de conexão chamado AEP clicando nele.

Você verá isso.

ServiceNow

Na guia Conexões , clique em Novo. Em seguida, você verá um formulário HTTP(s) Connection em branco.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: Plataforma AEP
  • Credencial: selecionar AEP
  • URL da conexão: insira https://platform.adobe.io/
  • Caixa de proteção de atributos : digite o nome do seu Adobe Experience Platform (não insira a ID da sua caixa de proteção). Sua caixa de areia está --aepSandboxId--.
  • Chave da API de atributos : cole a chave de API da integração do Adobe I/O, neste caso: f2bea01fc9414913bae8e0564e6c81cd
  • ID da organização dos atributos : insira a ID de organização IMS da sua instância do Adobe Experience Platform, neste exemplo: A71C5A0C536804740A490D44@AdobeOrg
OBSERVAÇÃO

Para o campo URL da conexão, talvez seja necessário preencher outro valor se a instância do Adobe Experience Platform estiver hospedada em um datacenter específico. Se sua instância estiver hospedada no datacenter na Holanda, o URL da conexão deverá ser definido como https://platform-nld2.adobe.io/. Se sua instância estiver hospedada no datacenter na Austrália, o URL da conexão deverá ser definido como https://platform-aus5.adobe.io/.

O formulário de conexão HTTP(s) agora deve ter a seguinte aparência:

ServiceNow

Clique com o botão direito do mouse no cabeçalho do formulário e, em seguida, clique em Salvar.

ServiceNow

Click the back button.

ServiceNow

Em seguida, você verá que sua conexão HTTP(s) é adicionada ao formulário Conexão. Click the back button.

ServiceNow

Você estará de volta aqui:

ServiceNow

Em seguida, abra o registro de conexão chamado AEP_Ingestion clicando nele.

Você verá isso.

ServiceNow

Na guia Conexões , clique em Novo. Em seguida, você verá um formulário HTTP(s) Connection em branco.

ServiceNow

Preencha os campos do formulário da seguinte maneira:

  • Nome: Dcs AEP
  • Credencial: selecione AEP_Ingestion
  • URL da conexão: insira https://dcs.adobedc.net
  • Caixa de proteção de atributos : digite o nome do seu Adobe Experience Platform (não insira a ID da sua caixa de proteção). Sua caixa de areia está --aepSandboxId--.
  • ID da organização dos atributos : insira a ID de organização IMS da sua instância do Adobe Experience Platform, neste exemplo: A71C5A0C536804740A490D44@AdobeOrg

O formulário de conexão HTTP(s) agora deve ter a seguinte aparência:

ServiceNow

Clique com o botão direito do mouse no cabeçalho do formulário e, em seguida, clique em Salvar.

ServiceNow

Click the back button.

ServiceNow

Em seguida, você verá que sua conexão HTTP(s) é adicionada ao formulário Conexão. Click the back button.

ServiceNow

Você terminou de configurar a integração entre a Adobe Experience Platform e o ServiceNow.

Próxima etapa: 19.4 Configurar a interface do usuário do ServiceNow

Voltar ao módulo 19

Voltar para todos os módulos

Nesta página