Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Authentification

Apprenez à vous authentifier sur l'API Dastra.

Obtention de la clé secrète d'API

L'API REST de Dastra utilise les clés d'API pour authentifier chaque requête. Vous gérez vos clés dans la page Clés d'API & MCP, réservée aux propriétaires de l'organisation. Voir Gestion des clés d'API.

Vous pouvez utiliser une clé d'API pour un espace de travail spécifique ou l'organisation complète.

Une clé d'API donne accès à vos données : conservez-la précieusement. Ne partagez pas votre clé privée dans les parties publiques d'applications, comme GitHub ou le code client.

Une clé expirée ou inconnue est refusée avec le code 401.

Si vous souhaitez utiliser l'authentification OAuth2 en mode « authorization_code », renseignez les URI de redirection et les origines CORS autorisées dans le panneau de détails de la clé.

La fenêtre de création d'une clé d'API, avec le nom, l'espace de travail, l'expiration et les permissions
La création d'une clé d'API

Clé d'API (X-API-Key)

Pour vous authentifier, la manière la plus simple est d'utiliser une entête HTTP X-API-Key contenant la clé privée de votre clé d'API, comme dans l'exemple ci-dessous :

OAuth2 « Authorization code » flow

Authorization

La phase d'autorisation s'effectue en appelant l'URL suivante :

Paramètres

Nom du paramètre
Description

response_type

code

client_id

La clé publique de votre clé d'api configuré dans votre compte Dastra

redirect_uri

L'url configuré dans la clé d'API de Dastra. Vous serez automatiquement redirigé sur cette page à l'issue du processus d'authorisation

scope

api1 => obligatoire

offline_access => pour récupérer un refresh_token (sessions longues)

state

Une clé aléatoire généré par votre application qui permet d'éviter les attaques de type cross-site request forgery (CSRF) , lire Mitigate CSRF Attacks With State Parameters. Les librairies cliente gèrent ça rapidement

OAuth2 « Client credential » flow

Méthode d'authentification

L'authentification de l'API s'effectue grâce à l'aide du protocole OAuth2 utilisant le flow « Client credential ». Ce mode d'authentification doit être utilisé uniquement pour des requêtes de serveur à serveur et ne doit en aucun cas être utilisé côté navigateur (SPA en javascript par exemple).

Schéma du flow Client credentials : votre serveur demande un jeton au serveur d'identification de Dastra, puis appelle l'API avec ce jeton
Le flow Client credentials

Récupération du token

POST https://account.dastra.eu/connect/token

Demandez un jeton en passant vos clés dans un en-tête Basic.

En-têtes

Nom
Type
Description

*

Authorization

Basic {base64("{PublicKey}:{PrivateKey}")}

Corps de la requête

Nom
Type
Description

*

grant_type

client_credentials

*

scope

api1

Une fois que vous avez récupéré un access_token, vous pouvez ensuite appeler n'importe quel endpoint de l'API Rest à l'aide de ce jeton d'accès en le passant en « Bearer token ».

Par exemple, pour récupérer la liste de vos espaces de travail :

GET https://api.dastra.eu/v1/Workspaces

Liste les espaces de travail de Dastra.

En-têtes

Nom
Type
Description

*

Authorization

Bearer {access_token}

Toutes les requêtes doivent s'effectuer en HTTPS et toujours côté serveur. Les requêtes sans authentification échoueront avec le code d'erreur 401

Consultez les références de l'API ici : https://api.dastra.eu/swagger/index.html

Mis à jour

Ce contenu vous a-t-il été utile ?