Skip to main content

Documentation technique Ekinops SSE

Installer l'Agent

Installer l'Agent de synchronisation d'annuaires et mettre en place la synchronisation de votre AD.

Prérequis

Pour mettre en place une synchronisation entre votre annuaire on premises et Ekinops SSE, vous devez au préalable avoir :

  • un compte administrateur Ekinops SSE actif (licence activée) ;

  • un annuaire Active Directory ainsi qu'un compte disposant de droits en lecture sur cet annuaire qui sera utilisé par l'Agent de synchronisation d'annuaires ;

  • un serveur (physique ou virtuel), distinct de votre AD, et qui respecte la configuration minimale requise pour installer et exécuter l'Agent de synchronisation d'annuaires.

La mise en place d'une synchronisation entre votre annuaire Active DIrectory et Ekinops SSE se fait en deux grandes étapes présentées ci-dessous :

Si vous ne l'avez pas déjà fait, commencez par créer un nouvel annuaire dans Ekinops SSE, en suivant les étapes ci-dessous :

  1. Rendez-vous sur Configuration > Annuaires.

    chemin_annuaire.png
  2. Cliquez sur le bouton + Créer un annuaire en haut à droite de votre écran.

  3. Saisissez le nom que vous souhaitez donner à votre annuaire.

  4. Sélectionnez le fournisseur : Via agent de synchronisation Ekinops SSE.

    Annuaire_AD__choix_fournisseur.png
  5. Cliquez sur Créer.

    L'annuaire a été créé.

  6. Ajoutez une description (optionnel) et cliquez sur Mettre à jour sinon cliquez sur l'onglet Synchronisation pour télécharger l'Agent de synchronisation d'annuaires et commencer à mettre en place la synchronisation entre votre annuaire et Ekinops SSE.

    dl_agent_synchro.png

Suivez les instructions ci-dessous pour installer et lancer la configuration initiale de l'Agent de synchronisation d'annuaires.

  1. Installez l'Agent de synchronisation en suivant les instructions de l'assistant d'installation.

  2. Avant de quitter l'assistant d'installation, cochez la case Démarrer la configuration :

    ADS_5.png

    L'Agent de synchronisation d'annuaires se lance sur l'assistant de configuration.

Suivez les étapes ci-dessous pour configurer l'Agent de synchronisation d'annuaires :

  1. À l'étape de Connexion à l'Active Directory, remplissez les champs suivants pour vous connecter à votre Active Directory :

    • URL du serveur de votre Active Directory

    • Choix de l'option LDAP sécurisé

    • Port de l'Active Directory si le LDAPS est activé (par défaut : LDAP 389; LDAPS 636)

    • Login du compte dédié à l'Agent de synchronisation pour la lecture sur votre AD

    • Mot de passe de connexion à l'AD

    ConfigAssistant2-AD.png

    Cliquez sur Vérifier et observez si le test est réussi et si les nombres d'utilisateurs/groupes trouvés sont cohérents avec votre requête LDAP.

    La vérification est réussie et votre Agent peut bien communiquer avec votre AD.

  2. Définissez les attributs des utilisateurs et groupes à synchroniser. Définissez également l'association avec les propriétés de l'annuaire Ekinops SSE.

    ConfigAssistant3-Users.png

    Choix de la propriété identifiante qui sera utilisée pour l'authentification

    Choisissez prudemment : la propriété identifiante (SamAccountName ou UserPrincipalName) que vous allez associer à userName sera utilisée par l'authentification sur Ekinops SSE. Pour prévenir les erreurs, cette propriété n'est plus modifiable une fois définie sur un annuaire donné.

    Nous recommandons l'usage du UserPrincipalName comme propriété identifiante parce que cela correspond aux préconisations récentes de Microsoft sur ce point mais l'usage de l'un comme de l'autre pour l'authentification est possible et dépendent surtout de votre contexte d'usage (veuillez noter cependant que l'usage de SamAccountName comme propriété identifiante pour Ekinops SSE peut nécessiter des ajustements complémentaires à votre configuration ADFS).

    Choix de la propriété identifiante qui sera utilisée comme nom des groupes

    Choisissez prudemment la propriété identifiante (SamAccountName, cn …) que vous allez associer à l’attribut de groupe DISPLAYNAME. C'est cette propriété qui sera affichée dans les sélecteurs de population sur Ekinops SSE. Pour prévenir les erreurs, cette propriété n'est plus modifiable une fois définie sur un annuaire donné.

  3. À l'étape Connexion à l'annuaire Ekinops SSE, complétez les champs Tenant URL et Jeton Secret.

    Au clic sur Suivant, l'Agent de synchronisation d'annuaires vérifie l'existence de l'annuaire indiqué sur la plateforme et la validité du jeton d'accès.

  4. Définissez ensuite l'Intervalle de synchronisation, pour la synchronisation incrémentale puis cliquez sur Suivant pour terminer la configuration initiale de l'Agent de synchronisation d'annuaires.

  5. La configuration est terminée, l'application s'ouvre automatiquement et lance une synchronisation complète.

  6. Lorsque la date s'affiche dans un badge vert, la synchronisation complète est terminée entre votre Active Directory et Ekinops SSE. Pour plus d'informations sur la synchronisation, consultez le rapport de synchronisation Interpréter un rapport de synchronisation.

    App1-HomeSyncInfo.png