Um eine signierte Einbettungs-URL zu erstellen, müssen Sie die Modelle und Berechtigungen angeben, die für jeden eingebetteten Nutzer verfügbar sind, und optional Nutzerattributdaten für eingebettete Nutzer bereitstellen. In diesem Dokument finden Sie einen kurzen Überblick darüber, was diese Elemente in Looker sind.
Modelle
Mit Modellen wird festgelegt, auf welche Daten Ihre Nutzer mit eingebetteten Inhalten zugreifen können.
Jedes LookML-Modell besteht aus einer einzelnen Datenbankverbindung und einem oder mehreren Explores. In jedem Explore wird festgelegt, welche Datenbanktabellen und ‑felder für das Modell verfügbar sind, wie sie verknüpft werden und wie sie dem Nutzer präsentiert werden. In der Regel sind mehrere Modelle mit einer einzelnen Datenbank verbunden. Dadurch wird festgelegt, auf welche Daten verschiedene Nutzergruppen zugreifen können. So benötigen Nutzer in der Vertriebsabteilung möglicherweise Zugriff auf andere Daten als Nutzer in der Einkaufsabteilung. In diesem Fall könnten Sie zwei Modelle bereitstellen, die jeweils für einen einzelnen Anwendungsfall optimiert sind.
In einer signierten Einbettungs-URL oder bei Verwendung des create_sso_embed_url-API-Endpunkt geben Sie an, auf welche Modelle ein eingebetteter Nutzer zugreifen kann, indem Sie sie nach Namen auflisten. Beispiel:
[
"model_one",
"model_two"
]
In einer signierten Einbettungs-URL ist mindestens ein Modellwert erforderlich.
Berechtigungen
Mit Berechtigungen wird festgelegt, was Ihre eingebetteten Nutzer in Looker tun können.
Für jede Funktion in Looker ist eine Berechtigung erforderlich. Ein Nutzer, der beispielsweise nicht die Berechtigung access_data hat, kann keine Daten sehen. Ein Nutzer mit der Berechtigung access_data, aber nicht mit der Berechtigung save_content kann Inhalte ansehen, aber keine Änderungen an Inhalten vornehmen und speichern.
In einer signierten Einbettungs-URL oder bei Verwendung des create_sso_embed_url-API-Endpunkt geben Sie an, welche Berechtigungen ein eingebetteter Nutzer hat, indem Sie sie nach Namen auflisten. Beispiel:
[
"access_data",
"see_looks"
]
Für eine signierte Einbettungs-URL ist mindestens eine Berechtigung erforderlich. Eine Liste der Berechtigungen, die von signierten Einbettungen unterstützt werden, finden Sie auf der Dokumentationsseite Signierte Einbettung.
Nutzerattribute
Nutzerattribute sind eine Methode, um Metadaten zu Ihren eingebetteten Nutzern bereitzustellen. Sie bestehen aus Name-Wert-Paaren.
Jeder Nutzer in Looker hat mehrere Standardnutzerattribute, z. B. first_name, last_name und locale. Looker-Administratoren können auch benutzerdefinierte Nutzerattribute in verschiedenen Datentypen erstellen. Beispielsweise kann es sein, dass die Daten, die dem Nutzer des eingebetteten Berichts angezeigt werden, je nach Unternehmen variieren, dem er zugeordnet ist. In diesem Fall können Sie ein benutzerdefiniertes Nutzerattribut company erstellen, das verschiedene Werte akzeptiert, mit denen der Datenzugriff gewährt oder eingeschränkt wird. Als Nächstes weisen Sie jedem eingebetteten Nutzer den entsprechenden Wert zu, um den Datenzugriff auf Nutzerebene einzuschränken.
In einer signierten Einbettungs-URL oder bei Verwendung des API-Endpunkt create_sso_embed_url geben Sie an, welche Nutzerattribute einem eingebetteten Nutzer zugewiesen werden, indem Sie jedes Name-Wert-Paar auflisten. Beispiel:
{
"vendor_id" : "17",
"company" : "altostrat.com"
}
Nutzerattribute sind in einer signierten Einbettungs-URL optional.