JDBC

Le connecteur JDBC permet la synchronisation des données entre RAC/M Identity et les bases de données relationnelles utilisant le pilote JDBC.

Le connecteur a été testé avec SQL Server, Azure SQL, Oracle, MySQL.

Note

Pour Azure SQL, le seul driver disponible est com.microsoft.sqlserver.jdbc.SQLServerDriver.

Ce connecteur convient-il à votre implémentation ? Car ici, il s'agit d'une simple connexion à une table sans jointures internes.
Si ce n'est pas le cas, consultez le connecteur Scripted JDBC.

Jar

Cette configuration est basée sur le connecteur ICF Database Table Connector - 1.4.2.1.jar.

Configuration

Les paramètres suivants sont requis :

Configuration	Description	Exemple
Hôte	Adresse ou nom de domaine du serveur de base de données.	localhost
Port	Numéro du port pour accéder au serveur de base de données.	1433
Utilisateur	Nom d'utilisateur pour la connexion au serveur.	sa
Mot de passe de l'utilisateur	Mot de passe pour la connexion au serveur.	Password123
Base de données	Nom de la base de données à laquelle se connecter.	racm_demo_config
Table	Nom de la table à laquelle se connecter.	LOGIN
Colonne clé	Nom de la colonne qui représente la clé primaire.	LOGIN_ID
Colonne de mot de passe	Nom de la colonne contenant les mots de passe des utilisateurs.	password
Pilote JDBC	Nom de l'implémentation de la classe Java du pilote JDBC.	com.microsoft.sqlserver.jdbc.SQLServerDriver
URL de connexion JDBC	L'URL pour la connexion.	jdbc:sqlserver://127.0.0.1:1433;databaseName=racm_demo_config;encrypt=false
Where clause	Clause WHERE personnalisée pour filtrer les résultats des requêtes.	WHERE is_active = 1

Configuration avancée

Configuration	Description	Exemple
Guillemets de noms	Définition des guillemets utilisés pour les noms d'entités.	", `
Activer l’écriture de chaînes vides	Option pour autoriser ou non l'écriture de chaînes vides dans la base de données.	true ou false
Jeter de nouveau toutes les exceptions SQL	Option pour relancer toutes les exceptions SQL capturées.	true ou false
Horodatages natifs	Utilisation des types natifs pour les horodatages dans la base de données.	true ou false
Tous natifs	Option pour utiliser uniquement des types natifs pour tous les champs pris en charge.	true ou false
Valider la requête de connexion	Requête SQL utilisée pour valider une connexion au serveur.	SELECT 1
Colonne du journal des modifications (synchr.)	Colonne utilisée pour suivre les modifications dans un processus de synchronisation.
Chemin d’accès à la source de données	Chemin JNDI ou autre identifiant pour accéder à la source de données.
Propriétés JNDI initiales	Propriétés spécifiques pour initialiser le contexte JNDI.
Suppress Password	Option pour masquer ou non les mots de passe dans les journaux ou les traces.	true ou false
Page Size	Taille des pages de résultats lors de la récupération des données.	1000

Note

Pour Azure SQL : Le seul driver disponible est com.microsoft.sqlserver.jdbc.SQLServerDriver.

Certificat

Un certificat pourrait être nécessaire en mode SSL.

Note

Au niveau de l'URL JDBC pour Microsoft Azure, le paramètre encrypt doit être présent afin de gérer le chiffrement des connexions SQL :

• encrypt=false : Désactive le chiffrement, ce qui exclut l'utilisation d'un certificat. Cette configuration n'est pas recommandée pour des environnements de production.
• encrypt=true : Active le chiffrement, ce qui inclut l'utilisation d'un certificat. Dans ce cas, le certificat SQL correspondant doit être présent dans le truststore de l'ICF (Identity Connector Framework).

Ajout

Ajoutez le certificat au truststore de l'ICF.

Redémarrage

Attention

Lorsque vous effectuez un changement dans le truststore par défaut de l'ICF, un redémarrage du service RAC/M est obligatoire.

Test

Vous pouvez tester le connecteur Database Table Connector en appuyant sur le bouton TEST.

Importation

Mappage de comptes

• ICF Connecteur -> Table source _ACCOUNT_ -> table cible APPLICATION_ACCOUNT_IMPORT.
• Table LOGIN

Colonne de la table cible	Colonne de la table source	Formatage (Constante)
ACCOUNT_NAME	_NAME_
EIN	GIA_ID
EMAIL	EMAIL
EXT_APPLICATION_ID		RACM
EXTRA1	LANGUAGE
FULL_NAME	FULL_NAME
GUID	LOGIN_ID
STATUS		Actif

Mappage de groupes

Les groupes n'ont pas de descriptions, alors nous ne les chargerons pas pour notre exemple.
Si nous souhaitons le faire, il faut configurer un autre connecteur ICF sur la table ROLE_LOGIN pour créer les profils RACM.

Mappage de membres

• ICF Connecteur -> Table source _ROLE_MEMBERS_ -> table cible _ACCOUNT_.
• Table LOGIN

Colonne RACM	Attribut du système cible	Formatage (Constante)
ACCOUNT_NAME	_NAME_
EXT_PROFILE_ID	LOGIN_ROLE_ID
GUID	LOGIN_ROLE_ID
EXT_APPLICATION_ID		RACM