Przykłady

W poniższych przykładach założymy, że masz już token do konta usługi:

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

Zakładamy też, że identyfikator projektu w Google Cloud jest już ustawiony na ${CLIENT_PROJECT}.

Podaj listę obecnych klientów

To polecenie zwraca wszystkich klientów, do których ma dostęp rozmówca:

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"

Dla wygody zapisz nazwę klienta, która została zwrócona w zmiennej:

CUSTOMER_NAME=customers/...

Utwórz nową konfigurację urządzenia

Najpierw ustaw ${FCCID} i ${SN} urządzenia, które chcesz utworzyć:

FCCID=f1
SN=sn1

Następnie utwórz konfigurację urządzenia za pomocą tego polecenia:

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

To polecenie zwraca nowo utworzoną konfigurację urządzenia. Dla wygody zapisz nazwę urządzenia w zmiennej:

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

Wyświetl listę bieżących urządzeń

Następujące polecenie zawiera listę istniejących urządzeń.

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"

Pobierz urządzenie według nazwy

Następujące polecenie pobiera urządzenia według nazwy.

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

Zaktualizuj dotychczasowe urządzenie

Następujące polecenie aktualizuje istniejące urządzenia.

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

Potwierdź swoją tożsamość i certyfikat CPI

Aby wygenerować tajny ciąg znaków, użyj tego przykładu:

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

Zwraca wartość w następującym formacie:

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

Tajny ciąg znaków musi zostać zakodowany w tokenie JWT. Użyj formatu tokena internetowego JSON. Przyjmijmy, że jako ${SECRET} masz ustawiony tajny ciąg znaków, ${ENCODED_SECRET} jako ciąg JWT, a ${CPI_ID} na identyfikator CPI, aby zweryfikować.

Poniższe polecenie pozwala zweryfikować tożsamość i certyfikat 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 może teraz instalować CBSD, które zawiera wszystkie wymagane parametry.

Wieloetapowa rejestracja domeny CBSD

Wieloetapową rejestrację CBSD można przeprowadzić na 2 sposoby w sekcjach opisanych poniżej. Możesz przeprowadzić wieloetapową rejestrację zarządzania przeglądarką Chrome w chmurze z parametrami podpisanymi wcześniej przez CPI lub na konto CPI.

Z parametrami urządzenia podpisanymi wcześniej przez CPI

Ten przykład pokazuje, jak utworzyć nieaktywną konfigurację urządzenia z parametrami instalacji CBSD wcześniej zakodowanymi na podstawie CPI, więc można ją utworzyć nawet dla użytkowników niekorzystających z CPI. Aby zakodować parametry CBSD, użyj klucza prywatnego CPI i #39. W tym celu używamy formatu tokena internetowego JSON. Przyjęliśmy, że ciąg ${ENCODED_DEVICE} to ciąg tekstowy JWT, a identyfikator CPI to ${CPI_ID}.

Następnie możesz utworzyć konfigurację nieaktywnego urządzenia za pomocą tego polecenia:

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

Następnie CBSD musi wysłać do SAS prośbę o rejestrację, aby dokończyć rejestrację.

Konto CPI

Najpierw musisz zweryfikować tożsamość CPI, zanim spróbujesz zweryfikować konfigurację urządzenia. Gdy wykonasz te czynności, utwórz nieaktywną konfigurację urządzenia, korzystając z tego polecenia:

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

Zakładamy, że ${DEVICE} ma być reprezentacją parametrów rejestracji zarządzania przeglądarką Chrome w formacie JSON w tym formacie.

Następnie CBSD musi wysłać do SAS prośbę o rejestrację, aby dokończyć rejestrację.