19.3 Configurare l'ambiente ServiceNow

NOTA

I seguenti passaggi di implementazione si basano sulla documentazione disponibile sul portale ServiceNow . La documentazione è disponibile qui. Tuttavia, segui i passaggi seguenti.

Prima di tutto, assicurati di aver effettuato l'accesso all'istanza ServiceNow.

ServiceNow

19.3.1 Certificati

In questo passaggio, devi allegare un archivio chiavi Java valido. Hai creato questo Java Key Store nell'esercizio precedente. Il nome del file Java Key Store che hai creato è aep.jks.

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Certificati. Fai clic su Certificati sotto Definizione del sistema.

ServiceNow

Allora vedrete questo. Fai clic su Nuovo.

ServiceNow

Verrà quindi visualizzato un modulo vuoto. Compila i campi del modulo come segue:

  • Nome: Certificato AEP
  • Formato: PEM
  • Tipo: apri il menu a discesa e seleziona Java Key Store.

(per gli altri campi, mantieni la selezione predefinita)

ServiceNow

Dopo aver selezionato Java Key Store Allora vedrete questo. Fai clic sul pulsante attacco in alto a destra sullo schermo.

ServiceNow

Nella finestra a comparsa, fai clic su Scegli file.

ServiceNow

Nella finestra a comparsa, passa alla cartella JKS sul desktop e seleziona il file aep.jks. Fai clic su Apri.

ServiceNow

A quel punto vedrai questo, fai clic sul pulsante X per chiudere il popup.

ServiceNow

Quindi, immetti la password dell’archivio chiavi Java nel campo . Password dell'archivio chiavi.

ServiceNow

Quindi, fai clic su Convalida archivi/certificati.

ServiceNow

Dovresti quindi visualizzare il messaggio key_store valido.

ServiceNow

Il certificato Java Key Store è ora allegato alla tua istanza ServiceNow.

19.3.2 Tasti JWT

Ora creerai una chiave di firma JSON Web Token (JWT) da assegnare al certificato Java Key Store.

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Tasti JWT. Fai clic su Tasti JWT.

ServiceNow

Vedrete questo. Fai clic su Nuovo.

ServiceNow

Verrà quindi visualizzato un modulo vuoto.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: Chiavi AEP JWT
  • Registro chiavi di firma: seleziona il certificato allegato al passaggio precedente, denominato Certificato AEP
  • Password chiave di firma: immetti la password dell'archivio chiavi Java immessa durante la creazione dell'archivio chiavi Java nell'esercizio 19.2

(per gli altri campi, mantieni la selezione predefinita)

Ora dovresti avere questo:

ServiceNow

Fai clic su Invia. Verrai reindirizzato al Tasti JWT panoramica.

ServiceNow

La chiave JWT viene creata e assegnata al certificato JKS.

19.3.3 Provider JWT

Ora aggiungi un provider JSON Web Token (JWT) all’istanza ServiceNow.

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Provider JWT. Fai clic su Provider JWT.

ServiceNow

Vedrete questo. Fai clic su Nuovo.

ServiceNow

Verrà quindi visualizzato un modulo vuoto.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: Provider JWT AEP
  • Configurazione della firma: seleziona la chiave JWT creata nel passaggio precedente, denominata Chiavi AEP JWT

(per gli altri campi, mantieni la selezione predefinita)

Quindi, fai clic con il pulsante destro del mouse sull'intestazione del modulo come indicato nella schermata . Fai clic su Salva.

ServiceNow

Vedrete questo.

ServiceNow

È ora necessario aggiornare i valori per iss, sub e aud. Puoi trovarli nel progetto di Adobe I/O.

Vai al progetto di Adobe I/O, che dovrebbe essere ancora aperto in un'altra scheda del browser, e fai clic su Genera JWT.

ServiceNow

Vedrete questo. In Payload JWT, troverai i valori da immettere in ServiceNow.

ServiceNow

Immetti questi valori nella schermata ServiceNow JWT Provider , come indicato di seguito.

  • aud: https://ims-na1.adobelogin.com/c/f2bea01fc9414913bae8e0564e6c81cd (questo URL viene utilizzato per l’autenticazione per Adobe I/O e fa riferimento al tuo ID client)

  • is: A71C5A0C536804740A490D44@AdobeOrg (questo è il tuo ID organizzazione IMS)

  • sub: CF2377955F96EBC90A495E88@techacct.adobe.com (ID account tecnico del progetto Adobe I/O)

Dovrebbe avere questo ora.

ServiceNow

Quindi, fai clic con il pulsante destro del mouse sull'intestazione del modulo come indicato nella schermata . Fai clic su Salva.

ServiceNow

Dopo il salvataggio, fai clic su Crediti personalizzati come indicato nella schermata precedente. Vedrete questo.

ServiceNow

Fare doppio clic in ogni colonna della riga contenente il testo Inserisci una nuova riga….

ServiceNow

Immetti i seguenti valori:

  • Nome attestazione: https://ims-na1.adobelogin.com/s/ent_dataservices_sdk
  • Tipo di valore attestazione: true|false
  • Valore attestazione: true

Dovrebbe avere questo ora. Fai clic su Aggiorna per salvare le modifiche.

ServiceNow

Il provider JWT viene aggiunto all'istanza ServiceNow.

Provider OAuth 19.3.4

Ora registrerai Adobe Experience Platform come provider OAuth e permetterai all’istanza di richiedere i token OAuth 2.0.

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Registro applicazioni. Fai clic su Registro applicazioni.

ServiceNow

Vedrete questo. Fai clic su Nuovo.

ServiceNow

Fai clic su Connettersi a un provider OAuth di terze parti.

ServiceNow

Verrà quindi visualizzato un modulo vuoto.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: enter AEP OAuth

  • ID client: copia/incolla ID client dal progetto Adobe I/O

  • Segreto client: copia/incolla Segreto client dal progetto Adobe I/O

    FYI: puoi trovare il tuo ID client e il tuo segreto client qui, nel tuo progetto di Adobe I/O.

    ServiceNow

  • Script API OAuth: select OAuthUtilAEP

  • Tipo di sovvenzione predefinito: select Portatore JWT

  • URL token: enter https://ims-na1.adobelogin.com/ims/exchange/jwt/ Per modificare l’URL del token, devi prima sbloccare l’URL del token di campo facendo clic sull’icona a forma di lucchetto sul lato destro del campo, come indicato nella schermata precedente

  • Invia credenziali: Nel corpo della richiesta (con codifica URL del modulo)

(per gli altri campi, mantieni la selezione predefinita)

Dovrebbe avere questo ora.

ServiceNow

Quindi, fai clic con il pulsante destro del mouse sull'intestazione del modulo come indicato nella schermata . Fai clic su Salva.

ServiceNow

Dopo aver fatto clic su Salva, viene visualizzato questo messaggio di errore:

Nella configurazione mancano record del provider JWT in uno o più profili di entità : AEP OAuth default_profile. Un record del provider JWT deve essere mappato al record del profilo di entità quando il tipo di sovvenzione è JWT Bearer.

È normale, e aggiornerai la configurazione ora per risolvere il problema.

ServiceNow

Scorri verso il basso e fai clic sul campo AEP OAuth default_profile come indicato di seguito.

ServiceNow

Vedrete questo.

ServiceNow

Nel campo Provider JWT, seleziona il provider JWT creato in precedenza, denominato Provider JWT AEP. Quindi, fai clic su Aggiorna.

ServiceNow

Dopo aver fatto clic su Aggiorna, tornerai alla schermata del provider OAuth e il messaggio di errore presente non è più disponibile. Fai clic su Aggiorna per salvare le modifiche.

ServiceNow

L’istanza ServiceNow può ora richiedere token OAuth 2.0 per il raggio.

19.3.5 Credenziali

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Credenziali. Fai clic su Credenziali.

ServiceNow

Vedrete questo. È ora necessario creare due record di credenziali, uno per Ingresso dati e un altro per Acquisizione dei dati.

AEP_Ingestion

Fai clic su Nuovo.

ServiceNow

Fai clic su Credenziali OAuth 2.0.

ServiceNow

Verrà quindi visualizzato un modulo vuoto.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: AEP_Ingestion
  • Profilo di entità OAuth: select AEP OAuth default_profile

(per gli altri campi, mantieni la selezione predefinita)

Dovrebbe avere questo ora.

ServiceNow

Quindi, fai clic con il pulsante destro del mouse sull'intestazione del modulo come indicato nella schermata . Fai clic su Salva.

ServiceNow

Vedrete questo. Il messaggio di errore è previsto. Per risolvere il messaggio di errore, fai clic su Ottieni token OAuth.

ServiceNow

Vedrai quindi questa finestra a comparsa che dovrebbe avere il messaggio Flusso del token OAuth completato.

ServiceNow

AEP

Fai clic su Nuovo.

ServiceNow

Fai clic su Credenziali OAuth 2.0.

ServiceNow

Verrà quindi visualizzato un modulo vuoto.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: AEP
  • Profilo di entità OAuth: select AEP OAuth default_profile

(per gli altri campi, mantieni la selezione predefinita)

Dovrebbe avere questo ora.

ServiceNow

Quindi, fai clic con il pulsante destro del mouse sull'intestazione del modulo come indicato nella schermata . Fai clic su Salva.

ServiceNow

Vedrete questo. Il messaggio di errore è previsto. Per correggere il messaggio di errore, fai clic su Ottieni token OAuth.

ServiceNow

Vedrai quindi questa finestra a comparsa che dovrebbe avere il messaggio Flusso del token OAuth completato.

ServiceNow

I record delle credenziali per il raggio Adobe Experience Platform vengono ora creati nella tua istanza ServiceNow e ServiceNow è in grado di eseguire l'autenticazione in base all'Adobe I/O e ora può interagire con Adobe Experience Platform.

19.3.6 Record di connessione

In ServiceNow, nel Navigatore filtri, immettere il termine di ricerca Alias di connessione e credenziali. Fai clic su Alias di connessione e credenziali.

ServiceNow

Vedrete questo. Verranno già visualizzati due record di connessione esistenti, AEP e AEP_Ingestion.

ServiceNow

Quindi, apri il record di connessione denominato AEP facendo clic su di essa.

Vedrete questo.

ServiceNow

In Connessioni scheda , fai clic su Nuovo. Verrà visualizzato un vuoto Connessione HTTP(i) modulo.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: Piattaforma AEP
  • Credenziale: select AEP
  • URL di connessione: enter https://platform.adobe.io/
  • Attributi Sandbox: immetti il nome del tuo Adobe Experience Platform (non inserire l’ID della tua sandbox). La sandbox è --aepSandboxId--.
  • Attributi Chiave API: incolla la chiave API dell’integrazione di Adobe I/O, in questo caso: f2bea01fc9414913bae8e0564e6c81cd
  • Attributi ID organizzazione: immetti l’ID organizzazione IMS della tua istanza Adobe Experience Platform, in questo esempio: A71C5A0C536804740A490D44@AdobeOrg
NOTA

Per il campo URL connessione, potrebbe essere necessario compilare un altro valore se l’istanza Adobe Experience Platform è ospitata in un datacenter specifico. Se l’istanza è ospitata nel centro dati nei Paesi Bassi, l’URL della connessione deve essere impostato su https://platform-nld2.adobe.io/. Se l’istanza è ospitata nel datacenter in Australia, l’URL della connessione deve essere impostato su https://platform-aus5.adobe.io/.

Il modulo di connessione HTTP deve ora essere simile al seguente:

ServiceNow

Fare clic con il pulsante destro del mouse sull’intestazione del modulo, quindi fare clic su Salva.

ServiceNow

Fai clic sul pulsante indietro pulsante .

ServiceNow

Verrà quindi visualizzata l'aggiunta della connessione HTTP al modulo Connessione. Fai clic sul pulsante indietro pulsante .

ServiceNow

Allora tornerai qui:

ServiceNow

Quindi, apri il record di connessione denominato AEP_Ingestion facendo clic su di essa.

Vedrete questo.

ServiceNow

In Connessioni scheda , fai clic su Nuovo. Verrà visualizzato un vuoto Connessione HTTP(i) modulo.

ServiceNow

Compila i campi del modulo come segue:

  • Nome: AEP dcs
  • Credenziale: select AEP_Ingestion
  • URL di connessione: enter https://dcs.adobedc.net
  • Attributi Sandbox: immetti il nome del tuo Adobe Experience Platform (non inserire l’ID della tua sandbox). La sandbox è --aepSandboxId--.
  • Attributi ID organizzazione: immetti l’ID organizzazione IMS della tua istanza Adobe Experience Platform, in questo esempio: A71C5A0C536804740A490D44@AdobeOrg

Il modulo di connessione HTTP deve ora essere simile al seguente:

ServiceNow

Fare clic con il pulsante destro del mouse sull’intestazione del modulo, quindi fare clic su Salva.

ServiceNow

Fai clic sul pulsante indietro pulsante .

ServiceNow

Verrà quindi visualizzata l'aggiunta della connessione HTTP al modulo Connessione. Fai clic sul pulsante indietro pulsante .

ServiceNow

È stata completata la configurazione dell’integrazione tra Adobe Experience Platform e ServiceNow.

Passaggio successivo: 19.4 Configurare l'interfaccia utente di ServiceNow

Torna al modulo 19

Torna a tutti i moduli

In questa pagina