Modifications pour le document DigDash API REST

Modifié par Aurelie Bertrand le 2025/03/25 16:13
Depuis la version 1.3
modifié par Aurelie Bertrand
sur 2024/08/28 16:58
Commentaire de modification : Il n'y a aucun commentaire pour cette version
À la version 2.2
modifié par Aurelie Bertrand
sur 2024/08/29 10:03
Commentaire de modification : Il n'y a aucun commentaire pour cette version

Résumé

Détails

Propriétés de la Page
Contenu
... ... @@ -35,10 +35,25 @@
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 -== Première authentification ==
38 +== Authentification via BasicAuth ==
39 39  
40 -Entrez votre nom d'utilisateur et mot de passe Digdash.
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é.
41 41  
42 -Cliquez sur le bouton Authorize puis, l'authentification effectuée, sur Close.
44 +== Création du jeton de sécurité ==
43 43  
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. Cliquez sur **Try it out **en haut à droit afin de définir votre requête. Celle-ci comprend les éléments suivants :
52 +1*. **targetUser** : (Optionnel) 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é.
54 +1*. **expires** : (Optionnel mais recommandé) 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]].
55 +1*. (((
56 +**permissions **: Autorisations à donner à ce jeton : "-" pour aucune autorisation, "r" pour lecture seule, "rw" pour lecture-écriture.
57 +)))
58 +
44 44