Intégration à Eloqua

Prérequis

Avant d'installer et de configurer un système orchestré Eloqua, vous devez tenir compte des tâches et prérequis suivants.

Composants certifiés

Le système peut être l'un des suivants :

Eloqua

Modes pris en charge

Le système orchestré Eloqua prend en charge les modes suivants :

Système géré

Opérations système prises en charge

Le système orchestré Eloqua prend en charge les opérations suivantes :

Créer un utilisateur
Supprimer l'utilisateur
Réinitialiser le mot de passe
Affectation de groupes à un utilisateur
Enlever des groupes d'un utilisateur
Attribuer des licences à un utilisateur
Supprimer les licences d'un utilisateur

Obtenir l'ID client et la clé secrète client

Enregistrez l'application dans Eloqua pour recevoir un ID client et une clé secrète client uniques.

Connectez-vous à l'instance Eloqua.
Accédez à Paramètres, puis à AppCloud Developer.
Sélectionnez Créer une application.
Renseignez les détails de la demande requis.
Dans la section OAuth, entrez l'URL de l'application dans le champ URL de rappel OAuth.
Sélectionnez Save (Enregistrer). Eloqua génère l'ID client et la clé secrète client. Enregistrez ces informations d'identification. Vous les utilisez lorsque vous configurez OAuth.

Pour obtenir des étapes détaillées, reportez-vous à Authentification à l'aide de OAuth 2.0.

Générer un code autorisation (navigateur)

Démarrez le processus OAuth en dirigeant les utilisateurs vers l'adresse d'autorisation d'Eloqua dans un navigateur Web.

Ouvrez un navigateur et utilisez l'URL suivante. Remplacez les espaces réservés par les valeurs réelles :

https://login.eloqua.com/auth/oauth2/authorize?response_type=code&client_id=<CLIENT_ID>&redirect_uri=<YOUR_CALLBACK_URL>&scope=full

Authentifier et approuver.
Après approbation, vous êtes redirigé vers l'URL de rappel :
```
https://yourapp.com/callback?code=AUTH_CODE_VALUE
```
Copiez et enregistrez le fichier AUTH_CODE_VALUE à partir de l'URL.

Code autorisation d'échange pour les jetons

Envoyez le code d'autorisation, ainsi que les informations d'identification, à l'adresse de jeton Eloqua à l'aide d'un client REST.

Utilisez un client REST (tel que Postman) pour effectuer une demande POST :

Adresse

POST https://login.eloqua.com/auth/oauth2/token

En-têtes

Authorization: Basic <BASE64(CLIENT_ID:CLIENT_SECRET)>
         Content-Type: application/x-www-form-urlencoded

Corps (form-data)

grant_type=authorization_code
         code=<AUTH_CODE_VALUE>
         redirect_uri=<YOUR_CALLBACK_URL>

Une demande réussie renvoie une réponse JSON qui contient à la fois un jeton d'accès et un jeton d'actualisation. Copiez et enregistrez le jeton d'actualisation. Vous l'utilisez lorsque vous configurez OAuth.

Configurer

Vous pouvez établir une connexion entre Eloqua et Oracle Access Governance en saisissant les détails de connexion. Pour ce faire, utilisez la fonctionnalité Systèmes orchestrés disponible dans la console Oracle Access Governance.

Accéder à la page Systèmes orchestrés

Accédez à la page Systèmes orchestrés de la console Oracle Access Governance en procédant comme suit :

Dans l'icône du menu de navigation d'Oracle Access Governance, sélectionnez Administration des services → Systèmes orchestrés.
Cliquez sur le bouton Ajouter un système orchestré pour démarrer le workflow.

Sélectionner un système

A l'étape Sélectionner un système du workflow, vous pouvez indiquer le type de système que vous souhaitez intégrer.

Sélectionnez Eloqua.
Sélectionnez Suivant.

Saisir les détails

A l'étape Ajouter des détails du workflow, entrez les détails du système orchestré :

Entrez le nom du système auquel vous souhaitez vous connecter dans le champ Nom.
Entrez une description du système dans le champ Description.
Décidez si ce système orchestré est une source faisant autorité et si Oracle Access Governance peut gérer les droits d'accès en cochant les cases suivantes.
- Il s'agit de la source faisant autorité pour mes identités
  Sélectionnez l'une des options suivantes :
  - Source d'identités et de leurs attributs : le système agit comme une source d'identités et des attributs associés. De nouvelles identités sont créées via cette option .
  - Source des attributs d'identité uniquement : le système ingère des détails d'attributs d'identité supplémentaires et les applique aux identités existantes. Cette option n'ingère ni ne crée d'enregistrements d'identité.
- Je veux gérer les droits d'accès pour ce système
Dans chaque cas, la valeur par défaut est Non sélectionné.
Sélectionnez Suivant.

Ajouter des propriétaires

Vous pouvez associer la propriété des ressources en ajoutant des propriétaires principaux et supplémentaires. Cela entraîne le libre-service car ces propriétaires peuvent ensuite gérer (lire, mettre à jour ou supprimer) les ressources qu'ils possèdent. Par défaut, le créateur de la ressource est désigné comme propriétaire de la ressource. Vous pouvez affecter un propriétaire principal et jusqu'à 20 propriétaires supplémentaires pour les ressources.

Remarque

Lorsque vous configurez le premier système orchestré pour votre instance de service, vous ne pouvez affecter des propriétaires qu'après avoir activé les identités à partir de la section Gérer les identités.

Pour ajouter des propriétaires :

Sélectionnez un utilisateur actif Oracle Access Governance en tant que propriétaire principal dans le champ Qui est le propriétaire principal ?.
Sélectionnez un ou plusieurs propriétaires supplémentaires dans la liste Qui d'autre en est propriétaire ?. Vous pouvez ajouter jusqu'à 20 propriétaires supplémentaires pour la ressource.

Vous pouvez afficher le propriétaire principal dans la liste. Tous les propriétaires peuvent afficher et gérer les ressources qu'ils possèdent.

Paramètres de compte

A l'étape Paramètres de compte du workflow, indiquez comment Oracle Access Governance doit gérer les comptes lorsque le système est configuré en tant que système géré :

Lorsqu'une autorisation est demandée et que le compte n'existe pas encore, sélectionnez cette option pour créer de nouveaux comptes. Cette option est sélectionnée par défaut. Lorsque cette option est sélectionnée, Oracle Access Governance crée un compte s'il n'en existe pas lorsqu'une autorisation est demandée. Si vous désélectionnez cette option, les droits d'accès ne sont provisionnés que pour les comptes existants dans le système orchestré. Si aucun compte n'existe, l'opération de provisionnement échoue.
Sélectionnez les destinataires des courriels de notification lorsqu'un compte est créé. Le destinataire par défaut est Utilisateur. Si aucun destinataire n'est sélectionné, aucune notification n'est envoyée lors de la création des comptes.
- Utilisateur
- Gestionnaire d'utilisateurs
Configurer des comptes existants
Remarque

Vous ne pouvez définir ces configurations que si l'administrateur système l'autorise. Lorsque les paramètres globaux de résiliation de compte sont activés, les administrateurs de l'application ne peuvent pas gérer les paramètres de résiliation de compte au niveau du système orchestré.
1. Sélectionner ce qu'il faut faire avec les comptes lorsqu'une résiliation anticipée commence : choisissez l'action à effectuer lorsqu'une résiliation anticipée commence. Cela se produit lorsque vous devez révoquer les accès à l'identité avant la date de fin officielle.
  - Supprimer : supprime tous les comptes et droits d'accès gérés par Oracle Access Governance.
    Remarque
    
    Si un système orchestré spécifique ne prend pas en charge l'action, aucune action n'est entreprise.
  - Désactiver : désactive tous les comptes et tous les droits d'accès gérés par Oracle Access Governance.
    - Supprimer les droits d'accès pour les comptes désactivés : pour garantir un accès résiduel nul, sélectionnez cette option pour supprimer les droits d'accès affectés directement et les droits d'accès accordés par une stratégie lors de la désactivation du compte.
  - Aucune action : aucune action n'est entreprise lorsqu'une identité est marquée pour une résiliation anticipée par Oracle Access Governance.
2. Sélectionner ce qu'il faut faire avec les comptes à la date de fin de contrat : sélectionnez l'action à effectuer lors de la fin de contrat officielle. Cela se produit lorsque vous devez révoquer les accès d'identité à la date de fin de contrat officielle.
  - Supprimer : supprime tous les comptes et droits d'accès gérés par Oracle Access Governance.
    Remarque
    
    Si un système orchestré spécifique ne prend pas en charge l'action Supprimer, aucune action n'est effectuée.
  - Désactiver : désactive tous les comptes et tous les droits d'accès gérés par Oracle Access Governance.
    - Supprimer les droits d'accès pour les comptes désactivés : pour garantir un accès résiduel nul, sélectionnez cette option pour supprimer les droits d'accès affectés directement et les droits d'accès accordés par une stratégie lors de la désactivation du compte.
    Remarque
    
    Si un système orchestré spécifique ne prend pas en charge l'action Désactiver, le compte est supprimé.
  - Aucune action : aucune action n'est effectuée sur les comptes et les droits d'accès par Oracle Access Governance.
Lorsqu'une identité quitte votre entreprise, vous devez supprimer l'accès à ses comptes.
Remarque

Vous ne pouvez définir ces configurations que si l'administrateur système l'autorise. Lorsque les paramètres globaux de résiliation de compte sont activés, les administrateurs de l'application ne peuvent pas gérer les paramètres de résiliation de compte au niveau du système orchestré.
Sélectionnez l'une des actions suivantes pour le compte :
- Supprimer : supprimez tous les comptes et droits d'accès gérés par Oracle Access Governance.
- Désactiver : désactivez tous les comptes et marquez les autorisations comme inactives.
  - Supprimer les droits d'accès pour les comptes désactivés : supprimer les droits d'accès directement affectés et accordés par une stratégie lors de la désactivation du compte afin de garantir un accès résiduel nul.
- Aucune action : n'effectuez aucune action lorsqu'une identité quitte l'organisation.
Remarque

Ces actions ne sont disponibles que si elles sont prises en charge par le type de système orchestré. Par exemple, si l'option Supprimer n'est pas prise en charge, vous verrez uniquement les options Désactiver et Aucune action.
Lorsque tous les droits d'accès d'un compte sont supprimés, par exemple lorsqu'une identité se déplace d'un service à l'autre, vous devrez peut-être décider quoi faire avec le compte. Sélectionnez l'une des actions suivantes, si elle est prise en charge par le type de système orchestré :
- Supprimer
- Désactiver
- Aucune intervention
Gérer les comptes qui ne sont pas créés par Access Governance : sélectionnez cette option pour gérer les comptes qui sont créés directement dans le système orchestré. Vous pouvez ainsi rapprocher les comptes existants et les gérer à partir d'Oracle Access Governance.

Remarque

Si vous ne configurez pas le système en tant que système géré, cette étape du workflow s'affiche mais n'est pas activée. Dans ce cas, vous passez directement à l'étape Paramètres d'intégration du workflow.

Remarque

Si votre système orchestré nécessite un repérage de schéma dynamique, comme pour les intégrations Generic REST et Database Application Tables, seule la destination de courriel de notification peut être définie (Utilisateur, Usermanager) lors de la création du système orchestré. Vous ne pouvez pas définir les règles de désactivation/suppression pour les déménageurs et les sortants. Pour ce faire, vous devez créer le système orchestré, puis mettre à jour les paramètres de compte comme décrit dans Configurer les paramètres de compte système orchestré.

Configurer Eloqua à l'aide de OAuth

A l'étape Paramètres d'intégration du workflow, entrez les détails de configuration requis pour permettre à Oracle Access Governance de se connecter à Eloqua à l'aide de OAuth.

Cochez la case Voulez-vous utiliser le jeton d'actualisation pour l'authentification ? et entrez les détails, comme suit :


Champ	Description
Hôte	Entrez le nom d'hôte à partir de l'URL. Par exemple, `secure.<pod>.eloqua.com`.
URL de réacheminement	URL de rappel après authentification. Il doit correspondre à l'URL que vous avez saisie lors de l'inscription de l'application. `https://yourapp.example.com/callback`
URL de serveur d'authentification	URL du serveur OAuth2 d'Eloqua pour la demande de jetons. `https://login.eloqua.com/auth/oauth2/token`
ID client	ID client de l'application affichée lors de l'inscription de l'intégration dans Eloqua. Reportez-vous à Obtain Client ID and Client Secret.
Clé primaire du client	Clé secrète client de l'application affichée lors de l'inscription de l'intégration dans Eloqua. Reportez-vous à Obtain Client ID and Client Secret.
Jeton d'actualisation	Jeton utilisé pour actualiser automatiquement le jeton d'accès lorsqu'il expire. Par exemple, `eyJraWQiOi...2IHpuqg`. Reportez-vous à Code d'autorisation d'échange pour jetons.
Délai d'expiration de demande	Temps d'attente maximal (en millisecondes) avant l'annulation de la demande. `30000`.

Terminer

La dernière étape du workflow est Terminer, où vous pouvez choisir de configurer davantage le système orchestré avant d'exécuter un chargement de données, ou d'accepter la configuration par défaut et de démarrer un chargement de données. Sélectionnez l'une des options suivantes :

Effectuer une personnalisation avant d'activer le système pour les chargements de données
Activer et préparer le chargement de données avec les valeurs par défaut fournies

Post-configuration

Aucune étape de post-configuration n'est associée à un système Eloqua.

Documentation Oracle Cloud Infrastructure