تهريب DN لـ LDAP
تصبح Smith, John هي Smith\, John، فتبقى الفاصلة جزءًا من الاسم بدل أن تقسم الاسم المميز. وتُعامل علامات الجمع والاقتباس والشرطات العكسية وأقواس الزاوية والفواصل المنقوطة بالطريقة نفسها وفق RFC 4514، ويعكس فك التهريب ذلك. مجاني في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- Smith, John
- وضع الحساب
- Encode
- النتيجة
- Smith\, John
- الترميز
- ldap_dn_rfc4514
- طول المُدخَل
- 11
- طول المُخرَج
- 12
يحوّل مهرب DN لـ LDAP قيمة سمة نصية عادية إلى الشكل المُهرَّب الذي تتطلبه RFC 4514 لتمثيل الأسماء المميزة نصيًا، ويعكس نفس التعيين عندما تلصق مكوّنًا مُهرَّبًا ليعود إلى أحرف عادية. تعيد الترميز كتابة الفواصل وعلامات الزائد وعلامات الاقتباس المزدوجة والشرطات المائلة العكسية والأقواس الزاوية والفواصل المنقوطة حتى يتمكن اسم شائع أو وحدة تنظيمية أو جزء من مرشح مكتوب يدويًا من الجلوس داخل RDN دون تقسيم DN المحيط. تتلقى علامات الرقم في البداية والمسافات ASCII في البداية أو النهاية أيضًا شرطة مائلة عكسية حتى لا تعاملها خوادم الدليل كعلامات سداسية عشرية أو حشو غير ذي أهمية. يقبل فك الترميز شكل الحرف الخاص وأزواجًا سداسية من رقمين مثل شرطة-اثنان-C للفاصلة، ويفشل بوضوح عند شرطة مائلة عكسية يتيمة في النهاية أو رقم سداسي ناقص أو حرف تهريب غير قانوني، حتى لا تصل أخطاء الكتابة بصمت إلى DN للربط أو إلى سكربتات الترحيل. المسار حتمي بالكامل: نفس النص والوضع ينتجان دائمًا نفس النتيجة، بلا استدعاءات شبكة ولا أملاح عشوائية ولا اختصارات تعتمد على التاريخ. تشمل الفحوصات الصغيرة ترميز لقب يحتوي فاصلة إلى شكل شرطة-فاصلة، وفك ترميز لقب مستعار بين علامتي اقتباس يستخدم أزواج شرطة-اقتباس إلى علامات اقتباس حقيقية.
ما تهريب مكوّن DN وفق RFC 4514 وما الذي يعيده هذا الأداة
الاسم المميز في LDAP سلسلة من أسماء مميزة نسبية، ويقترن كل RDN بنوع سمة وقيمة نصية. يجب أن تظهر الفاصلة الحرفية كزوج شرطة-فاصلة، والزائد الحرفي كشرطة-زائد، وتتبع علامة الاقتباس المزدوجة والشرطة المائلة العكسية والأصغر والأكبر والفاصلة المنقوطة نفس النمط. تُهرَّب علامة الرقم في بداية القيمة حتى لا تُقرأ كعلامة سلسلة سداسية، وتُهرَّب مسافة ASCII في البداية أو النهاية حتى لا تُحذف كمسافة بيضاء غير ذات أهمية.
تُكتب ثمانيات التحكم دون المسافة كشرطة مائلة عكسية ورقمين سداسيين بأحرف كبيرة، وهو الشكل المحمول في أمثلة الدليل وروابط لغات كثيرة. تنفّذ هذه الصفحة ذلك المجموعة في مسار الترميز وعكسه في فك الترميز: الاستجابة هي سلسلة المكوّن فقط، دون اختراع أسماء أنواع سمات أو اجتياز شجرة متعددة RDN. بخلاف محلل DN كامل، لا تقسم هذه الصفحة على فواصل غير مُهرَّبة إلى RDNs، ولا تتحقق من مخططات object-class، ولا تفتح مقبس LDAP.
أين يناسب تهريب وفك تهريب DN لـ LDAP سير عمل المطوّر
يواجه مهندسو الدليل تهريب DN عند تضمين ألقاب المستخدمين في DN للربط، وكتابة stubs لـ ldif يدويًا للاختبارات، وترحيل حسابات تحتوي أسماؤها الشائعة على فواصل أو علامات زائد، أو إعداد تجهيزات ذهبية يجب أن تنجو من محلل DN صارم. تُرمّز فرق الهوية وSSO أسماء العرض الديناميكية قبل وضعها داخل اسم مميز نسبي حتى لا تكسر فاصلة أو علامة اقتباس واحدة التمثيل النصي المحيط. يفك مؤلفو المسارات ترميز صادرات كثيفة بالتهريب من أدلة قديمة حتى يعمل كود التطبيق بفواصل ومسافات حقيقية بدل تسلسلات شرطة-فاصلة حرفية.
يولّد مهندسو الجودة أزواج encode وdecode حتمية لاختبارات العقد حتى لا ينتقل وسيط يدّعي دعم RFC 4514 بصمت إلى جدول تهريب غير قياسي بين الإصدارات. يستخدم المعلّمون الأداة نفسها عند شرح الفرق بين اسم مميز متعدد RDN كامل، وقيمة سمة واحدة، والمجموعة الصغيرة من التهريبات التي تسمح بها المواصفة داخل تلك القيمة.
حالات الاستخدام
قيم سمات RDN آمنة
هرّب الألقاب وOU وقيم CN النصية الحرة حتى لا تكسر الفواصل والزائد وعلامات الاقتباس والمسافات الطرفية اسمًا مميزًا مكتوبًا يدويًا أو من قالب.
تنظيف LDIF والترحيل
افك تهريب RFC 4514 من الصادرات والسجلات أو ملفات LDIF الذهبية إلى Unicode عادي لفروق مقروءة وكود تطبيق.
أزواج حتمية في CI
ولّد أزواج encode وdecode قابلة للتكرار لاختبارات الوحدة وعقود وسيط الدليل والأدوات التي يجب أن تطابق جداول RFC 4514.
الأسئلة الشائعة
أي أحرف تُهرَّب عند الترميز؟
يعيد الترميز كتابة الفاصلة والزائد وعلامة الاقتباس المزدوجة والشرطة المائلة العكسية والأصغر والأكبر والفاصلة المنقوطة ببادئة شرطة؛ وعلامة الرقم الأولى والمسافة ASCII الأولى أو الأخيرة بنفس الطريقة؛ وثمانيات التحكم U+0000–U+001F كسداسي من رقمين.
ماذا يحدث إذا كان التهريب ناقصًا أو غير قانوني؟
تُرفض الشرطات المائلة العكسية اليتيمة والأزواج السداسية الناقصة وأحرف التهريب خارج RFC.
هل النتيجة حتمية؟
نعم. نفس النص والوضع ينتجان دائمًا نفس النتيجة بلا شبكة ولا عشوائية ولا سلوك يعتمد على التاريخ.
لماذا تُهرَّب المسافات في بداية القيمة أو نهايتها؟
لأن خوادم الدليل تعدّ المسافة في البداية أو النهاية حشوًا وقد تحذفها، والشرطة العكسية تحفظها. وتُهرَّب أيضًا علامة # في أول القيمة حتى لا تُقرأ علامةً على قيمة ست عشرية.
هل يقبل فك التهريب فاصلة مكتوبة على شكل \2C؟
نعم. يقبل الشكل الذي يأتي فيه المحرف نفسه بعد الشرطة العكسية، ويقبل أيضًا أزواج الأرقام الست عشرية مثل \2C للفاصلة، ثم يعيد المحرف الأصلي.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
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"}'const res = await fetch("https://api.kit.forhosting.com/enc/ldap-dn-escape", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "Smith, John"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/ldap-dn-escape",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "Smith, John"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/ldap-dn-escape", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"Smith, John"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"Smith, John"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/ldap-dn-escape", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "Smith, John"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.ldap_dn_escape",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدمه مجانًا في المتصفح لنظافة DN وتنظيف التجهيزات، أو استدعِ واجهة API بسعر $0.002 لكل طلب ناجح عندما تحتاج المسارات إلى تحويلات RFC 4514 قابلة للتكرار في CI وأدوات الدليل.
ما تهريب مكوّن DN وفق RFC 4514 وما الذي يعيده هذا الأداة
تحدد RFC 4514 كيفية كتابة تلك القيمة نصيًا حتى يستعيد المحللون الثمانيات الأصلية دون الخلط بين فواصل البنية والحمولة. تتضمن استجابة JSON دائمًا result للسلسلة المحوّلة، وmode الذي يعكس encode أو decode، وencoding ثابتًا إلى ldap_dn_rfc4514، وinput_length مع output_length حتى تتمكن الاختبارات من تأكيد الأحجام. يبلّغ الترميز أيضًا عن escapes_applied وفك الترميز عن escapes_resolved لتأكيد عدد الأحرف الخاصة أو تسلسلات التهريب التي أُعيدت كتابتها. لا يوجد تخطٍ صامت جزئي لتسلسل معطوب: إما أن كل زوج بشرطة مائل قانوني بموجب RFC 4514 أو يفشل الطلب بـ invalid_input. إذا احتجت إلى تحليل شجرة DN كاملة أو بناء مرشحات أو مصادقة bind، فاستخدم تلك النقاط المخصصة؛ تجيب هذه الصفحة فقط عن عقد تهريب وفك تهريب المكوّن بمخرج مستقر يناسب التجهيزات ومستهلكي API الذين يبنون أو يصلحون أجزاء DN يدويًا.
كيف تُقرأ text وmode وكيف تبقى النتائج قابلة للتكرار
يكون mode افتراضيًا encode ويقبل decode صراحة؛ وتُعيَّن الأسماء المستعارة op وdirection وaction إلى نفس المفتاح للنصوص التي تستخدم تلك الأسماء، وتُقبل escape أو unescape كمرادفين. يمر الترميز على السلسلة بوحدات رمز UTF-16 ويستبدل فقط الأحرف التي تتطلب RFC 4514 تهريبها، تاركًا الحروف والأرقام وUnicode العادي دون تغيير حتى تبقى الأسماء المقروءة مقروءة. ولأن الشرطة المائلة العكسية تُعاد كتابتها في نفس المرور من اليسار إلى اليمين مع الفواصل وعلامات الاقتباس، تحصل على مرور تهريب واحد متسق يطابق جداول أدوات الدليل الشائعة لقيم السمات. يمسح فك الترميز تسلسلات الشرطة المائلة العكسية: إذا كان الحرفان التاليان سداسيين عشريين، يُعامل الزوج كثمانية واحدة؛ وإلا يجب أن يكون الحرف التالي أحد الخاصين: مسافة أو علامة رقم أو اقتباس أو زائد أو فاصلة أو فاصلة منقوطة أو أصغر أو أكبر أو شرطة مائلة عكسية أو يساوي. حقل الحمولة المفضّل هو text، مع الأسماء المستعارة input وvalue وs وpayload وdn وcomponent حتى تعيد النماذج وسلاسل الاستعلام وعملاء SDK استخدام نفس العقد دون إعادة تسمية الأعمدة. تثير شرطة مائلة عكسية نهائية ناقصة، أو رقم سداسي واحد بلا شريك، أو أي حرف آخر بعد الشرطة، invalid_input برسالة تسمّي المشكلة. سقف الطول مئة ألف حرف يحافظ على ذاكرة Worker قابلة للتوقع ويغطي أجزاء متعددة القيم الطويلة وDN للعينات ومعظم لوحات اللصق. اقرن التشغيل المجاني في المتصفح على هذه الصفحة بواجهة API المدفوعة عندما تحتاج إلى نفس التعيين داخل مسار آلي دون إعادة تنفيذ جداول RFC 4514 بنفسك. تُرجع المدخلات غير الصالحة invalid_input ولا تُحاسب، مما يبقي التحقق رخيصًا بينما تبقى التحويلات الناجحة سعرًا ثابتًا لكل عنصر عند $0.002.
أين يناسب تهريب وفك تهريب DN لـ LDAP سير عمل المطوّر
على هذه الصفحة يعمل كل شيء في متصفحك؛ وعبر API تكلف كل استعلام ناجح $0.002، ولا تُحاسب التحقق الفاشل، ولا يُخزَّن شيء بعد إرجاع الاستجابة. ذلك التقسيم—استكشاف تفاعلي مجاني وAPI مدفوعة مطابقة—يطابق بقية كتالوج KIT من المستوى A ويتيح الانتقال من عرض تعليمي إلى مسار آلي دون تغيير النتيجة المُهرَّبة. اقرنه بترميز النسبة المئوية لعناوين URL أو مساعدات سلاسل JSON أو اقتباس وسائط الصدفة عندما تحتاج تحويلات نص أوسع، وبمنافذ ترميز أخرى عند بناء مختبر صغير من أدوات مجانية وحتمية لـ CI والتوثيق.
أسئلة تقنية
كم يكلف مهرب DN لـ LDAP؟
إنه مجاني في متصفحك على هذه الصفحة. عبر API يكلف الطلب الناجح $0.002؛ والمدخلات غير الصالحة لا تُحاسب.
ما الأوضاع المدعومة؟
mode=encode (الافتراضي) يحوّل النص العادي إلى تهريبات مكوّن DN وفق RFC 4514. mode=decode يعيد تلك التهريبات إلى أحرف.