ตัวอย่าง

ในตัวอย่างต่อไปนี้ เราถือว่าคุณได้รับโทเค็นกับบัญชีบริการแล้ว

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}\" }"

ตอนนี้ CPI มีความสามารถในการติดตั้ง CBSD ที่มีพารามิเตอร์ที่จําเป็นทั้งหมดได้แล้ว

การลงทะเบียน CBSD แบบหลายขั้นตอน

คุณสามารถลงทะเบียน CBSD แบบหลายขั้นตอนได้ 2 วิธี ดังนี้ คุณสามารถดําเนินการลงทะเบียน CBSD แบบหลายขั้นตอนได้โดยใช้พารามิเตอร์ที่ลงนามโดย CPI ก่อนหน้านี้หรือบัญชี 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 เพื่อดําเนินการลงทะเบียนให้เสร็จสมบูรณ์