Clés API

Les clés API ne sont pas des Membres disposant d'identifiants. Elles disposent de leur propre modèle de permissions, plus simple :

Les deux modèles sont délibérément distincts. Les Membres reçoivent des rôles, des profils et une granularité par compte, car les personnes accumulent des responsabilités variées. Les clés reposent sur un modèle plat combinant périmètre et comptes, car l'automatisation doit être ciblée, uniforme et facile à auditer en un coup d'œil.

Une clé API regroupe deux paramètres : ce qu'elle peut faire (ses permissions) et où (ses comptes).

Autorisations

Association des comptes

Chaque clé est associée à un ou plusieurs comptes, sélectionnés à sa création et modifiables ultérieurement. Les permissions de la clé s'appliquent uniformément à chaque compte sélectionné :

• Une clé disposant des permissions "Consulter les fonds" et "Créer et modifier des ordres" sur deux comptes peut lire les soldes et passer des ordres sur les deux, sans aucune autre action possible.
• Une même clé applique les mêmes permissions à tous ses comptes, sans exception. Si votre automatisation doit trader sur un compte et seulement consulter un autre, utilisez deux clés. Cela rend le périmètre d'action de chaque clé immédiatement lisible.

Connectivité FIX

Les clés disposant de permissions sur les ordres prennent en charge la connectivité FIX pour le trading spot, en complément des API REST et WebSocket. Une session FIX hérite des mêmes permissions et de la même association de comptes que la clé sous-jacente : elle opère uniquement sur les comptes sélectionnés, dans les limites des permissions définies. Les entreprises acheminant des flux d'ordres FIX dédient généralement une clé par session, limitée aux comptes du desk concerné.

Les paramètres de sécurité

La gouvernance de l'Organisation s'applique à ce que font les clés et à la façon dont elles sont gérées.

Ce que font les clés

La règle à deux catégories applicable aux Membres s'applique de la même façon aux clés :

• Les opérations directes s'exécutent immédiatement. Le trading, les Gains, les consultations de solde, les consultations du registre et les exportations de données s'effectuent sur-le-champ, dans les limites des permissions et des comptes de la clé.
• Les opérations soumises à gouvernance créent des demandes. Un retrait ou une modification d'adresse initié par une clé suit le même circuit qu'une demande émanant d'un Membre : la politique du workflow détermine si elle s'exécute immédiatement ou si elle est placée en file d'attente pour validation humaine.

Une clé ne peut qu'initier des demandes soumises à gouvernance. Les clés ne disposent jamais du droit d'approbation : la séparation des tâches exige qu'un Membre humain approuve chaque demande, et aucun script ne peut se substituer à ce jugement. Lorsque la politique de demande de retrait exige deux approbations, un retrait initié par une clé attend la validation de deux Membres, exactement comme le ferait une demande initiée par un Membre.

Concevez vos automatisations autour de cette asynchronie : un appel API réussi signifie que la demande a été créée, non que les fonds ont bougé. Suivez la demande jusqu'à son exécution et prenez en compte la limitation actuelle : une demande en attente ne réserve pas les fonds. Si le solde évolue pendant la validation, la demande approuvée échoue et doit être soumise à nouveau. Voir Maintenir les fonds disponibles jusqu'à l'approbation.

Les clés n'ont également aucun accès aux workflows administratifs. La gestion des accès de l'équipe, des clés API, des comptes, des adresses (hors initiation de demandes d'adresse) et des politiques est réservée aux Membres.

Gestion des clés

La création, la modification et la révocation des clés API constituent des opérations soumises à gouvernance, dans le cadre du workflow dédié Gérer les clés API, distinct de Gérer l'équipe et les accès. Cette séparation a deux implications :

• Des administrateurs distincts. Vous pouvez autoriser un ingénieur des opérations à gérer les clés sans pouvoir modifier les accès des Membres, et inversement.
• Des politiques distinctes. La gestion des clés peut être soumise à ses propres exigences d'approbation. De nombreuses Organisations exigent une approbation indépendante pour créer ou modifier une clé – toute nouvelle clé représentant une nouvelle voie d'accès à vos comptes – tout en maintenant la possibilité de révoquer rapidement.

1. Accédez à Clés API et sélectionnez Créer une clé.
2. Nommez la clé selon sa fonction – le système qu'elle dessert et ce qu'elle fait – afin que son rôle soit immédiatement identifiable lors des audits et des incidents de sécurité.
3. Sélectionnez les permissions de la clé.
4. Sélectionnez les comptes sur lesquels la clé opère. Les permissions s'appliquent uniformément à l'ensemble de ces comptes.
5. Configurez les paramètres de sécurité : expiration, restrictions IP, fenêtre de nonce.
6. Vérifiez et confirmez. Si la politique Manage API Keys exige une approbation, la demande est suspendue jusqu'à l'obtention des validations requises avant l'émission de la clé.

La modification des permissions ou des comptes associés à une clé, ainsi que sa révocation, suivent le même processus soumis à gouvernance.

L'appel a créé une demande de retrait, actuellement retenue en attente d'approbation par la politique de demande de retrait. Consultez la page Demandes : la demande y figure avec la clé comme initiateur, en attente des approbations requises de la part des membres. C'est le modèle de gouvernance qui fonctionne comme prévu : l'automatisation propose, les humains valident.

Si la demande a été approuvée mais que les fonds n'ont pas bougé, vérifiez si le solde source couvrait le montant au moment du traitement : une demande en attente ne réserve pas les fonds, et toute activité intervenue pendant la révision peut entraîner l'échec d'une demande pourtant approuvée. Soumettez à nouveau la demande une fois le solde reconstitué.

Le compte concerné ne figure pas dans le mappage de comptes de la clé. Une clé n'agit que sur les comptes qui lui sont associés. Modifiez la clé pour y ajouter le compte, en notant que l'ensemble des permissions de la clé s'y appliquera, les clés n'admettant aucune variation par compte. Si ce périmètre est trop large, créez une seconde clé limitée au nouveau compte.

Une même clé ne peut pas avoir des permissions différentes selon le compte. Créez deux clés : une clé de trading associée au compte A et une clé en lecture seule associée au compte B. Des clés plus ciblées sont aussi plus faciles à auditer et plus sûres à révoquer.

Le workflow Manage API Keys nécessite probablement une approbation, et la demande est toujours en attente. La clé est émise, et son secret affiché, uniquement une fois les approbations requises obtenues. Vérifiez le statut de la demande sur la page Demandes.

Non. L'approbation requiert toujours un Membre humain. Il s'agit d'une règle système, et non d'une politique configurable : c'est elle qui donne tout son sens à l'approbation multipartite lorsque l'automatisation initie des mouvements de fonds.