ForHosting KIT · Outils pour développeurs

Echappement DN LDAP

Smith, John devient Smith\, John : la virgule reste dans le nom au lieu de couper le nom distinctif. Signes plus, guillemets, barres obliques inverses, chevrons et points-virgules reçoivent le même traitement RFC 4514, et le décodage l'inverse. Gratuit dans votre navigateur.

  • Gratuit
  • Fonctionne dans votre navigateur
  • Sans inscription
  • Vos données restent sur votre appareil
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt
Si vous saisissez
Texte
Smith, John
Mode de calcul
Encode
Vous obtenez
Résultat
Smith\, John
Encodage
ldap_dn_rfc4514
Longueur de l'entrée
11
Longueur de la sortie
12

Cet échappement de DN LDAP convertit une valeur d'attribut brute en la forme échappée exigée par la RFC 4514 pour la représentation textuelle des noms distinctifs, et inverse le même mapping lorsque vous collez un composant échappé pour retrouver des caractères ordinaires. L'encodage réécrit virgules, signes plus, guillemets doubles, barres obliques inverses, chevrons et points-virgules afin qu'un common name, une unité d'organisation ou un fragment de filtre écrit à la main puisse s'insérer dans un RDN sans scinder le DN environnant. Les dièses en tête et les espaces ASCII en tête ou en queue reçoivent aussi une barre inverse pour que les serveurs d'annuaire ne les traitent pas comme marqueurs hexadécimaux ou padding insignifiant. Le décodage accepte la forme caractère spécial et les paires hexadécimales à deux chiffres, comme barre-deux-C pour une virgule, et échoue clairement sur une barre finale isolée, un chiffre hex incomplet ou une lettre d'échappement illégale, afin que les fautes de frappe n'atteignent pas en silence les DN de bind ni les scripts de migration. Le chemin est entièrement déterministe : le même texte et le même mode produisent toujours le même résultat, sans appels réseau, sans sels aléatoires ni raccourcis liés à la date. Les contrôles simples incluent l'encodage d'un nom de famille contenant une virgule en forme barre-virgule, et le décodage d'un surnom entre guillemets avec des paires barre-guillemet en guillemets réels.

Ce qu'est l'échappement de composant DN RFC 4514 et ce que renvoie cet outil

Un nom distinctif LDAP est une séquence de noms distinctifs relatifs, et chaque RDN associe un type d'attribut à une valeur chaîne. La RFC 4514 définit comment cette valeur s'écrit en texte pour que les analyseurs récupèrent les octets d'origine sans confondre séparateurs structurels et charge utile. Une virgule littérale doit apparaître comme paire barre-virgule, un plus littéral comme barre-plus, et guillemet double, barre inverse, inférieur, supérieur et point-virgule suivent le même schéma.

Un dièse en tout début de valeur est échappé pour ne pas être lu comme marqueur de chaîne hex, et un espace ASCII en tête ou en queue est échappé pour ne pas être abandonné comme blanc insignifiant. Les octets de contrôle sous l'espace s'écrivent en solidus inverse et deux chiffres hexadécimaux majuscules, la forme portable des exemples d'annuaire et de nombreuses liaisons de langage.

Cette page implémente cet ensemble sur la voie encode et l'inverse sur decode : la réponse est uniquement la chaîne du composant, sans inventer de noms de type d'attribut ni parcourir un arbre multi-RDN. Contrairement à un analyseur DN complet, cette landing ne découpe pas sur des virgules non échappées en RDNs, ne valide pas les schémas object-class et n'ouvre pas de socket LDAP.

Où l'échappement et le déséchappement de DN LDAP s'insèrent dans le flux développeur

Les équipes identité et SSO encodent des noms d'affichage dynamiques avant de les placer dans un nom distinctif relatif, afin qu'une seule virgule ou un guillemet ne casse pas la représentation textuelle environnante. Les auteurs de pipelines décodent des exports denses en échappements issus d'annuaires hérités pour que le code applicatif travaille avec de vraies virgules et espaces au lieu de séquences littérales barre-virgule.

Les ingénieurs qualité génèrent des paires encode et decode déterministes pour des tests de contrat, afin qu'un middleware qui prétend supporter la RFC 4514 ne puisse pas basculer en silence vers une table d'échappement non standard entre versions. Les formateurs utilisent le même outil pour enseigner la différence entre un nom distinctif multi-RDN complet, une seule valeur d'attribut et le petit ensemble d'échappements que la spécification autorise dans cette valeur.

Valeurs d'attribut RDN sûres

Échappez noms de famille, OU et valeurs CN en texte libre pour que virgules, plus, guillemets et espaces de bord ne cassent pas un nom distinctif écrit à la main ou par modèle.

Paires déterministes en CI

Générez des paires encode et decode reproductibles pour tests unitaires, contrats de middleware d'annuaire et outils qui doivent coller aux tables RFC 4514.

Combien coûte l'échappement de DN LDAP ?

C'est gratuit dans votre navigateur sur cette page.

Quels caractères sont échappés en encode ?

Encode réécrit virgule, plus, guillemet double, barre inverse, inférieur, supérieur et point-virgule avec un préfixe barre ; dièse en tête et espace ASCII en tête ou en queue de même ; et les octets de contrôle U+0000–U+001F en hex à deux chiffres.

Que se passe-t-il si un échappement est incomplet ou illégal ?

Barres isolées, paires hex incomplètes et lettres d'échappement hors RFC sont rejetées.

Le résultat est-il déterministe ?

Oui. Le même texte et le même mode produisent toujours le même résultat, sans réseau, sans aléa ni comportement lié à la date.

Pourquoi les espaces en début ou en fin de valeur sont-ils échappés ?

Parce que les serveurs d'annuaire considèrent un espace initial ou final comme du remplissage et peuvent le supprimer, alors que la barre oblique inverse le préserve. Un signe dièse placé tout au début est aussi échappé, pour ne pas être lu comme la marque d'une valeur hexadécimale.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/enc/ldap-dn-escape

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/enc/ldap-dn-escape \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Smith, John"}'
{
  "text": "Smith, John"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ldap_dn_escape",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Ce qu'est l'échappement de composant DN RFC 4514 et ce que renvoie cet outil

La réponse JSON inclut toujours result pour la chaîne transformée, mode qui reprend encode ou decode, encoding fixé à ldap_dn_rfc4514, et input_length plus output_length pour que les tests puissent affirmer les tailles. Encode signale aussi escapes_applied et decode escapes_resolved pour confirmer combien de caractères spéciaux ou de séquences d'échappement ont été réécrits. Il n'y a pas d'omission silencieuse partielle d'une séquence cassée : chaque paire avec barre est légale sous RFC 4514, sinon la requête échoue avec invalid_input.

Comment text et mode sont lus et comment les résultats restent reproductibles

Encode parcourt la chaîne par unités de code UTF-16 et ne remplace que les caractères que la RFC 4514 exige d'échapper, laissant lettres, chiffres et Unicode ordinaire inchangés pour que les noms lisibles restent lisibles. Comme la barre inverse est réécrite dans le même passage de gauche à droite que virgules et guillemets, vous obtenez un seul passage d'échappement cohérent, aligné sur les tables habituelles des boîtes à outils d'annuaire pour les valeurs d'attribut. Decode analyse les séquences de solidus inverse : si les deux caractères suivants sont hexadécimaux, la paire est traitée comme un octet ; sinon le caractère suivant doit être l'un des spéciaux espace, dièse, guillemet, plus, virgule, point-virgule, inférieur, supérieur, barre ou égal. Le champ de charge préféré est text, avec les alias input, value, s, payload, dn et component pour que formulaires, chaînes de requête et clients SDK réutilisent le même contrat sans renommer les colonnes. Mode vaut encode par défaut et accepte decode explicitement ; les alias op, direction et action mappent vers le même commutateur pour les scripts qui utilisent déjà ces noms, et escape ou unescape sont acceptés comme synonymes. Une barre finale incomplète, un seul chiffre hex sans partenaire ou toute autre lettre après la barre lève invalid_input avec un message qui nomme le problème. Le plafond de longueur de cent mille caractères maintient la mémoire du Worker prévisible tout en couvrant de longs fragments multi-valeurs, des DN d'exemple et la plupart des presse-papiers. Associez l'exécution gratuite dans le navigateur sur cette page à l'API tarifée lorsque vous avez besoin du même mapping dans un pipeline automatisé sans réimplémenter les tables RFC 4514. Les entrées invalides renvoient invalid_input et ne sont pas facturées, ce qui garde la validation peu coûteuse tandis que les transforms réussis restent un prix fixe par item de $0.002.

Où l'échappement et le déséchappement de DN LDAP s'insèrent dans le flux développeur

Sur cette page le travail s'exécute entièrement dans votre navigateur ; via l'API chaque consultation réussie coûte $0.002, la validation en échec n'est pas facturée et rien n'est stocké après la réponse. Cette division—exploration interactive gratuite et API identique tarifée—correspond au reste du catalogue KIT de niveau A et vous permet de passer d'une démo de cours à un pipeline automatisé sans changer le résultat échappé. Associez-le au percent-encoding d'URL, aux aides de chaîne JSON ou aux guillemets d'arguments shell lorsque vous avez besoin de transforms de texte plus larges, et à d'autres endpoints d'encodage pour constituer un petit laboratoire d'outils gratuits et déterministes pour la CI et la documentation.

Nettoyage LDIF et migrations

Décodez les échappements RFC 4514 issus d'exports, journaux ou fichiers LDIF golden en Unicode plain pour des diffs lisibles et du code applicatif.

Quels modes sont pris en charge ?

mode=encode (par défaut) transforme le texte brut en échappements de composant DN RFC 4514. mode=decode transforme ces échappements en caractères.

Consulter la documentation complète du KIT →