Guide de l’administrateur

Ce guide s’adresse aux administrateurs d’organisation — les personnes chargées de déterminer qui peut se connecter, quelles équipes existent et comment l’organisation collabore avec ses partenaires.

L’administration s’effectue dans deux interfaces :

DICE — l’application elle-même, où s’effectue le travail quotidien et où les administrateurs d’équipe gèrent les connexions et le partage.
Le portail DUST Account — le site de gestion des comptes où sont gérés l’appartenance à l’organisation, les équipes, les invitations et les clés API. Ouvrez-le depuis DICE via le menu utilisateur (en haut à droite) → Gestion du compte.

Inviter des utilisateurs

Les comptes utilisateur et l’appartenance à l’organisation sont gérés dans le portail DUST Account, et non dans DICE. Les nouveaux membres rejoignent l’organisation sur invitation :

Ouvrez le portail de gestion des comptes (menu utilisateur → Gestion du compte) et accédez à la section Invitations de votre organisation.
Cliquez sur Inviter un utilisateur. Dans la boîte de dialogue Créer une invitation, saisissez l’adresse e-mail de la personne invitée, choisissez son rôle dans l’organisation (Membre ou Administrateur) et, si vous le souhaitez, affectez-la immédiatement à une équipe.
Cliquez sur Envoyer l’invitation. La personne invitée reçoit un e-mail contenant un lien Accepter l’invitation.
La personne invitée suit le lien, se connecte (ou crée son compte DUST), puis accepte l’invitation. Elle apparaît ensuite dans la liste des membres de votre organisation.

À retenir :

Les invitations expirent après 48 heures. Depuis la liste des invitations, vous pouvez renvoyer une invitation (ce qui renouvelle sa date d’expiration) ou annuler une invitation en attente.
Les administrateurs d’organisation ne peuvent pas créer eux-mêmes de nouvelles organisations — les organisations sont provisionnées par DUST Identity.
Les membres existants sont gérés depuis la section Utilisateurs de l’organisation : modifiez le rôle d’un membre ou retirez-le de l’organisation.

Ce que voit un tout nouvel utilisateur

Un utilisateur qui se connecte à DICE avant d’appartenir à une organisation et à une équipe arrive sur l’écran de sélection du contexte. Celui-ci lui indique que son compte ne fait encore partie d’aucune organisation ni équipe et affiche l’adresse e-mail utilisée pour se connecter. Ce qu’il peut ensuite faire dépend de l’existence ou non d’une invitation :

Vous l’avez invité. L’invitation figure sur cet écran sous Invitations en attente, avec l’organisation, le rôle qui lui sera attribué et l’identité de l’expéditeur. Il clique sur Accepter et DICE prend automatiquement en compte le nouvel accès ; Actualiser permet de couvrir les quelques secondes que peut prendre la propagation. Demandez aux utilisateurs d’accepter l’invitation affichée devant eux — il n’est pas nécessaire de se déconnecter, de se reconnecter ni d’ouvrir une demande d’assistance.
L’invitation a expiré. Elle est indiquée comme Expirée · demander une nouvelle invitation. L’utilisateur peut sélectionner Demander une nouvelle invitation pour solliciter vos administrateurs ; vous pouvez choisir Renvoyer l’invitation dans la liste des invitations du portail de gestion des comptes, ce qui la renouvelle afin qu’il puisse l’accepter immédiatement.
Vous ne l’avez pas invité. L’écran lui indique de s’adresser à l’administrateur de son organisation et propose l’option Contacter l’assistance. C’est le seul cas où « contacter un administrateur » constitue la bonne première étape.

Deux précisions qu’il est utile de communiquer d’emblée aux nouveaux utilisateurs : les invitations sont associées à une adresse e-mail précise, ils doivent donc se connecter avec l’adresse que vous avez invitée ; et, dès lors qu’ils appartiennent à une organisation, toute invitation ultérieure apparaît sous Invitations dans le menu utilisateur de DICE plutôt que sur cet écran.

Consultez également la FAQ.

Équipes

Tout ce qu’un utilisateur fait dans DICE s’inscrit dans le contexte d’une organisation et d’une équipe — les fiches, dossiers, expéditions et autres données appartiennent à une équipe, et les utilisateurs changent de contexte depuis l’en-tête. Un utilisateur doit appartenir à au moins une équipe pour utiliser DICE.

La gestion des équipes s’effectue également dans le portail de gestion des comptes, dans la section Équipes de votre organisation :

Créer une équipe — réservé aux administrateurs d’organisation (« Seuls les administrateurs d’organisation peuvent créer des équipes »). Une équipe n’a besoin que d’un nom.
Ajouter des membres — sélectionnez-les parmi les membres existants de l’organisation (recherche par nom ou adresse e-mail). Invitez d’abord les personnes à rejoindre l’organisation, puis affectez-les à des équipes.
Rôles d’équipe — chaque membre d’une équipe est soit Membre (« Accès standard à l’équipe »), soit Administrateur (« Gérer les membres de l’équipe »). Les administrateurs d’équipe peuvent gérer les membres de leur propre équipe sans disposer de droits d’administrateur d’organisation.
Éditeur — une autorisation supplémentaire accordée à un membre de l’équipe par un administrateur d’équipe. Il ne s’agit pas d’un troisième échelon au-dessus de Membre : un membre dispose ou non de cette autorisation, et les administrateurs d’équipe en disposent toujours. Le rôle d’éditeur conditionne la publication des données de l’équipe — toute modification dans le module Pages publiques (création et publication de modèles, publication ou dépublication d’une page, déploiement d’une version, lancement ou annulation d’un lot de publication) le requiert. Les membres qui n’en disposent pas peuvent tout de même ouvrir le module et consulter les modèles, l’historique des versions, les pages publiées et l’activité des pages. Les comptes de service peuvent également disposer de cette autorisation, afin qu’une intégration puisse publier sans intervention humaine.
Renommer ou supprimer — depuis les paramètres de l’équipe.

Les administrateurs d’équipe disposent également de fonctionnalités supplémentaires dans DICE : la section d’administration de l’équipe dans la barre latérale (par exemple Connexions) n’apparaît que pour les administrateurs de l’équipe active.

Configurer la collaboration entre organisations

La collaboration avec une autre organisation commence par une connexion entre l’une de vos équipes et l’une des siennes. L’établissement d’une connexion est une tâche administrative — la confirmation réciproque est effectuée par les administrateurs d’équipe des deux côtés. Consultez Connexions pour connaître le processus complet, notamment la direction de la connexion (qui peut envoyer et qui peut recevoir).

Une fois la connexion confirmée :

Les équipes peuvent partager des fiches et des dossiers avec l’équipe partenaire — consultez Partage et accès.
Les équipes peuvent envoyer des expéditions afin de transférer des fiches à l’organisation partenaire, lorsque la direction de la connexion l’autorise.

Disponibilité des modules

DICE est modulaire. Des fonctionnalités telles que les expéditions, les certificats, les Vlinks, la division, les pages publiques, les connexions et le partage sont activées pour chaque organisation par DUST Identity — il ne s’agit pas d’options qu’un administrateur d’organisation peut activer ou désactiver dans le produit.

Lorsqu’un module est désactivé pour votre organisation, ses entrées de navigation sont entièrement masquées ; les utilisateurs ne voient aucun élément verrouillé ou grisé. Si votre équipe demande « où se trouve la fonctionnalité X ? », vérifiez que le module est activé avant de poursuivre le dépannage.

Pour modifier les modules activés pour votre organisation, contactez support@dustidentity.com.

Accès à l’API

L’accès programmatique à la plateforme DUST repose sur des comptes de service — des identités machine appartenant à votre organisation — gérés dans le portail de gestion des comptes (page de l’organisation → onglet Comptes de service). Un compte de service appartient à une seule organisation, peut obtenir l’accès à une équipe comme un membre, et chacune de ses actions lui est attribuée dans l’historique des activités. La création et la gestion de comptes de service nécessitent que les deux conditions suivantes soient remplies :

Vous êtes administrateur de l’organisation, et
Les comptes de service sont activés pour cette organisation par DUST Identity. S’ils ne le sont pas, l’onglet affiche un message vous invitant à contacter support@dustidentity.com pour demander l’accès.

Chaque compte de service peut détenir des clés API et/ou un client OAuth pour client_credentials. Les secrets des identifiants de connexion ne sont affichés qu’une seule fois lors de leur création — copiez-les immédiatement. Plusieurs identifiants de connexion peuvent être actifs simultanément, ce qui permet d’effectuer une rotation sans interruption de service ; la date de dernière utilisation de chaque identifiant est visible dans le portail. La désactivation d’un compte de service l’empêche immédiatement d’obtenir de nouveaux jetons.

À des fins de traçabilité, la politique d’attribution à l’opérateur d’un compte de service peut être définie comme obligatoire, ce qui impose que ses écritures via l’API déclarent la personne ayant initié chaque action (par exemple, l’identifiant d’un badge d’atelier) — consultez Authentification de l’API.

Consultez Authentification de l’API pour savoir comment authentifier les requêtes API, et Environnements pour connaître les URL des environnements.

Référence rapide

Tâche	Emplacement
Inviter un utilisateur, gérer les membres et les rôles	Portail DUST Account → organisation → Utilisateurs / Invitations
Créer des équipes, gérer l’appartenance aux équipes	Portail DUST Account → organisation → Équipes
Se connecter à une organisation partenaire	DICE → Connexions (administrateurs d’équipe ; consultez Connexions)
Partager des fiches ou des dossiers entre équipes	DICE (consultez Partage et accès)
Activer ou désactiver des modules	Contactez support@dustidentity.com
Comptes de service et identifiants de connexion à l’API	Portail DUST Account → organisation → Comptes de service (consultez Authentification de l’API)

Signaler un problème dans la documentation