Utilisateurs fonctionnels

Un utilisateur fonctionnel est un compte de service non humain conçu pour faciliter les tâches automatisées et les intégrations système à système. Contrairement aux utilisateurs standard, les utilisateurs fonctionnels ne sont pas liés à une personne ou à une adresse e-mail spécifique, ce qui garantit la continuité des flux de travaux automatisés, même lorsque les membres de l'équipe changent ou quittent l'entreprise.

Création d'utilisateurs fonctionnels

Pour des raisons de sécurité, seul un Administrator peut créer des utilisateurs fonctionnels, et uniquement via l'API.

Utilisez le nœud final d'API /api/v4/User/CreateFunctionalUser pour créer un utilisateur fonctionnel. Incluez au moins les paramètres suivants :

FirstName : Nom de compte descriptif (par exemple, « Jira_Automation_Service »).
RoleId : Rôle à attribuer à l'utilisateur fonctionnel. Récupérez le RoleId à l'aide de l'API suivante :
```
api/v4/Roles
```

Conseil :

Une adresse e-mail active est facultative, mais vous pouvez en attribuer une si nécessaire.
Si l'utilisateur n'est pas un Administrator, associez-le à des groupes d'actifs. Vous pouvez l'ajouter ultérieurement, mais il est essentiel que l'utilisateur effectue des tâches dans des contextes liés à l'application.
Récupérez les AssetGroupIds à l'aide de l'API suivante :
```
api/v4/AssetGroups
```

Après une requête POST réussie, la réponse inclut l'API key, et le système crée un utilisateur fonctionnel avec un nom d'utilisateur généré automatiquement au format <FirstName>_Func_<OrgID>.

Important : L'API key ne s'affiche qu'une seule fois. Copiez-la immédiatement et conservez-la dans un emplacement sécurisé (comme un gestionnaire de secrets). Elle ne sera pas visible dans l'interface utilisateur ni accessible via les appels d'API suivants.

Gestion des utilisateurs fonctionnels dans l'interface utilisateur

Une fois que vous les avez créés via l'API, les utilisateurs fonctionnels apparaissent dans le tableau Gestionnaire des utilisateurs à côté de tous les autres utilisateurs et sont traités comme des utilisateurs standard. Pour connaître les actions disponibles, voir la page Gestion des utilisateurs.

Pour filtrer la liste des utilisateurs fonctionnels, recherchez le mot clé "func".

Rotation de la clé d'API

Vous pouvez faire pivoter les clés d'API si nécessaire.

Processus : Effectuez la rotation des clés via l'API.
Expiration immédiate : Si vous générez une nouvelle clé d'API, la clé précédente expire immédiatement. Mettez à jour vos scripts d'automatisation et vos intégrations immédiatement pour éviter les temps d'arrêt.
Affichage unique : Comme pour la création initiale, la nouvelle clé n'est renvoyée qu'une seule fois dans la réponse de l'API et doit être enregistrée localement.