Sampel

Pada contoh berikut, kami asumsikan Anda telah mendapatkan token dengan akun layanan:

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

Kami juga berasumsi bahwa Anda telah menyetel ${CLIENT_PROJECT} ke project ID dari Project Google Cloud.

Mencantumkan pelanggan saat ini

Perintah berikut menampilkan semua pelanggan yang dapat diakses oleh pemanggil:

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"

Untuk memudahkan, simpan nama Pelanggan yang ditampilkan ke variabel:

CUSTOMER_NAME=customers/...

Membuat konfigurasi perangkat baru

Pertama, setel ${FCCID} dan ${SN} perangkat yang ingin Anda buat:

FCCID=f1
SN=sn1

Kemudian, buat konfigurasi perangkat dengan perintah berikut:

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

Perintah tersebut menampilkan konfigurasi perangkat yang baru dibuat. Untuk memudahkan, simpan nama perangkat ke dalam variabel:

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

Mencantumkan perangkat saat ini

Perintah berikut mencantumkan perangkat yang ada.

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"

Ambil perangkat berdasarkan nama

Perintah berikut mengambil perangkat berdasarkan nama.

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

Update perangkat yang ada

Perintah berikut akan memperbarui perangkat yang ada.

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

Memvalidasi identitas dan sertifikasi CPI Anda

Gunakan contoh berikut untuk membuat string rahasia:

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

Tindakan ini akan menampilkan nilai dengan formulir berikut:

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

String rahasia kemudian harus dienkode ke dalam JWT. Gunakan format Token Web JSON. Kami berasumsi bahwa Anda telah menetapkan ${SECRET} ke string rahasia, ${ENCODED_SECRET} ke string JWT, dan ${CPI_ID} ke ID CPI untuk divalidasi.

Perintah berikut memvalidasi identitas dan sertifikasi 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 kini memiliki kemampuan untuk menginstal CBSD yang memiliki semua parameter yang diperlukan.

Pendaftaran CBSD multi-langkah

Ada dua cara untuk melakukan pendaftaran CBSD multi-langkah yang dibahas di dua bagian berikut. Anda dapat melakukan pendaftaran CBSD multi-langkah dengan parameter yang sebelumnya ditandatangani oleh CPI atau dengan akun CPI.

Dengan parameter perangkat yang sebelumnya ditandatangani oleh CPI

Contoh ini menunjukkan cara membuat konfigurasi perangkat yang tidak aktif dengan parameter penginstalan CBSD yang sebelumnya dienkode oleh CPI, sehingga konfigurasi dapat dibuat bahkan oleh pengguna non-CPI. Gunakan kunci pribadi CPI untuk mengenkode parameter CBSD. Kami menggunakan format Token Web JSON untuk melakukannya. Kami mengasumsikan bahwa Anda telah menetapkan ${ENCODED_DEVICE} ke string JWT dan ${CPI_ID} ke ID CPI.

Konfigurasi perangkat yang tidak aktif selanjutnya dapat dibuat dengan perintah berikut:

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 kemudian harus mengirimkan permintaan pendaftaran ke SAS untuk menyelesaikan pendaftarannya.

Dengan akun CPI

Pertama, identitas CPI harus divalidasi sebelum Anda mencoba memvalidasi konfigurasi perangkat. Setelah itu, gunakan perintah berikut untuk membuat konfigurasi perangkat yang tidak aktif:

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

Kami berasumsi bahwa Anda telah menetapkan ${DEVICE} sebagai representasi JSON dari parameter pendaftaran CBSD dalam format ini.

CBSD kemudian harus mengirimkan permintaan pendaftaran ke SAS untuk menyelesaikan pendaftarannya.