Points clés
Les clés API peuvent désormais être affichées. Générez-en une dans votre Dashboard, partez, revenez la semaine suivante, et la clé est toujours là, disponible en un clic. Nous avons aussi corrigé trois aspérités dans le playground d'API afin que le reproducteur cURL s'exécute réellement.
Nouveautés
Des clés API que vous pouvez revoir
La plupart des API SaaS ne vous fournissent une clé qu'une seule fois. Si vous la perdez, il faut la régénérer. Mettre à jour chaque service qui utilise l'ancienne clé. Redéployer. Vous connaissez le refrain.
Ce schéma ne nous convenait pas. Nous l'avons donc modifié.
Les clés créées à partir de maintenant disposent d'une copie affichable. Ouvrez votre Dashboard, cliquez sur l'icône en forme d'œil à côté d'une clé, confirmez, et la valeur complète pk_live_... s'affiche. Quinze secondes plus tard, elle se masque automatiquement et s'efface de la page. Chaque affichage est consigné dans les logs d'audit.
Quelques détails importants à nos yeux :
- Le chemin qui authentifie vos requêtes reste un hash unidirectionnel, inchangé. La copie affichable est un second artefact chiffré (AES-256-GCM) conservé à côté. Si nous devions changer la clé de chiffrement, la validation continuerait de fonctionner.
- Les clés créées avant ce changement ne peuvent pas être affichées. Elles ne disposent d'aucune copie chiffrée à relire. Elles continuent de fonctionner indéfiniment via le hash. Le Dashboard affiche un petit cadenas et l'indication "régénérer pour activer", afin que vous sachiez quelles clés bénéficient de la nouvelle fonctionnalité.
- Le contrôle d'accès correspond au reste de l'API des clés. Vous pouvez afficher vos propres clés. Un admin d'organisation peut afficher n'importe quelle clé de l'organisation. Les membres avec accès en écriture d'équipe peuvent afficher les clés de l'équipe. Les rôles en lecture seule ne le peuvent pas.
- Les clés créées par un admin d'organisation pour le compte d'un collègue sont également affichables, avec les mêmes règles. La capacité est portée par la clé, pas par l'interface qui l'a créée.
Si vous accumuliez les entrées de gestionnaire de mots de passe pour les clés FourA, vous pouvez arrêter.
Le reproducteur cURL est désormais un vrai cURL
Chaque requête conçue dans le playground s'accompagne d'une commande cURL prête à être copiée-collée. L'idée est simple : validez la requête dans l'interface, copiez le cURL, collez-le dans un script, dans le terminal d'un collègue ou dans un rapport de bug.
Jusqu'à cette semaine, la commande cURL contenait un espace réservé à l'emplacement de la clé (PASTE_PLAINTEXT_FOR_my-key), et vous deviez la renseigner à la main avant de pouvoir l'exécuter. Le reproducteur n'était pas un reproducteur. C'était un modèle.
C'est terminé. Pour toute clé affichable, le playground propose un bouton Afficher sur le panneau cURL. Cliquez dessus, le texte en clair réel est inséré dans le cURL, copiez l'ensemble, collez-le dans votre terminal, et il s'exécute. Cliquez à nouveau pour masquer. L'affichage s'effectue en mémoire pour cette session uniquement, n'est jamais écrit sur le disque, et le panneau cURL suit le menu déroulant des clés, de sorte que changer de clé ne provoque aucune fuite de l'une vers l'autre. Les anciennes clés non affichables continuent de montrer l'espace réservé, car nous ne pouvons pas récupérer leur texte en clair.
Bouton Annuler sur les requêtes en cours
Si vous lanciez une request de test dans le playground vers un site cible lent, la seule option consistait jusqu'ici à attendre le timeout. Nous avons ajouté un bouton Cancel au panneau de chargement. Cliquez dessus, la request s'interrompt proprement et la zone de response revient à son état initial avec le message "Request canceled." au lieu d'une erreur alarmante.
Un détail, certes, mais le playground ressemble désormais à un véritable outil plutôt qu'à une démo. Vous pouvez sonder un site instable, annuler, ajuster la request et réessayer, sans jamais rester bloqué à attendre.
Sous le capot
Trois ajustements mineurs sur le bouton Reveal de cURL après le déploiement initial : le toast d'erreur affiche un message clair au lieu du code d'erreur brut, le bouton ne peut plus rester bloqué sur "Revealing…" si une autre exception survient, et un bug de spécificité CSS qui laissait le bouton visible pour des clés incompatibles avec l'affichage a été corrigé.
Si vous avez rencontré l'un de ces problèmes, il est désormais résolu. Si ce n'est pas le cas, vous n'avez rien manqué.
Générez, copiez, collez, perdez le fil. Revenez plus tard. Le Dashboard s'en souvient.