النماذج

في الأمثلة التالية، نفترض أنّك حصلت على رمز مميّز باستخدام حساب الخدمة:

TOKEN=$(gcloud auth print-access-token)

نفترض أيضًا أنّك سبق أن ضبطت ${CLIENT_PROJECT} على معرّف مشروع Google Cloud.

قائمة العملاء الحاليين

يعرض الأمر التالي جميع العملاء الذين يمكن للمتصل الوصول إليهم:

curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" \"https://sasportal.googleapis.com/v1alpha1/customers"

لتسهيل الأمر، احفظ اسم العميل الذي تم إرجاعه في متغيّر:

CUSTOMER_NAME=customers/...

إنشاء إعدادات جهاز جديدة

أولاً، اضبط ${FCCID} و${SN} للجهاز الذي تريد إنشاءه:

FCCID=f1
SN=sn1

بعد ذلك، أنشئ إعدادات الجهاز باستخدام الأمر التالي:

curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices" \
  -d "{ \"fcc_id\": \"$FCCID\", \"serial_number\": \"$SN\", \"preloaded_config\": { \"call_sign\": \"cs1\", \"category\": \"DEVICE_CATEGORY_A\"}}"

يعرض الأمر إعدادات جهاز تم إنشاؤها حديثًا. لتسهيل الأمر، احفظ اسم الجهاز في متغيّر:

DEVICE_NAME=customers/.../devices/...

عرض قائمة الأجهزة الحالية

يسرد الأمر التالي الأجهزة الحالية.

curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices"

استرداد الجهاز حسب الاسم

يسترد الأمر التالي الأجهزة حسب الاسم.

curl -X GET -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}"

تعديل جهاز حالي

يعدّل الأمر التالي الأجهزة الحالية.

curl -X PATCH -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}" \

التحقّق من صحة هوية CPI وشهادتها

استخدِم المثال التالي لإنشاء سلسلة المفتاح السري:

curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/installer:generateSecret" \
  -d "{}"

يُرجع هذا التعبير قيمة بالشكل التالي:

{
  "secret": "<generated secret>"
}

يجب بعد ذلك ترميز السلسلة السرية إلى رمز JWT. استخدِم تنسيق رمز JSON المميّز للويب. نفترض أنّك ضبطت ${SECRET} على السلسلة السرية، و${ENCODED_SECRET} على سلسلة JWT، و${CPI_ID} على رقم تعريف CPI المطلوب التحقّق من صحته.

يتحقّق الأمر التالي من هوية CPI وشهادتها.

curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/installer:validate" \
  -d "{ \"installer_id\": \"${CPI_ID}\", \"secret\": \"${SECRET}\", \"encoded_secret\": \"${ENCODED_SECRET}\" }"

يمكن الآن للمثبّت المعتمد تثبيت جهاز CBSD يتضمّن جميع المَعلمات المطلوبة.

تسجيل أجهزة CBSD المتعدد الخطوات

هناك طريقتان لتنفيذ عملية تسجيل أجهزة CBSD المتعدّدة الخطوات، وهما موضّحتان في القسمَين التاليَين. يمكنك إجراء عملية تسجيل CBSD متعددة الخطوات باستخدام مَعلمات سبق أن وقّع عليها CPI أو باستخدام حساب CPI.

مع مَعلمات الجهاز التي وقّع عليها سابقًا موفّر خدمة معتمد

يوضّح هذا النموذج كيفية إنشاء إعدادات جهاز غير نشطة مع مَعلمات تثبيت CBSD سبق أن ترميزها بواسطة CPI، وبالتالي يمكن إنشاء الإعدادات حتى من قِبل المستخدمين غير التابعين لـ CPI. استخدِم المفتاح الخاص لـ CPI لترميز مَعلمات CBSD. نستخدم تنسيق رمز JSON المميّز للويب لإجراء ذلك. نفترض أنّك ضبطت ${ENCODED_DEVICE} على سلسلة JWT و${CPI_ID} على معرّف CPI.

يمكن بعد ذلك إنشاء إعداد الجهاز غير النشط باستخدام الأمر التالي:

curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${TOKEN}" \ "https://sasportal.googleapis.com/v1alpha1/${CUSTOMER_NAME}/devices:createSigned" \
  -d "{ \"installer_id\": \"${CPI_ID}\", \"encoded_device\": \"${ENCODED_DEVICE}\", \"parent\": \"${CUSTOMER_NAME}\" }"

بعد ذلك، يجب أن يرسل جهاز CBSD طلب تسجيل إلى نظام SAS لإكمال عملية التسجيل.

باستخدام حساب CPI

أولاً، يجب إثبات هوية CPI قبل محاولة إثبات صحة إعدادات الجهاز. بعد الانتهاء، استخدِم الأمر التالي لإنشاء إعدادات جهاز غير نشط:

curl -X POST -H "X-Goog-User-Project: ${CLIENT_PROJECT}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \ "https://sasportal.googleapis.com/v1alpha1/${DEVICE_NAME}:signDevice" \
  -d "${DEVICE}"

نفترض أنّك ضبطت ${DEVICE} ليكون تمثيلاً بتنسيق JSON لمعلَمات تسجيل CBSD بهذا التنسيق.

بعد ذلك، يجب أن يرسل جهاز CBSD طلب تسجيل إلى نظام SAS لإكمال عملية التسجيل.