Cet article vous expliquera comment configurer les identités API pour le Dalux Build API.
Les identités API permettent d'accéder au Dalux Build API avec des autorisations spécifiques.
En créant une identité API, vous pouvez spécifier le niveau d'accès au système, que ce soit un accès à toutes les données de l'entreprise sur tous les projets ou un accès limité à certains groupes sur des projets particuliers.
Si vous souhaitez en savoir plus sur les API Dalux, lisez cet article : Dalux API.
Note
Les identités API remplaceront la fonctionnalité de clé API actuelle. Veuillez noter que toutes les clés API actuelles du profil de l'entreprise expireront après le 28 février 2026.
Toutes les clés API devront être remplacées par des identités API avant cette date.
Comment configurer les identités API
Les identités API sont configurées dans le profil de l'entreprise.
Autorisations
Seuls les administrateurs de l'entreprise peuvent configurer, modifier ou supprimer des identités API.
Pour créer une identité API, allez dans Profil de l'entreprise
Réglages
'Identités API'.
Dans la fenêtre des identités API, vous pouvez créer de nouvelles identités et gérer celles existantes.
Vous pouvez créer plusieurs identités pour gérer les niveaux d'accès selon les besoins. Pour créer une nouvelle identité API, cliquez sur Créer.
- Nom - Le nom de l'identité API affiché dans l'interface. Nous vous suggérons de choisir un nom à la fois descriptif et clair.
- Email - L'adresse e-mail saisie ici est utilisée pour valider l'API via un e-mail de confirmation
- Entreprise - Le nom de l'entreprise pour laquelle l'identité API est créée (métadonnées)
- Autorisations de l'entreprise - N'attribuez cette autorisation que lorsque l'identité API doit avoir accès aux données de tous vos projets. Les autorisations de l'entreprise correspondent à celles des rôles du profil de l'entreprise (Administrateur de l'entreprise et Observateur de l'entreprise). Cela peut être modifié après la création de l'identité.
- Description - Une brève description incluant des détails sur l'identité API, comme la portée d'accès, les informations de contact ou d'autres données pertinentes.
Après avoir fourni les informations nécessaires et accepté les Conditions générales de l'identité API, un e-mail de vérification sera envoyé à l'adresse e-mail que vous avez fournie. Si nécessaire, l'email peut être renvoyé. Vous ne pouvez pas générer de clé API tant que l'identité n'a pas été vérifiée.
Après avoir vérifié l'identité API, vous pouvez ajouter des paramètres de projet, qui permettent un accès plus spécifique au projet. Cette étape n'est nécessaire que si vous n'avez sélectionné aucun accès à l'entreprise.
Cliquez sur 'Ajouter un projet' pour continuer. Puis sélectionnez le projet et ajoutez le(s) groupe(s) d'utilisateurs.
Les permissions des groupes d'utilisateurs sélectionnés contrôlent l'accès de l'identité API au projet.
Lorsque vous avez terminé, cliquez sur 'Ajouter'.
Maintenant, vous pouvez ajouter une clé API à l'identité API. Cliquez sur 'Ajouter une clé API' pour continuer. Lors de l'ajout d'une clé API, vous devez spécifier la durée de sa validité.
Une clé API sera maintenant générée. Copiez la clé et confirmez que la clé a été copiée, puis cliquez sur 'OK'.
IMPORTANT
La clé API doit être copiée et stockée. Vous ne pourrez plus accéder à la clé API une fois la fenêtre fermée.
L'identité API peut désormais être utilisée avec le Dalux Build API.