Redash
Récupérer une clé API utilisateur Redash et choisir les requêtes accessibles depuis Persyst.
Persyst se connecte à votre instance Redash avec son URL et une clé API utilisateur. Un administrateur sélectionne ensuite les requêtes à exposer et les attribue aux personnes concernées.
Préparer la clé dans Redash
- Connectez-vous à Redash avec le compte qui portera l’intégration. Utilisez de préférence un compte dédié dont les groupes n’ouvrent que les sources nécessaires.
- Ouvrez le profil de ce compte et copiez sa User API Key.
- Notez l’URL de base de votre instance, par exemple
https://redash.example.com, avec le chemin d’organisation si votre installation en utilise un.
La clé utilisateur reprend les droits de son propriétaire. Une Query API Key, disponible sur une requête, ne convient pas à cette connexion : Persyst doit aussi pouvoir lister les requêtes disponibles.
Connecter l’instance dans Persyst
- Dans Sources de données → Ajouter une source, choisissez Redash.
- Renseignez le nom de la connexion, l’URL de Redash et la clé API utilisateur.
- Cliquez sur Tester, puis créez le connecteur.
- Sélectionnez les requêtes approuvées à ajouter à cette source.
- Dans Gestion des accès, accordez les requêtes et leurs outils aux équipes ou aux membres concernés.
Choisir les outils
La lecture du dernier résultat et l’exécution d’une requête paramétrée sont deux usages distincts. L’exécution doit être activée pour la connexion et l’outil correspondant doit être accordé au membre.
L’assistant ne reçoit pas le SQL des requêtes et ne peut ni en écrire librement, ni créer ou modifier des requêtes Redash. Une lecture du dernier résultat doit être interprétée avec sa date de calcul.
Vérifier l’utilisation
Demandez à un membre autorisé : « Liste mes requêtes Redash, puis lis le dernier résultat de la requête de suivi hebdomadaire en précisant sa date. » Il doit retrouver les seules requêtes qui lui ont été accordées.
Renouveler les identifiants
Le formulaire web ne propose pas encore le remplacement de la clé sur une connexion existante. Préparez la nouvelle clé avec le responsable Redash, puis contactez l’équipe Persyst pour organiser son remplacement en conservant les requêtes et les accès. Vérifiez une lecture avant de retirer l’ancien accès chez Redash.
Référence : authentification API Redash et types de clés.