عميل RDAP موحد وآمن وعالي الأداء
[](https://www.npmjs.com/package/rdapify) [](https://www.npmjs.com/package/rdapify) [](LICENSE) [](https://github.com/rdapify/RDAPify/actions/workflows/ci.yml) [](https://codecov.io/gh/rdapify/RDAPify) [](https://www.typescriptlang.org/) [](https://github.com/rdapify/RDAPify/blob/main/CHANGELOG.md) [](SECURITY.md) [](https://rdapify.com) > **برنامج Alpha** > > RDAPify قيد التطوير النشط. الوظائف الأساسية (استعلامات RDAP والتخزين المؤقت وحماية SSRF) مستقرة واختبارات شاملة، لكن الواجهات البرمجية قد تتغير قبل v1.0. نرحب بـ [المشاكل](https://github.com/rdapify/RDAPify/issues) و[التعليقات](https://github.com/rdapify/RDAPify/discussions) من المجتمع أثناء تطور المشروع. **RDAPify** يوحد استعلامات RDAP عبر جميع السجلات العالمية (Verisign و ARIN و RIPE و APNIC و LACNIC) مع حماية أمان قوية وأداء استثنائية وتجربة مطور متكاملة. هذا ليس مجرد عميل RDAP آخر — إنه منصة كاملة لمعالجة بيانات التسجيل بأمان. > **ملاحظة:** يزيل هذا المشروع الحاجة إلى بروتوكول WHOIS التقليدي، مع الحفاظ على التوافق العكسي عند الحاجة. ## 🚀 لماذا RDAPify؟ استعلامات RDAP المباشرة معقدة — كل سجل يستخدم تنسيقات مختلفة وحدود معدل وإجراءات أمان. بدلاً من إعادة اختراع العجلة لكل مشروع: ```diff - الحفاظ على تطبيقات WHOIS/RDAP متعددة - التعامل اليدوي مع الاختلافات بين السجلات - القلق المستمر حول ضعف SSRF - الأداء غير المتوقع بدون التخزين المؤقت + حل موحد واحد، يختبر بصرامة، مفتوح المصدر ``` يعالج RDAPify ذكياً هذه التحديات: - ✅ **تطبيع البيانات**: استجابة متسقة بغض النظر عن سجل المصدر - ✅ **حماية SSRF**: منع الهجمات على البنية التحتية الداخلية - ✅ **أداء استثنائية**: التخزين المؤقت الذكي، المعالجة المتوازية، تحسين الذاكرة - ✅ **توافق Node.js**: التحقق من العمل على Node.js 20+؛ Bun و Deno و Cloudflare Workers مدعومة أيضاً - ✅ **جاهز للـ GDPR**: أدوات مدمجة لحذف البيانات الشخصية تلقائياً ## 📦 التثبيت السريع ```bash # استخدام npm npm install rdapify # استخدام yarn yarn add rdapify # استخدام pnpm pnpm add rdapify ``` ```bash # استخدام Bun bun add rdapify ``` ## ⚡ ابدأ في 30 ثانية ### الاستخدام الأساسي ```typescript import { RDAPClient } from 'rdapify'; // إنشء عميل بالإعدادات الافتراضية const client = new RDAPClient(); // استعلام عن نطاق const result = await client.domain('example.com'); console.log({ domain: result.query, registrar: result.registrar?.name, status: result.status, nameservers: result.nameservers, created: result.events.find((e) => e.eventAction === 'registration')?.eventDate, expires: result.events.find((e) => e.eventAction === 'expiration')?.eventDate, }); ``` ### مع خيارات الأمان والأداء ```typescript import { RDAPClient } from 'rdapify'; // إنشاء عميل آمن مع إعدادات محسنة const client = new RDAPClient({ cache: true, // ذاكرة تخزين مؤقت LRU (TTL ساعة واحدة) privacy: true, // حذف PII تلقائي (GDPR/CCPA) retry: { maxAttempts: 3, backoff: 'exponential', }, }); // استعلام النطاق أو IP أو ASN أو nameserver أو entity const domain = await client.domain('example.com'); const ip = await client.ip('8.8.8.8'); const asn = await client.asn('AS15169'); const ns = await client.nameserver('ns1.example.com'); const entity = await client.entity('ARIN-HN-1', 'https://rdap.arin.net/registry'); ``` **مثال الإخراج:** ```json { "query": "example.com", "registrar": "Internet Assigned Numbers Authority", "status": ["clientDeleteProhibited", "clientTransferProhibited", "clientUpdateProhibited"], "nameservers": ["a.iana-servers.net", "b.iana-servers.net"], "created": "1995-08-14T04:00:00Z", "expires": "2026-08-13T04:00:00Z" } ``` ### مع استعلامات Nameserver و Entity (v0.1.7+) ```typescript import { RDAPClient } from 'rdapify'; const client = new RDAPClient(); // استعلام عن nameserver — اكتشاف تلقائي عبر bootstrap IANA DNS const ns = await client.nameserver('ns1.example.com'); console.log(ns.ldhName); // "ns1.example.com" console.log(ns.ipAddresses); // { v4: ['93.184.216.34'], v6: [...] } console.log(ns.status); // ['active'] // استعلام عن entity — يتطلب عنوان URL خادم صريح (لا توجد عمليات بحث عامة عن IANA) const entity = await client.entity('ARIN-HN-1', 'https://rdap.arin.net/registry'); console.log(entity.handle); // "ARIN-HN-1" console.log(entity.roles); // ['registrar', 'technical'] ``` ### مع المراقبة والمقاييس (v0.1.2+) ```typescript import { RDAPClient } from 'rdapify'; // إنشاء عميل مع تمكين المراقبة const client = new RDAPClient({ cache: true, logging: { level: 'info', // debug, info, warn, error enabled: true, }, }); // تنفيذ الاستعلامات await client.domain('example.com'); await client.ip('8.8.8.8'); // احصل على مقاييس الأداء const metrics = client.getMetrics(); console.log(`معدل النجاح: ${metrics.successRate}%`); console.log(`وقت الاستجابة المتوسط: ${metrics.avgResponseTime}ms`); console.log(`معدل Cache Hit: ${metrics.cacheHitRate}%`); // احصل على إحصائيات Connection Pool const poolStats = client.getConnectionPoolStats(); console.log(`الاتصالات النشطة: ${poolStats.activeConnections}`); // احصل على السجلات الأخيرة const logs = client.getLogs(10); logs.forEach((log) => { console.log(`[${log.level}] ${log.message}`); }); // تنظيف الموارد client.destroy(); ``` ## 🌟 المميزات الأساسية ### 🔒 أمان المؤسسات - **حماية SSRF مدمجة**: منع الاستعلامات إلى عناوين IP الداخلية أو النطاقات الخطرة - **التحقق من الشهادات**: رفض الاتصالات غير الآمنة بخوادم RDAP - **تحديد المعدل**: منع حظر الخدمة بسبب الطلبات المفرطة - **معالجة البيانات الآمنة**: حذف PII وفقاً لمتطلبات GDPR/CCPA - **دعم المصادقة** (v0.1.1+): Basic و Bearer Token و API Key و OAuth2 - **دعم Proxy** (v0.1.1+): HTTP/HTTPS/SOCKS4/SOCKS5 مع المصادقة - **مسار تدقيق كامل**: تتبع جميع العمليات الحرجة لأغراض الامتثال ### ⚡ أداء استثنائية - **التخزين المؤقت الذكي**: ذاكرة تخزين مؤقت LRU مع TTL قابل للتكوين - **التخزين المؤقت الثابت** (v0.1.1+): ذاكرة تخزين مؤقت قائمة على الملفات تبقى بعد إعادة التشغيل - **Connection Pooling** (v0.1.2+): إعادة استخدام اتصال HTTP لتحسين الأداء بنسبة 30-40٪ - **معالجة الدفعات**: معالجة الاستعلامات المتعددة بكفاءة (أسرع 5-10 مرات) - **ضغط الاستجابة** (v0.1.1+): دعم gzip/brotli لتقليل النطاق الترددي بنسبة 60-80٪ - **استراتيجيات إعادة المحاولة** (v0.1.1+): قاطع الدائرة مع تراجع أسي - **أولويات الاستعلام** (v0.1.1+): قائمة انتظار ذات أولوية عالية/عادية/منخفضة - **اكتشاف السجل**: اكتشاف Bootstrap IANA التلقائي لإيجاد السجل الصحيح - **التحليل المحسّن**: تطبيع JSONPath السريع ### 📊 المراقبة والملاحظة (v0.1.2+) - **جمع المقاييس**: تتبع أداء الاستعلام ومعدلات النجاح وفعالية الذاكرة المؤقتة - **تسجيل الطلب/الاستجابة**: التسجيل المفصل مع مستويات قابلة للتكوين (debug و info و warn و error) - **تحليل الأداء**: مراقبة أوقات الاستجابة والتعرف على الاختناقات وتحسين الاستعلامات - **إحصائيات Connection Pool**: تتبع إعادة استخدام الاتصال واستخدام الموارد - **التصفية الزمنية**: تحليل المقاييس خلال فترات زمنية محددة - **إمكانيات التصدير**: تصدير المقاييس والسجلات للتحليل الخارجي ### 🧩 التكامل السلس - **دعم TypeScript الكامل**: مكتوب بقوة مع الوثائق المضمنة - **دعم Node.js 20+**: التحقق من العمل (Node.js و Bun و Deno و Cloudflare Workers) - **التحقق المحسّن** (v0.1.1+): نطاقات IDN و IPv6 والنطاقات و ASN - **استعلامات Nameserver و Entity** (v0.1.7+): `client.nameserver()` و `client.entity()` مع دعم RDAP الكامل - **أداة CLI** (v0.1.7+): `rdapify domain/ip/asn/nameserver/entity` مع `--json` و `--no-cache` و `--timeout` و `--server` flags - **ملعب ويب**: جرب RDAPify مباشرة على [rdapify.com/playground](https://rdapify.com/playground) - **قوالب مدمجة مسبقاً**: لـ AWS Lambda و Azure Functions و Kubernetes والمزيد (مخطط) ### 📊 تحليلات متقدمة (مخطط) الإصدارات المستقبلية ستشمل: - **لوحات معلومات قابلة للتخصيص**: تتبع النطاقات والأصول الحرجة - **تقارير آلية**: جدولة تنبيهات انتهاء الصلاحية والتغييرات المهمة - **كشف النمط**: تحديد السلوكيات المريبة في التسجيل أو الهجمات المحتملة - **تصور العلاقات**: فهم الملكية المعقدة وشبكات التسجيل ## 🏗️ البنية الأساسية ```mermaid graph LR A[التطبيق] --> B(عميل RDAP) B --> C{اكتشاف السجل} C -->|Bootstrap IANA| D[(طبقة الذاكرة المؤقتة)] B --> E[التطبيع] E -->|JSONPath| F[استجابات خام] F --> G[تنسيق موحد] G --> H[حذف PII] H --> I[الاستجابة النهائية] D -->|التحضير المسبق| C style B fill:#4CAF50,stroke:#388E3C style D fill:#FF9800,stroke:#F57C00 style G fill:#2196F3,stroke:#0D47A1 ``` ## 🛡️ الأمان كمبدأ أساسي لا نتعامل مع الأمان كميزة إضافية — إنه أساسي لتصميمنا. يحمي RDAPify تطبيقاتك من: | التهديد | آلية الحماية | الحرجية | |--------|-------------|--------| | SSRF | التحقق من النطاق وحظر IP الداخلية | 🔴 حرج | | DoS | تحديد المعدل والمهل الزمنية | 🟠 مهم | | تسرب البيانات | حذف PII وعدم تخزين الاستجابة الخام | 🔴 حرج | | MitM | HTTPS إجباري والتحقق من الشهادة | 🟠 مهم | | حقن البيانات | التحقق من المخطط والتحليل الصارم | 🟠 مهم | اقرأ [وثيقة أمان RDAP الخاصة بنا](docs/security/whitepaper.md) لمزيد من التفاصيل التقنية والسيناريوهات المتقدمة. ## 📚 التوثيق يوفر RDAPify توثيقاً شاملاً في المستودع: - **[البدء السريع](docs/getting_started/)** - التثبيت والبدء السريع والاستعلام الأول - **[مرجع API](docs/api_reference/)** - توثيق API TypeScript الكامل - **[المفاهيم الأساسية](docs/core_concepts/)** - أساسيات RDAP والبنية والتطبيع - **[دليل الأمان](docs/security/)** - حماية SSRF وحذف PII وأفضل الممارسات - **[الأدلة](docs/guides/)** - معالجة الأخطاء واستراتيجيات التخزين المؤقت وتحسين الأداء - **[الأمثلة](examples/)** - أمثلة كود من العالم الحقيقي وحالات الاستخدام > **نصيحة**: التوثيق الكامل للـ API والدليل متاح في دليل [`docs/`](docs/). ## 🌐 ملعب تفاعلي جرب RDAPify مباشرة في المتصفح — لا حاجة للتثبيت: **[rdapify.com/playground](https://rdapify.com/playground)** ## 📊 معايير الأداء تم قياسها على **النهاية الخلفية الأصلية** (`rdapify-nd` و `cargo bench` و Criterion و Linux x86-64 وخادم HTTP وهمي). معايير pipeline TypeScript أعلى بـ ~10-20×: | السيناريو | الكمون | |---------|--------| | استعلام — بدون ذاكرة مؤقتة (bootstrap + fetch + normalize) | ~180 µs | | استعلام — **cache hit** | **~2.3 µs** (~80× أسرع) | | قراءة الذاكرة المؤقتة (DashMap و TTL جديد) | ~124 ns | | التحقق من عنوان URL SSRF | ~141–295 ns | > **مع النهاية الخلفية الأصلية** (`npm install rdapify-nd`)، تعمل الطرق الخمسة الأساسية > استعلام داخل Rust المترجم بدلاً من pipeline TypeScript — أقل > كمون لكل استدعاء للسيناريوهات عالية الإنتاجية. > > ```ts > const client = new RDAPClient({ backend: 'auto' }); // يستخدم rdapify-nd إذا تم التثبيت > ``` ## 👥 المجتمع والدعم RDAPify مشروع مفتوح المصدر. احصل على المساعدة أو ساهم: ### 🐛 تقارير الأخطاء وطلبات الميزات - **[مشاكل GitHub](https://github.com/rdapify/RDAPify/issues)** - الإبلاغ عن الأخطاء أو طلب الميزات ### 💬 الأسئلة والنقاشات - **[نقاشات GitHub](https://github.com/rdapify/RDAPify/discussions)** - اطرح أسئلة وشارك الأفكار وأظهر ما بنيته ### 📧 الاتصال المباشر - **استفسارات عامة**: contact@rdapify.com - **مشاكل الأمان**: security@rdapify.com (انظر [SECURITY.md](SECURITY.md)) - **الدعم**: support@rdapify.com ### 🤝 المساهمة - **[CONTRIBUTING.md](CONTRIBUTING.md)** - إرشادات المساهمة - **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** - معايير المجتمع ## 🚧 حالة المشروع **الإصدار الحالي**: v0.3.0 (Alpha) ### 🎉 ما هو جديد في v0.3.0 **Streaming و Monitoring و Runtime Maturity** - ✅ **واجهة برمجية Streaming Batch**: `client.streamBatch(queries[])` — `AsyncIterable