Direct naar de inhoud

Hoe maak en beheer ik een API-sleutel?

Account

Maak onder Account een API-sleutel aan, kopieer het geheim één keer en schakel de sleutel later uit, vernieuw of verwijder hem.

Een API-sleutel met de naam CI pipeline met de acties uitschakelen, vernieuwen en verwijderen

Een sleutel aanmaken

Open Account, ga naar API keys en klik op Create key. Geef de sleutel een naam die zegt waar hij wordt gebruikt, zoals CI pipeline. De naam mag maximaal 60 tekens zijn.

DNSense toont het geheim één keer. Kopieer het en bewaar het veilig, bijvoorbeeld in een wachtwoordmanager. Stuur het mee als Bearer-token in de Authorization-header van je verzoeken.

Wat een sleutel kan

Een sleutel werkt als jij, binnen je rol in het team waarin je werkt. Hij kan je login, tweestapsverificatie en API-sleutels niet beheren. Wijzigingen met een sleutel staan in de zonegeschiedenis en de auditlog.

Uitschakelen, vernieuwen of verwijderen

  • Disable pauzeert de sleutel tot je hem weer inschakelt.
  • Rotate geeft de sleutel een nieuw geheim en trekt het oude direct in. Alles wat het oude geheim nog gebruikt, werkt niet meer.
  • Delete verwijdert de sleutel definitief.

Bij elke sleutel staat wanneer hij is aangemaakt en voor het laatst is gebruikt, zodat je sleutels opmerkt die niet meer nodig zijn.

Ik ben het geheim kwijt

Een geheim kan niet opnieuw worden getoond. Vernieuw de sleutel voor een nieuw geheim en pas aan waar de sleutel wordt gebruikt.

Hulp nodig?

Vragen over API-sleutels? Neem contact op met ons supportteam.