API-Bereiche mit Bereichsmodifikatoren eingrenzen

Ein Scope-Modifikator grenzt einen API-Scope auf eine Teilmenge seiner Operationen ein. Um einen Modifier hinzuzufügen, fügen Sie ihn zum Beispiel clusters:readdem Scope-Namen nach einem Doppelpunkt an. Ein Scope ohne Modifikator erlaubt jede Operation im Scope.

Sie können Bereichsmodifikatoren in Folgendem verwenden:

Für die vollständige Liste der Scopes und die API-Operationen, die jeder abdeckt, siehe API-Scopes.

Verfügbare Modifikatoren

  • :read: Erlaubt nur die Leseoperationen (GET und HEAD Anfragen) des Scopes. Zum Beispiel erlaubt es clusters:read, Cluster aufzulisten und abzurufen, aber nicht, sie zu erstellen, zu bearbeiten oder zu löschen.
  • :restricted-query: Erlaubt schreibgeschützte SQL-Abfragen. Dieser Modifikator gilt nur für den Scope sql . Ein Token mit sql:restricted-query kann mit der Statement Execution API sowie SQL-Treibern und -Connectoren Abfragen wie SELECT und DESCRIBE ausführen. Es kann keine anderen SQL-APIs aufrufen, wie zum Beispiel das Listen von SQL-Warehouses. Anweisungen, die Objekte oder Daten ändern, schlagen fehl:
    • Anweisungen, die Objekte erstellen, ändern oder löschen, wie CREATE TABLE und DROP TABLE, versagen mit [OP_NOT_SUPPORTED_READ_ONLY] ... is not supported in read-only session mode. SQLSTATE: 42KD1.
    • Anweisungen, die Daten wie INSERT und UPDATE ändern, versagen mit [INSUFFICIENT_PERMISSIONS] Insufficient privileges, selbst bei Tabellen, die Ihnen gehören.

Um Modifikatoren zu kombinieren, fügen Sie beides hinzu: sql:read:restricted-query ermöglicht die Lesevorgänge des sql-Scopes, wie das Auflisten von SQL-Warehouses, sowie schreibgeschützte Abfragen.

Wählen Sie eine Zugriffsstufe in der Benutzeroberfläche aus

Wenn Sie ein persönliches Zugriffstoken oder ein OAuth-Geheimnis in der Arbeitsbereichsoberfläche generieren, wählen Sie nach Hinzufügen eines Bereichs dessen Zugriffsstufe aus. Die Zugriffsstufe legt den Modifikator fest:

Zugriffsebene Gewährter Geltungsbereich
Lesen <scope>:read
Lesen + Schreiben <scope> (kein Modifikator)
Eingeschränkte Abfrage (sql nur) sql:restricted-query
Lesen + Eingeschränkte Abfrage (sql nur) sql:read:restricted-query
Lesen + Eingeschränkte Abfrage + Schreiben (sql nur) sql (kein Modifikator)

Verwenden Sie Modifikatoren mit persönlichen Zugriffstoken

Mit der Token-API fügen Sie jeden Scope mit seinen Modifikatoren als ein Element des Arrays scopes ein. Persönliche Zugangstoken unterstützen all-apis:readnicht. Um vollen Arbeitsbereichszugriff zu gewähren, verwenden Sie ein leeres scopes Array (das all-apis Scope). Siehe Gescopte persönliche Zugriffstoken.

Verwenden Sie Modifikatoren mit OAuth

Sie können ein OAuth-Geheimnis des Serviceprinzipals mit Modifikatoren an Scopes binden und ein OAuth-Zugriffstoken mit Modifikator-Scopes anfordern. Ein Access Token darf die Scopes des Secrets, aus dem er ausgestellt wurde, nicht überschreiten, außer bei einem Secret mit dem authentication-Scope. Siehe Scoped OAuth Secrets. OAuth akzeptiert all-apis:readaußerdem , was Leseoperationen auf jeder API ermöglicht, für die der Principal autorisiert ist.

Um einen Token mit Modifikatoren anzufordern, listen Sie die Scopes im scope Parameter der Token-Anfrage auf, getrennt durch Leerzeichen. Trennen Sie in der Autorisierungs-URL des User-to-Machine-Flows stattdessen die Scopes mit +.

Zusätzliche Ressourcen