Stay organized with collections
Save and categorize content based on your preferences.
The Google Spectrum Access System (SAS) Portal API lets you create, view, update, and delete
user IDs and devices within your Citizens Broadband Radio Service (CBRS) network.
The ability for each user to manage a resource depends on the user role assigned
to the resource or parent resource. Permissions are inherited from the parent
resource.
User IDs
A user ID uniquely identifies the operator of a Citizens Broadband Radio Service Device (CBSD).
SAS uses user IDs to assign a device to a
customer.
Every SAS customer has to provide at least one user ID during
customer account setup. You can add additional user IDs later.
Devices
The SAS Portal API enables multistep registration of
CBSDs. For devices that need to be installed by a
Certified Professional Installer (CPI), there are two ways
to initiate the multistep registration process:
Option 1. Initiate the process with a CPI account. The user must be
authenticated with the role_cpi role.
First, the user is verified by using the
ValidateInstaller() method,
and then they use the SignDevice() method
to send the CPI-validated configuration to SAS.
Option 2. Initiate the process with any account. Any user can use the
CreateSigned() method
to create an inactive device configuration that is ready for the
CBSD to use. This method uses device parameters that are
encoded with a CPI's private key.
Regardless of which option you use, this process creates an inactive
configuration for the device in the SAS. Then, the
CBSD sends a registration request to the SAS. If
it is successful, the device status changes to Registered.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[],[],null,["# Manage user IDs and devices\n\nThe Google Spectrum Access System (SAS) Portal API lets you create, view, update, and delete\nuser IDs and devices within your Citizens Broadband Radio Service (CBRS) network.\n\nThe ability for each user to manage a resource depends on the user role assigned\nto the resource or parent resource. Permissions are inherited from the parent\nresource.\n\nUser IDs\n--------\n\nA user ID uniquely identifies the operator of a Citizens Broadband Radio Service Device (CBSD).\nSAS uses user IDs to assign a device to a\n[customer](/spectrum-access-system/docs/key-terms).\nEvery SAS customer has to provide at least one user ID during\ncustomer account setup. You can add additional user IDs later.\n\nDevices\n-------\n\nThe SAS Portal API enables multistep registration of\nCBSDs. For devices that need to be installed by a\n[Certified Professional Installer (CPI)](/spectrum-access-system/docs/key-terms), there are two ways\nto initiate the multistep registration process:\n\n- **Option 1.** Initiate the process with a CPI account. The user must be\n authenticated with the [`role_cpi` role](/spectrum-access-system/docs/roles-and-permissions#cpi).\n First, the user is verified by using the\n [`ValidateInstaller()` method](/spectrum-access-system/docs/reference/rest/v1alpha1/installer/validate#spectrum.sas.portal.v1alpha1.DeviceManager.ValidateInstaller),\n and then they use the [`SignDevice()` method](/spectrum-access-system/docs/reference/rest/v1alpha1/deployments.devices/signDevice)\n to send the CPI-validated configuration to SAS.\n\n | **Note:** The user only needs to validate their CPI identity once.\n- **Option 2.** Initiate the process with any account. Any user can use the\n [`CreateSigned()` method](/spectrum-access-system/docs/reference/rest/customers.devices/createSigned)\n to create an inactive device configuration that is ready for the\n CBSD to use. This method uses device parameters that are\n encoded with a CPI's private key.\n\nRegardless of which option you use, this process creates an inactive\nconfiguration for the device in the SAS. Then, the\nCBSD sends a registration request to the SAS. If\nit is successful, the device status changes to **Registered**.\n\n- For CBSDs that do not need CPI validation, use the [`CreateDevice()` method](/spectrum-access-system/docs/reference/rpc/spectrum.sas.portal.v1alpha1#spectrum.sas.portal.v1alpha1.DeviceManager.CreateDevice).\n- For single-step registration with CPI-encoded data, use the [SAS-CBSD API](https://winnf.memberclicks.net/assets/CBRS/WINNF-TS-0016.pdf) defined by WInnForum.\n\nWhat's next\n-----------\n\n- To get an overview of the SAS Portal API, see [Google SAS Portal API overview](/spectrum-access-system/docs/overview-api).\n- For information about each API, see [Customers API](/spectrum-access-system/docs/customers-api) and [Device Manager API](/spectrum-access-system/docs/device-manager-api).\n- For examples of how to use the API, see [API code samples](/spectrum-access-system/docs/samples).\n- For reference documentation, see [APIs and reference](/spectrum-access-system/docs/apis)."]]