Clients API
Le logiciel externe détient la clé d'accès à cette entreprise. Chaque appel qu'il effectue s'exécute avec les droits d'un utilisateur nommé, de sorte que tout ce qu'il peut atteindre est accessible uniquement par cet utilisateur. La clé n'est affichée qu'une seule fois, lors de son émission, et jamais plus.
Où le trouver
- Module: Plate-forme
- Groupe: Connectivité
- Section: API publiée
- Écran: Clients API
Adresse dans la console: /platform/api-clients
Liste · 14 colonnes · 13 champs sur son formulaire · 3 d'entre eux requis · 2 actes
Ce que la liste affiche
Voici les colonnes de la liste, dans l'ordre où elles apparaissent. Chacune d'elles peut être triée, filtrée, masquée ou exportée.
| Colonne | Gentil | Nom du champ |
|---|---|---|
| Client | Code | code |
| Nom | Texte | name |
| Logiciel | Texte | software_name |
| Protocole | Statut | protocol |
| Agit comme | Texte | run_as_name |
| Préparation | Statut | readiness |
| Accordé | Nombre | grant_count |
| Adresses | Nombre | allowlist_count |
| Clé | Code | key_last4 |
| Taux/min | Nombre | rate_limit_per_minute |
| Appels (24h/24) | Nombre | calls_24h |
| Refusé (24h) | Nombre | refused_24h |
| Dernière utilisation | Date et heure | last_used_at |
| Statut | Statut | status |
Le formulaire
Voici les informations demandées lors de la création d'un enregistrement. Les champs obligatoires sont indiqués ; un choix issu d'une liste de configuration est un choix qu'un administrateur peut compléter sans nouvelle version.
| Champ | Taper | Choix | Notes |
|---|---|---|---|
| Code client requis | Texte | ||
| Nom requis | Texte | ||
| De quel logiciel s'agit-il ? | Texte | Une clé survit à la personne qui l'a demandée. Dans trois ans, il faudra décider si elle est toujours nécessaire, et c'est sur cette base qu'il faudra se décider. | |
| À qui s'adresser ? | Adresse email | ||
| Là où il vit | Texte | ||
| À quoi ça sert | Texte long | ||
| Protocole | Choix | repos, mcp, les deux | La même clé permet d'accéder aux mêmes données, quelle que soit la méthode utilisée ; cela détermine quelle porte elle ouvre. Une clé MCP présentée à l'API REST est refusée explicitement, sans ambiguïté. |
| Agit comme requis | Choix | Consulté à partir des archives existantes | Chaque appel effectué par cette clé l'est au nom de cette personne. Ce que cette personne ne peut pas faire, la clé ne peut pas le faire non plus ; c'est ce qui empêche une vulnérabilité d'étendre l'accès au lieu de le restreindre. Attribuez-lui un utilisateur dédié, doté du rôle le plus restreint possible. |
| Uniquement à partir des adresses autorisées | Oui ou non | L'activation est explicite : une clé sans adresse répertoriée ne permet pas d'accéder à Internet. La désactiver signifie délibérément que cette clé peut être présentée depuis n'importe où dans le monde par quiconque la détient. | |
| Limite de débit par minute | Nombre | ||
| Que dire à un client MCP | Texte long | Ces instructions sont envoyées au serveur lors de la connexion d'un agent. Un modèle qui ignore que ces outils accèdent à un registre réel les traitera comme un environnement de test. | |
| Statut | Choix | actif, suspendu, révoqué | |
| Expire | Date |
Ce que vous pouvez faire ici
Clé d'émission primaire
Émettre une nouvelle clé API
Clé de retrait
Retirez cette clé
Les règles qui s'appliquent ici
Tout ce qui s'affiche à l'écran obéit aux règles de la plateforme et non à des règles propres. Voici celles qu'il est important de connaître avant de l'utiliser :
- Réduire une liste — Recherche, conditions, tri, totaux, exportation et vues enregistrées.
- Ce qui peut être changé — les cinq motifs pour lesquels un enregistrement ne peut être modifié.
- Entreprises et unités commerciales — ce que le commutateur situé au-dessus de cette liste lui fait.
- Création d'un enregistrement — champs obligatoires, provenance des choix et mode d'attribution des numéros.
- Importer une feuille de calcul — Cet écran en accepte un, et il suit les mêmes règles que la saisie au clavier.