Gestion de vos Clés d'API : désactivation et réactivation
Klaviyo vous permet de désactiver et de réactiver des clés d’API privées sans les supprimer définitivement. Cela est utile si vous souhaitez suspendre temporairement l’activité d’une clé (par exemple, pendant que vous enquêtez sur un comportement suspect), tout en conservant la possibilité de la restaurer ultérieurement.
Cet article couvre :
- Comment désactiver une Clé d'API
- Comment réactiver une Clé d'API
- Que faire si Klaviyo a désactivé une clé en votre nom
Avant de commencer
Vous devez disposer des autorisations nécessaires pour modifier les clés d’API afin de les désactiver ou de les réactiver. Si vous ne pouvez pas utiliser les options décrites ci-dessous, contactez le propriétaire de votre compte ou un administrateur pour obtenir de l’aide.
Comment désactiver une Clé d'API
Remarque : la désactivation d’une clé interrompt les appels d’API provenant des intégrations ou des automatisations qui en dépendent. Avant de désactiver, assurez-vous de savoir lesquels utilisent la clé. Pour consulter les appels d’API récents, sélectionnez Afficher les outils pour les développeurs sur la page Clés d’API, puis sélectionnez Journaux.
- Connectez-vous à votre compte Klaviyo.
- Accédez à Paramètres > clés d’API.
- Dans Clés d’API privées, localisez la clé dans l’onglet Actif ou Inactif. Vous pouvez utiliser le nom de la clé ou la valeur partielle de la clé pour l’identifier.
- Cliquez sur le menu … (plus d’options) à côté de la clé.
- Sélectionnez Désactiver.
La désactivation de la clé interrompt les appels API qui l’utilisent. Elle apparaît dans l’onglet Désactivé. Aucune donnée n’est supprimée, et vous pouvez réactiver la clé lorsque vous êtes prêt à l’utiliser à nouveau.
Comment réactiver une Clé d'API
Si Klaviyo a désactivé la clé en raison d’une exposition suspectée ou d’une activité inhabituelle, consultez les recommandations ci-dessous avant de la réactiver.
- Connectez-vous à votre compte Klaviyo.
- Accédez à Paramètres > clés d’API.
- Dans clés d’API privées, sélectionnez l’onglet Désactivé et localisez la clé.
- Cliquez sur le menu … (plus d’options) à côté de la clé.
- Sélectionnez Activer.
La réactivation de la clé permet aux appels API qui l’utilisent de reprendre.
Que dois-je faire si Klaviyo a désactivé ma clé d’API ?
Klaviyo peut désactiver automatiquement les clés d’API privées après 730 jours sans utilisation. Pour une clé qui n’a jamais été utilisée, cette période commence au moment de sa création. Il s’agit d’une mesure de sécurité visant à réduire le risque que des clés inactives soient exploitées. Klaviyo peut également désactiver une clé en votre nom si nous pensons qu’elle est exposée et risque d’être utilisée de manière abusive.
Si votre clé a été désactivée pour l’une de ces raisons, vous pouvez la trouver dans l’onglet Désactivé. Consultez la notification envoyée au contact de sécurité de votre compte pour connaître la raison et les prochaines étapes.
À faire :
- Si votre clé d’API a été désactivée pour cause d’inactivité et que vous en avez encore besoin, suivez les étapes de la section « Comment réactiver une clé d’API » ci-dessus, puis reprenez son utilisation dans votre intégration.
- Si Klaviyo a désactivé la clé en raison d’une exposition suspectée ou d’une activité inhabituelle, examinez son activité dans Developer Tools > Logs. Si l’activité est légitime, vous pouvez réactiver la clé. Si la clé a été exposée ou si l’activité semble suspecte, supprimez-la et créez une nouvelle clé d’API privée, puis mettez à jour les intégrations qui utilisaient l’ancienne clé. En cas de doute, répondez à la notification pour obtenir de l’aide.
- Si vous n’avez plus besoin de la clé, vous pouvez la laisser désactivée ou la supprimer définitivement. Pour le supprimer, ouvrez le menu …, sélectionnez Supprimer, puis confirmez en cliquant sur Supprimer.
Remarque : Une clé réactivée qui répond toujours aux critères d’inactivité peut être à nouveau désactivée. La seule réactivation ne réinitialise pas sa date de dernière utilisation.
Articles connexes
Learn more about managing and securing your Klaviyo API keys:
- Comment créer ou cloner une clé d’API privée
Découvrez comment créer une clé d’API privée, qui est un identifiant unique utilisé pour les appels d’API, ainsi que définir une portée.