Passer au contenu principal
POST
Créer une session

Créer une session

POST /v1/agent-sessions Crée une nouvelle session authentifiée pour un agent machine. La session lie un jeton d’accès et un jeton de rafraîchissement à durée limitée à l’agent, avec un ensemble de portées explicite qui doit être un sous-ensemble des portées accordées à l’agent. Les token et refresh_token ne sont renvoyés que dans la réponse de création. Stockez-les en toute sécurité — ils ne pourront pas être récupérés ultérieurement.
Les champs token et refresh_token ne sont renvoyés qu’une seule fois dans cette réponse. Stockez-les dans un gestionnaire de secrets sécurisé ou un stockage chiffré immédiatement. En cas de perte, terminez la session et créez-en une nouvelle.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

object
L’objet de session créé contenant :
string
Clé primaire UUID interne.
string
Identifiant de session MAIP au format maip-sess:<short-uuid>:<random-hex>. Utilisez cet ID dans les appels d’API ultérieurs.
string
L’agent auquel appartient cette session.
string
Statut de la session. Toujours "active" à la création.
string[]
Les portées effectives pour cette session.
object
Métadonnées de session.
string
Horodatage d’expiration ISO 8601.
string
Horodatage de création ISO 8601.
string
Horodatage de dernière mise à jour ISO 8601.
string
Jeton d’accès opaque pour l’authentification des requêtes API au sein de cette session. Chaîne hexadécimale de 64 caractères. Retournée une seule fois.
string
Jeton pour rafraîchir la session avant expiration. Chaîne hexadécimale de 64 caractères. Retourné une seule fois.

Exemple


Cycle de vie de la session

Un reçu de session est automatiquement créé au début de la session, liant la session à la piste d’audit de l’agent.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
agent_id
string<uuid>
requis

Agent pour lequel créer la session

metadata
any
scopes
string[]

Portées pour cette session (doit être un sous-ensemble des portées de l'agent)

ttl_minutes
integer

Réponse

Session créée

session_id
string<uuid>
agent_id
string<uuid>
token
string

Jeton de porteur de session (retourné une seule fois lors de la création)

scopes
string[]
status
enum<string>
Options disponibles:
active,
terminated,
expired
metadata
object
expires_at
string<date-time>
created_at
string<date-time>
terminated_at
string<date-time>