דוגמאות

בדוגמאות הבאות אנחנו מניחים שכבר קיבלתם אסימון באמצעות חשבון השירות שלכם:

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 Web Token. אנחנו מניחים שהגדרתם את ${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}\" }"

ל-CPI יש עכשיו אפשרות להתקין CBSD עם כל הפרמטרים הנדרשים.

הרשמה רבת-שלבים של CBSD

יש שתי דרכים לבצע רישום של מכשירי CBSD עם כמה שלבים, והן מפורטות בשני הקטעים הבאים. אפשר לבצע רישום של CBSD בכמה שלבים עם פרמטרים שנחתמו בעבר על ידי CPI או עם חשבון CPI.

באמצעות פרמטרים של מכשיר שנחתמו בעבר על ידי CPI

בדוגמה הזו מוצג איך ליצור הגדרת מכשיר לא פעילה עם פרמטרים של התקנת CBSD שקודדו בעבר על ידי CPI, כך שאפשר ליצור את ההגדרה גם על ידי משתמשים שאינם CPI. משתמשים במפתח הפרטי של ה-CPI כדי לקודד את הפרמטרים של ה-CBSD. אנחנו משתמשים בפורמט JSON Web Token כדי לעשות את זה. אנחנו מניחים שהגדרתם את ${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 כדי להשלים את הרישום שלו.