Supprimer une clé d'API
Une clé d'API (ou jeton d'API) autorise une application à utiliser le serveur OCR en votre nom : application mobile, plugin Dolibarr, script ou intégration tierce. Chaque clé est rattachée à votre compte.
Vous pouvez supprimer une clé à tout moment. Supprimez une clé lorsque :
- l'application qui l'utilisait n'est plus en service ;
- vous soupçonnez que la clé a été divulguée ou compromise ;
- vous faites le ménage parmi des clés de test ou inutilisées.
Attention : la suppression d'une clé d'API est définitive et immédiate. Toute application qui s'authentifie encore avec cette clé sera instantanément refusée. Assurez-vous d'avoir mis à jour ou arrêté l'application concernée avant de supprimer sa clé. Le serveur ne conserve que l'empreinte publique de la clé : il est impossible de retrouver ou de réémettre une clé supprimée.
Accéder à la liste des jetons d'API
- Connectez-vous à l'administration du serveur OCR (adresse
/admin). - Dans le menu latéral de gauche, cliquez sur Jetons d'API.
La liste affiche les clés rattachées à votre compte, avec les colonnes suivantes :
| Colonne | Description |
|---|---|
| Name | Nom donné à la clé lors de sa création. |
| Keyword | Mot-clé associé à la clé (par exemple le nom du client ou de l'application). |
| Created | Date de création de la clé. |
| Last used | Date de dernière utilisation, utile pour repérer les clés inactives. |
Selon votre profil, l'étendue de la liste varie :
- Utilisateur standard : vous ne voyez que vos propres clés.
- Revendeur : vous voyez vos clés et celles de vos clients (une colonne supplémentaire indique l'utilisateur propriétaire).
- Super-administrateur : vous voyez l'ensemble des clés du serveur.
Retrouver la clé à supprimer
Si vous avez beaucoup de clés, utilisez la barre de recherche en haut de la liste. La recherche porte sur le nom, le mot-clé et l'empreinte de la clé. Vous pouvez aussi cliquer sur l'en-tête d'une colonne pour trier la liste (par exemple par Last used afin de repérer les clés jamais utilisées).
Identifiez la ligne correspondant à la clé que vous souhaitez révoquer avant de poursuivre. Vérifiez le nom et le mot-clé pour ne pas supprimer une clé encore active.
Supprimer la clé
- Cliquez sur la ligne de la clé concernée pour ouvrir sa fiche.
- Vérifiez le nom et l'empreinte affichés afin de confirmer qu'il s'agit bien de la bonne clé.
- Cliquez sur le bouton de suppression (icône de corbeille).
- Confirmez la suppression dans la fenêtre qui s'affiche.
La clé disparaît immédiatement de la liste. À partir de cet instant, toute requête présentant cette clé est rejetée par le serveur.
Après la suppression
- L'application qui utilisait la clé ne pourra plus se connecter : elle affichera une erreur d'authentification.
- Pour rétablir l'accès, créez une nouvelle clé depuis la même page Jetons d'API, puis renseignez-la dans l'application concernée.
- Lors de la création d'une nouvelle clé, le serveur n'affiche la valeur complète qu'une seule fois : copiez-la et conservez-la en lieu sûr immédiatement, elle ne pourra plus être réaffichée ensuite.
Questions fréquentes
Puis-je récupérer une clé supprimée ?
Non. La suppression est définitive et le serveur ne stocke que l'empreinte publique de la clé. Vous devez créer une nouvelle clé.
La suppression affecte-t-elle mon abonnement ou mes quotas ?
Non. Supprimer une clé ne modifie ni votre abonnement ni vos quotas. Seul l'accès via cette clé précise est révoqué. Mais par contre votre facture sera probablement impactée: sauf accord spécifique toute clé d'api supplémentaire est facturée il est donc important de supprimer les clés inutilisées.
Comment savoir si une clé est encore utilisée ?
Consultez la colonne Last used : une date ancienne (ou absente) indique une clé peu ou jamais utilisée, donc plus sûre à supprimer.