Uw PushEngage API-sleutel authentiseert API-verzoeken voor een site, dus alles wat de PushEngage API aanroept, gebruikt deze. U kunt de sleutel bekijken, kopiëren en opnieuw genereren vanuit uw site-instellingen, en elke site heeft zijn eigen sleutel. Deze handleiding laat u zien hoe u uw API-sleutel vindt en hoe u deze veilig roteert.
Voordat u begint
- U moet zijn aangemeld bij het PushEngage-dashboard met toegang tot de site die u wilt beheren.
- Het onmiddellijk opnieuw genereren van de sleutel vervangt de oude. Elke integratie die nog steeds de oude sleutel gebruikt, stopt met werken totdat u deze bijwerkt met de nieuwe sleutel, dus plan om uw integraties direct na het roteren bij te werken.
- De API-sleutel is specifiek voor een site. Als u meer dan één site beheert, schakelt u eerst naar de juiste site.
Waar u uw API-sleutel kunt vinden
Ga in het PushEngage-dashboard naar Site-instellingen » Sitegegevens en scrol naar de sectie API-sleutel.
Genereer uw eerste API-sleutel
Als de site nog geen API-sleutel heeft, klikt u op Genereer een nieuwe API-sleutel. PushEngage maakt de sleutel aan en bevestigt met "API-sleutel succesvol gegenereerd".
Kopieer uw API-sleutel
Zodra een sleutel bestaat, wordt deze om veiligheidsredenen gemaskeerd weergegeven. Klik op Kopiëren om de volledige sleutel naar uw klembord te kopiëren, plak deze vervolgens in wat u nodig heeft. De sleutel wordt op het scherm altijd gemaskeerd weergegeven, dus gebruik Kopiëren in plaats van te proberen deze te lezen.
Roteer (Genereer opnieuw) uw API-sleutel
Het roteren van de sleutel vervangt deze door een nieuwe, wat de juiste stap is als de sleutel mogelijk is blootgesteld, of als periodieke hygiëne.
- Klik in de sectie API-sleutel op API-sleutel opnieuw genereren.
- Klik in het bevestigingsvenster "Wilt u de API-sleutel opnieuw genereren?" op Ja, opnieuw genereren.
- PushEngage geeft een nieuwe sleutel uit en bevestigt dat deze is gegenereerd.
- Kopieer de nieuwe sleutel en werk elke integratie bij die de oude gebruikte.
Veelgestelde vragen
Zal het opnieuw genereren van de sleutel mijn integraties verbreken?
Ja, totdat u ze bijwerkt. De oude sleutel stopt met werken op het moment dat u opnieuw genereert, dus elke app, plugin of script die deze gebruikt, zal falen totdat u deze vervangt door de nieuwe sleutel. Roteer op een moment dat u uw integraties direct kunt bijwerken.
Is de API-sleutel hetzelfde voor al mijn sites?
Nee. Elke site heeft zijn eigen API-sleutel. Als u meerdere sites beheert, zorg er dan voor dat u op de juiste site bent voordat u een sleutel kopieert of opnieuw genereert.
Waarom zie ik alleen een gemaskeerde sleutel?
De sleutel wordt om veiligheidsredenen gemaskeerd weergegeven op het scherm. Gebruik de knop Kopiëren om de volledige sleutel naar uw klembord te kopiëren.
Wanneer moet ik mijn API-sleutel roteren?
Draai hem als je denkt dat de sleutel is blootgesteld, wanneer iemand met toegang ertoe vertrekt, of op een regelmatig schema als goede beveiligingshygiëne. Vergeet niet om je integraties telkens bij te werken met de nieuwe sleutel.
Als u problemen ondervindt, neem dan gerust contact met ons op door hier te klikken. Ons ondersteuningsteam zal u kunnen helpen.