L'utilisation de l'API DataGalaxy est sécurisée et nécessite de disposer d'un jeton d'authentification (aussi appelés token). Deux types de token existent :
- Token d'accès personnel (aussi appelé PAT pour Personal Access Token) : associé à votre compte personnel, celui dispose des mêmes droits et exploite la même license que votre compte.
- Token d'intégration : la création d'un token d'intégration doit être effectué partir de la plateforme par un administrateur. Elle entraine automatiquement la création d'un utilisateur associé, sur lequel des droits et des restrictions pourront être définis, de la même façon que pour un utilisateur classique.
Consulter cet article pour plus de détails sur le fonctionnement de l'authentification et sur l'utilisation de nos APIs
L'utilisation d'un token d'intégration est préférable dans le cas d'une utilisation isolée du contexte de votre compte utilisateur, par exemple :
- lorsque l'on souhaite restreindre ou étendre les opérations possibles (i.e vous disposez personnellement de droits administrateurs, qui ne sont pas nécessaires pour les tâches que vous souhaitez effectuer via API)
- lorsque vous souhaitez vous assurer que ces opérations continueront d'être opérationnelles si votre compte venait à être désactivé (i.e pour la synchronisation de métadonnées dans DataGalaxy depuis un système tiers)
Cette notion est à distinguer de celle des intégrations disponibles dans l'onglet réglages des espaces de travail, qui correspond à des solutions déjà paramétrées dans DataGalaxy.
Activation du token d'accès personnel
Par défaut, le token d'accès lié à votre compte n'est pas activé. Vous devez aller dans votre page de profil pour vérifier s'il a déjà été défini et, le cas échéant, le générer.
1. Accéder à la page d'administration de votre profil
2. Vérifier si un token a déjà été activé, et le cas échéant, le générer
3. Vous pouvez alors copier la valeur de votre token pour vous authentifier lorsque vous souhaitez communiquer avec l'API
La re-génération d'un token invalidera le token précédemment créé
Création d'un token d'intégration
La création de token d'intégration nécessite une licence administrateur.
Suivez ces étapes :
- Connectez-vous à l'espace d'administration.
2. Allez dans l'onglet Intégration puis cliquez sur Créer.
3. Renseignez un nom de token puis cliquez sur Créer.
Si vous souhaitez effectuer des créations d'utilisateurs ou des mise a jour de licences via l'API, cochez la case Accès administrateur
4. Le token apparaît dans la liste
5. Les tokens d'intégration créés vont générer des utilisateurs "techniques" ayant une licence de type Steward. Les utilisateurs techniques ainsi créés apparaissent dans l'onglet Utilisateurs de la console d'administration. Un petit cadenas indique qu'ils sont non modifiables.
6. Dernière étapes : ajouter ces utilisateurs techniques dans des Equipes et leur donner des droits d'accès à des Workspaces. Voir: Gérer les droits d'accès des utilisateurs