Configurer l'automatisation Okta | Electric Knowledge Base

Introduction

Electric a lancé une automatisation avec Okta.

En tant que client d'Okta et d'Electric, vous pouvez désormais intégrer les deux applications afin d'accélérer la création et la désactivation des comptes employés.

Avantages

L'automatisation de la création et de la désactivation des employés améliore l'efficacité et la sécurité. Elle élimine les processus manuels, réduit les erreurs humaines et garantit que les employés disposent d'un accès en temps voulu.

L'automatisation permet de révoquer rapidement l'accès d'un employé qui quitte l'entreprise, ce qui atténue les risques de sécurité.

Elle simplifie l'intégration et le départ des employés, permettant à ces derniers de consacrer leur temps à des tâches plus stratégiques au lieu de gérer manuellement les accès aux applications pour leurs collègues.

Portée de l'automatisation Okta actuelle

Création de nouveaux comptes
Ajout des nouveaux comptes dans des groupes définis dans Okta
Suspension des comptes existants

Comment configurer l'automatisation Okta

Assurez-vous d'être un utilisateur administrateur dans Electric et dans Okta pour votre entreprise afin de compléter ce processus en quelques minutes. Si vous n'êtes pas administrateur, vous devrez collaborer avec la personne responsable dans votre entreprise pour effectuer cette configuration.

Prérequis : Ajoutez Okta à vos applications Electric via http://my.electric.ai/applications

Étapes dans Okta

Pour intégrer Electric à votre instance Okta, vous devrez configurer Okta afin de permettre à Electric de gérer les utilisateurs et les groupes. Les étapes suivantes vous guideront dans la configuration d'Okta.

Étape 1 : Créer un ensemble de ressources (Resource Set)

Connectez-vous à votre Okta Admin Console.
Dans le menu de navigation de gauche, sélectionnez Security → Administrators.
Sélectionnez l'onglet Resources.
Cliquez sur Create new resource set.
Donnez un nom à l'ensemble de ressources (par exemple, Electric Managed).
Cliquez sur Add resource.
Dans le menu déroulant, sélectionnez Users, puis All users, et cliquez sur Save selection.
Cliquez sur Add another resource type.
Dans le menu déroulant, sélectionnez Groups, puis All groups, et cliquez sur Save selection.
Cliquez sur Create.

Étape 2 : Créer une application Okta API Services

Dans la barre latérale gauche, accédez à Applications → Applications.
Cliquez sur Create App Integration.
Sélectionnez API Services comme méthode de connexion, puis cliquez sur Next.
Donnez un nom à votre application (par exemple, Electric) et cliquez sur Save.
Dans l'onglet General de l'application, repérez votre Client ID — vous devrez le fournir à Electric.

Étape 3 : Configurer les identifiants (Credentials)

L'intégration Okta d'Electric nécessite la génération et l'enregistrement d'une paire de clés RSA. Ce guide suppose que vous utilisez le générateur de clés intégré d'Okta, mais vous pouvez générer vos propres clés et les fournir.

Accédez à l'onglet General et faites défiler jusqu'à la section Public keys.
Cliquez sur Edit.
Cliquez sur Add Key, puis sélectionnez Generate new key.
Sous Private key - Copy this!, cliquez sur JSON, puis sur Copy to clipboard — vous devrez fournir cette clé à Electric.
Assurez-vous de copier la clé JWK privée avant de fermer la boîte de dialogue. Vous devrez la fournir à Electric.
Cliquez sur Done pour fermer la boîte de dialogue.
Cliquez sur Save pour enregistrer la nouvelle clé dans votre application.
Faites défiler vers le haut jusqu'à la section Client Credentials et cliquez sur Edit.
Définissez Client authentication sur Public key / Private key, puis cliquez sur Save.
Cliquez à nouveau sur Save si un message vous indique que Existing client secrets will no longer be used.
Faites défiler vers le bas jusqu'à la section General Settings et cliquez sur Edit.
Assurez-vous que Proof of possession (DPoP) est Disabled / Unchecked.
Cliquez sur Set Client authentication to Public key / Private key.
Cliquez sur Save.

Étape 4 : Accorder les portées API (API Scopes)

Sélectionnez l'onglet Okta API Scopes pour votre application.
Accordez les portées suivantes pour permettre à Electric de gérer vos utilisateurs et groupes :
- okta.users.read
- okta.users.manage
- okta.groups.read
- okta.groups.manage

Étape 5 : Attribuer un rôle à l'application

Sélectionnez l'onglet Admin roles pour votre application.
Cliquez sur Edit assignments.
Dans le menu déroulant Role, sélectionnez Create a role.
Donnez un nom au rôle (par exemple, Electric Automation).
Accordez au moins les permissions suivantes au rôle :
- User
  - Create users
  - Edit users' profile attributes
  - Suspend users
  - Unsuspend users
  - Edit users' group membership
- Group
  - View groups and their details
  - Manage group membership
Cliquez sur Save role.
Dans le menu déroulant Role, trouvez le rôle que vous avez créé et sélectionnez-le.
Dans le menu déroulant Resource set, trouvez l'ensemble de ressources créé à l'étape 1 et sélectionnez-le.
Cliquez sur Save Changes.

Étape 6 : Trouver votre domaine Okta

Dans l'Admin Console, la barre d'adresse de votre navigateur affiche une URL du type https://dev-12345678-admin.okta.com.
Votre domaine Okta correspond à la partie avant .okta.com, sans le -admin (par exemple, dev-12345678).
Vous pouvez aussi accéder à Settings > Account dans l'Admin Console pour trouver votre domaine Okta.

Étape 7 : Rassembler les paramètres de configuration

Assurez-vous d'avoir les informations suivantes en main avant de continuer :

Okta Domain
Client ID
Private Key

Étapes dans Electric

Accédez à Applications depuis la navigation de gauche.
Cliquez sur l'application Okta dans la liste des applications.
Dans la zone des paramètres d'automatisation, cliquez sur le bouton "Connect application".
Entrez le Client ID, la Private Key et le Okta Domain obtenus lors des étapes de configuration Okta dans le formulaire.
Pour Scopes, entrez ce qui suit : okta.users.read okta.users.manage okta.groups.read okta.groups.manage