Clés API
Créer et gérer les clés API pour l'accès programmatique aux services WakaStart.
Clés API
Une Clé API permet à un outil externe (logiciel tiers, automatisation, outil de déploiement) d'interagir avec WakaStart sans passer par l'interface web. Elle est associée à un utilisateur et à une application précise.
Quand utilisez-vous cette section ?
- Vous souhaitez connecter un outil externe à WakaStart (outil de déploiement, logiciel de supervision, script d'automatisation)
- Vous devez créer une clé avec des droits limités pour une intégration spécifique
- Vous voulez consulter ou révoquer des clés existantes
Important : la clé complète n'est visible qu'une seule fois, immédiatement après sa création. Copiez-la et conservez-la en lieu sûr avant de fermer la fenêtre.
Accéder à la liste des clés API
Depuis le menu principal à gauche, cliquez sur Applications puis Clés API.
La liste affiche, pour chaque clé : son nom, l'utilisateur associé, l'application concernée, sa date d'expiration (ou "Sans expiration") et son statut.
Créer une clé API
- Cliquez sur + Nouvelle clé en haut à droite.
- Renseignez les informations obligatoires :
- Utilisateur : le compte au nom duquel la clé agira
- Application : l'application à laquelle la clé donnera accès
- Nom de la clé : un libellé parlant pour l'identifier (ex. : "Connexion outil de monitoring")
- Définissez les droits de la clé (facultatif mais recommandé) :
- Profil : la clé hérite des droits d'un profil existant
- Niveau d'administration : vous pouvez limiter ce niveau à un niveau inférieur à celui de l'utilisateur
- Rôles données de santé : cochez les rôles HDS applicables si nécessaire
- Ajoutez des restrictions de sécurité si besoin (facultatif) :
- Date d'expiration : la clé sera automatiquement invalidée à cette date
- Adresses IP autorisées : limitez l'utilisation de la clé à certaines adresses ou plages d'adresses réseau
- Limite de requêtes par minute : protège contre les abus (0 = sans limite)
- Cliquez sur Créer.
La clé s'affiche une seule fois dans une fenêtre. Copiez-la immédiatement.
Révoquer une clé API
Cliquez sur l'icône corbeille en face de la clé. La révocation est immédiate et irréversible.