Changes for page DigDash API REST

Last modified by Aurelie Bertrand on 2025/03/25 16:13

From version 1.2
edited by Aurelie Bertrand
on 2024/08/28 16:54
Change comment: There is no comment for this version
To version 3.1
edited by Aurelie Bertrand
on 2024/08/29 10:06
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -35,4 +35,30 @@
35 35  ❗Il n'est pas recommandé d'utiliser la méthode **BasicAuth** de manière systématique pour des raisons de sécurité.
36 36  )))
37 37  
38 +== Authentification via BasicAuth ==
39 +
40 +1. Entrez votre nom d'utilisateur et mot de passe Digdash.
41 +1. Cliquez sur le bouton **Authorize** puis, une fois l'authentification effectuée, sur **Close**.
42 +➡ Le cadenas est à présent fermé, signifiant que vous êtes autorisé.
43 +
44 +== Création du jeton de sécurité ==
45 +
46 +Nous allons créer ici le jeton de sécurité Json Web Token (JWT) :
47 +
48 +1. Allez dans la section **Authentication**.
49 +1. Cliquez sur **POST ddenterpriseapi/api/v1/auth/jwt.**
50 +1. Avant de commencer, vous pouvez visualiser un exemple de requête et en passant sur l'onglet **Schema**, une description des différents éléments.
51 +1. (((
52 +Cliquez sur **Try it out **en haut à droit afin de définir votre requête. Celle-ci comprend les éléments suivants :* **targetUser** : (Optionnel) Indiquez le nom de l'utilisateur à emprunter. Cela ne fonctionne que si l'utilisateur utilisé pour créer le JWT dispose de l'autorisation (ACL) **Admin > Autoriser l'emprunt d'identité**.
53 +S'il n'est pas renseigné, l'utilisateur utilisé par défaut est celui connecté, ce qui sera généralement le cas.
54 +
55 +* **expires** : (Optionnel mais recommandé) Indiquez la période de validité du JWT spécifiée sous la forme d'une période de temps au format ISO 8601 (c'est-à-dire PT5M pour 5 minutes). Pour plus d'informations, consultez [[https:~~/~~/en.wikipedia.org/wiki/ISO_8601#Durations>>https://en.wikipedia.org/wiki/ISO_8601#Durations]].
56 +* (((
57 +**permissions **: Définissez les autorisations à donner à ce jeton : "-" pour aucune autorisation, "r" pour lecture seule, "rw" pour lecture-écriture.
58 +)))
59 +* (((
38 38  
61 +)))
62 +)))
63 +
64 +