Cloudflare

يُربط Cloudflare برمز API للقراءة فقط مملوك للحساب. يحقق Polylane ويشرح ما يجده من دون أن يغيّر أي شيء في حسابك أبداً؛ وحين يكون الإصلاح في الكود، يصل على شكل pull request لتراجعه. يُشفَّر رمزك قبل تخزينه، ولا يراه الوكيل أبداً.

الإعداد

1. انقر Create read-only token أعلاه، أو Create API token في نموذج الاتصال في وحدة التحكم. يفتح كلاهما شاشة رموز API للحساب في Cloudflare مع تحديد كل إذن يحتاجه Polylane مسبقاً.
2. اختر الحساب الذي تريد ربطه. يجب أن تكون Super Administrator على ذلك الحساب لإنشاء رمز مملوك للحساب.
3. راجع الأذونات المعبَّأة مسبقاً، ثم انقر Continue to summary وCreate Token.
4. انسخ الرمز والصقه في Polylane.
5. يتحقق Polylane من الرمز ويبدأ المزامنة.

يجب أن تكون على Workers Paid plan لاكتشاف الموارد كاملاً.

الأذونات

ينشئ الرابط المضبوط مسبقاً رمزاً مملوكاً للحساب: كيان خدمة دائم يواصل العمل حتى إذا غادر الشخص الذي أنشأه الحساب. كل إذن للقراءة فقط، عبر الحساب كله:

• Developer Platform: Workers وKV وR2 وD1 وQueues وPipelines وHyperdrive وDurable Objects وContainers وSecrets Store وArtifacts وغيرها
• AI & Machine Learning: Workers AI وAI Gateway وAutoRAG وVectorize وAI Search
• DNS & Zones: DNS وإعدادات المناطق والمسجّل وجدار حماية DNS
• Network Services: Load Balancing وMagic Transit/WAN وSpectrum والأنفاق
• App Security: WAF ومجموعات القواعد وDDoS وإدارة bots وقواعد الصفحات والشهادات
• Cache, Email, Media, Rules, Analytics & Logs

لا شيء في الرمز يستطيع إنشاء أي شيء في حسابك أو تعديله أو حذفه: لا عمليات نشر، ولا تغييرات إعدادات، ولا تراجعات، ولا إدارة للفوترة أو رموز API. تصل المعالجة على شكل pull requests بدلاً من ذلك.

الفصل

افصل الحساب في Polylane، ثم ألغِ رمز API من لوحة تحكم Cloudflare تحت My Profile → API Tokens (أو Manage Account → API Tokens للرموز المملوكة للحساب).

لا يحتاج ربط Cloudflare إلى متصفح: نقطة النهاية نفسها التي تستدعيها وحدة التحكم تناسب مهمة CI. ينشئ طلب POST موثَّق واحد الاتصال ويبدأ المزامنة الأولى.

المتطلبات الأساسية

• مفتاح API من Polylane بنطاقَي cloud_accounts:write وcloud_accounts:read. انظر مفاتيح API وOAuth.
• معرّف مساحة عملك، الذي يبدأ بـ ws_. اقرأه من GET /v1/workspaces بالمفتاح نفسه.
• رمز API مملوك لحساب Cloudflare. يحدد رابط Create read-only token أعلاه مسبقاً كل إذن يحتاجه Polylane.

إنشاء الاتصال

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "cloudflare",
    "workspaceId": "ws_0abc123",
    "token": "<cloudflare-api-token>",
    "readOnly": true
  }'

يربط استدعاء واحد كل حساب Cloudflare يستطيع الرمز الوصول إليه، كل واحد كاتصال خاص به.

• يسجّل readOnly أن الرمز أُنشئ للقراءة فقط؛ احذفه (أو مرّر false) لرمز يستطيع الكتابة.
• يتحكم createMonitoringAlarms (اختياري، الافتراضي true) في تنبيهات قابلية الملاحظة الافتراضية لـ Workers.

تسرد الاستجابة ما رُبط، مع المزامنة الأولى جارية أصلاً. مختصرة إلى الحقلين اللذين تقرؤهما بقية التدفق:

{
  "success": true,
  "result": {
    "provider": "cloudflare",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

يقع الحساب المربوط أصلاً في failures بدلاً من accounts، فلا يكرر تكرار الاستدعاء اتصالاً أبداً.

انتظار المزامنة الأولى

استطلع كل حساب مُعاد عبر id الخاص به حتى تصل status إلى ready (‏new عند التسجيل، وsyncing أثناء تدفق الموارد):

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

أعطِ الحلقة موعداً نهائياً ليُفشل الربط الفاشل المهمة بدلاً من تعليقها. وبعد أن يصبح الحساب ready، تكون موارده في Topology ويكون Polylane قد بدأ فحصه الأول.

الفصل من API

يوقف حذف الاتصال كل مزامنة وفحص ويحذف بيانات الاعتماد التي احتفظ بها Polylane. يحتاج الاستدعاء إلى نطاق cloud_accounts:delete:

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

ثم ألغِ بيانات اعتماد Cloudflare على جانب المزود، كما هو موضح تحت الفصل أدناه.