Aşağıdaki örneklerde, hizmet hesabınızla bir jeton edindiğiniz varsayılır:
TOKEN=$(gcloud auth print-access-token)
Ayrıca, ${CLIENT_PROJECT} hizmetini Google Cloud projesinin proje kimliğine ayarladığınızı varsayıyoruz.
Mevcut müşterileri listeleme
Aşağıdaki komut, arayanın erişebildiği tüm müşterileri döndürür:
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"
Kolaylık sağlaması açısından, bir değişkene döndürülen Müşteri adını kaydedin:
CUSTOMER_NAME=customers/...
Yeni cihaz yapılandırması oluşturma
Öncelikle, oluşturmak istediğiniz cihazın ${FCCID} ve ${SN} özelliklerini ayarlayın:
FCCID=f1 SN=sn1
Ardından, aşağıdaki komutu kullanarak cihaz yapılandırmasını oluşturun:
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\"}}"
Komut, yeni oluşturulmuş bir cihaz yapılandırması döndürür. Kolaylık olması için cihaz adını bir değişkene kaydedin:
DEVICE_NAME=customers/.../devices/...
Mevcut cihazları listeleme
Aşağıdaki komut mevcut cihazları listeler.
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"
Cihazı ada göre al
Aşağıdaki komut, cihazları ada göre alır.
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}"
Mevcut cihazı güncelleyin
Aşağıdaki komut mevcut cihazları günceller.
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}" \
YBM kimliğinizi ve sertifikanızı doğrulama
Gizli dizeyi oluşturmak için aşağıdaki örneği kullanın:
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 "{}"
Bu, aşağıdaki biçimde bir değer döndürür:
{
"secret": "<generated secret>"
}
Gizli dize, bir JWT olarak kodlanmalıdır. JSON Web Jetonu biçimini kullanın. ${SECRET} özelliğini gizli dizeye, ${ENCODED_SECRET}'yi JWT dizesine ve ${CPI_ID} değerini YBM'nin kimliğine ayarladığınızı varsayıyoruz.
Aşağıdaki komut, YBM'nin kimliğini ve sertifikasını doğrular.
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}\" }"
YBM, gerekli tüm parametrelere sahip bir CBSD dosyası yükleyebilir.
Çok adımlı CBSD kaydı
Aşağıdaki iki bölümde ele alınan çok adımlı CBSD kaydını gerçekleştirmenin iki yolu vardır: Daha önce bir YBM veya YBM hesabı tarafından imzalanmış parametrelerle çok adımlı CBSD kaydı gerçekleştirebilirsiniz.
Daha önce YBM tarafından imzalanmış cihaz parametreleriyle
Bu örnekte, önceden YBM tarafından kodlanan CBSD yükleme parametreleriyle etkin olmayan bir cihaz yapılandırmasının nasıl oluşturulacağı gösterilmektedir. Böylece yapılandırma, YBM olmayan kullanıcılar tarafından bile oluşturulabilir.
CBSD parametrelerini kodlamak için YBM'nin özel anahtarını kullanın. Bunun için JSON Web Jetonu biçimini kullanırız.
${ENCODED_DEVICE} öğesini JWT dizesine ve ${CPI_ID} özelliğini YBM kimliğine ayarladığınızı varsayıyoruz.
Etkin olmayan cihaz yapılandırması aşağıdaki komutla oluşturulabilir:
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}\" }"
Ardından CBSD, kaydını tamamlamak için SAS'ye kayıt isteği göndermelidir.
YBM hesabı ile
Cihaz yapılandırmasını doğrulamaya çalışmadan önce YBM'nin kimliği doğrulanmalıdır. Bu işlem tamamlandığında, etkin olmayan bir cihaz yapılandırması oluşturmak için aşağıdaki komutu kullanın:
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} öğesini, CBSD kayıt parametrelerinin JSON gösterimi olarak bu biçimde ayarladığınızı varsayıyoruz.
Ardından CBSD, kaydını tamamlamak için SAS'ye kayıt isteği göndermelidir.