Les extensions sont des applications Web créées avec des composants Looker et développées à l'aide du framework d'extension Looker. Ces extensions hériteront de la structure des autorisations de votre instance Looker, en gérant les autorisations au niveau de l'ensemble de modèles. Si un utilisateur n'est pas autorisé à accéder à certains modèles dans l'application Looker standard, il ne pourra pas accéder à ces modèles dans les extensions Looker. Cette page explique comment les administrateurs Looker peuvent accorder aux utilisateurs les autorisations appropriées pour accéder aux extensions Looker.
Looker Marketplace déploie une extension en important un nouveau projet dans votre application Looker. Ce projet contient tout ce qui est nécessaire pour exécuter l'extension et comporte au moins un fichier model. Les administrateurs Looker peuvent contrôler la façon dont un utilisateur consulte ou interagit avec le contenu basé sur ce modèle en lui attribuant un rôle qui lui donne l'autorisation d'accéder au modèle de l'extension.
Par exemple, si votre instance Looker contient des données basées sur des modèles appelés finance, marketing et sales, mais que vous ne souhaitez autoriser l'accès aux données financières qu'à certains utilisateurs, vous n'accorderez l'accès qu'au modèle finance. Les autorisations pour les extensions fonctionnent de la même manière.
Les administrateurs Looker peuvent contrôler les autorisations d'accès au modèle d'une extension (et donc à l'extension elle-même), ainsi qu'au modèle ou aux modèles sur lesquels repose tout contenu dans l'extension.
Les administrateurs Looker peuvent configurer les ensembles de modèles disponibles pour une instance Looker en accédant à la page Rôles du panneau Admin. Pour accéder à l'extension et l'utiliser, les utilisateurs doivent disposer d'un rôle qui inclut les autorisations manage models ou explore ou develop pour tous les modèles ou l'ensemble de modèles contenant le modèle de l'extension.
Accorder des autorisations aux utilisateurs pour les extensions
Les extensions Looker sont développées à l'aide du framework d'extension Looker et peuvent être installées depuis le Marketplace Looker. Les extensions nécessitent l'activation des fonctionnalités Framework d'extension et Marketplace.
En plus de ces fonctionnalités, il existe trois types d'autorisations associées aux extensions :
- Autorisations pour développer des extensions
- Autorisations pour installer des extensions depuis Looker Marketplace
- Autorisations d'utilisation des extensions
Autorisations pour développer des extensions
Pour développer une extension à l'aide du framework d'extension Looker, les utilisateurs ont besoin d'autorisations de développeur LookML pour l'instance, ainsi que des compétences recommandées sur la page de documentation Introduction au framework d'extension Looker.
Autorisations pour installer des extensions depuis Looker Marketplace
Chaque extension aura un projet avec au moins un modèle LookML dédié. Par exemple, l'extension Dictionnaire de données utilise le modèle data-dictionary.
Pour installer une extension depuis Looker Marketplace, un utilisateur doit disposer des autorisations develop, manage_models et deploy pour le modèle de l'extension.
Lors de l'installation d'une extension nécessitant une clé d'accès depuis le Looker Marketplace, un écran de configuration invite l'utilisateur à saisir les valeurs de la clé d'accès, qui seront stockées en tant qu'attributs utilisateur pour l'instance Looker.
Autorisations pour utiliser les extensions
Si l'extension est installée via le Looker Marketplace ou disponible dans une instance Looker, l'administrateur Looker devra configurer les autorisations des utilisateurs.
Dans la plupart des cas d'utilisation des extensions, l'extension s'exécute toujours avec les autorisations accordées à l'utilisateur lorsqu'il se connecte. Par défaut, une fois l'extension installée, tout utilisateur disposant d'un rôle avec les autorisations explore ou develop et l'accès à l'ensemble de modèles défini sur Tous pourra automatiquement afficher et utiliser l'extension et son contenu sans avoir à configurer d'autorisations supplémentaires. Les utilisateurs doivent avoir accès à tous les modèles utilisés par l'extension pour qu'elle fonctionne pleinement.
Looker affiche l'extension dans la section Applications du menu principal de Looker.
Looker n'affiche l'extension que pour les utilisateurs Looker qui ont accès à au moins l'un des modèles sous-jacents de l'extension.
Pour les extensions intégrées, l'extension hérite des autorisations accordées à l'ID utilisateur intégré créé, comme une exploration, un tableau de bord ou un Look intégrés.
Pour les extensions plein écran qui utilisent l'option /spartan dans l'URL de l'extension, vous pouvez ajouter des utilisateurs à un groupe d'utilisateurs Extensions uniquement. Les utilisateurs de ce groupe ne peuvent pas afficher les pages Looker en dehors de l'extension. Les administrateurs Looker peuvent personnaliser le groupe Extensions uniquement comme n'importe quel autre groupe et lui attribuer un rôle disposant de certaines autorisations et d'un accès à des ensembles de modèles. Les utilisateurs n'ont pas besoin d'appartenir au groupe Extensions uniquement pour afficher une extension en plein écran. S'ils n'appartiennent pas à ce groupe, l'extension s'exécutera avec les autorisations de l'utilisateur connecté.
Ajouter des autorisations utilisateur
Un administrateur Looker devra accorder aux utilisateurs et aux utilisateurs intégrés un ensemble d'autorisations incluant access_data et toutes les autorisations plus restrictives associées à cette extension. Ces autorisations doivent être appliquées à un ensemble de modèles qui inclut le ou les modèles de l'extension.
Pour accorder aux utilisateurs l'accès à l'extension, les administrateurs Looker doivent :
- Créez un ensemble de modèles qui inclut le modèle de l'extension ou modifiez un ensemble de modèles existant pour ajouter le modèle de l'extension.
- Vérifiez que les utilisateurs sont attribués à un rôle disposant au moins de l'autorisation
access_data(et de toute autorisation plus restrictive associée à cette extension) pour cet ensemble de modèles.
Exemple : extension Dictionnaire de données
Le projet d'extension Dictionnaire de données utilise le modèle data-dictionary.
Les utilisateurs dont le rôle n'inclut pas les autorisations explore ou develop, ou dont l'accès Ensemble de modèles n'est pas défini sur Tous, devront demander à un administrateur Looker de leur accorder les autorisations explore ou develop pour un ensemble de modèles incluant le modèle data-dictionary.
Imaginons que vous souhaitez donner à votre équipe financière l'accès à l'extension Dictionnaire de données. L'équipe financière est attribuée à l'ensemble de modèles Finance Team, mais cela ne lui donne pas accès au modèle data-dictionary pour le moment :
Pour ajouter le modèle data-dictionary à leur ensemble de modèles, sélectionnez le bouton Modifier à côté de l'ensemble de modèles Finance Team, puis cochez la case du modèle data-dictionary.
Sélectionnez Mettre à jour les paramètres pour enregistrer votre sélection.
Après avoir ajouté le modèle data-dictionary à l'ensemble de modèles Finance Team, vérifiez que le rôle de l'équipe financière utilise un ensemble d'autorisations contenant les autorisations explore ou develop. Dans cet exemple, le rôle de l'équipe financière (Service financier) contient l'ensemble d'autorisations Developer, ainsi que l'ensemble de modèles Finance Team.
L'ensemble d'autorisations Developer contient les autorisations explore et develop.
Désormais, tous les utilisateurs auxquels le rôle Service financier est attribué auront accès à l'extension Dictionnaire de données, car ce rôle contient les autorisations et l'accès au modèle appropriés.