Örnekler

Aşağıdaki örneklerde, hizmet hesabınızla jeton aldığınızı varsayıyoruz:

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

Ayrıca, ${CLIENT_PROJECT} değerini Google Cloud projesinin proje kimliği olarak 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 olması için döndürülen müşteri adını bir değişkene kaydedin:

CUSTOMER_NAME=customers/...

Yeni cihaz yapılandırması oluşturma

Öncelikle, oluşturmak istediğiniz cihazın ${FCCID} ve ${SN} değerlerini 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\"}}"

Bu komut, yeni oluşturulan bir cihaz yapılandırmasını döndürür. Kolaylık sağlaması 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ı adına göre alma

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üncelleme

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

CPI 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 işlev, aşağıdaki biçimde bir değer döndürür:

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

Gizli dize daha sonra JWT'ye kodlanmalıdır. JSON Web Token biçimini kullanın. ${SECRET} değerini gizli dizeye, ${ENCODED_SECRET} değerini JWT dizesine ve ${CPI_ID} değerini doğrulanacak CPI'nin kimliğine ayarladığınızı varsayıyoruz.

Aşağıdaki komut, CPI'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}\" }"

CPI artık gerekli tüm parametrelere sahip bir CBSD yükleyebilir.

Çok adımlı CBSD kaydı

Aşağıdaki iki bölümde, çok adımlı CBSD kaydı gerçekleştirmenin iki yolu açıklanmaktadır. Daha önce CPI tarafından imzalanmış parametrelerle veya CPI hesabı ile çok adımlı CBSD kaydı gerçekleştirebilirsiniz.

Daha önce bir CPI tarafından imzalanmış cihaz parametreleriyle

Bu örnekte, daha önce bir CPI tarafından kodlanmış CBSD yükleme parametreleriyle etkin olmayan bir cihaz yapılandırmasının nasıl oluşturulacağı gösterilmektedir. Böylece, yapılandırma CPI olmayan kullanıcılar tarafından da oluşturulabilir. CBSD parametrelerini kodlamak için CPI'nın özel anahtarını kullanın. Bunu yapmak için JSON Web Token biçimini kullanırız. ${ENCODED_DEVICE} değerini JWT dizesine ve ${CPI_ID} değerini CPI'nin kimliğine ayarladığınızı varsayıyoruz.

Etkin olmayan cihaz yapılandırması daha sonra 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'a bir kayıt isteği göndermelidir.

CPI hesabı ile

Öncelikle, bir cihaz yapılandırmasını doğrulamaya çalışmadan önce CPI'nin kimliği doğrulanmalıdır. Bu işlem tamamlandıktan sonra, 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} değerinin, bu biçimde CBSD kaydı parametrelerinin JSON gösterimi olduğunu varsayıyoruz.

Ardından CBSD, kaydını tamamlamak için SAS'a bir kayıt isteği göndermelidir.