Restringere gli ambiti API con modificatori di ambito

Un modificatore di ambito restringe un ambito API a un sottoinsieme delle sue operazioni. Per aggiungere un modificatore, aggiungalo al nome dell'ambito dopo i due punti, ad esempio clusters:read. Un ambito senza modificatore consente ogni operazione all'interno dell'ambito.

Puoi utilizzare i modificatori di ambito in:

Per l'elenco completo degli ambiti e delle operazioni dell'API coperte da ciascuno di essi, consulta API scopes.

Modificatori disponibili

  • :read: Consente solo le operazioni di lettura dell'ambito (le richieste GET e HEAD). Ad esempio, clusters:read permette di elencare e ottenere cluster ma non di crearli, modificare o cancellarli.
  • :restricted-query: Consente query SQL di sola lettura. Questo modificatore si applica solo all'ambito sql . Un token con sql:restricted-query può eseguire query come SELECT e DESCRIBE con l'API di esecuzione delle istruzioni e i driver e connettori SQL. Non può chiamare altre API SQL, ad esempio per elencare i SQL warehouse. Le istruzioni che modificano oggetti o dati non funzionano:
    • Le istruzioni che creano, modificano o eliminano oggetti, come CREATE TABLE e DROP TABLE, falliscono con [OP_NOT_SUPPORTED_READ_ONLY] ... is not supported in read-only session mode. SQLSTATE: 42KD1.
    • Le istruzioni che modificano dati, come INSERT e UPDATE, falliscono con [INSUFFICIENT_PERMISSIONS] Insufficient privileges, anche su tabelle di tuo possesso.

Per combinare i modificatori, aggiungi entrambi: sql:read:restricted-query consente le sql operazioni di lettura dell'ambito, come l'elenco dei magazzini SQL e le query di sola lettura.

Seleziona un livello di accesso nell'interfaccia utente

Quando generi un token di accesso personale o un segreto OAuth nell'interfaccia utente dello spazio di lavoro, dopo aver aggiunto un ambito, seleziona il suo livello di accesso. Il livello di accesso imposta il modificatore:

Livello di accesso Ambito autorizzato
Leggi <scope>:read
Leggi + Scrivi <scope> (nessun modificatore)
Query limitata (sql solo) sql:restricted-query
Lettura + Query limitata (sql solo) sql:read:restricted-query
Lettura + Query Restringita + Scrittura (sql solo) sql (nessun modificatore)

Usa i modificatori con i token di accesso personali

Con l'API Token, includere ogni ambito con i suoi modificatori come un elemento dell'array scopes . I token di accesso personali non supportano all-apis:read. Per concedere l'accesso completo allo spazio di lavoro, utilizza un array vuoto scopes (lo scope all-apis). Vedere Token di accesso personali con ambito.

Usa i modificatori con OAuth

Puoi associare un segreto OAuth di service principal a scope con modificatori, e puoi richiedere un token di accesso OAuth con scope modificatori. Un token di accesso non può superare l'ambito del segreto da cui è stato coniato, tranne nel caso di un segreto con l'ambito authentication. Vedi segreti OAuth con ambito definito. OAuth accetta anche all-apis:read, che consente operazioni di lettura su ogni API per cui il principal è autorizzato.

Per richiedere un token con modificatori, elenca gli ambiti nel scope parametro della richiesta del token, separati da spazi. Nell'URL di autorizzazione del flusso utente-macchina, separare gli ambiti con + invece.

Risorse aggiuntive