Configurer une connexion
Lorsque vous ajoutez une carte à un flux, vous devez sélectionner ou créer une connexion pour vous authentifier auprès de cette application ou de ce service. Vous pouvez créer des connexions au niveau du dossier ou au niveau de l'org.
Une fois votre connexion de compte distant configurée, Okta enregistre les informations sur votre compte afin que vous puissiez réutiliser la connexion lorsque vous générez d'autres flux qui utilisent le même connecteur.
Les connexions au niveau du dossier ne peuvent être utilisées que par les flux se trouvant dans le dossier dans lequel elles ont été créées. Les sous-dossiers héritent des connexions de leur dossier parent racine.
Nouvelles connexions
Connexions au niveau des org
Vous pouvez créer des connexions au niveau de l'org pour vos flux à l'aide de la page Connexions de la console Workflows. Avant de pouvoir utiliser les connexions de niveau de l'org dans un dossier, vous devez les ajouter à celui-ci.
Pour configurer une nouvelle configuration de connexion au niveau de l'org, procédez comme suit :
-
Sur la page Connexions de la console Workflows, cliquez sur Nouvelle connexion.
-
Dans la fenêtre contextuelle du sélecteur Nouvelle connexion, cliquez sur l'icône qui correspond à l'application ou au service que vous souhaitez connecter.
-
Facultatif : cliquez sur Accès aux dossiers (facultatif) et sélectionnez les dossiers auxquels vous souhaitez ajouter la connexion. Les connexions ne peuvent pas être utilisées tant qu'elles n'ont pas été ajoutées à un dossier.
Connexions au niveau des dossiers
Vous pouvez créer des connexions au niveau des dossiers pour vos flux à l'aide de la page Flux de la console Workflows. Les connexions au niveau du dossier ne peuvent être utilisées que par les flux se trouvant dans le dossier dans lequel elles ont été créées.
Pour configurer une nouvelle configuration de connexion au niveau du dossier, procédez comme suit :
-
Dans la Workflows Console, ouvrez la page Flux.
-
Cliquez sur le dossier dans lequel vous souhaitez travailler.
-
Ouvrez l'onglet Connexions et cliquez sur Nouvelle connexion.
-
Dans la fenêtre contextuelle du sélecteur Nouvelle connexion, cliquez sur l'icône qui correspond à l'application ou au service que vous souhaitez connecter.
Les étapes suivantes dépendent du mode de connexion à l'app ou au service externe.
Connexions OAuth 2.0
Cette procédure traite de la configuration des connexions qui utilisent le protocole d'autorisation OAuth 2.0 :
Dans l'onglet Général, remplissez les champs de la manière suivante :
-
Dans le champ Nom, saisissez un nom unique pour la connexion. Cette opération est utile si vous avez plusieurs comptes connectés à la même application ou au même service.
-
Ajoutez une description utile pour fournir toute autre information pertinente pour cette connexion. Le texte de description apparaît sur la page Connexions de la console Workflows, en regard du Nom de la connexion.
Pour une application ou un service externe qui utilise OAuth 2.0 pour les connexions, vous pouvez cliquer sur l'onglet Autorisations pour vérifier les permissions spécifiques demandées pour cette connexion.
Permissions configurables
Dans certains services ou certaines applications externes plus récents qui utilisent OAuth 2.0, vous pouvez choisir ou modifier les permissions demandées.
Cette opération est utile si vous devez créer plusieurs connexions qui appellent le même service, mais vous devez spécifier des permissions différentes.
Par exemple, une connexion à un service de messagerie électronique peut inclure la permission read-email pour une administration simple. Une connexion plus avancée au même service pourrait également inclure les permissions delete-email et send-email.
Cliquez sur l'onglet Autorisations.
-
Sélectionnez Utiliser les permissions par défaut pour créer la connexion à l'aide des permissions prédéfinies.
-
Sélectionnez Personnaliser les permissions (avancé) pour sélectionner des permissions individuelles. Vous ne pouvez pas effacer les permissions requises.
Remarque :Si vous supprimez une permission qui n'est pas marquée comme requise, mais qui est utilisée par le connecteur, il se peut que vos cartes d'événement et d'action ne fonctionnent pas correctement.
-
Vous pouvez utiliser le champ de recherche pour saisir une partie du nom de la permission et filtrer la liste des permissions individuelles.
-
Si le connecteur le prend en charge, vous pouvez également ajouter manuellement d'autres permissions. Saisissez les noms des permissions, de manière individuelle ou sous forme de liste de valeurs séparées par des espaces ou des virgules, dans le champ Ajouter manuellement des permissions et cliquez sur Ajouter.
-
Si le connecteur ne prend pas en charge l'ajout d'autres permissions, vous pouvez soumettre une demande pour ajouter des permissions au connecteur via le site Okta Ideas.
Cliquez sur Créer pour terminer la configuration. Si nécessaire, Okta vous invite à saisir vos identifiants de connexion pour le site de destination.
Autres protocoles d'authentification
Cette procédure traite de la configuration des connexions qui n'utilisent pas le protocole d'autorisation OAuth 2.0 :
-
Dans le champ Nom, saisissez un nom unique pour la connexion. Cette opération est utile si vous avez plusieurs comptes connectés à la même application ou au même service.
-
Ajoutez une description utile pour fournir toute autre information pertinente pour cette connexion. Le texte de description apparaît sur la page Connexions de la console Workflows, en regard du Nom de la connexion.
-
Si votre connexion nécessite des identifiants, saisissez ces valeurs dans les champs supplémentaires. Il peut s'agir d'un domaine de service spécifique, d'un jeton d'API, ou d'une clé et d'un secret d'accès jumelés. Les exigences de sécurité dépendent de l'application ou du service externe.
-
Cliquez sur Créer pour terminer la configuration. Si nécessaire, Okta vous invite à saisir vos identifiants de connexion pour le site de destination.
Connexions existantes
Vous pouvez modifier les connexions existantes à l'aide de la page Connexions de la console Workflows.
-
Cliquez sur Ouvrir en regard du connecteur que vous souhaitez mettre à jour.
-
Cliquez sur le menu déroulant Actions, puis sur l'action que vous souhaitez effectuer.
- Modifier les détails : modifier le nom ou la description.
- Utilisation : voir quels flux utilisent une connexion particulière.
- Réautoriser : si vous mettez à jour le mot de passe, la clé API ou un autre paramètre d'une application, vous devez réautoriser votre application. Cliquez sur l'icône Réautoriser et suivez les étapes pour mettre à jour votre connexion. Veillez à réautoriser chaque connexion à la même application.
- Supprimer la connexion : supprimer la connexion. Tous les flux qui utilisent cette connexion doivent être mis à jour pour utiliser une connexion différente. Vous pouvez également cliquer sur l'icône de suppression à côté d'une connexion pour la supprimer.
-
Cliquez sur Affecter des dossiers pour ajouter une connexion de niveau de l'org à un dossier existant. Cliquez sur Créer un dossier pour affecter la connexion à un nouveau dossier. Les connexions au niveau de l'org peuvent être ajoutées à plusieurs dossiers.
Pour de plus amples informations sur la gestion des connexions existantes, consultez la page Afficher les connexions.