Gestion des comptes de service

Un compte de service est nécessaire pour qu'une application ou un script utilise API ThingPark OSS ou l'API héritée DX-API.

Seuls les administrateurs peuvent créer et gérer des comptes de service.

Création d'un compte de service

Le compte de service génère l'ID client et le secret client à donner au développeur pour s'authentifier avec l'API ThingPark.

important

Le secret client peut être utilisé autant de fois que nécessaire avec le compte de service auquel il appartient, mais peut uniquement être régénéré s'il est perdu. Pour plus d'informations, consultez Régénération du secret client.

Quant aux utilisateurs, vous pouvez configurer les autorisations du compte de service en utilisant :

• Rôles ,
• Restrictions de domaine, si la séparation basée sur les domaines a été activée. Voir À propos des domaines.

Définissez les autorisations du compte de service en fonction des exigences de l'application.

---

1. Sélectionnez Administration > Comptes de service.

2. Cliquez sur AJOUTER UN COMPTE DE SERVICE.

3. Saisissez un Nom et un ID Client pour votre compte de service. Vous ne pouvez fournir que le suffixe de l'ID client.

4. (Optionnel) Ajoutez des restrictions de domaine pour restreindre les ressources accessibles par le compte de service. Disponible uniquement si la séparation basée sur les domaines a été activée. Pour plus d'informations, voir À propos des domaines.

   

5. Sélectionnez le rôle que vous souhaitez attribuer au compte de service pour définir les types de ressources que le compte de service est autorisé à gérer.

6. Lorsque vous avez terminé, cliquez sur AJOUTER.

7. Dans le nouveau compte de service qui s'affiche, allez dans la section CREDENTIELS pour copier le Secret client.

   important

   Pour des raisons de sécurité, le secret client ne s'affichera plus et ne peut être régénéré que s'il est perdu.

8. Donnez les informations suivantes du compte de service au développeur pour suivre les instructions données sur cette Mise en route page :

   • ID client
   • secret client

Visualisation des comptes de service

Dans la liste des comptes de service, vous pouvez afficher tous les comptes de service actifs et désactivés et personnaliser la liste.

---

1. Sélectionnez Administration > Comptes de service.
2. Pour personnaliser la liste selon vos besoins, cliquez sur Afficher/Masquer les colonnes. Votre sélection est enregistrée dans votre navigateur web et s'applique au même ordinateur.

Exportation des comptes de service

Vous pouvez exporter tous les comptes de service de votre compte dans un fichier CSV. Il exporte toutes les informations, peu importe les colonnes masquées dans la liste des comptes de service.

---

1. Sélectionnez Administration > Comptes de service.
2. Cliquez sur Exporter en CSV.

Visualisation et modification d'un compte de service

Vous pouvez accéder aux informations du compte de service depuis la liste des comptes de service.

Vous pouvez modifier les informations de n'importe quel compte de service sauf :

• Le préfixe de l'ID client
• Le secret client. Pour plus d'informations, consultez Régénération du secret client.

---

1. Sélectionnez Administration > Comptes de service.
2. Effectuez l'une des actions suivantes :
   1. Cliquez sur le nom du compte de service que vous souhaitez modifier.
   2. Passez votre pointeur sur le nom du compte de service que vous souhaitez modifier, puis cliquez sur Ouvrir dans un nouvel onglet.
3. Sur la page du compte de service, vérifiez ou modifiez les informations souhaitées.

Régénération du secret client

Si le secret client du compte de service est perdu, vous pouvez le générer à nouveau.

---

1. Sélectionnez Administration > Comptes de service.
2. Cliquez sur le nom du compte de service dont vous souhaitez régénérer le secret client.
3. Dans CREDENTIELS, cliquez sur RÉGÉNÉRER.
4. Cliquez sur RÉGÉNÉRER pour confirmer.
5. Dans Secret client, cliquez sur Copier, puis enregistrez le secret client.

Désactivation/activation d'un compte de service

Si vous n'êtes pas sûr qu'un compte de service est encore utilisé, vous pouvez d'abord le désactiver, puis le supprimer ou l'activer une fois confirmé.

Si on vous dit qu'un compte de service ne fonctionne pas, vous pouvez vérifier qu'il existe toujours sur le compte, puis l'activer à nouveau.

important

Lorsque le compte de service est désactivé, le secret client est conservé et peut être réutilisé lorsque le compte de service est réactivé.

---

1. Sélectionnez Administration > Comptes de service.

2. Cliquez sur le nom du compte de service que vous souhaitez désactiver ou activer.

3. Cliquez sur la flèche à côté de l'étiquette ACTIF ou DÉSACTIVÉ, puis cliquez sur Désactiver ou Activer.

   -> L'état de l'étiquette du compte de service change.

Suppression d'un compte de service

Vous pouvez arrêter l'utilisation d'un compte de service en le supprimant :

• Soit depuis la liste des comptes de service
• Soit depuis la page du compte de service.

---

1. Sélectionnez Administration > Comptes de service.
2. Dans la liste des comptes de service qui s'affiche, effectuez l'une des actions suivantes :

   1. Pour supprimer le compte de service de la liste des comptes de service :

      Dans la ligne du compte de service que vous souhaitez supprimer, cliquez sur ..., puis Supprimer.

   2. Pour supprimer le compte de service depuis la page du compte de service :

      1. Cliquez sur le nom du compte de service.
      2. Sur la page du compte de service, cliquez sur Supprimer.
3. Cliquez sur Supprimer pour confirmer.