Limitar los ámbitos de API con modificadores de alcance

Un modificador de alcance reduce un ámbito de API a un subconjunto de sus operaciones. Para añadir un modificador, añágalo al nombre del ámbito después de dos puntos, por clusters:readejemplo. Un ámbito sin modificador permite cualquier operación dentro del ámbito.

Puedes usar modificadores de alcance en:

Para la lista completa de ámbitos y las operaciones API que cubre cada uno, véase ámbitos API.

Modificadores disponibles

  • :read: Permite únicamente las operaciones de lectura (GET y HEAD solicitudes) del ámbito. Por ejemplo, clusters:read permite listar y obtener clústeres pero no crearlos, editarlos, ni eliminarlos.
  • :restricted-query: Permite consultas SQL de solo lectura. Este modificador se aplica únicamente al sql ámbito. Un token con sql:restricted-query puede ejecutar consultas como SELECT y DESCRIBE con la API de Ejecución de Sentencias y los controladores y conectores SQL. No puede llamar a otras APIs SQL, como listar almacenes SQL. Las sentencias que modifican objetos o datos fallan:
    • Las sentencias que crean, alteran o eliminan objetos, como CREATE TABLE y DROP TABLE, fallan con [OP_NOT_SUPPORTED_READ_ONLY] ... is not supported in read-only session mode. SQLSTATE: 42KD1.
    • Las sentencias que modifican datos, como INSERT y UPDATE, fallan con [INSUFFICIENT_PERMISSIONS] Insufficient privileges, incluso en tablas que posees.

Para combinar modificadores, añade ambos: sql:read:restricted-query permite las sql operaciones de lectura del ámbito, como listar almacenes SQL y consultas de solo lectura.

Seleccione un nivel de acceso en la interfaz de usuario

Cuando generes un token de acceso personal o un secreto OAuth en la interfaz de trabajo del espacio de trabajo, después de añadir un ámbito, selecciona su nivel de acceso. El nivel de acceso establece el modificador:

Nivel de acceso Alcance concedido
Read <scope>:read
Leer + Escribir <scope> (sin modificador)
Consulta restringida (sql solo) sql:restricted-query
Lectura + consulta restringida (sql solo) sql:read:restricted-query
Lectura + Consulta restringida + Escritura (sql solo) sql (sin modificador)

Usa modificadores con tokens de acceso personal

Con la API de Tokens, incluye cada ámbito con sus modificadores como un elemento del scopes array. Los tokens de acceso personal no soportan all-apis:read. Para conceder acceso completo al espacio de trabajo, utilice un array vacío scopes (el all-apis scope). Consulte Tokens de acceso personal con ámbito.

Usa modificadores con OAuth

Puedes vincular un secreto OAuth de entidad de servicio a alcances con modificadores, y puedes solicitar un token de acceso OAuth con alcances modificadores. Un token de acceso no puede exceder el alcance del secreto del que fue acuñado, salvo un secreto con ese authentication alcance. Consulta los secretos OAuth con ámbito definido. OAuth también acepta all-apis:read, lo que permite operaciones de lectura en cada API para la que el principal esté autorizado.

Para solicitar un token con modificadores, enumera los ámbitos en el scope parámetro de la solicitud de token, separados por espacios. En la URL de autorización del flujo usuario-máquina, separar los ámbitos con + en su lugar.

Recursos adicionales