Administration

Sources externes : LDAP et bases de données

Connexions à des annuaires LDAP et à des bases de données SQL dans lesquels EasyUC lit des contacts et des données d’utilisateurs.

EasyUC · Version 4.8.7

Dans EasyUC : EasyUC Cisco → Administration → Integrations & Communication → External Sources → Create

À quoi cela sert

Une source externe est une connexion en lecture, enregistrée, vers un annuaire ou une base de données extérieurs à EasyUC. Vous créez la connexion une seule fois et l’utilisez à plusieurs endroits : comme fournisseur de données pour les annuaires téléphoniques, pour la recherche de contacts d’une connexion CUCM, pour le lien entre le plan de numérotation et LDAP, et pour la correspondance d’attributs dans le provisioning automatique.

EasyUC lit la source et n’y écrit pas. Les champs de la source qui servent de prénom, de numéro de téléphone ou de clé unique ne sont pas définis ici, mais à l’endroit où la source est utilisée.

Prérequis

Rôle ROLE_APP_ADMIN. L’interface n’affiche le menu Administration qu’avec ce rôle.
Le module cucm est activé. Sans ce module, l’interface verrouille la page.
Le serveur est joignable depuis le système EasyUC : LDAP en général sur le port 389, avec TLS sur 636, les bases de données sur leur port respectif.
Un compte disposant du droit de lecture. Pour LDAP, le distinguished name du compte, la base de recherche et un filtre. Pour SQL, le nom de la base de données, la table ou la vue, et les identifiants.

Procédure pas à pas : créer une source LDAP

Sélectionnez l’espace de travail EasyUC Cisco dans l’en-tête.
Ouvrez Administration → Integrations & Communication → External Sources.
Cliquez sur Create.
Sous Type, sélectionnez l’entrée pour LDAP.
Saisissez un Name.
Dans la section LDAP Connection, saisissez Host or Ip et Port.
Cochez Use TLS? si l’accès à l’annuaire est chiffré, et adaptez le port.
Saisissez Search Base et LDAP Filter.
Sous Manager, saisissez le distinguished name du compte de lecture et, sous Password, son mot de passe.
Cliquez sur Create.

Procédure pas à pas : créer une source SQL

Cliquez sur Create et sélectionnez MySQL, PostgreSQL ou MS SQL sous Type.
Saisissez un Name.
Saisissez Host or Ip et Port.
Saisissez Database name, Database table, Database user et Database password.
Cliquez sur Create.

Procédure pas à pas : modifier ou supprimer une source

Dans la ligne, cliquez sur Actions → Update.
Modifiez les valeurs. Laissez le champ du mot de passe vide si le mot de passe enregistré doit rester valable.
Cliquez sur Update.
Avec Actions → Delete, vous supprimez la source après la demande This external source will be deleted.

Champs et options

Champs et options
Champ / action	Signification et utilisation
Type	LDAP, MySQL, PostgreSQL ou MS SQL. La liste affiche aussi le type CUCM pour les sources générées en interne. Le type ne peut plus être modifié après la création.
Name	Nom de la source dans les listes de sélection.
Host or Ip / Port	Adresse du serveur. Pour LDAP, le port est prérempli avec 389.
Use TLS?	Connexion LDAP chiffrée. Par défaut : désactivé. EasyUC mémorise le certificat du serveur lors du premier contact et refuse la connexion si une chaîne de certificats différente apparaît ensuite.
Search Base	Point de départ de la recherche LDAP, par exemple `OU=Benutzer,DC=firma,DC=intern`.
LDAP Filter	Restreint les résultats, par exemple `(objectClass=person)`.
Manager / Password	Distinguished name et mot de passe du compte de lecture.
Database name / Database table	Base de données et table ou vue qui est lue.
Database user / Database password	Identifiants du compte de lecture.
Mot de passe enregistré	Lors de la modification : laisser le champ vide conserve le mot de passe, mais seulement avec les mêmes hôte, port et réglage TLS (LDAP) ou les mêmes hôte, port et nom de base de données (SQL). Si vous modifiez l’un de ces éléments, vous devez saisir de nouveau le mot de passe.
Used By	Colonne de la liste. Affiche contact search, numberplan link ou phonebook si la source y est intégrée.

Vérifier le résultat et circonscrire les erreurs

La source est listée avec son Source Type. La colonne Used By se remplit dès que vous intégrez la source.
Test de fonctionnement : créez un lien sous Phonebooks → Phonebook Sources. Si la liste des champs de la source se charge, la connexion et l’authentification fonctionnent.
La liste des champs reste vide : la base de recherche ou le filtre ne renvoient aucune entrée, ou le compte n’a pas le droit de lecture.
Après un changement de certificat sur le serveur LDAP, la connexion avec TLS échoue. La remarque dans le journal indique la chaîne de certificats mémorisée lors du premier contact. Clarifiez la modification avec l’exploitant de l’annuaire.
Avant de supprimer ou de modifier : vérifiez Used By. La synchronisation des annuaires téléphoniques, la recherche de contacts et le lien avec le plan de numérotation dépendent de la source.