انتقل إلى المحتوى الرئيسي انتقل إلى الملاحة انتقل إلى التذييل

التثبيت المحلي

تشغيل خادم الحساب وتوزيع CLI على بنيتك التحتية الخاصة.

يمكن تشغيل 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 الهدف عندما لا يحتفظ الجهاز بسجل تثبيت للنطاق.

التحديثات

المكوّنالأمر
CLIrdc 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

هذا الأمر الواحد يقوم بما يلي:

  1. تنزيل ثنائي CLI من نقطة نهاية /releases/ بخادمك
  2. الاستعلام عن /account/api/v1/.well-known/server-info لاكتشاف قناة التحديث
  3. كتابة التكوين الافتراضي (rediacc.json) بعنوان URL للخادم وقناة التحديث ومفاتيح التشفير ضمن حقول account.* الخاصة به
  4. تكوين 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 بشهادة صالحة لإصلاح ذلك. أما الشهادة المنتهية فتُحمَّل كالمعتاد: تتراجع وظائفها تدريجيًا بدل أن تُرفض.

إذا كان الخادم المحلي يملك وصولاً 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 صادر)

إذا تعذَّر على الخادم المحلي الوصول إلى الخادم الأعلى، استخدم تدفق النقل اليدوي:

  1. نزّل طلب تجديد من بوابة مشرف الخادم المحلي. بوصفك جذر نظام الخادم المحلي، اطلب GET /onprem/renewal-request. يُعيد هذا مانيفيست JSON يحتوي على رأس السلسلة المحلية والمفتاح العام المفوَّض وتوقيع Ed25519 مقاوم للتلاعب من مفتاحك الخاص المحلي.
  2. انقل المانيفيست إلى الخادم الأعلى عبر USB أو البريد الإلكتروني المشفر أو أي قناة خارج النطاق. المانيفيست صغير (بضعة كيلوبايتات) ولا يحتوي على أسرار.
  3. عالج المانيفيست عند الخادم الأعلى. يفتح مالك أو admin المؤسسة /account/delegation-certs ثم Upload renewal request ويختار ملف المانيفيست. يتحقق الخادم الأعلى من توقيع المانيفيست مقابل delegatedPublicKey الخاص بالشهادة النشطة (يُثبت أنه جاء من حامل المفتاح الخاص المحلي)، ويتحقق من مكافحة الإعادة (تُرفض المانيفيستات الأقدم من 7 أيام)، ثم يُصدر شهادة جديدة.
  4. نزّل الشهادة الجديدة من بوابة الخادم الأعلى كملف .json.
  5. انقل الشهادة مجدداً إلى الخادم المحلي.
  6. ارفع إلى الخادم المحلي عبر بوابة المشرف المحلية (POST /onprem/cert-upload). يتحقق الخادم المحلي من الشهادة الجديدة مقابل UPSTREAM_PUBLIC_KEY ويتحقق من أن genesisSequence للشهادة لا يزال يرتبط بإدخال سلسلة في دفتر الإصدار المحلي (يُدعم تقدم السلسلة أثناء النقل - السلسلة تمتد بشكل طبيعي).

هذه الحلقة بأكملها لا تتطلب أي خروج شبكي من الخادم المحلي.

أوضاع فشل المانيفيست

الكودالسببالإصلاح
NO_ACTIVE_CERTلا توجد شهادة نشطة في الخادم الأعلى لهذا الاشتراكأصدر شهادة جديدة عبر تدفق الإنشاء بدلاً من التجديد
DELEGATED_KEY_MISMATCHdelegatedPublicKey للمانيفيست يختلف عن الشهادة النشطةقد يكون المانيفيست إعادة تشغيل من تثبيت محلي مختلف
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السبب
malformed400الملف المرفوع ليس شهادة صالحة
bad-signature400الشهادة غير موقَّعة بـ UPSTREAM_PUBLIC_KEY المُعدّ
wrong-key400صدرت الشهادة لمفتاح مختلف عن مفتاح هذا النشر المحلي
expired400تجاوزت الشهادة تاريخ validUntil الخاص بها
not-newer409الشهادة ليست أحدث من الشهادة السارية
other-subscription409الشهادة تخص اشتراكًا آخر
chain-ahead409genesisSequence للشهادة متقدم على رأس السلسلة المحلية
chain-fork409تجزئة السلسلة عند genesisSequence للشهادة لا تتطابق مع دفتر الأستاذ المحلي
no-upstream-key500UPSTREAM_PUBLIC_KEY غير مُعدّ
write-failed500تعذّرت كتابة الشهادة على القرص
adoption-failed500تعذّر على الخادم تحميل الشهادة المكتوبة

للخطأ 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 الشهادة. التخفيف: دوِّر زوج المفاتيح (ألغِ الشهادة القديمة وأنشئ جديدة بمفتاح جديد) وعامل جميع التراخيص الموقّعة بالمفتاح القديم باعتبارها مشبوهة.
  • المفتاح الرئيسي للخادم الأعلى المخترق: هذا هو جذر الثقة. إجراءات التدوير خارج نطاق هذه الصفحة.