Ressources · Intégration n8n

Intégration LDAP n8nAutomatiser LDAP avec n8n.

L'annuaire, c'est souvent là que l'automatisation s'arrête. L'intégration LDAP n8n pose 6 opérations sur un seul nœud : chercher, comparer, créer, mettre à jour, renommer et supprimer des entrées. Aucun nœud trigger n'est fourni : c'est un Schedule Trigger ou un Webhook qui lance le workflow. Pour les équipes IT.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert vraiment l'intégration LDAP n8n ?

Un credential (regroupant les identifiants de connexion enregistrés dans n8n) et un nœud unique suffisent pour parler à un serveur d'annuaire via LDAP : adresse du serveur et compte de connexion d'un côté, lecture et écriture des entrées de l'autre. Le catalogue tient en 6 opérations sur une seule ressource, sans trigger dédié. Ce que l'annuaire imposait de faire à la main entre deux outils devient une étape de workflow comme une autre.

Premier scénario : des arrivées qui finissent dans l'annuaire toutes seules. Un Schedule Trigger relit les nouvelles lignes d'un onglet Google Sheets, Create a new entry écrit chaque personne au distinguished name que le workflow assemble, et Update attributes complète le reste depuis la même ligne. Plus personne ne ressaisit quoi que ce soit.

Deuxième scénario : un départ traité le jour même, pas trois semaines plus tard. Rename the DN of an existing entry donne au compte le distinguished name prévu par ta procédure de sortie, ou Delete an entry le retire pour de bon, et un message part dans Gmail pour que la trace existe ailleurs que dans la tête de quelqu'un.

Troisième scénario : un export d'annuaire qui alimente un reporting. Search LDAP parcourt le sous-arbre sous un Base DN, Return All évite qu'il s'arrête en route, et les entrées atterrissent dans MySQL, où les équipes les interrogent sans jamais toucher à l'annuaire.

Voilà le point à retenir. Sur une intégration classique, quand une opération manque, on passe par le nœud HTTP Request qui appelle l'API REST de l'outil avec le même credential. Ici, non. Le credential LDAP ouvre une connexion vers un serveur d'annuaire, pas vers un endpoint HTTP : HTTP Request n'a rien à appeler. Le recours se trouve dans le nœud lui-même, avec Custom Filter sur Search LDAP, un filtre LDAP que tu écris à la main et dans lequel les caractères *, (, ) et \ s'échappent avec un antislash.

Deux limites à anticiper. Il n'existe pas de nœud trigger LDAP, donc le workflow démarre ailleurs : un Schedule Trigger à intervalle fixe, un Webhook n8n (une URL qu'un autre service appelle) ou le trigger d'un autre outil. Et une recherche large réclame Return All, sinon Limit plafonne le nombre d'entrées renvoyées, tandis que Page Size fixe combien en arrivent d'un coup. La page de doc du nœud existe, celle des problèmes fréquents renvoie une 404 : prévois un test sur un Base DN étroit avant de viser tout l'arbre. Pour le reste, l'Avis n8n parle de la plateforme et la Formation n8n de la construction de ce genre de workflow.

Connexion

Comment connecter n8n à un serveur LDAP ?

  1. 01

    Indiquer l'adresse du serveur

    Avant tout, il faut un serveur d'annuaire joignable en LDAP : Jumpcloud, Azure ADDS ou Okta en proposent tous un. Direction ensuite le menu Credentials de n8n, pour créer un credential LDAP. Deux champs à remplir en premier : LDAP Server Address, l'adresse IP ou le domaine du serveur, et LDAP Server Port, le numéro du port de connexion. Ces deux valeurs se trouvent dans la documentation du fournisseur d'annuaire utilisé.

  2. 02

    Renseigner le compte de connexion

    Deux champs suivent, Binding DN et Binding Password : le compte de connexion du credential, en chemin complet dans l'annuaire (cn=administrator, cn=Users, dc=n8n, dc=io sous Active Directory), et son mot de passe. La documentation du fournisseur LDAP indique comment repérer les deux.

  3. 03

    Choisir la sécurité de connexion

    Reste le réglage Connection Security, à choisir parmi None, TLS et STARTTLS selon la configuration du serveur. Connection Timeout, facultatif, prend une valeur numérique en secondes. Une fois enregistré, ce credential unique alimente n'importe quel nœud LDAP de l'instance : il apparaît dans la liste déroulante, mot de passe déjà mémorisé.

Actions

Ce que le nœud LDAP sait faire

Le nœud Ldap expose 6 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Compare an attribute

compare

Ce que tu vois dans n8n

Notes & cas d'usage

Compare confronte un attribut d'une entrée à une valeur et renvoie le résultat de ce contrôle. De quoi orienter un workflow dans une branche ou une autre sans relire l'entrée entière.

Paramètres clés

  • DN : le distinguished name de l'entrée à comparer, son adresse complète dans l'arbre, sur le modèle affiché par n8n, ou=users,dc=n8n,dc=io, souvent {{ $json.field }} repris du nœud précédent.
  • Attribute ID : l'identifiant de l'attribut à comparer, choisi dans la liste que n8n affiche.
  • Value : la valeur à comparer.
Cas d'usage
avant qu'un workflow ouvre l'accès à un outil interne, compare l'attribut qui porte l'équipe sur l'entrée de la personne, et coupe l'exécution si la valeur ne correspond pas.
02

Create a new entry

create

Ce que tu vois dans n8n

Notes & cas d'usage

Cette opération inscrit un nouvel objet dans l'annuaire au distinguished name que tu lui donnes. Le compte existe sans que personne n'ait ouvert la console d'administration.

Paramètres clés

  • DN : le distinguished name de l'entrée à créer. Il fixe d'un coup l'emplacement et le nom de l'objet, d'où l'habitude de le composer à partir de l'item entrant.
  • Attributes : les attributs à ajouter à l'entrée, empilés un par un derrière le bouton Add Attributes.
Cas d'usage
un contrat signé arrive dans l'outil RH, le workflow construit le DN à partir des informations de la personne et crée l'entrée dans l'heure, plutôt que le lundi où quelqu'un y repense.
03

Delete an entry

delete

Ce que tu vois dans n8n

Notes & cas d'usage

Delete retire l'objet situé au distinguished name transmis, puis le workflow enchaîne. Un seul champ à remplir, ce qui en fait l'opération la plus facile à rater du nœud : le DN qui arrive est celui qui disparaît.

Paramètres clés

  • DN : le distinguished name de l'entrée à supprimer, en général {{ $json.field }} récupéré d'une étape Search LDAP plutôt que saisi à la main.
Cas d'usage
un ménage trimestriel liste les comptes de service que plus personne ne revendique, un humain valide la liste dans un message, et la branche qui suit supprime les entrées approuvées une à une.
04

Rename the DN of an existing entry

rename

Ce que tu vois dans n8n

Notes & cas d'usage

Rename remplace le distinguished name d'une entrée existante par celui que tu fournis, et l'entrée continue d'exister sous ce nouveau nom.

Paramètres clés

  • DN : le distinguished name actuel de l'entrée à renommer (cn=john,ou=users,dc=n8n,dc=io dans l'exemple proposé par n8n).
  • New DN : le nouveau distinguished name de cette entrée (cn=nathan,ou=users,dc=n8n,dc=io).
Cas d'usage
une personne change de nom d'usage. Le workflow renomme l'entrée au lieu de la supprimer puis d'en recréer une, donc rien de ce qui pointe vers ce compte n'est à refaire.
06

Update attributes

update

Ce que tu vois dans n8n

Notes & cas d'usage

Update travaille sur une entrée déjà présente et ne modifie que les attributs listés, le reste de l'entrée n'est pas touché.

Paramètres clés

  • DN : le distinguished name de l'entrée à mettre à jour, le plus souvent {{ $json.field }} issu de l'étape Search LDAP qui l'a trouvée.
  • Update Attributes : les attributs de l'entrée à mettre à jour, listés derrière le bouton Update Attributes.
Cas d'usage
quelqu'un change d'équipe. Un workflow cherche son entrée, met à jour les attributs qui décrivent la nouvelle équipe, et publie le changement pour que le support ne l'apprenne pas en dernier.
Besoin d'aide

Besoin d'aide pour automatiser Ldap avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

LDAP et n8n, les questions qui suivent

01L'intégration LDAP n8n est-elle gratuite ?
Côté n8n, aucun coût : le nœud LDAP fait partie du socle standard, sans installation, aussi bien en Community Edition auto-hébergée sous licence Sustainable Use que sur n8n Cloud. Un workflow prototypé sur Cloud se transporte tel quel vers un serveur maison, le comportement ne change pas. Le credential se crée une seule fois et se réutilise partout, sans frais non plus. Reste le prix de l'annuaire lui-même, qui dépend entièrement du fournisseur choisi et ne concerne que la relation avec lui.
02Quels identifiants faut-il pour connecter n8n à LDAP ?
Le credential LDAP repose sur des informations serveur, pas sur une clé d'API. Deux champs de connexion d'abord, LDAP Server Address et LDAP Server Port. Puis le Binding DN, chemin complet du compte de connexion sur le modèle Active Directory documenté par n8n, accompagné du Binding Password correspondant. Connection Security propose None, TLS ou STARTTLS, et Connection Timeout, facultatif, s'exprime en secondes. Une seule création dans le menu Credentials, et ensuite chaque nœud LDAP posé dans un workflow le retrouve directement dans sa liste déroulante.
03Quelles sont les limites du nœud LDAP de n8n ?
Deux choses à anticiper. D'abord la pagination des résultats de recherche : Return All désactivé, Limit fixe le nombre d'entrées renvoyées, et Page Size règle combien sont demandées à chaque appel, la valeur 0 supprimant la pagination. Ensuite, le recours habituel de n8n ne fonctionne pas ici : sur les autres intégrations, une opération absente se rattrape via HTTP Request sur l'API REST de l'outil, mais le credential LDAP ouvre une connexion vers un serveur d'annuaire et non vers un endpoint HTTP. Le filtre Custom Filter de Search LDAP prend le relais, à écrire soi-même en échappant les caractères *, ( ), et l'antislash. À noter aussi : la page des problèmes fréquents du nœud renvoie une 404, prévoir un test.
04n8n réagit-il en temps réel aux changements LDAP ?
Non : ce point vaut mieux le savoir avant de dessiner le workflow, puisque cet outil n'a pas de trigger dans n8n. Rien ne pousse donc un changement d'annuaire tout seul dans une exécution. Trois façons de démarrer autrement : un Schedule Trigger à intervalle fixe qui relance un Search LDAP pour comparer, un Webhook n8n déclenché par un autre service, ou le trigger d'un outil déjà en place dans l'automatisation. Dans la pratique, une recherche planifiée couplée à une comparaison couvre l'essentiel, et c'est l'intervalle retenu qui fixe la fraîcheur réelle des données.
05n8n ou Make pour automatiser un annuaire LDAP ?
Quatre critères tranchent, sans qu'aucun des deux outils ne soit un mauvais choix en soi. L'hébergement d'abord : n8n s'installe sur une infrastructure maison via Docker ou npm, ou tourne sur n8n Cloud, alors que Make reste une plateforme uniquement hébergée. La maîtrise des données en découle, un point qui pèse davantage quand le workflow manipule des entrées d'annuaire. Le modèle de coût ensuite : Make facture à l'opération, à rapprocher de la fréquence des recherches planifiées. La logique visuelle enfin, comparable sur les deux éditeurs, où les habitudes de l'équipe comptent plus que les capacités. Mieux vaut comparer sur ses propres volumes qu'à partir d'une liste de fonctionnalités.