Variables et secrets

Les applications ont souvent besoin d’une clé : pour une carte, un identifiant d’analyse ou la clé d’API d’un service externe. Vous n’écrivez jamais une telle clé dans le code d’une application : quiconque l’ouvre peut lire son code, et kvyk.ai arrête une version qui contient une clé. Les clés et les réglages vont dans Variables et secrets, sur Technique → Clés et secrets dans la barre latérale.

Seuls les Builders et les Administrators les voient et les modifient.

Variables et secrets

Chaque entrée a un nom, comme MAPS_KEY, une valeur pour Preview et une valeur pour Live, pour que vos applications utilisent une clé de test dans Preview et la vraie dans Live.

Chaque entrée est de l’un de deux types :

• Variable. Vos applications peuvent la lire dans le navigateur, dans l’étape où elles tournent. Toute personne qui ouvre l’application peut la voir : utilisez-la donc seulement pour des clés destinées à être publiques, comme une clé Maps que vous limitez à l’adresse de votre application chez le fournisseur.
• Secret. Il n’atteint jamais un navigateur. Seul le code qui tourne sur les serveurs de kvyk.ai peut l’utiliser, comme les appels de vos automatisations à d’autres services. Une nouvelle entrée est un secret, sauf si vous choisissez autrement.

La page liste chaque entrée dans un tableau : son nom, son type, Dans le navigateur (Oui pour une variable, que les apps peuvent lire dans le navigateur, Non pour un secret, qui reste sur le serveur), ses valeurs pour Preview et Live, et En attente de publication quand Live ne l’a pas encore. Les valeurs d’une variable sont affichées. Les valeurs d’un secret sont masquées par des points : une fois enregistrées, elles ne sont plus jamais affichées, pas même à vous. Choisissez une ligne pour ouvrir l’entrée.

Ajouter une entrée

1. Ouvrez Technique → Clés et secrets et, sous Variables et secrets, choisissez Ajouter.
2. Donnez-lui un nom en majuscules, chiffres et _, comme MAPS_KEY.
3. Choisissez son type : Secret ou Variable.
4. Saisissez sa valeur pour Preview et sa valeur pour Live si vous les avez, puis choisissez Ajouter.

La valeur d’un secret reste masquée pendant que vous la saisissez. Pour vérifier qu’elle ne contient pas de faute de frappe, choisissez l’œil à côté du champ (Afficher la valeur), puis choisissez-le à nouveau (Masquer la valeur) pour la masquer. Une valeur déjà enregistrée n’est plus jamais affichée : l’œil n’apparaît donc qu’une fois que vous saisissez quelque chose.

Pour modifier une entrée, ouvrez-la. Le haut de sa page dit où ses valeurs peuvent aller : Les apps peuvent la lire dans le navigateur pour une variable, Serveur uniquement : n’atteint jamais un navigateur pour un secret. Les valeurs d’une variable se modifient sur place ; videz-en une pour la retirer. Pour un secret, saisissez une nouvelle valeur pour la remplacer, ou choisissez Effacer pour la retirer. Choisissez ensuite Enregistrer. Faire d’un secret une variable vous est demandé d’abord, car ses valeurs deviennent visibles pour toute personne qui ouvre vos applications.

Vous pouvez aussi demander à l’assistant, par exemple Ma carte a besoin d’une clé Google Maps. Il propose l’entrée sur une carte dans la conversation, où vous saisissez vous-même les valeurs : elles vont directement à kvyk.ai, et l’assistant ne les voit jamais. Ne collez jamais une clé dans la conversation elle-même.

Preview et Live

Preview utilise une modification aussitôt, pour que vous puissiez l’essayer tout de suite dans l’aperçu de votre application. Live continue d’utiliser ce qu’il avait jusqu’à ce que vous publiiez : une nouvelle entrée, une nouvelle valeur pour Live, un type modifié et une suppression disent Enregistré, attend la publication. et attendent ensemble, comme un seul élément, sous Variables et secrets dans le panneau de publication, qu’ouvre Publier dans la barre du haut. Cochez-le, avec l’application qui en a besoin, et choisissez Publier. Voir Publier et annuler des modifications.

Utiliser une variable dans une application

Quand l’assistant construit une application qui a besoin d’une clé, il lit la variable au lieu d’écrire la clé dans le code. Une application publiée la lit dans l’étape où elle tourne : la valeur pour Preview à son adresse Preview, celle pour Live à sa propre adresse. Quand une valeur change, vous n’avez pas besoin de construire une nouvelle version, seulement de publier la modification.

Supprimer une entrée

Sur la page de l’entrée, choisissez Supprimer et confirmez. Preview la perd aussitôt et Live dès que vous publiez ; les applications qui la lisent n’obtiennent alors plus rien.

Chaque modification figure sous Technique → Événements, avec le nom de l’entrée et la personne qui l’a faite, jamais ses valeurs.