Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Google Spectrum Access System (SAS) Portal te permite crear, ver, actualizar y borrar ID de usuario y dispositivos dentro de tu red de servicio de radio de banda ancha para ciudadanos (CBRS).
La capacidad de cada usuario para administrar un recurso depende del rol asignado al recurso o al recurso superior. Los permisos se heredan del recurso superior.
IDs de usuario
Un ID de usuario identifica de forma única al operador de un dispositivo de servicio de radio de banda ancha para ciudadanos (CBSD).
SAS usa IDs de usuario para asignar un dispositivo a un cliente.
Cada cliente de SAS debe proporcionar al menos un ID de usuario durante la configuración de la cuenta de cliente. Puedes agregar IDs de usuario adicionales más adelante.
Dispositivos
La API de SAS Portal permite el registro de CBSD en varios pasos. En el caso de los dispositivos que debe instalar un instalador profesional certificado (CPI), hay dos maneras de iniciar el proceso de registro de varios pasos:
Opción 1. Inicia el proceso con una cuenta de CPI. El usuario debe estar autenticado con el rol role_cpi.
Primero, se verifica al usuario con el método ValidateInstaller() y, luego, se usa el método SignDevice() para enviar la configuración validada por el CPI a SAS.
Opción 2. Inicia el proceso con cualquier cuenta. Cualquier usuario puede usar el método CreateSigned() para crear una configuración de dispositivo inactiva que esté lista para que la use CBSD. Este método usa parámetros de dispositivos que están codificados con la clave privada de un CPI.
Independientemente de la opción que uses, este proceso crea una configuración inactiva para el dispositivo en el SAS. Luego, el CBSD envía una solicitud de registro al SAS. Si se ejecuta de forma correcta, el estado del dispositivo cambiará a Registrado.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (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)."]]
