Migrazione degli operatori tecnici di Campaign a Adobe Developer Console :headding-anchor:migrate-tech-users-to-ims
Come parte degli sforzi per rafforzare la sicurezza e il processo di autenticazione, a partire da Campaign v8.5, il processo di autenticazione a Campaign v8 viene migliorato. Gli operatori tecnici possono ora utilizzare Adobe Identity Management System (IMS) per connettersi a Campaign. Ulteriori informazioni sul processo di autenticazione da server a server nel documento Adobe Developer Console.
Un operatore tecnico è un profilo utente di Campaign creato esplicitamente per l’integrazione API. Questo articolo descrive i passaggi necessari per migrare un operatore tecnico a un account tecnico tramite la console Adobe Developer.
Sei interessato? :headding-anchor:ims-impacts
Se effettui chiamate API da un sistema esterno a Campaign nell’istanza Campaign Marketing o Real-Time Message Center, devi migrare gli operatori tecnici agli account tecnici tramite Adobe Developer Console come descritto di seguito.
Questa modifica è applicabile a partire da Campaign v8.5 e sarà obbligatoria a partire da Campaign v8.6.
Processo di migrazione :headding-anchor:ims-migration-procedure
Segui i passaggi seguenti per creare account tecnici all’interno di Adobe Developer Console, quindi utilizza gli account appena creati per poter modificare i metodi di autenticazione per tutti i sistemi esterni che effettuano chiamate API in Adobe Campaign.
Ecco una panoramica dei passaggi:
- Creazione di un progetto in Adobe Developer Console
- Assegnazione delle API appropriate al progetto appena creato
- Assegnazione dei profili di prodotto di Campaign necessari al progetto
- Aggiornamento delle API per utilizzare le credenziali dell’account tecnico appena create
- Rimuovere gli operatori tecnici legacy dall’istanza Campaign
Prerequisiti per la migrazione :headding-anchor:ims-migration-prerequisites
Per le chiamate API nelle istanze del Centro messaggi, avrebbe dovuto essere creato un profilo di prodotto durante l’aggiornamento a Campaign v8.5 o durante il provisioning dell’istanza. Questo profilo di prodotto è denominato:
campaign - <your campaign instance> - messagecenter
Se utilizzi già l’autenticazione basata su IMS per l’accesso utente a Campaign, i profili di prodotto necessari per le chiamate API dovrebbero già esistere all’interno dell’Admin Console. Se utilizzi un gruppo di operatori personalizzato all’interno di Campaign per le chiamate API all’istanza Marketing, devi creare tale profilo di prodotto nell’Admin Console.
Per gli altri casi, devi contattare il tuo Adobe Transition Manager in modo che i team tecnici Adobe possano migrare i gruppi di operatori e i diritti denominati esistenti ai profili di prodotto all’interno dell’Admin Console.
Passaggio 1: creare il progetto Campaign in Adobe Developer Console :headding-anchor:ims-migration-step-1
Le integrazioni vengono create come parte di un progetto in Adobe Developer Console. Ulteriori informazioni sui progetti nella documentazione di Adobe Developer Console.
Puoi utilizzare qualsiasi progetto creato in precedenza da te oppure creare un nuovo progetto. I passaggi per la creazione di un progetto sono descritti nella documentazione di Adobe Developer Console. Di seguito sono riportati i passaggi chiave
Per creare un nuovo progetto, fare clic su Crea nuovo progetto nella schermata principale di Adobe Developer Console.
Puoi usare il pulsante Modifica progetto per rinominare questo progetto.
Passaggio 2: aggiungere API al progetto :headding-anchor:ims-migration-step-2
Dalla schermata del progetto appena creato, aggiungi nelle API necessarie per poter utilizzare questo progetto come account tecnico per le chiamate API ad Adobe Campaign.
Per aggiungere API al progetto, effettua le seguenti operazioni:
- Fai clic su Aggiungi API per selezionare le API da aggiungere al progetto.
- Seleziona e aggiungi l’API Adobe Campaign al progetto selezionando la casella nell’angolo superiore destro della scheda Adobe Campaign che viene visualizzata quando passi il mouse sulla scheda
- Fai clic su Avanti nella parte inferiore della schermata.
Passaggio 3: selezionare il tipo di autenticazione :headding-anchor:ims-migration-step-3
Nella schermata Configura API, selezionare il tipo di autenticazione necessario. Per questo progetto è richiesta l'autenticazione da server a server OAuth. Assicurati che sia selezionato e fai clic su Avanti nella parte inferiore della schermata.
Passaggio 4: selezionare i profili di prodotto :headding-anchor:ims-migration-step-4
Come descritto nella sezione prerequisiti, è necessario assegnare i profili di prodotto appropriati da utilizzare per il progetto. In questo passaggio, devi selezionare il profilo o i profili di prodotto da utilizzare per l’account tecnico creato.
Se questo account tecnico viene utilizzato per effettuare chiamate API all'istanza del Centro messaggi, assicurarsi di selezionare l'Adobe Crea profilo prodotto che termina con messagecenter
.
Per le chiamate API alle istanze Marketing, seleziona il profilo di prodotto corrispondente all’istanza e al gruppo di operatori.
Dopo aver selezionato i profili di prodotto necessari, fai clic su Salva API configurata nella parte inferiore della schermata.
Passaggio 5: aggiungi l’API di gestione I/O al progetto :headding-anchor:ims-migration-step-5
Dalla schermata del progetto, fai clic su + Add to Project e scegli API in alto a sinistra per poter aggiungere l'API di gestione I/O a questo progetto.
Nella schermata Aggiungi API, scorri verso il basso per trovare la scheda API di gestione I/O. Selezionala facendo clic sulla casella di controllo che compare quando passi il cursore del mouse sulla scheda. Quindi fai clic su Avanti nella parte inferiore della schermata.
Nella schermata Configura API, l'autenticazione server-to-server OAuth esiste già. Fai clic su Salva API configurata nella parte inferiore della schermata.
Viene visualizzata di nuovo la schermata Progetto nell’API di gestione I/O del progetto appena creato. Fai clic sul nome del progetto nelle breadcrumb nella parte superiore dello schermo per tornare alla pagina principale dei Dettagli del progetto.
Passaggio 6: verificare la configurazione del progetto :headding-anchor:ims-migration-step-6
Controlla il progetto per assicurarti che sia simile al seguente con le API di gestione I/O e API Adobe Campaign visibili nella sezione Prodotti e servizi e Server-to-Server OAuth nella sezione Credenziali.
Passaggio 7: convalidare la configurazione :headding-anchor:ims-migration-step-7
Per provare la connessione, seguire i passaggi descritti nella guida alle credenziali di Adobe Developer Console per generare un token di accesso e copiare il comando cURL di esempio fornito. Puoi creare una chiamata soap utilizzando queste credenziali per verificare di poter autenticare e connettersi correttamente alle istanze di Adobe Campaign. È consigliabile eseguire questa convalida prima di apportare tutte le modifiche alle integrazioni API di terze parti.
Passaggio 8: aggiornare le integrazioni API di terze parti :headding-anchor:ims-migration-step-8
Ora devi aggiornare tutte le integrazioni API che effettuano chiamate ad Adobe Campaign per utilizzare l’account tecnico appena creato.
Per ulteriori dettagli sui passaggi di integrazione API, incluso un codice di esempio per un'integrazione fluida, consulta la documentazione di autenticazione di Adobe Developer Console.
Di seguito sono riportati alcuni esempi di chiamate SOAP che mostrano le chiamate prima e dopo la migrazione per i sistemi di terze parti.
Quando si utilizza l'autenticazione Adobe Identity Management System (IMS), per generare un file WSDL è necessario aggiungere Authorization: Bearer <IMS_Technical_Token_Token>
nella chiamata postman:
curl --location --request POST 'https://<instance_url>/nl/jsp/schemawsdl.jsp?schema=nms:rtEvent' \--header 'Authorization: Bearer <Technical account access token>'
Una volta completato e convalidato il processo di migrazione, le chiamate Soap vengono aggiornate come segue:
-
Prima della migrazione: non era disponibile il supporto per il token di accesso dell’account tecnico.
code language-sql POST /nl/jsp/soaprouter.jsp HTTP/1.1 Host: localhost:8080 Content-Type: application/soap+xml; SOAPAction: "nms:rtEvent#PushEvent" charset=utf-8 <?xml version="1.0" encoding="utf-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent"> <soapenv:Header/> <soapenv:Body> <urn:PushEvent> <urn:sessiontoken>SESSION_TOKEN</urn:sessiontoken> <urn:domEvent> <!--You may enter ANY elements at this point--> <rtEvent type="type" email="name@domain.com"/> </urn:domEvent> </urn:PushEvent> </soapenv:Body> </soapenv:Envelope>
-
Dopo la migrazione: è disponibile il supporto per il token di accesso dell’account tecnico. Il token di accesso deve essere fornito nell'intestazione
Authorization
come token Bearer. L’utilizzo del token di sessione deve essere ignorato qui, come mostrato nell’esempio di chiamata soap seguente.code language-sql POST /nl/jsp/soaprouter.jsp HTTP/1.1 Host: localhost:8080 Content-Type: application/soap+xml; SOAPAction: "nms:rtEvent#PushEvent" charset=utf-8 Authorization: Bearer <IMS_Technical_Token_Token> <?xml version="1.0" encoding="utf-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent"> <soapenv:Header/> <soapenv:Body> <urn:PushEvent> <urn:sessiontoken></urn:sessiontoken> <urn:domEvent> <!--You may enter ANY elements at this point--> <rtEvent type="type" email="name@domain.com"/> </urn:domEvent> </urn:PushEvent> </soapenv:Body> </soapenv:Envelope>
Passaggio 9: (facoltativo) aggiorna l’operatore dell’account tecnico nella console client di Campaign :headding-anchor:ims-migration-step-9
Questo passaggio è facoltativo e disponibile solo all’interno delle istanze Marketing, non all’interno di alcuna istanza del Centro messaggi. Se sono state definite autorizzazioni di cartelle specifiche o diritti denominati per l’operatore tecnico non tramite i gruppi di operatori assegnati. Ora è necessario aggiornare l’utente dell’account tecnico appena creato nell’Admin Console per concedere le autorizzazioni della cartella o i diritti denominati richiesti.
L’utente dell’account tecnico NON esisterà in Adobe Campaign finché non verrà effettuata almeno una chiamata API all’istanza di Campaign, momento in cui IMS creerà l’utente all’interno di Campaign. Se non riesci a individuare gli utenti tecnici all’interno di Campaign, assicurati di aver inviato correttamente una chiamata API come descritto nel passaggio 7.
-
Per applicare le modifiche necessarie per il nuovo utente account tecnico, individuale nella console client di Campaign per indirizzo e-mail. Questo indirizzo e-mail è stato creato durante i passaggi di creazione e autenticazione del progetto descritti sopra.
Puoi individuare questo indirizzo e-mail facendo clic sull'intestazione OAuth Server-to-Server nella sezione Credenziali del progetto.
Nella schermata Credenziali, scorri verso il basso per individuare il Indirizzo e-mail account tecnico e fai clic sul pulsante Copia.
-
Ora devi aggiornare l’operatore tecnico appena creato nella console client di Adobe Campaign. È necessario applicare al nuovo operatore tecnico le autorizzazioni esistenti per la cartella dell’operatore tecnico.
Per aggiornare questo operatore, effettua le seguenti operazioni:
- Da Esplora console client di Campaign, passa a Amministrazione > Gestione degli accessi > Operatori.
- Accedi all’operatore tecnico esistente utilizzato per le API.
- Individua le autorizzazioni della cartella e controlla i diritti.
- Applica le stesse autorizzazioni all’operatore tecnico appena creato. L'e-mail di questo operatore è il valore E-mail account tecnico copiato in precedenza.
- Salva le modifiche.
Passaggio 10 - Rimuovere il vecchio operatore tecnico da Adobe Campaign :headding-anchor:ims-migration-step-10
Dopo aver migrato tutti i sistemi di terze parti per utilizzare il nuovo account tecnico con autenticazione IMS, puoi eliminare il vecchio operatore tecnico dalla console client di Campaign.
A tale scopo, accedi alla console client di Campaign e vai a Amministrazione > Gestione degli accessi > Operatori, individua i vecchi utenti tecnici ed eliminali.