Je API-sleutel beheren: uitschakelen en opnieuw inschakelen
Met Klaviyo kun je privé-API-sleutels uitschakelen en opnieuw inschakelen zonder ze permanent te verwijderen. Dit is handig als je de activiteit van een API-sleutel tijdelijk wilt pauzeren (bijvoorbeeld terwijl je verdacht gedrag onderzoekt) en tegelijkertijd de optie wilt behouden om deze later te herstellen.
Dit artikel behandelt:
- Een API-sleutel uitschakelen
- Een API-sleutel opnieuw inschakelen
- Wat te doen als Klaviyo namens jou een sleutel heeft uitgeschakeld
Voordat je van start gaat
Je hebt toestemming nodig om API-sleutels te bewerken om ze uit te schakelen of opnieuw in te schakelen. Als je de opties hieronder niet kunt gebruiken, neem dan contact op met de eigenaar van je account of je beheerder voor hulp.
Een API-sleutel uitschakelen
Opmerking: Als je een sleutel uitschakelt, worden API-aanroepen onderbroken vanuit integraties of automatiseringen die ervan afhankelijk zijn. Zorg er voordat je uitschakelt voor dat je weet welke de API-sleutel gebruiken. Als je recente API-aanroepen wilt bekijken, selecteer je Ontwikkelaarstools bekijken op de pagina API-sleutels en selecteer je vervolgens Logboeken.
- Log in op je Klaviyo-account.
- Navigeer naar Instellingen > API-sleutels.
- Zoek in Private API-sleutels de sleutel op het tabblad actief of inactive. Je kunt de sleutelnaam of een gedeeltelijke sleutelwaarde gebruiken om deze te identificeren.
- Klik op het menu … (meer opties) naast de sleutel.
- Selecteer Uitschakelen.
Als je de sleutel uitschakelt, stoppen de API-aanroepen die deze gebruiken. Deze verschijnt op het tabblad Uitgeschakeld. Er worden geen gegevens verwijderd en je kunt de sleutel weer inschakelen wanneer je klaar bent om deze opnieuw te gebruiken.
Een API-sleutel opnieuw inschakelen
Als Klaviyo de sleutel heeft uitgeschakeld vanwege vermoedelijke blootstelling of ongebruikelijke activiteit, bekijk dan de richtlijnen hieronder voordat je deze weer inschakelt.
- Log in op je Klaviyo-account.
- Navigeer naar Instellingen > API-sleutels.
- Selecteer op Private API-sleutels het tabblad Uitgeschakeld en zoek de sleutel.
- Klik op het menu … (meer opties) naast de sleutel.
- Selecteer Inschakelen.
Als je de sleutel opnieuw inschakelt, kunnen API-aanroepen die deze gebruiken weer doorgaan.
Wat moet ik doen als Klaviyo mijn API-sleutel heeft uitgeschakeld?
Klaviyo kan privé-API-sleutels automatisch uitschakelen na 730 dagen zonder gebruik. Voor een sleutel die nog nooit is gebruikt, begint deze periode zodra deze is aangemaakt. Dit is een beveiligingsmaatregel om het risico te verkleinen dat ongebruikte sleutels worden misbruikt. Klaviyo kan ook namens jou een sleutel uitschakelen als we denken dat deze is blootgesteld en het risico loopt om te worden misbruikt.
Als je sleutel om een van deze redenen is uitgeschakeld, kun je deze vinden op het tabblad Uitgeschakeld. Controleer de melding die naar het beveiligingscontact van je account is gestuurd voor de reden en de volgende stappen.
Wat je kunt doen:
- Als je sleutel wegens inactiviteit is uitgeschakeld en je hem nog steeds nodig hebt, volg dan de stappen in het gedeelte API-sleutel opnieuw inschakelen hierboven en ga hem daarna weer gebruiken in je integratie.
- Als Klaviyo de sleutel heeft uitgeschakeld vanwege vermoedelijke blootstelling of ongebruikelijke activiteit, controleer dan de activiteit in Ontwikkelaarstools > Logboeken. Als de activiteit legitiem is, kun je de sleutel opnieuw inschakelen. Als de sleutel is blootgesteld of de activiteit verdacht lijkt, verwijder je deze en maak je een nieuwe privé-API-sleutel, en werk je daarna de integraties bij die de oude sleutel gebruikten. Bij twijfel kun je reageren op de melding voor hulp.
- Als je de sleutel niet meer nodig hebt, kun je deze uitgeschakeld laten of definitief verwijderen. Om het te verwijderen, open je het menu …, selecteer je Verwijderen en bevestig je met Verwijderen.
Opmerking: Een opnieuw ingeschakelde sleutel die nog steeds aan de inactiviteitscriteria voldoet, kan opnieuw worden uitgeschakeld. Alleen opnieuw inschakelen stelt de datum van laatste gebruik niet opnieuw in.
Gerelateerde artikelen
Learn more about managing and securing your Klaviyo API keys:
- Een privé-API-sleutel maken of klonen
Lees hoe je een privé API-sleutel maakt, die een unieke identifier is die wordt gebruikt voor API-calls, en hoe je een scope definieert.