يمكن تشغيل Rediacc بالكامل على بنيتك التحتية الخاصة. تتضمن صورة Docker المستقلة خادم الحساب وبوابة الويب وموقع التسويق ونقطة توزيع CLI. لا تتطلب أي اعتماديات خارجية على خدمات Rediacc المستضافة.
التثبيت باستخدام rdc
يثبّت rdc server install خادم الحسابات كمستودع على جهاز تصل إليه CLI عبر SSH. يغطي أمر واحد فحص الجهاز وإعداد renet وDNS وTLS وتوليد المفاتيح والترخيص والتشغيل وحساب المالك. لكل قيمة خيار خاص بها. في الطرفية تُطلب القيمة الناقصة؛ ومع --yes لا يُطلب شيء وتُرفض القيمة الناقصة. تُسجَّل كل خطوة، لذا تتخطى إعادة التشغيل ما أُنجز بالفعل.
الخطوات بالترتيب: preflight (sudo بلا كلمة مرور، المعمارية، المنفذان 80 و443، مساحة القرص، انحراف الساعة)، وsetup (rdc machine setup، فقط عند غياب renet)، وdns، وtls، وrepo، وkeys، وlicence، وimage، وup، وowner.
الأجهزة الموجودة أولًا
يستهدف التثبيت جهازًا موجودًا بالفعل: خادمًا في مركز بيانات أو جهازًا في الشبكة المحلية. يُذكر الجهاز المُعدّ كوسيط. أما الجهاز غير المسجَّل بعد فيُضاف بعنوانه:
rdc server install --ip 203.0.113.10 --user admin --domain accounts.example.com
rdc server install server-1 --domain accounts.example.com --owner owner@example.com --yes
يحدد --port و--name منفذ SSH والاسم الذي يُسجَّل به الجهاز. تُنشأ الآلة الافتراضية السحابية أولًا بالأمر rdc machine provision؛ ولا ينشئ التثبيت آلة أبدًا.
DNS
يطبع التثبيت سجلات A وAAAA لنطاق الخادم ونطاق مخزن النسخ الاحتياطي (--store-domain، والافتراضي <الاسم>-store.<بقية النطاق>) ثم ينتظر حتى يُحَل كلاهما إلى الجهاز. لا يُكتب أي سجل في أي منطقة أبدًا. يطبع --no-dns-wait السجلات ويتابع، وهذا مناسب لاسم شبكة محلية يخدمه محلّل محلي.
TLS
يختار --tls واحدة من ثلاث طرق:
| الطريقة | المتطلبات | ملاحظات |
|---|---|---|
letsencrypt | المنفذان 80 و443 متاحان من الإنترنت | تحدي HTTP-01. يستقبل --cert-email إشعارات الانتهاء؛ والافتراضي هو المالك. |
cloudflare | --cf-token | تحدي DNS-01 عبر رمز API من Cloudflare. |
byo | --tls-cert و--tls-key | شهادة PEM موجودة تغطي النطاقين. يحدد --tls-ca جهة الإصدار التي يثق بها فحص السلامة. |
rdc server install lab --domain lab.example.internal --tls byo \
--tls-cert host.crt --tls-key host.key --tls-ca ca.crt \
--licence free --no-dns-wait --yes
الصورة
تسحب خطوة الصورة افتراضيًا ghcr.io/rediacc/server:latest على الجهاز. يختار --image مرجعًا آخر. يرسل --image-file ملف tar كُتب بالأمر docker save، ويحفظ --local-image الصورة --image من Docker المحلي ثم يرسلها. كلاهما يغني عن وصول الجهاز إلى أي سجل.
الترخيص والباقة المجانية
يأخذ --licence auto (الافتراضي) شهادة تفويض من الحساب المسجَّل دخوله، أو يبدأ على الباقة المجانية إن لم توجد. ويبدأ --licence free دائمًا على الباقة المجانية. الحساب الذي سجّل الدخول قبل وجود أمر التثبيت يحتاج إلى إعادة تشغيل rdc subscription login ليحمل النطاق (scope) الصحيح.
للجهاز الذي لا طريق له إلى خادم الحسابات، يقبل --cert <file> شهادة تفويض أُخذت من مكان آخر. يجب أن تسمّي الشهادة المفتاح المولَّد على الجهاز، لذا فالترتيب المعتاد تثبيت على الباقة المجانية أولًا ثم الشهادة:
rdc server install server-1 --domain accounts.example.com --licence free --yes
rdc server licence accounts.example.com --cert delegation-cert.json
ينقل rdc server licence خادمًا على الباقة المجانية إلى شهادة من الحساب المسجَّل دخوله أو من --cert. تصف الخطوة 3 في قسم الترخيص أدناه ما يتحقق منه الخادم.
حزمة الاسترداد
تُولَّد كل المفاتيح على الجهاز وتُكتب فقط في secrets.env الخاص بالمستودع. في الطرفية ينتهي التثبيت بطباعة حزمة استرداد لمرة واحدة: زوج المفاتيح المفوَّض ومفتاح خادم إعدادات الحساب وبيانات اعتماد تخزين الكائنات. لا تُسجَّل الحزمة في السجلات ولا تدخل في --output json. وبلا طرفية لا تُطبع، ويذكر السطر الأخير الأمر rdc server backup.
rdc server backup accounts.example.com --out elite-recovery.env
يكتب --out الملف بصلاحيات 0600؛ وبدونه تذهب الحزمة إلى stdout. ينسخ --bws-project <id> عند التثبيت المفاتيح أيضًا إلى مشروع في Bitwarden Secrets Manager، ويستبدل --rotate قيمة مخزَّنة مختلفة. وبدون --bws-project لا تغادر المفاتيح الخادم إلا في حزمة الاسترداد التي يطبعها التثبيت وفي الحزمة التي ينتجها rdc server backup، سواء في ملف --out أو على stdout.
الحالة
rdc server status accounts.example.com
تعرض الحالة سلامة الخادم وباقته وشهادته وصورته. يحدد --machine و--repo الهدف عندما لا يحتفظ الجهاز بسجل تثبيت للنطاق.
التحديثات
| المكوّن | الأمر |
|---|---|
| CLI | rdc update |
| renet على الجهاز | rdc machine setup <machine> |
| صورة الخادم وقالبه | rdc server upgrade <domain> |
ينشئ rdc server upgrade fork للمستودع كنقطة رجوع، ويضع الصورة الجديدة، ويعيد تطبيق القالب عندما يكون المضمَّن أحدث، ثم يعيد التشغيل. يقبل --image و--image-file و--local-image مثل التثبيت، فيُحدَّث الجهاز المعزول من ملف tar لصورة محفوظة.
صورة Docker
سحب الصورة المستقلة:
docker pull ghcr.io/rediacc/server:stable
التشغيل بالإعدادات الافتراضية:
docker run -p 80:80 -p 443:443 ghcr.io/rediacc/server:stable
تُقدم الصورة:
- Account API على
/account/api/v1/ - بوابة الويب على
/account/ - موقع التسويق على
/ - قطع أثر CLI على
/releases/ - ثنائيات Renet على
/bin/
تثبيت CLI من خادمك
ثبّت CLI مباشرةً من خادمك المحلي. يكتشف سكريبت التثبيت قناة التحديث تلقائياً ويُوجِّه CLI للتحقق من خادمك بحثاً عن التحديثات.
curl -fsSL https://account.example.com/install.sh | \
REDIACC_SERVER_URL=https://account.example.com bash
هذا الأمر الواحد يقوم بما يلي:
- تنزيل ثنائي CLI من نقطة نهاية
/releases/بخادمك - الاستعلام عن
/account/api/v1/.well-known/server-infoلاكتشاف قناة التحديث - كتابة التكوين الافتراضي (
rediacc.json) بعنوان URL للخادم وقناة التحديث ومفاتيح التشفير ضمن حقولaccount.*الخاصة به - تكوين
rdc updateللتحقق من خادمك للتحديثات المستقبلية
لا حاجة لمتغير REDIACC_CHANNEL. يقرأ سكريبت التثبيت القناة من تكوين خادمك تلقائياً.
تكوين CLI بالتكوينات المسماة
إذا كنت تتصل بخوادم متعددة (محلي، إنتاج، edge)، تُبقي التكوينات المسماة كل بيئة معزولة:
# Create a config for your on-premise server
rdc config init myserver --server https://account.example.com
# Log in using that config
rdc --config myserver subscription login
# All commands with --config use the on-premise server
rdc --config myserver machine status prod-1
يخزن كل تكوين مسمى عنوان URL لخادم الحساب الخاص به (ضمن حقول account.*) ورمز API الخاص بحسابه، محفوظاً بجانب التكوين في api-token-<name>.json. يُؤدي التبديل بين التكوينات إلى تبديل سياق الخادم بأكمله.
البيئات المعزولة عن الإنترنت
للبيئات التي لا تملك وصولاً إلى الإنترنت، اضبط عنوان URL للخادم وعنوان URL مخصص للإصدارات:
curl -fsSL https://account.example.com/install.sh | \
REDIACC_SERVER_URL=https://account.example.com \
REDIACC_RELEASES_URL=https://account.example.com/releases \
bash
سيتحقق CLI من account.example.com/releases/cli/stable/manifest.json للتحديثات بدلاً من شبكة CDN العامة للإصدارات.
إذا كان الخادم غير متصل بالإنترنت كلياً، ثبّت CLI عبر npm من حزمة tarball المجمّعة:
npm install -g https://account.example.com/npm/rediacc-cli-latest.tgz
مرجع متغيرات البيئة
| المتغير | يُستخدم بواسطة | الغرض |
|---|---|---|
REDIACC_SERVER_URL | سكريبت التثبيت | عنوان URL لخادم الحساب. يكتشف القناة ومفاتيح التشفير تلقائياً. |
REDIACC_RELEASES_URL | سكريبت التثبيت، مُحدِّث CLI | نقطة نهاية مخصصة للإصدارات لثنائيات CLI. الافتراضي: https://releases.rediacc.com |
REDIACC_CHANNEL | سكريبت التثبيت | تجاوز قناة التحديث. يتم الاكتشاف التلقائي من الخادم إذا لم يُضبط. |
REDIACC_ACCOUNT_SERVER | وقت تشغيل CLI | تجاوز عنوان URL لخادم الحساب لجميع أوامر CLI. |
REDIACC_UPDATE_CHANNEL | وقت تشغيل CLI | تجاوز قناة التحديث لـ rdc update. |
تكوين الخادم
تستخدم صورة Docker المحلية نفس متغير ENVIRONMENT الخاص بالخدمة المستضافة. اضبطه في بيئة Docker أو تكوين التنسيق:
ENVIRONMENT=production(الافتراضي): حدود موارد قياسية؛ تستخدم CLIs المتصلة بهذا الخادم قناة التحديث stable افتراضياً. اسم القيمةproductionهو معرف نشر قديم. كلاً منproductionوedgeبجودة الإنتاج.ENVIRONMENT=edge: ضعف حدود Community؛ تستخدم CLIs قناة التحديث edge افتراضياً
راجع قنوات الإصدار للاطلاع على تفاصيل ما توفره كل بيئة.
ما يخبرك به الخادم عن CLI
عند اتصال CLI بخادمك، يستعلم عن /.well-known/server-info لاكتشاف:
- مفتاح التشفير العام للتشفير الشامل: لتخزين التكوين بمعرفة صفرية
- الحد الأدنى لإصدار CLI: يمنع إصدارات CLI القديمة من الاتصال
- قناة التحديث: تُخبر CLI بقناة الإصدار التي يستخدمها للتحديثات
- البيئة: ملف تعريف النشر الذي يشغله الخادم (حدود قياسية مقابل edge بحدود 2X)
يعني هذا التكوين التلقائي أنك تحتاج فقط إلى عنوان URL للخادم. كل شيء آخر يُكتشف تلقائياً.
الترخيص لعمليات النشر المعزولة عن الإنترنت
تُصدر الخوادم المحلية والمستضاتة ذاتياً التراخيص محلياً باستخدام شهادة تفويض موقّعة من المفتاح الرئيسي الأعلى. تُقيّد الشهادة الخادم المحلي بحدود خطته وتُنشئ سلسلة مقاومة للتلاعب. راجع سلسلة التراخيص والتفويض للتصميم التشفيري (سلامة السلسلة، اكتشاف الشوكة، إثباتات التدقيق).
يغطي هذا القسم الإعداد التشغيلي: توليد المفاتيح وطلب الشهادة وتكوين التجديد التلقائي وتدفق التجديد دون إنترنت.
اشتراك واحد، تثبيت محلي واحد
قد يمتلك الاشتراك شهادة تفويض نشطة واحدة على الأكثر في أي وقت. يُطبق كل تثبيت محلي حدود الشهر والجهاز مقابل دفتر إصدار محلي خاص به، لذا فإن وجود شهادات نشطة متعددة سيضاعف الحصة الفعلية دون أي تسوية ممكنة.
إذا كنت بحاجة إلى بيئات منفصلة (إنتاج، تدريج، DR، متعدد المناطق)، اشترِ اشتراكاً واحداً لكل تثبيت. يُقنِّن إنفاذ الشهادة النشطة الواحدة هذا العقد: محاولة إنشاء شهادة ثانية نشطة تُعيد 409 DELEGATION_CERT_ALREADY_ACTIVE مع معرف الشهادة الموجودة وتعليمات للتجديد (مُفضَّل، يحافظ على السلسلة) أو الإلغاء والإنشاء (يُعيد ضبط السلسلة).
1. توليد زوج مفاتيح Ed25519 للخادم المحلي
يستخدم الخادم المحلي زوج مفاتيح Ed25519 منفصلاً للتوقيع على التراخيص. تُخوِّل شهادة التفويض من الخادم الأعلى هذا المفتاح العام المحدد.
# Generate a fresh keypair
openssl genpkey -algorithm Ed25519 -out onprem-private.pem
openssl pkey -in onprem-private.pem -pubout -out onprem-public.pem
# Convert to base64 (the format the on-premise expects in env vars)
ON_PREMISE_PRIVATE_KEY=$(openssl pkey -in onprem-private.pem -outform DER | base64 -w 0)
ON_PREMISE_PUBLIC_KEY=$(openssl pkey -in onprem-private.pem -pubout -outform DER | base64 -w 0)
احفظ المفتاح الخاص إلى جانب أسرارك الأخرى (مثل Docker secret أو Kubernetes Secret). لا يغادر الخادم المحلي أبداً.
2. طلب شهادة تفويض من الخادم الأعلى
يمكنك طلب الشهادة من بوابة الحساب الأعلى بثلاث طرق:
الخيار أ: الخدمة الذاتية للعميل (موصى به). سجّل الدخول إلى البوابة الأعلى بوصفك مالك أو admin للمؤسسة وانتقل إلى /account/delegation-certs. انقر على Create New، والصق المفتاح العام للخادم المحلي (base64 SPKI)، واختر فترة الصلاحية (أو اقبل الافتراضي لكل خطة)، ثم نزّل ملف .json الناتج.
الخيار ب: Admin (عبر العملاء). يمكن لدعم Rediacc أو مسؤول النظام الأعلى استخدام POST /admin/delegation-certs بنفس المعاملات.
الخيار ج: CLI rdc (مخطط). سيُغلِّف أمر CLI مستقبلي تدفق البوابة.
يبدو .json المُعاد كما يلي:
{
"payload": "eyJ2ZXJzaW9uIjoxLCJzdWJzY3JpcHRpb25JZCI6...",
"signature": "...",
"publicKeyId": "..."
}
تحكمها سياسة الصلاحية (إعدادات افتراضية وحدود قصوى لكل خطة، تجاوز لكل اشتراك، محدودة بنهاية الاشتراك بالإضافة إلى 3 أيام سماح). تتضمن الاستجابة أيضاً effectiveDays وreason لترى سبب اختياره لتلك القيمة. راجع سلسلة التراخيص - سياسة الصلاحية للاطلاع على القواعس الكاملة.
3. تثبيت الشهادة على الخادم المحلي
يقرأ الخادم شهادة التفويض من ملف واحد على وحدة بياناته، هو /data/delegation-cert.json (DELEGATION_CERT_PATH يحدد مساره). لا يحمل أي متغير بيئة الشهادة نفسها. يضع rdc server install الشهادة التي نزّلتها هناك، ثم يستبدلها rdc server licence لاحقًا:
rdc server install <domain> --cert delegation-cert.json
rdc server licence <domain> --cert delegation-cert.json
rdc server status <domain>
يسلّم الأمران الشهادة إلى الخادم العامل عبر صندوق وارد الشهادات (data/web/cert-inbox/new.json). يتحقق الخادم منها ويردّ بالملف applied.json أو rejected.json، ويؤكد الأمر معرّف الشهادة الجديدة عبر rdc server status (وهي بيانات cert-status نفسها في الخطوة 6). يستخدم rdc server upgrade صندوق الوارد نفسه. لم يعد الخادم يقرأ DELEGATION_CERT_BASE64: تنقل إحدى خطوات الترقية القيمة المتبقية في secrets.env إلى صندوق الوارد، فيحتفظ الجهاز المثبّت قبل وجود الصندوق بشهادته.
يحمّل الخادم الشهادة عند الإقلاع ويطابقها مع المفتاح الذي يوقّع به التراخيص: يجب أن تساوي بصمة مفتاح التوقيع بصمة delegatedPublicKey في الشهادة، لأن التراخيص الموقّعة بمفتاح لا تفوّضه الشهادة لا يمكن التحقق منها على أي جهاز. أبقِ زوج مفاتيح التوقيع وdelegatedPublicKey في الشهادة متطابقين.
الشهادة التي يرفضها الخادم عند الإقلاع (توقيع غير صالح، أو مفتاح خاطئ، أو غياب UPSTREAM_PUBLIC_KEY، أو ملف مشوّه) لا توقفه. يبدأ الخادم على الفئة المجانية وينقل الملف المعيب إلى delegation-cert.rejected.json بجانب الأصل. يردّ توقيع تراخيص المستودعات بالرمز 503 DELEGATION_CERT_REFUSED إلى أن توضع شهادة صالحة، ويعرض rdc server status الحالة cert REFUSED (reason). شغّل rdc server licence بشهادة صالحة لإصلاح ذلك. أما الشهادة المنتهية فتُحمَّل كالمعتاد: تتراجع وظائفها تدريجيًا بدل أن تُرفض.
4. تكوين التحقق الأعلى والتجديد التلقائي (اختياري لكن موصى به)
إذا كان الخادم المحلي يملك وصولاً HTTPS صادراً إلى الخادم الأعلى، اضبط التجديد التلقائي لكي تتجدد الشهادة قبل انتهاء الصلاحية دون تدخل يدوي:
# Required for /onprem/cert-upload to verify uploaded certs against the upstream master key.
# Fails-fast at boot if UPSTREAM_API_KEY is set without this.
UPSTREAM_PUBLIC_KEY="<upstream master Ed25519 SPKI public key, base64>"
# Required for the auto-renew loop. Mint via the portal:
# Org owner/admin → /account/delegation-certs → "Get auto-renew token"
# This is the ONLY way to obtain a delegation:renew-scoped api token.
UPSTREAM_URL="https://www.rediacc.com"
UPSTREAM_API_KEY="rdt_..."
# Optional tuning (defaults shown).
AUTO_RENEW_INTERVAL_HOURS=24
RENEW_THRESHOLD_DAYS=14
تعمل حلقة التجديد التلقائي للخادم المحلي مرةً واحدة عند الإقلاع ثم على الفاصل الزمني المكوَّن. تستخدم عتبة تكيفية (min(env.RENEW_THRESHOLD_DAYS, ceil(certValidityDays / 3))) بحيث تتجدد شهادة COMMUNITY لمدة 15 يوماً عند بقاء 5 أيام بدلاً من إطلاق التجديد في اليوم الأول. تتجدد شهادة BUSINESS لمدة 90 يوماً عند بقاء 14 يوماً (الحد المكوَّن في البيئة).
إذا فشل التجديد، تظل الشهادة مستخدمةً حتى انتهاء صلاحيتها الطبيعية. يتراجع الفشل لمدة ساعة واحدة ويُسجَّل في ${DELEGATION_CERT_PATH}.status.json ويُكشف عبر GET /onprem/cert-status.
5. التجديد المعزول عن الإنترنت (بدون HTTPS صادر)
إذا تعذَّر على الخادم المحلي الوصول إلى الخادم الأعلى، استخدم تدفق النقل اليدوي:
- نزّل طلب تجديد من بوابة مشرف الخادم المحلي. بوصفك جذر نظام الخادم المحلي، اطلب
GET /onprem/renewal-request. يُعيد هذا مانيفيست JSON يحتوي على رأس السلسلة المحلية والمفتاح العام المفوَّض وتوقيع Ed25519 مقاوم للتلاعب من مفتاحك الخاص المحلي. - انقل المانيفيست إلى الخادم الأعلى عبر USB أو البريد الإلكتروني المشفر أو أي قناة خارج النطاق. المانيفيست صغير (بضعة كيلوبايتات) ولا يحتوي على أسرار.
- عالج المانيفيست عند الخادم الأعلى. يفتح مالك أو admin المؤسسة /account/delegation-certs ثم Upload renewal request ويختار ملف المانيفيست. يتحقق الخادم الأعلى من توقيع المانيفيست مقابل
delegatedPublicKeyالخاص بالشهادة النشطة (يُثبت أنه جاء من حامل المفتاح الخاص المحلي)، ويتحقق من مكافحة الإعادة (تُرفض المانيفيستات الأقدم من 7 أيام)، ثم يُصدر شهادة جديدة. - نزّل الشهادة الجديدة من بوابة الخادم الأعلى كملف
.json. - انقل الشهادة مجدداً إلى الخادم المحلي.
- ارفع إلى الخادم المحلي عبر بوابة المشرف المحلية (
POST /onprem/cert-upload). يتحقق الخادم المحلي من الشهادة الجديدة مقابلUPSTREAM_PUBLIC_KEYويتحقق من أنgenesisSequenceللشهادة لا يزال يرتبط بإدخال سلسلة في دفتر الإصدار المحلي (يُدعم تقدم السلسلة أثناء النقل - السلسلة تمتد بشكل طبيعي).
هذه الحلقة بأكملها لا تتطلب أي خروج شبكي من الخادم المحلي.
أوضاع فشل المانيفيست
| الكود | السبب | الإصلاح |
|---|---|---|
NO_ACTIVE_CERT | لا توجد شهادة نشطة في الخادم الأعلى لهذا الاشتراك | أصدر شهادة جديدة عبر تدفق الإنشاء بدلاً من التجديد |
DELEGATED_KEY_MISMATCH | delegatedPublicKey للمانيفيست يختلف عن الشهادة النشطة | قد يكون المانيفيست إعادة تشغيل من تثبيت محلي مختلف |
MANIFEST_SIGNATURE_INVALID | التوقيع لا يتحقق مقابل المفتاح العام المفوَّض | تم العبث بالمانيفيست أثناء النقل، أو أنشأته على خادم محلي مختلف |
MANIFEST_EXPIRED | المانيفيست أقدم من 7 أيام | أنشئ طلب تجديد جديداً من الخادم المحلي |
أوضاع فشل رفع الشهادة
يُعيد POST /onprem/cert-upload عند النجاح {uploaded: true, bootstrap, certId}. أما الشهادة المرفوضة فيُعاد لها {error, code}، حيث يحمل error التفاصيل ويكون code أحد الأسباب المذكورة في الجدول أدناه. تُسجَّل كل شهادة مطبَّقة أو مرفوضة في السجل وتُرسل بالبريد إلى مالك الجهاز.
يضع rdc server licence الشهادة عبر SSH في صندوق الوارد الخاص بالجهاز (data/web/cert-inbox) ثم يقرأ applied.json أو rejected.json. بعد ذلك يؤكد معرّف الشهادة الجديدة عبر cert-status. وتحمل حالة الرفض الأسباب نفسها، إضافةً إلى not-a-regular-file وtoo-large اللذين يصدران عن صندوق الوارد نفسه.
| الرمز | HTTP | السبب |
|---|---|---|
malformed | 400 | الملف المرفوع ليس شهادة صالحة |
bad-signature | 400 | الشهادة غير موقَّعة بـ UPSTREAM_PUBLIC_KEY المُعدّ |
wrong-key | 400 | صدرت الشهادة لمفتاح مختلف عن مفتاح هذا النشر المحلي |
expired | 400 | تجاوزت الشهادة تاريخ validUntil الخاص بها |
not-newer | 409 | الشهادة ليست أحدث من الشهادة السارية |
other-subscription | 409 | الشهادة تخص اشتراكًا آخر |
chain-ahead | 409 | genesisSequence للشهادة متقدم على رأس السلسلة المحلية |
chain-fork | 409 | تجزئة السلسلة عند genesisSequence للشهادة لا تتطابق مع دفتر الأستاذ المحلي |
no-upstream-key | 500 | UPSTREAM_PUBLIC_KEY غير مُعدّ |
write-failed | 500 | تعذّرت كتابة الشهادة على القرص |
adoption-failed | 500 | تعذّر على الخادم تحميل الشهادة المكتوبة |
للخطأ bad-signature، تحقق من تطابق UPSTREAM_PUBLIC_KEY مع المفتاح العام الرئيسي للخادم الأعلى. وللخطأ no-upstream-key، اضبط UPSTREAM_PUBLIC_KEY.
6. الحالة والمراقبة
استعلم عن حالة الشهادة المحلية للخادم المحلي في أي وقت:
curl https://onprem.example.com/account/api/v1/onprem/cert-status \
-H "Cookie: <admin session>"
يُعيد subscriptionId وplanCode وvalidUntil وdaysUntilExpiry للشهادة المحملة، بالإضافة إلى كتلة autoRenew (enabled وlastSuccessAt وlastErrorAt وlastError). وصّل هذا بمنظومة المراقبة الخاصة بك لتنبيهك عند lastSuccessAt قديمة أو lastError غير فارغة.
للنسخ الاحتياطي والتدقيق، يمكن لمشرف الخادم المحلي أيضاً تنزيل الشهادة الموقّعة المحملة حالياً عبر GET /onprem/cert-current (يتطلب جلسة مرتفعة الصلاحيات).
مرجع متغيرات بيئة شهادة التفويض
| المتغير | مطلوب؟ | الغرض |
|---|---|---|
ON_PREMISE_MODE | نعم | اضبطه على true لتمكين مجموعة مسارات الخادم المحلي |
ON_PREMISE_PRIVATE_KEY | نعم | مفتاح خاص Ed25519 بتنسيق PKCS8 base64 للتوقيع المفوَّض |
ON_PREMISE_PUBLIC_KEY | نعم | مفتاح عام Ed25519 بتنسيق SPKI base64 (يجب أن يتطابق مع delegatedPublicKey في الشهادة) |
DELEGATION_CERT_PATH | اختياري | مسار نظام الملفات لملف JSON للشهادة الموقّعة. الافتراضي /data/delegation-cert.json على وحدة البيانات. استبدل الشهادة بالأمر rdc server licence لا يدويًا. |
UPSTREAM_PUBLIC_KEY | مطلوب إذا ضُبط UPSTREAM_API_KEY، أو لعمل /onprem/cert-upload | بتنسيق SPKI base64 للمفتاح العام الرئيسي للخادم الأعلى. بدونه يرفض الخادم كل شهادة عند الإقلاع (no-upstream-key) ويعمل بالباقة المجانية، كما تصف الخطوة 3. |
UPSTREAM_URL | للتجديد التلقائي | عنوان URL الأساسي لخادم الحساب الأعلى، مثل https://www.rediacc.com |
UPSTREAM_API_KEY | للتجديد التلقائي | رمز API بنطاق delegation:renew. احصل عليه عبر البوابة - انظر الخطوة 4. |
AUTO_RENEW_INTERVAL_HOURS | اختياري | الافتراضي 24. مدة التحقق من حاجة الشهادة للتجديد. |
RENEW_THRESHOLD_DAYS | اختياري | الافتراضي 14. يعمل كحد أقصى على عتبة الثلث التكيفية. |
ملخص نموذج التهديد
يدافع نموذج شهادة التفويض ضد:
- التراخيص المزوّرة: لا يستطيع الخادم المحلي التوقيع إلا ضمن حدود خطته؛ يرفض renet أي شيء خارج حدود الشهادة.
- مشاركة الشهادة عبر عمليات النشر: يُكتشف تباعد السلسلة عند التجديد (يُعيد
CHAIN_FORK_DETECTED). - تجاوز الحصة عبر التثبيت المتعدد: يُطبَّق عند الخادم الأعلى بواسطة الشهادة النشطة الواحدة (شهادة واحدة لكل اشتراك).
- التراجع عن السلسلة: يخزن renet أعلى تسلسل شوهد لكل اشتراك ويرفض أي كتلة برقم تسلسل أدنى.
- اعتراض اعتمادات الخادم الأعلى: رمز
delegation:renewللبوتسراب قابل لإصداره فقط عبر نقطة نهاية البوابة المخصصة ومحمي بصلاحيات admin. يمنح الرمز التجديد فقط - لا يمكنه قراءة أو تعديل أي مورد آخر. - هجمات إعادة التشغيل على المانيفيستات: تُرفض المانيفيستات الأقدم من 7 أيام.
ما لا يدافع ضده:
- المفتاح الخاص المحلي المخترق: يتيح المفتاح المسرَّب لمهاجم التوقيع على التراخيص حتى
validUntilالشهادة. التخفيف: دوِّر زوج المفاتيح (ألغِ الشهادة القديمة وأنشئ جديدة بمفتاح جديد) وعامل جميع التراخيص الموقّعة بالمفتاح القديم باعتبارها مشبوهة. - المفتاح الرئيسي للخادم الأعلى المخترق: هذا هو جذر الثقة. إجراءات التدوير خارج نطاق هذه الصفحة.