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ę.