API-nøkler
API-nøkler-fanen lager langlivede tokens for skript og integrasjoner som bruker Gigahost-API-et. Tilgjengelig for administratorer. Hver nøkkel tilhører administratoren som opprettet den.
Når du bør bruke API-nøkkel og når passord
| API-nøkkel | POST /authenticate med passord | |
|---|---|---|
| Levetid | Langlivet; utløper bare når du bestemmer det (eller tilbakekaller) | Kortlivet token (må autentisere på nytt jevnlig) |
| Tilganger | Avgrenset per ressursområde | Full kontotilgang |
| Påvirkes av passordbytte | Nei (forblir gyldig) | Ja (alle tokens ugyldiggjøres) |
| Fungerer med 2FA | Ja, ingen kode nødvendig | Hvert /authenticate-kall trenger gjeldende TOTP-kode |
Bruk en API-nøkkel til alt som kjører uten tilsyn, og passord til interaktive verktøy som logger inn én gang per økt.
Opprette en nøkkel
Navn er eneste måte å skille nøklene fra hverandre på i listen. Det tar opptil 100 tegn; < > " ' & avvises. Utløpet kan ikke endres etter at nøkkelen er opprettet.
Tillatelser
Hvert område er Ingen, Les (GET-forespørsler) eller Les/skriv (også POST, PUT og DELETE).
| Område | Hva det styrer |
|---|---|
| DNS og domener | DNS-soner og poster, domeneregistrering, oppdatering av registrant/navneservere/DNSSEC, videresendinger, PTR-soner. |
| Servere | Serverens livssyklus, strøm, reinstallasjon, snapshots, ISO, oppgradering, bestilling av IP-er. |
| Webhotell | Webhotellkontoer: e-postkontoer, databaser, DNS, SSL, apper, filer, backup. |
| Deploy | Bestilling av nye servere via Deploy. |
| Rack | Colocation-rack, enheter, PDU-er. |
| Support | Supportsaker: liste, opprette, svare, lukke. |
| Fakturering | Fakturaer, betalingsmetode, påfylling. |
| Min konto | Profil, kontakter, adresse, faktura-e-post. |
DNS og domener, Servere og Webhotell kan avgrenses til utvalgte soner, servere eller webhotellkontoer.
TIPS
Gi bare det integrasjonen trenger. Et overvåkingsskript trenger som regel Servere: Les, avgrenset til serverne det overvåker.
Bruke nøkkelen
Tokenet vises én gang, rett etter at du har opprettet det. Kopier det før du forlater siden. Mister du det, roterer du nøkkelen eller oppretter en ny.
Send det som et bearer-token, på samme måte som et fra POST /authenticate:
curl https://api.gigahost.no/api/v0/servers \
-H "Authorization: Bearer $GIGAHOST_API_KEY"Se API → Autentisering for hele forespørselsformatet.
Administrere nøkler
Prefiks er de første 22 tegnene i hemmeligheten og den eneste delen Flux lagrer i klartekst. Bruk det til å koble en nøkkel til din egen konfigurasjon. Sist brukt viser tidspunktet og IP-adressen for den siste forespørselen.
Redigere en nøkkel
Du kan endre navnet og tilgangene. For å endre utløpet oppretter du en ny nøkkel og tilbakekaller den gamle.
Rotere hemmeligheten
Roter nøkkel bytter ut hemmeligheten og beholder navn, tilganger og utløp. Den gamle hemmeligheten slutter å virke med en gang, så ha integrasjonen klar for den nye verdien før du roterer. Den nye hemmeligheten vises én gang. Bare aktive nøkler kan roteres.
Brukslogg
Bruksloggen viser de siste forespørslene til nøkkelen, med innholdet i forespørsel og svar. Forespørsler lagres opptil 4 KB og svar opptil 16 KB. Vil du finne ut hva en lekket nøkkel har gjort, sjekker du IP-adressene her før du velger mellom å rotere og å tilbakekalle.
Tilbakekalle en nøkkel
ADVARSEL
En tilbakekalt nøkkel slutter å virke med en gang. Det kan ikke angres, og nøkkelen kan ikke lenger redigeres eller roteres.