Jetons API

Les jetons API vous permettent de connecter l'API REST complète d'InfraNest à vos propres scripts ou outils, afin d'automatiser tout ce que vous feriez normalement dans l'application. Cela s'adresse à toute personne souhaitant gérer son infrastructure de manière programmatique plutôt qu'en naviguant dans l'application.

Vue d'ensemble

• Les jetons API sont le moyen par lequel vous vous authentifiez lors des appels à l'API d'InfraNest.
• Chaque jeton peut être limité aux seuls domaines et actions dont il a besoin.
• Les jetons sont gérés depuis une page dédiée où vous pouvez suivre leur utilisation et révoquer l'accès à tout moment.

Créer un jeton

1. Allez dans Jetons API et sélectionnez Créer.
2. Donnez-lui un nom, choisissez ses capacités (ce qu'il peut faire), et définissez éventuellement une date d'expiration.

3. Sélectionnez Copier pour enregistrer immédiatement le jeton — il n'est affiché qu'une seule fois. Par la suite, vous ne verrez qu'un indice des derniers caractères.

WarningUne fois que vous quittez l'écran du jeton, vous ne pourrez plus jamais afficher le jeton complet. Si vous le perdez, vous devrez en créer un nouveau.

Comprendre les capacités

Les capacités déterminent exactement ce qu'un jeton peut faire :

• Choisissez un accès en lecture ou en écriture pour chaque domaine — certificats, DNS, domaines, cloud et supervision.
• Utilisez le préréglage lecture seule pour les jetons qui n'ont besoin que de consulter les données.
• Utilisez accès complet pour les jetons qui doivent tout pouvoir faire.

TipN'accordez à chaque jeton que les capacités dont il a réellement besoin. Un jeton avec un accès plus restreint est plus sûr en cas d'exposition.

Gérer les jetons

1. Allez dans Jetons API pour voir la liste complète de vos jetons.
2. Consultez la colonne Statut pour voir la dernière utilisation de chaque jeton.
3. Sélectionnez Retirer à côté d'un jeton pour le révoquer immédiatement.

TipPour plus de détails sur chaque action disponible, sélectionnez View full API documentation depuis la page Jetons API.

Dépannage

Certaines actions — comme les synchronisations manuelles ou les demandes Vérifier — sont soumises à une limite de fréquence par organisation afin de protéger la plateforme. Si vous dépassez cette limite, un message vous demandera de réessayer un peu plus tard.