Générer, gérer et utiliser les clés API de Devolutions Server

Cet article décrit comment générer et gérer les clés API pour Devolutions Server, ainsi que la façon de les utiliser.

Autoriser les utilisateurs à générer des clés API

L'utilisation des clés API nécessite une autorisation qui peut être accordée globalement ou au niveau de l'utilisateur. Pour permettre à tous les utilisateurs de générer et d'utiliser des clés API, accédez à Administration – Paramètres système – Utilisateurs, et cochez Autoriser les clés API sous l'en-tête Utilisateurs.

Pour des utilisateurs spécifiques, accédez à Administration – Utilisateurs – Modifier (icône de crayon) – Paramètres, et choisissez Oui dans le menu déroulant Autoriser les clés API.

L'autorisation au niveau de l'utilisateur remplace les paramètres globaux, ce qui permet aux administrateurs un contrôle granulaire sur l'utilisation des clés API.

Gestion et utilisation des clés API

Une fois l'autorisation appropriée accordée, les utilisateurs peuvent générer des clés API en cliquant sur leur photo de profil, puis sur Préférences – Clés API – Générer une clé API.

Une fois générée, une clé API ne sera affichée qu'une seule fois. Gardez la clé secrète, renouvelez-la régulièrement et supprimez-la si elle est compromise.

Les clés peuvent être gérées directement par les utilisateurs dans la fenêtre Préférences – Clés API de leur profil, et globalement par les administrateurs dans Administration – Clés API des utilisateurs.

Pour utiliser les clés API dans des scripts et des intégrations, utilisez le préfixe Bearer dans l'en-tête Authorization :

"Authorization" = "Bearer $YourAPIKey"

Voir aussi

• API keys entry settings