Documentazione dell'infrastruttura Oracle Cloud

Integrazione con Eloqua

Requisiti indispensabili

Prima di installare e configurare un sistema orchestrato Eloqua, è necessario considerare i prerequisiti e i task riportati di seguito.

Componenti certificati

Il sistema può essere uno dei seguenti:

  • Eloqua

Modalità supportate

Il sistema orchestrato Eloqua supporta le seguenti modalità:
  • Sistema gestito

Operazioni di sistema supportate

Il sistema orchestrato Eloqua supporta le operazioni riportate di seguito.
  • Crea utente
  • Elimina l'utente
  • Reimposta password
  • Assegna gruppi a un utente
  • Rimuovi gruppi da un utente
  • Assegna licenze a un utente
  • Rimuovi licenze da un utente

Ottieni ID client e Segreto client

Registrare l'applicazione in Eloqua per ricevere un ID client e un segreto client univoci.

  1. Accedere all'istanza di Eloqua.
  2. Passare a Impostazioni, quindi a AppCloud Developer.
  3. Selezionare Crea nuova applicazione.
  4. Completare i dettagli della richiesta.
  5. Nella sezione OAuth immettere l'URL dell'applicazione nel campo OAuth URL di callback.
  6. Selezionare Salva. Eloqua genera l'ID client e il segreto client. Salvare le credenziali. Vengono utilizzati quando si configura OAuth.

Per la procedura dettagliata, vedere Autenticazione mediante OAuth 2.0.

Genera codice autorizzazione (browser)

Avviare il processo OAuth indirizzando gli utenti all'endpoint di autorizzazione di Eloqua in un browser Web.

  1. Aprire un browser e utilizzare il seguente URL. Sostituire i segnaposto con i valori effettivi: 
    https://login.eloqua.com/auth/oauth2/authorize?response_type=code&client_id=<CLIENT_ID>&redirect_uri=<YOUR_CALLBACK_URL>&scope=full
  2. Autenticare e approvare.
  3. Dopo l'approvazione, si viene reindirizzati all'URL di callback: 
    https://yourapp.com/callback?code=AUTH_CODE_VALUE
  4. Copiare e salvare AUTH_CODE_VALUE dall'URL.

Codice autorizzazione cambio per token

Invia il codice di autorizzazione, insieme alle credenziali, all'endpoint del token di Eloqua utilizzando un client REST.

Utilizzare un client REST (ad esempio Postman) per effettuare una richiesta POST:

  1. Endpoint 
    POST https://login.eloqua.com/auth/oauth2/token
  2. Intestazioni 
    Authorization: Basic <BASE64(CLIENT_ID:CLIENT_SECRET)>
         Content-Type: application/x-www-form-urlencoded
  3. Corpo (dati-form) 
    grant_type=authorization_code
         code=<AUTH_CODE_VALUE>
         redirect_uri=<YOUR_CALLBACK_URL>

Una richiesta riuscita restituisce una risposta JSON contenente sia il token di accesso che il token di aggiornamento. Copiare e salvare il token di aggiornamento. Lo si utilizza quando si configura OAuth.

Configura

Immettere i dettagli di connessione per stabilire una connessione tra Eloqua e Oracle Access Governance. A tale scopo, utilizzare la funzionalità Sistemi orchestrati disponibile in Oracle Access Governance Console.

Passa alla pagina Sistemi orchestrati

Passare alla pagina Sistemi orchestrati di Oracle Access Governance Console, effettuando le operazioni riportate di seguito.
  1. Dall'icona Menu di navigazione del menu di navigazione di Oracle Access Governance selezionare Amministrazione servizi → Sistemi orchestrati.
  2. Selezionare il pulsante Aggiungi un sistema orchestrato per avviare il workflow.

Seleziona sistema

Nel passo Seleziona sistema del flusso di lavoro, è possibile specificare il tipo di sistema da inserire.

  1. Selezionare Eloqua.
  2. Selezionare Next.

Immettere i dettagli

Nel passo Aggiungi dettagli del flusso di lavoro, immettere i dettagli del sistema orchestrato.
  1. Immettere il nome del sistema a cui si desidera connettersi nel campo Nome.
  2. Immettere una descrizione nel campoDescrizione per il sistema.
  3. Decidere se il sistema orchestrato è un'origine affidabile e se Oracle Access Governance può gestire le autorizzazioni impostando le caselle di controllo riportate di seguito.
    • Questa è l'origine affidabile per le identità personali

      Selezionare una delle seguenti opzioni:

      • Origine delle identificative e dei relativi attributi: il sistema funge da identità di origine e attributi associati. Le nuove identità vengono create con questa opzione.
      • Solo origine degli attributi di identità: il sistema acquisisce ulteriori dettagli sugli attributi di identità e li applica alle identità esistenti. Questa opzione non include o crea nuovi record di identità.
    • Desidero gestire le autorizzazioni per questo sistema
    Il valore predefinito in ogni caso è Non selezionato.
  4. Selezionare Next.

Aggiungi proprietari

È possibile associare la proprietà delle risorse aggiungendo proprietari principali e aggiuntivi. Il servizio self-service consente ai proprietari di gestire (leggere, aggiornare o eliminare) le risorse di cui sono proprietari. Per impostazione predefinita, l'autore della risorsa viene designato come proprietario della risorsa. È possibile assegnare un proprietario principale e fino a 20 proprietari aggiuntivi per le risorse.
Nota

Quando si imposta il primo sistema orchestrato per l'istanza del servizio, è possibile assegnare i proprietari solo dopo aver abilitato le identità dalla sezione Gestisci identità.
Per aggiungere proprietari:
  1. Selezionare un utente attivo di Oracle Access Governance come proprietario principale nel campo Chi è il proprietario principale?.
  2. Selezionare uno o più proprietari aggiuntivi nell'elenco Chi altro lo possiede?. È possibile aggiungere fino a 20 proprietari aggiuntivi per la risorsa.
È possibile visualizzare il proprietario principale nell'elenco. Tutti i proprietari possono visualizzare e gestire le risorse di cui sono proprietari.

Impostazioni account

Nel passo Impostazioni account del workflow, immettere la modalità di gestione degli account da parte di Oracle Access Governance quando il sistema è configurato come sistema gestito.
  1. Quando viene richiesta un'autorizzazione e l'account non esiste già, selezionare questa opzione per creare nuovi account. Questa opzione è selezionata per impostazione predefinita. Quando questa opzione è selezionata, Oracle Access Governance crea un account se non ne esiste uno quando viene richiesta un'autorizzazione. Se si deseleziona questa opzione, viene eseguito il provisioning delle autorizzazioni solo per gli account esistenti nel sistema orchestrato. Se non esiste alcun account, l'operazione di provisioning non riesce.
  2. Selezionare i destinatari dei messaggi di posta elettronica di notifica quando viene creato un account. Il destinatario predefinito è Utente. Se non viene selezionato alcun destinatario, le notifiche non vengono inviate quando vengono creati gli account.
    • Utente
    • Responsabile utenti
  3. Configura account esistenti
    Nota

    È possibile impostare queste configurazioni solo se consentito dall'amministratore di sistema. Quando le impostazioni di cessazione dell'account globale sono abilitate, gli amministratori dell'applicazione non possono gestire le impostazioni di cessazione dell'account a livello di sistema orchestrato.
    1. Selezionare le azioni da eseguire con i conti all'inizio della cessazione anticipata: scegliere l'azione da eseguire all'inizio di una cessazione anticipata. Ciò si verifica quando è necessario revocare gli accessi di identità prima della data di cessazione ufficiale.
      • Elimina: elimina tutti gli account e le autorizzazioni gestiti da Oracle Access Governance.
        Nota

        Se un sistema orchestrato specifico non supporta l'azione, non viene eseguita alcuna azione.
      • Disabilita: disabilita tutti gli account e disabilita le autorizzazioni gestite da Oracle Access Governance.
        • Eliminare le autorizzazioni per gli account disabilitati: per garantire zero accessi residui, selezionare questa opzione per eliminare le autorizzazioni assegnate direttamente e le autorizzazioni concesse dai criteri durante la disabilitazione dell'account.
      • Nessuna azione: non viene eseguita alcuna azione quando un'identità viene contrassegnata per l'interruzione anticipata da Oracle Access Governance.
    2. Selezionare le azioni da eseguire con i conti alla data di cessazione: selezionare l'azione da eseguire durante la cessazione ufficiale. Ciò si verifica quando è necessario revocare gli accessi di identità alla data di cessazione ufficiale.
      • Elimina: elimina tutti gli account e le autorizzazioni gestiti da Oracle Access Governance.
        Nota

        Se un sistema orchestrato specifico non supporta l'azione Elimina, non viene eseguita alcuna azione.
      • Disabilita: disabilita tutti gli account e disabilita le autorizzazioni gestite da Oracle Access Governance.
        • Eliminare le autorizzazioni per gli account disabilitati: per garantire zero accessi residui, selezionare questa opzione per eliminare le autorizzazioni assegnate direttamente e le autorizzazioni concesse dai criteri durante la disabilitazione dell'account.
        Nota

        Se un sistema orchestrato specifico non supporta l'azione Disabilita, l'account viene eliminato.
      • Nessuna azione: Oracle Access Governance non esegue alcuna azione sugli account e sulle autorizzazioni.
  4. Quando un'identità lascia l'azienda, è necessario rimuovere l'accesso ai propri account.
    Nota

    È possibile impostare queste configurazioni solo se consentito dall'amministratore di sistema. Quando le impostazioni di cessazione dell'account globale sono abilitate, gli amministratori dell'applicazione non possono gestire le impostazioni di cessazione dell'account a livello di sistema orchestrato.

    Selezionare una delle azioni seguenti per l'account:

    • Elimina: consente di eliminare tutti gli account e le autorizzazioni gestiti da Oracle Access Governance.
    • Disabilita: disabilita tutti gli account e contrassegna le autorizzazioni come inattive.
      • Eliminare le autorizzazioni per gli account disabilitati: eliminare le autorizzazioni assegnate direttamente e concesse dai criteri durante la disabilitazione dell'account per garantire zero accessi residui.
    • Nessuna azione: non eseguire alcuna azione quando un'identità lascia l'organizzazione.
    Nota

    Queste azioni sono disponibili solo se supportate dal tipo di sistema orchestrato. Ad esempio, se Elimina non è supportato, verranno visualizzate solo le opzioni Disabilita e Nessuna azione.
  5. Quando vengono rimosse tutte le autorizzazioni per un account, ad esempio quando un'identità si sposta tra i reparti, potrebbe essere necessario decidere cosa fare con l'account. Selezionare una delle seguenti azioni, se supportata dal tipo di sistema orchestrato:
    • Elimina
    • Disabilita
    • Nessuna azione
  6. Gestisci account non creati da Access Governance: selezionare questa opzione per gestire gli account creati direttamente nel sistema orchestrato. Ciò consente di riconciliare i conti esistenti e di gestirli da Oracle Access Governance.
Nota

Se non si configura il sistema come sistema gestito, questo passo del workflow verrà visualizzato ma non è abilitato. In questo caso si passa direttamente al passo Impostazioni di integrazione del workflow.
Nota

Se il sistema orchestrato richiede la ricerca automatica dinamica degli schemi, come per le integrazioni delle tabelle applicazioni REST e di database generiche, è possibile impostare solo la destinazione e-mail di notifica (Utente, Usermanager) durante la creazione del sistema orchestrato. Impossibile impostare le regole di disabilitazione/eliminazione per movers e leavers. A tale scopo, è necessario creare il sistema orchestrato, quindi aggiornare le impostazioni dell'account come descritto in Configura impostazioni account di sistema orchestrato.

Configurare Eloqua mediante OAuth

Nel passo Impostazioni di integrazione del workflow, immettere i dettagli di configurazione necessari per consentire a Oracle Access Governance di connettersi a Eloqua utilizzando OAuth.

Selezionare la casella di controllo Utilizzare il token di aggiornamento per l'autenticazione? e immettere i dettagli, come indicato di seguito.

Campo Descrizione
Host

Immettere il nome host dall'URL. Ad esempio, secure.<pod>.eloqua.com.
URL di reindirizzamento

URL di callback dopo l'autenticazione. Deve corrispondere all'URL inserito durante la registrazione dell'applicazione.

https://yourapp.example.com/callback
URL server di autenticazione

URL del server OAuth2 di Eloqua per la richiesta di token.

https://login.eloqua.com/auth/oauth2/token
ID client

ID client dell'applicazione visualizzato durante la registrazione dell'integrazione in Eloqua. Vedere Ottieni ID client e Segreto client.
Segreto client

Segreto client dell'applicazione visualizzato durante la registrazione dell'integrazione in Eloqua. Vedere Ottieni ID client e Segreto client.
Token di aggiornamento

Token utilizzato per aggiornare automaticamente il token di accesso alla scadenza. Ad esempio, eyJraWQiOi...2IHpuqg. Vedere Codice autorizzazione cambio per token.
Timeout richiesta

Tempo massimo di attesa (in millisecondi) prima di annullare la richiesta. 30000.

Termina

Il passo finale del flusso di lavoro è Fine, in cui è possibile scegliere se configurare ulteriormente il sistema orchestrato prima di eseguire un caricamento dati oppure accettare la configurazione predefinita e avviare un caricamento dati. Selezioni una sola opzione tra:
  • Personalizzare prima di abilitare il sistema per i caricamenti dati
  • Attivare e preparare il caricamento dati con le impostazioni predefinite fornite

Postconfigurazione

Non sono presenti passi successivi alla configurazione associati a un sistema Eloqua.