OAuth-App registrieren

Version 4.0.23.6 (neueste Version)

OAuth2-Client-App registrieren

Registriert Details, mit denen eine externe Web-App oder native App als OAuth2-Log-in-Client der Looker-Instanz identifiziert wird. Die App-Registrierung muss einen eindeutigen „client_guid“- und „redirect_uri“-Dienst angeben, den die App bei OAuth-Log-in-Anfragen verwenden soll. Wenn die Parameter „client_guid“ und „redirect_uri“ in der Anmeldeanfrage nicht mit den in der Looker-Instanz registrierten Anwendungsdetails übereinstimmen, wird die Anfrage als Fälschung angenommen und abgelehnt.

Anfrage

POST /oauth_client_apps/{client_guid}
Datentyp
Beschreibung
Anfrage
HTTPRequest
Pfad
HTTPPath
HTTPPath-Definition maximieren...
client_guid
String
Eindeutige ID dieser Anwendung
body
HTTP-Text
HTTPBody-Definition maximieren...
body
OAuth-Client-App
OauthClientApp-Definition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
client_guid
String
Die global eindeutige ID dieser Anwendung
Weiterleitungs-URI
String
Der URI, mit dem diese Anwendung einen Autorisierungscode per Browserweiterleitung erhält.
display_name
String
Anzeigename der Anwendung
description
String
Eine Beschreibung der Anwendung, die Nutzern angezeigt wird
aktiviert
boolean
Wenn die Richtlinie auf „true“ gesetzt ist, werden OAuth2- und API-Anfragen von dieser App akzeptiert. Wenn „false“ festgelegt ist, werden alle Anfragen von dieser App abgelehnt. Wenn Sie die Einstellung deaktivieren, werden vorhandene Tokens ungültig.
group_id
String
Wenn Sie diese Option aktivieren, können nur Looker-Nutzer, die Mitglieder dieser Gruppe sind, diese Webanwendung mit Looker verwenden. Wenn „group_id“ nicht festgelegt ist, kann jeder Looker-Nutzer diese App verwenden, um auf diese Looker-Instanz zuzugreifen
Tokens_ungültig_vor
String
Alle Authentifizierungs-, Zugriffstokens und Aktualisierungstokens, die für diese Anwendung vor diesem Datum für ALLE NUTZER ausgestellt wurden, sind ungültig.
Nutzer aktiviert
Abfrage
HTTP-Abfrage
HTTPQuery-Definition maximieren...
Felder
String
Angeforderte Felder.

Antwort

200: OAuth-Client-App

Datentyp
Beschreibung
(Objekt)
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
client_guid
String
Die global eindeutige ID dieser Anwendung
Weiterleitungs-URI
String
Der URI, mit dem diese Anwendung einen Autorisierungscode per Browserweiterleitung erhält.
display_name
String
Anzeigename der Anwendung
description
String
Eine Beschreibung der Anwendung, die Nutzern angezeigt wird
aktiviert
boolean
Wenn die Richtlinie auf „true“ gesetzt ist, werden OAuth2- und API-Anfragen von dieser App akzeptiert. Wenn „false“ festgelegt ist, werden alle Anfragen von dieser App abgelehnt. Wenn Sie die Einstellung deaktivieren, werden vorhandene Tokens ungültig.
group_id
String
Wenn Sie diese Option aktivieren, können nur Looker-Nutzer, die Mitglieder dieser Gruppe sind, diese Webanwendung mit Looker verwenden. Wenn „group_id“ nicht festgelegt ist, kann jeder Looker-Nutzer diese App verwenden, um auf diese Looker-Instanz zuzugreifen
Tokens_ungültig_vor
String
Alle Authentifizierungs-, Zugriffstokens und Aktualisierungstokens, die für diese Anwendung vor diesem Datum für ALLE NUTZER ausgestellt wurden, sind ungültig.
Nutzer aktiviert
UserPublic-Definition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
String
Eindeutige ID
first_name
String
Vorname
last_name
String
Nachname
display_name
String
Vollständiger Name für Anzeige (nur verfügbar, wenn sowohl „first_name“ als auch „last_name“ festgelegt sind)
Avatar-URL
String
URL für das Avatarbild (möglicherweise generisch)
URL
String
Link zum Abrufen dieses Artikels

400: Ungültige Anfrage

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

404: Nicht gefunden

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

409: Ressource ist bereits vorhanden

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

422: Validierungsfehler

Datentyp
Beschreibung
nachricht
String
Fehlerdetails
ValidationErrorDetail-Definition maximieren...
Feld
String
Feld mit Fehler
Code
String
Fehlercode
nachricht
String
Fehlermeldung
Dokumentations-URL
String
Link zur Dokumentation
Dokumentations-URL
String
Link zur Dokumentation

429: Zu viele Anfragen

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

Beispiele