Passer au contenu principal

Bonnes pratiques de sécurité pour les clés API

Comment conserver la clé API de l'organisation, pourquoi elle ne doit jamais être partagée, et ce qui se passe lorsque vous la renouvelez.

Écrit par Steven Ching

La clé API de l'organisation s'affiche une seule fois, au moment de sa création. Toute personne qui la possède peut transmettre l'identité d'un apprenant à l'intégration de votre widget. Traitez-la comme un secret pour toute l'organisation.

Enregistrez-la dès qu'elle apparaît

Copiez la clé immédiatement, puis placez-la dans un gestionnaire de mots de passe ou un autre espace de stockage contrôlé par votre organisation. Une fois cette fenêtre fermée, Raison n'affiche plus qu'une version masquée. La clé complète ne s'affichera plus.

Les paramètres Intégrations dans Organisation, centrés sur la section API. La section explique l'accès à l'API et affiche une ligne Clé API où la clé est masquée par des points.

Ne la partagez jamais

  • Ne mettez pas la clé dans un ticket, un chat ou un e-mail au support.

  • Le support ne peut pas récupérer une clé à partir d'un message. Si elle a pu fuiter, remplacez-la.

  • La clé apparaît dans le HTML de la page, dans data-user : n'ajoutez donc le widget que sur des pages que vous contrôlez.

Remplacer la clé si nécessaire

Raison conserve une seule clé API par organisation. Vous ne pouvez pas créer une deuxième clé tant qu'une clé existe. Pour la renouveler, ouvrez Organisation, puis Intégrations, allez dans API, supprimez la clé actuelle, puis créez-en une nouvelle.

L'ancienne clé cesse de fonctionner dès que vous la supprimez. Il n'y a aucune période de chevauchement : toutes les pages qui utilisent l'ancienne clé cessent de fonctionner jusqu'à leur mise à jour. Mettez à jour les extraits d'intégration en même temps.

Articles liés

Besoin d'aide ? Écrivez à [email protected].

Avez-vous trouvé la réponse à votre question ?