דוגמאות

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

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

אנחנו גם מניחים שכבר הגדרת את ${CLIENT_PROJECT} כמזהה הפרויקט ב-Google Cloud Project.

הצגת רשימת הלקוחות הנוכחיים

הפקודה הבאה מחזירה את כל הלקוחות שיש למתקשר גישה אליהם:

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)

הדוגמה הבאה מראה איך ליצור הגדרה לא פעילה של מכשיר באמצעות פרמטרים של התקנת CBSD שמקודדים בעבר על ידי CPI, כך שניתן ליצור את התצורה גם על ידי משתמשים שלא משתמשים בעלות להתקנה. צריך להשתמש במפתח הפרטי מסוג CPI&#39 כדי לקודד את הפרמטרים של CBSD. לשם כך אנחנו משתמשים בפורמט אסימון אינטרנט של JSON. אנחנו מגדירים שהגדרת את המחרוזת ${ENCODED_DEVICE} למחרוזת JWT ואת הערך ${CPI_ID} עבור מזהה העלות להתקנה.

לאחר מכן אפשר ליצור את תצורת המכשיר הלא פעילה באמצעות הפקודה הבאה:

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

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

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 כדי להשלים את הרישום.