Connecteur sur site pour les bases de données génériques

Version en accès anticipé

L'On-prem Connector for Generic Databases offre une solution prête à l'emploi permettant de connecter des bases de données locales à la plateforme Okta Identity Governance. Ce connecteur utilise l'agent SCIM local Okta pour gérer les utilisateurs et les droits dans divers systèmes de bases de données. Cela renforce la sécurité et simplifie la gouvernance en éliminant le besoin d'intégrations personnalisées.

L'intégration avec Okta permet d'activer les capacités essentielles d'Identity Governance. Cela inclut les requêtes d'accès, les certifications d'accès, l'approvisionnement et l'annulation de l'approvisionnement des utilisateurs, ainsi que la séparation des tâches (SoD) pour vos environnements de bases de données sur site.

Ce connecteur prend en charge l'approvisionnement et la gestion des droits pour les systèmes de gestion de bases de données relationnelles Oracle, MySQL, PostgreSQL, IBM Db2 LUW et Microsoft SQL Server.

Exigences du système

Pour installer l'On-prem Connector for Generic Databases, assurez-vous que votre système répond aux exigences matérielles et logicielles. Voir Exigences du système pour On-prem Connector - Generic Databases.

Fonctionnalités relatives à l'approvisionnement et aux droits

Ce connecteur prend en charge les capacités suivantes :

  • Créer des utilisateurs – Crée automatiquement un utilisateur dans la base de données locale lorsque l'utilisateur est affecté à l'application dans Okta.
  • Mettre à jour les utilisateurs – Synchronise les modifications apportées au profil d'un utilisateur dans Okta avec la base de données.
  • Approvisionner/annuler l'approvisionnement des utilisateurs –Gère l'état actif ou inactif des comptes utilisateur dans la base de données.
  • Gérer les droits – Affecte ou supprime les droits des utilisateurs de la base de données via Okta.
  • Importer les utilisateurs et les droits – Effectue des importations manuelles et planifiées des données sur les utilisateurs et les droits depuis la base de données vers Okta.

Avant de commencer

  • Collectez les informations suivantes pour utiliser un compte de base de données avec On-prem Connector :
    • Nom d'utilisateur pour le compte de base de données
    • Mot de passe du compte de la base de données
    • Type de base de données
    • IP/Nom de domaine
    • Numéro de port
    • Nom de la base de données

Télécharger les packages JDK et JDBC

  • Téléchargez la version 21 du JDK depuis une source approuvée et chargez-la sur votre serveur Linux.
  • Téléchargez le pilote JDBC requis (par exemple, Oracle OJDBC) et chargez-le sur votre serveur Linux.

Activer les fonctionnalités du connecteur pour bases de données

  1. Dans Console des administrateurs , accédez à Paramètres > Fonctionnalités.
  2. Dans la section Accès anticipé, activez les options suivantes :
    1. Connecteur sur site pour les bases de données génériques
    2. Agent OPP avec prise en charge SCIM 2.0
    3. Activer l'agent SCIM local Okta

Configurer l'On-prem Connector for Generic Databases

Après avoir installé et configuré les composants nécessaires, vous pouvez configurer l'application dans votre Console des administrateurs.

  1. Dans la Console des administrateurs, accédez à Applications and Resources > Applications.

  2. Cliquez sur Parcourir le catalogue d'applications.
  3. Cherchez et sélectionnez On-prem Connector for Generic Databases, puis cliquez sur Ajouter une intégration.
  4. Configurez vos paramètres généraux, puis cliquez sur Suivant.
  5. Configurez vos options d'authentification, puis cliquez sur Terminé.
  6. Accédez à l'onglet Général et cliquez sur Modifier dans la section Gestion des droits.
  7. Dans la liste déroulante Gestion des droits, sélectionnez Activé.
  8. Cliquez sur Enregistrer. L'activation de la fonctionnalité peut prendre quelques instants, après quoi vous pourrez actualiser la page pour afficher l'onglet Governance.
  9. Accédez à l'onglet Approvisionnement. Cliquez sur Activer l'approvisionnement.
  10. Sélectionnez l'agent SCIM local Okta que vous avez installé, puis cliquez sur Suivant.
  11. Cliquez sur Suivant.
  12. Saisissez vos détails de connexion à la base de données, tels que le nom d'utilisateur, le mot de passe et le type.
  13. Cliquez sur Agents de connexion.
  14. Définissez les paramètres de schéma et d'importation.
  15. Définissez des actions d'approvisionnement.
  16. Mappez les attributs de l'application sur la page d'approvisionnement.

Définir les paramètres de schéma et d'importation

  1. Accédez à l'onglet Approvisionnement.
  2. Sous Intégration, sélectionnez la section Okta. Cliquez sur Modifier en regard de Reconnaissance de schéma et import.
  3. Pour Obtenir des utilisateurs, sélectionnez Activé.
  4. Sélectionnez Instruction SQL ou Procédure stockée.
  5. Saisissez la requête ou la procédure et l'ID utilisateur.
  6. Pour Obtenir tous les droits, sélectionnez Activé.
  7. Sous Informations de base, configurez les éléments suivants :
    • Type de ressource: le nom utilisé par Okta pour identifier ce type de droit, par exemple Roles ou Groups.
    • Description(facultatif) : une étiquette pour distinguer ce type de droit.
  8. Sous Configuration des requêtes, sélectionnez Instruction SQL ou Procédure stockée, puis saisissez l'instruction SQL ou la procédure stockée qui récupère l'ensemble des valeurs pour ce type de droit dans votre base de données.
  9. Sous Mappage des champs, saisissez les éléments suivants :
    • ID du droit : la colonne de la base de données utilisée comme identifiant unique pour le droit.
    • Affichage des droits : la colonne de la base de données utilisée en tant qu'étiquette pour le droit.
  10. Sous Valeurs des droits par utilisateur, sélectionnez l'une des options suivantes :
    • Valeurs multiples par utilisateur : les utilisateurs peuvent détenir simultanément plusieurs valeurs de ce type de droit.
    • Valeur unique par utilisateur : chaque utilisateur détient exactement une valeur de ce type de droit.
  11. Pour définir un type de droit supplémentaire, sélectionnez Ajouter un autre et répétez les quatre étapes précédentes.
  12. Cliquez sur Enregistrer.
  13. Dans la boîte de dialogue Confirmer les paramètres des droits, vérifiez la configuration, puis sélectionnez Confirmer et enregistrer.
  14. Une fois la reconnaissance de schéma réussie, sélectionnez Modifier à côté de Reconnaissance du schéma et importer pour configurer des requêtes spécifiques à l'utilisateur.
  15. Dans la section Importation spécifique à l'utilisateur, activez l'option Obtenir le droit. Pour chaque type de droit, sélectionnez Instruction SQL ou Procédure stockée, puis saisissez l'instruction SQL ou la procédure stockée qui permet de récupérer les droits d'un utilisateur spécifique.
  16. Sélectionnez Enregistrer.

Définir les paramètres d'importation incrémentielle

  1. Accédez à l'onglet Approvisionnement.
  2. Sous Intégration, sélectionnez la section Opérations de base de données, puis cliquez sur Modifier en regard de Reconnaissance de schéma et import.
  3. Activez Obtenir des utilisateurs.
  4. Sélectionnez Instruction SQL ou Procédure stockée.
  5. Saisissez la requête et indiquez le nom de la colonne d'ID utilisateur.
  6. Facultatif. Dans la zone Attribut de statut du compte, saisissez le nom de la colonne de statut pour l'utilisateur dans votre base de données. Saisissez ensuite la valeur qui correspond à un statut actif. Si vous ignorez cette étape, Okta traitera tous les utilisateurs que vous importez par le biais d'importations incrémentielles comme des utilisateurs actifs.
  7. Activez Importation incrémentielle.
  8. Sélectionnez Instruction SQL ou Procédure stockée.
  9. Pour filtrer les utilisateurs qui ont été modifiés après la précédente importation réussie, saisissez la requête et utilisez un point d'interrogation (?) comme espace réservé pour la dernière heure d'importation.
  10. Dans la zone Champ de base de données pour l'espace réservé, saisissez le nom de la colonne d'horodatage de votre base de données.
  11. Dans la zone Colonne d'horodatage, saisissez le même nom de colonne d'horodatage.
  12. Cliquez sur Enregistrer.

Exigences relatives à la base de données

  • Vos tableaux de base de données doivent prendre en charge la suppression réversible. L'importation incrémentielle s'appuie sur cet historique pour détecter les enregistrements qui ont été modifiés. La suppression définitive des lignes, plutôt que leur marquage comme supprimées, empêche l'importation incrémentielle de suivre cet historique.
  • Chaque tableau doit inclure une colonne d'horodatage qui se met automatiquement à jour à chaque fois qu'une ligne est écrite ou modifiée. L'importation incrémentielle utilise cet horodatage pour identifier les enregistrements qui ont été modifiés depuis la dernière importation.
  • Vos données relatives aux utilisateurs et aux droits peuvent être stockées dans des tableaux distincts. Si tel est le cas, votre base de données doit mettre à jour explicitement l'horodatage du tableau des utilisateurs chaque fois qu'une configuration de droits est modifiée. L'importation incrémentielle ne peut pas détecter les modifications liées aux droits uniquement si l'horodatage du tableau des utilisateurs ne les reflète pas.
  • La colonne récupérée par votre requête getUser doit correspondre à la colonne après la configuration de l'importation incrémentielle. Ne modifiez pas la colonne extraite après avoir configuré l'importation incrémentielle, car cela pourrait entraîner une perte de données.
  • En l'absence de l'attribut Statut actif et de sa valeur, Okta ne désactive pas les utilisateurs, même lorsque le statut d'un utilisateur est inactif dans votre base de données.

Définir les actions d'approvisionnement

  1. Accédez à la section Dans l'application et cliquez sur Modifier.
  2. Activez les options d'approvisionnement de votre choix. Par exemple : Créer un utilisateur, Mettre à jour un utilisateur, Désactiver un utilisateur.
  3. Fournissez les instructions SQL ou procédures stockées nécessaires pour chaque opération (par exemple : INSERT, UPDATE, DELETE).
  4. Faites correspondre les paramètres de vos instructions SQL ou procédures stockées aux attributs utilisateur appropriés provenant d'Okta.
  5. Cliquez sur Enregistrer.