Gestion des clés API

Une fois qu'un administrateur vous a invité sur un portail, vous pouvez générer des clés API et les gérer à partir de l'onglet Clés API de votre compte.

Les clés API sont liées à un espace de travail spécifique ; elles ne fonctionnent que sur l'espace de travail sur lequel elles ont été créées.

Les clés API vous permettent d'utiliser les API suivantes :

• ODS Explorer API V2

• ODS Automation V1 (si inclus dans votre forfait)

• OData

• WFS

• CSW

• TPF

Pour plus d'informations, consultez Utilisation des API.

Générez une clé API pour effectuer des appels API authentifiés.

1. Connectez-vous au portail et, dans le coin supérieur droit, cliquez sur votre nom d'utilisateur.

2. Depuis la page de votre compte, cliquez sur l’onglet Clés API s’il n’est pas déjà sélectionné.

3. Cliquez sur le bouton + Générer une nouvelle clé API et une carte de clé API apparaîtra sur l’onglet.

4. Saisissez un nom pour la clé API dans le champ « Libellé » (un nom par défaut est attribué en fonction de la date de sa création). Pour vous aider à gérer vos clés, définissez-les de manière descriptive et indiquez l'objectif de la clé API.

   

5. Sélectionnez les autorisations que vous souhaitez accorder à cette clé API.

   La liste des permissions ne proposera que celles que vous possédez déjà sur votre espace de travail ODS.

   

   N'oubliez pas qu'une clé API n'accorde pas de droits que le créateur de la clé ne possède pas déjà. Par exemple, si les seuls droits dont vous disposez sont des droits de modification sur deux jeu de données spécifiques, l'autorisation « Modifier tous jeu de données » ne s'appliquera qu'à ces deux jeu de données.

   Et n'oubliez pas : vous devez être aussi restrictif que possible avec les autorisations afin de limiter vos risques de sécurité. Si vous constatez une utilisation non autorisée de votre clé API, ou si votre clé API est exposée ou n'est pas utilisée, il est recommandé de la révoquer et d'en créer une nouvelle.

6. Vous pouvez maintenant utiliser la clé API. Cliquez sur le bouton Copier pour la copier.

   

Pour révoquer les clés API compromises ou inutilisées :

1. Connectez-vous au portail et, dans le coin supérieur droit, cliquez sur votre nom d'utilisateur

2. Depuis la page Votre compte, cliquez sur l’onglet Clés API

3. Cliquez sur le bouton Révoquer la clé de la carte de clé API souhaitée

   

4. Dans la boîte de dialogue qui apparaît, saisissez « SUPPRIMER » et cliquez sur le bouton Révoquer la clé API