Créer une URL d'intégration

Version 4.0.23.6 (la plus récente)

Créer une URL d'intégration

Crée une URL d'intégration qui s'exécute en tant qu'utilisateur Looker effectuant cet appel d'API. ("Intégrer en tant que moi") Cette URL d'intégration peut ensuite être utilisée pour instancier une session d'intégration Looker dans une application Web "Powered by Looker" (PBL).

Cette méthode est semblable à l'intégration privée (https://cloud.google.com/looker/docs/r/admin/embed/private-embed). Au lieu de s'authentifier dans l'interface utilisateur Web, l'utilisateur s'est déjà authentifié auprès de l'API pour effectuer cet appel. Toutefois, contrairement à la fonctionnalité d'intégration privée, où l'utilisateur a accès à toute autre partie de l'interface utilisateur de Looker, la session Web d'intégration créée en demandant le fichier EmbedUrlResponse.url n'a accès qu'au contenu visible dans le contexte /embed.

Une URL d'intégration ne peut être utilisée qu'une seule fois et doit être utilisée dans les cinq minutes suivant sa création. Une fois utilisée pour demander une page au serveur Looker, l'URL n'est pas valide. Les futures requêtes utilisant la même URL échoueront. Cela permet d'éviter les attaques par rediffusion.

La propriété target_url doit être une URL complète d'une page d'interface utilisateur intégrée Looker : schéma, nom d'hôte, chemin commençant par "/embed" et paramètres de requête. Pour charger un tableau de bord portant l'ID 56 et le filtre Date=1 years, l'URL d'intégration de Looker doit se présenter comme suit : https://myname.looker.com/embed/dashboards/56?Date=1%20years. Le meilleur moyen d'obtenir ce target_url consiste à accéder à la page Looker souhaitée dans votre navigateur Web, à copier l'URL affichée dans la barre d'adresse du navigateur, à insérer "/embed" après l'hôte/le port, puis à la coller dans la propriété target_url en tant que valeur de chaîne entre guillemets dans cette requête API.

Remarque concernant la sécurité

Protégez cette URL d'intégration comme vous le feriez pour un jeton d'accès ou des identifiants de mot de passe. Ne l'écrivez pas sur le disque, ne la transmettez pas à un tiers et ne la transmettez que via un transport sécurisé HTTPS chiffré.

Demande

POST /embed/token_url/me
Type de données
Description
Demande
HTTPRequest
body
Corps HTTP
Développer la définition HTTPBody...
body
EmbedParams (paramètres d'intégration)
Paramètres d'intégration
Développer la définition d'EmbedParams...
target_url
string
URL complète de la page de l'interface utilisateur Looker à afficher dans le contexte d'intégration. Par exemple, pour afficher le tableau de bord avec l'ID 34, "target_url" ressemblerait à "https://mycompany.looker.com:9999/dashboards/34". "target_uri" DOIT contenir un schéma (HTTPS), un nom de domaine et un chemin d'URL. Le port doit être inclus s'il est nécessaire d'accéder au serveur Looker depuis les clients de navigateur. Si l'instance Looker se trouve derrière un équilibreur de charge ou un autre proxy, "target_uri" doit être le nom de domaine public et le port requis pour atteindre l'instance Looker, et non le nom réel de la machine réseau interne de l'instance Looker.
durée_session
integer
Durée en secondes après laquelle la session d'intégration SSO est valide. La valeur par défaut est de 300 secondes. La durée maximale de session est de 259 200 secondes (30 jours).
force_logout_login
booléen
Lorsque la valeur est "true", la session d'intégration supprime définitivement tous les états de connexion résiduels de Looker (dans les cookies de navigateur, par exemple) avant de créer un état de connexion avec les informations utilisateur intégrées intégrées. La valeur par défaut est "true".

Réponse

200: Intégrer l'URL

Type de données
Description
(objet)
url
string
URL d'intégration Toute modification apportée à cette chaîne rendra l'URL inutilisable.

400 Bad Request

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

404: introuvable

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

409: La ressource existe déjà

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation

422: Erreur de validation

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
Développer la définition de ValidationErrorDetail...
champ
string
Champ comportant une erreur
code
string
Code d'erreur
Message
string
Message d'information sur l'erreur
documentation_url
string
Lien vers la documentation
documentation_url
string
Lien vers la documentation

429 : Too Many Requests

Type de données
Description
(objet)
Message
string
Infos sur l'erreur
documentation_url
string
Lien vers la documentation