تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
وفقًا لمتطلبات WInnForum، تتطلب بعض أنظمة CBSD أن يتحقق برنامج تثبيت المهنة المعتمَدة (CCPA) من معلّمات التثبيت قبل إرسالها إلى اتفاقية الخدمة العامة.
الشكل 1. مسار التحقّق من هوية التكلفة لكل تثبيت
في واجهة برمجة تطبيقات بوابة SAS، علينا التحقّق من أن المستخدم المعيّن لديه شهادة صالحة للتكلفة لكل تثبيت حتى يتمكّن من استدعاء الطريقة
SignDevice(). ويتم تحقيق ذلك باستخدام طريقة التحقق بخطوتين التالية:
يطلب مستخدم لديه دور role_cpi طريقة
GenerateSecret()
التي تعرض سرًّا.
يوقّع المستخدم السر باستخدام مفتاحه الخاص ويستخدم طريقة
ValidateInstaller()
لإعادة إرسال النسخة المشفّرة
كـ JWT، بالإضافة إلى رقم تعريف التكلفة لكل تثبيت
والسر الأصلي. لمزيد من التفاصيل حول إنشاء الرمز المميّز، يمكنك الاطّلاع على
تنسيق الرمز المميّز للويب JSON.
لا تصبح امتيازات دور التكلفة لكل تثبيت سارية إلا بعد إكمال المستخدم الذي لديه دور role_cpi
عملية التحقّق من صحة التكلفة لكل تثبيت.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCertain CBSDs require Certified Professional Installer (CPI) validation before installation parameters are sent to the Spectrum Access System (SAS).\u003c/p\u003e\n"],["\u003cp\u003eCPI validation is a two-step process involving secret generation and JWT-based signature validation using the CPI's private key.\u003c/p\u003e\n"],["\u003cp\u003eUsers with the \u003ccode\u003erole_cpi\u003c/code\u003e role must successfully complete the CPI validation flow to gain CPI privileges within the SAS Portal API.\u003c/p\u003e\n"]]],["Certified Professional Installers (CPIs) must validate installation parameters for certain CBSDs. The process involves two steps via the SAS Portal API: First, a user with `role_cpi` obtains a secret using `GenerateSecret()`. Second, they sign the secret with their private key and submit it via `ValidateInstaller()`, along with their CPI ID, using a JWT. This validates the CPI's identity, granting them CPI role privileges, enabling them to use the `SignDevice()` method. The user must be logged in and use HTTPS.\n"],null,["# Validation of CPI identity\n\nAccording to the WInnForum requirements, certain CBSDs require that a Certified Professional\nInstaller (CPI) validates the installation parameters before they are sent to the SAS.\n**Figure 1.** CPI identity validation flow\n\nIn the SAS Portal API, we need to validate that a given user has a valid CPI certification before\nthey can call the\n[`SignDevice()`](/spectrum-access-system/reference/rest/customers.devices/signDevice)\nmethod. We achieve this with the following two-step validation method:\n\n1. A user with the `role_cpi` role calls the [`GenerateSecret()`](/spectrum-access-system/reference/rest/customers.devices/generateSecret) method, which returns a secret.\n2. The user signs the secret with their private key and uses the [`ValidateInstaller()`](/spectrum-access-system/reference/rest/customers.devices/validate) method to send the encoded version back as a [JWT](https://jwt.io/), along with their CPI ID and the original secret. For more details about token creation, see [JSON Web Token format](/spectrum-access-system/guides/json-web-token-format).\n\n| **Note:** For the prior steps, it's assumed that the user is logged in with their Google Account, and the traffic uses HTTPS.\n\nThe CPI role privileges become effective only after a user with the `role_cpi` role\nsuccessfully completes the CPI validation flow."]]