Hoppa till innehåll
hostup.se

API-nycklar: skapa, begränsa och återkalla

Kontrollerad mot kundzonen 29 oktober 2026

Med en API-nyckel kan ett skript eller ett program hantera dina tjänster utan att logga in i kundzonen. Du skapar nyckeln under API-hantering och bestämmer själv vad den får göra. Skapa en nyckel per skript eller tjänst. Då kan du återkalla en av dem utan att de andra slutar fungera.

Öppna API-hantering i kundzonen

  1. Gå till API-hantering och klicka på Skapa nyckel. På mobilen är det den runda plusknappen nere till höger.

    Sidan API-nycklar med API-hantering i menyn och knappen Skapa nyckel markerade
  2. Skriv ett namn under Namn, till exempel vad nyckeln ska användas till. Beskrivning är frivillig.

  3. Gå till fliken Behörigheter och kryssa i det nyckeln behöver. Inget är förvalt.

    • read:all låter nyckeln läsa allt på kontot.
    • write:all låter den också ändra, beställa och betala.
    • Ska nyckeln bara sköta en sak väljer du bara den. En nyckel som ska ändra DNS behöver till exempel bara write:dns. Den kan då också läsa DNS.
    Rutan Skapa API-nyckel med fliken Behörigheter markerad
  4. Vill du begränsa nyckeln till vissa IP-adresser eller DNS-zoner går du till fliken Säkerhet. Där väljer du också ett utgångsdatum. Läs mer under Begränsa nyckeln längre ner.

  5. Klicka på Skapa.

  6. Nyckeln visas nu en enda gång. Kopiera den med kopieringsknappen (Kopiera nyckel). Spara den på ett säkert ställe, till exempel i en lösenordshanterare.

  7. Klicka på Jag har sparat den och sedan på Ja, stäng.

Väljer du bara läsbehörigheter står det i rutan att nyckeln är skrivskyddad. Den kan hämta uppgifter men aldrig ändra, skapa eller beställa något.

Nyckeln står i listan med status Live. Skicka den i headern Authorization i varje anrop:

Terminal window
curl -H "Authorization: Bearer DIN_API_NYCKEL" \
https://cloud.hostup.se/api/v2/domains

Samma exempel står under Autentisering nedanför listan med nycklar. Vilka anrop som finns läser du i dokumentationen. Klicka på Utvecklardokumentation under API-dokumentation.

Varje nyckel kan göra 300 anrop per fem minuter.

Begränsningarna finns under fliken Säkerhet när du skapar nyckeln.

  • Begränsa IP-adresser: skriv en IP-adress eller ett nät per rad, till exempel 203.0.113.10 eller 203.0.113.0/24. IPv6 fungerar också. Anrop från andra adresser nekas. Lämnar du fältet tomt fungerar nyckeln från alla adresser.
  • Utgångsdatum: välj dagen då nyckeln slutar fungera, högst ett år fram. Står det Utgår aldrig gäller nyckeln tills du återkallar den. Datumet går inte att ändra senare.

Så begränsar du nyckeln till vissa DNS-zoner eller poster:

  1. Slå på reglaget vid DNS-begränsning.

  2. Under Vad får nyckeln göra med DNS? väljer du Läsa eller Läsa och ändra.

    Fliken Säkerhet i rutan Skapa API-nyckel med DNS-begränsning påslagen. Reglaget och valet Vad får nyckeln göra med DNS? är markerade
  3. Kryssa i zonerna under Tillåtna DNS-zoner. Nyckeln når då alla poster i dem.

  4. Ska nyckeln bara nå vissa poster lägger du till en regel under Postregler. Välj zon, skriv postens namn och välj posttyp. Ett tomt namn betyder zonens rot. Klicka på Lägg till regel.

Du behöver minst en zon eller en regel. En nyckel som bara ska hämta SSL-certifikat behöver till exempel bara en regel för TXT-posten _acme-challenge i sin zon.

Vill du ändra en nyckel du redan har klickar du på de tre prickarna (Åtgärder) på dess rad. Välj Redigera behörigheter. Ändra namn, behörigheter, IP-adresser eller DNS-begränsning och klicka på Spara. Ändringen gäller direkt. Nyckeln fortsätter att fungera med de nya inställningarna.

Har nyckeln kommit på avvägar byter du ut den. Gör det när du kan lägga in den nya nyckeln i dina skript direkt efteråt.

  1. Klicka på de tre prickarna (Åtgärder) på nyckelns rad och välj Byt ut nyckeln.

    Listan med API-nycklar med menyn Åtgärder öppen och Byt ut nyckeln markerad
  2. Rutan Byta ut API-nyckeln? öppnas. Klicka på Byt ut nyckeln. Den gamla nyckeln slutar fungera direkt.

  3. Kopiera den nya nyckeln. Den visas bara en gång.

  4. Klicka på Klar.

Den nya nyckeln har samma behörigheter, begränsningar och utgångsdatum som den gamla.

Behövs nyckeln inte längre återkallar du den:

  1. Klicka på papperskorgen (Återkalla) på nyckelns rad.
  2. Rutan Återkalla API-nyckel? öppnas. Klicka på Återkalla nyckel.

Allt som använder nyckeln förlorar åtkomsten direkt. Det går inte att ångra. Vill du återkalla flera nycklar på en gång kryssar du i dem i listan. Klicka på Återkalla valda och sedan på Återkalla alla.

  • Klicka på nyckelns namn i listan för att se dess behörigheter, IP-adresser, DNS-begränsning och när den skapades.
  • Under de tre prickarna finns Visa statistik. Där ser du anropen de senaste 30 dagarna och de senaste felen.
  • En nyckel vars utgångsdatum har passerat står kvar i listan som Utgången. Den fungerar inte längre. Skapa en ny i stället.
  • Kryssar du i Detta är en testnyckel (prefix sk_test_) ändras bara hur nyckeln börjar. En testnyckel når dina riktiga tjänster precis som en vanlig nyckel.
  • Användare som du har lagt till på kontot ser inte API-hantering i menyn.
  • AI-appar som du har kopplat till kontot står inte i listan över nycklar. De står under Kopplade AI-appar längre ner på sidan. Läs mer i Koppla Claude eller ChatGPT till kontot.