DocumentaciónAide

Identifiants d'accès

Choisissez comment la plateforme s'authentifie auprès de votre système et enregistrez sa clé, son jeton ou son utilisateur de façon chiffrée.

Sur cette page

Les identifiants permettent à la plateforme de se connecter à l'API de votre système, par exemple pour tester la connexion avec le bouton Tester. Ils sont stockés chiffrés et ne sont plus jamais affichés : une fois enregistrés, vous ne verrez qu'un indice de leurs derniers caractères.

Ne confondez pas ces identifiants avec le Secret de signature du webhook : les identifiants permettent à la plateforme d'accéder à votre système ; le secret permet à votre système de signer ce qu'il envoie à la plateforme.

Avant de commencer

  • Vous devez avoir le rôle Administrateur.

  • Demandez au responsable du système un identifiant en lecture seule, si le système le permet. La plateforme n'a pas besoin de droits d'écriture.

Types d'authentification

Dans Authentification, au sein du formulaire de l'intégration, choisissez une option. Chacune affiche ses propres champs :

Option

Champs

Sans authentification

Aucun

Clé API

Clé API et Nom de l'en-tête (facultatif), par exemple X-API-Key

Jeton Bearer

Jeton

Utilisateur et mot de passe

Utilisateur et Mot de passe

OAuth 2.0 (client credentials)

Client ID, Client secret et URL du jeton

Sous les champs, vous voyez : Ils sont stockés chiffrés et ne sont plus affichés ; vous ne verrez qu'un indice des derniers caractères.

Si, pour Clé API, vous laissez Nom de l'en-tête (facultatif) vide, la clé est envoyée dans l'en-tête X-API-Key.

Avec OAuth 2.0 (client credentials), la plateforme stocke les données chiffrées, mais pour l'instant Tester interroge votre système sans s'authentifier. Si votre système exige une authentification pour son chemin de santé, le test répondra avec un code tel que 401.

Enregistrer les identifiants à la création

  1. Dans Paramètres → Intégrations, cliquez sur Nouvelle intégration.

  2. Choisissez le type dans Authentification et renseignez ses champs.

  3. Complétez le reste du formulaire et cliquez sur Enregistrer.

Modifier ou conserver les identifiants lors de la modification

  1. Sur la carte de l'intégration, cliquez sur le bouton Modifier (crayon).

  2. Sous Authentification, vous voyez Identifiant enregistré : avec son indice et Laissez les champs vides pour le conserver. Les champs apparaissent vides avec le texte Laisser vide pour conserver.

  3. Faites l'une de ces actions :

    • Le conserver : laissez les champs vides.

    • Le remplacer : saisissez le nouvel identifiant dans les champs.

    • Changer de type : choisissez un autre type dans Authentification. Vous voyez Vous avez changé le type d'authentification : saisissez les nouveaux identifiants. Renseignez les champs du nouveau type : le formulaire ne l'exige pas, mais si vous les laissez vides, l'ancien identifiant reste enregistré et il ne sert pas pour le nouveau type.

    • Le supprimer : choisissez Sans authentification. Vous voyez L'enregistrement supprime l'identifiant enregistré.

  4. Cliquez sur Enregistrer.

Lorsque vous changez le type d'authentification, ce que vous aviez saisi dans les champs est effacé. Si vous vous trompez de type, choisissez de nouveau le bon et saisissez à nouveau les valeurs.

Personne ne peut voir un identifiant après son enregistrement, pas même un administrateur. Si vous le perdez, générez-en un nouveau dans votre système et remplacez-le ici.

Ensuite

La carte de l'intégration affiche dans Authentification le type choisi et l'indice de l'identifiant. Pour vérifier qu'il fonctionne, utilisez Tester la connexion.

Si le test répond Las credenciales guardadas no se pueden descifrar (cambió la llave maestra). Vuelve a ingresarlas. (les identifiants enregistrés ne peuvent pas être déchiffrés, car la clé maîtresse a changé ; saisissez-les de nouveau), modifiez l'intégration et saisissez de nouveau l'identifiant.

Voir aussi

Rechercher dans SofIA Gouvernance

Saisissez au moins 2 caractères pour rechercher dans SofIA Gouvernance.

↑↓ naviguer · Enter ouvrir · Esc fermer