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