Hoppa till huvudinnehåll

Översikt

Den här sidan beskriver autentisering, behörigheter, giltighet och lagring för Developer Platform-nycklar. Varje nyckel hör till ett projekt och tillåter bara valda åtgärder.

Använd en Developer Platform-nyckel

Skicka detta Authorization-huvud med varje anrop.
Nycklar från vanliga teaminställningar använder arbetsytor, deras behörigheter och NoimosAI-krediter. Developer Platform-nycklar använder separata projekt, behörigheter och förbetalda USD-saldon.
Nycklarna är inte utbytbara. Ogiltig nyckel, otillräcklig behörighet eller saldo byter aldrig automatiskt autentisering eller debitering.

Ange behörigheter

Välj nödvändiga behörigheter när nyckeln skapas. Separera nycklar för anslutningstest från nycklar för betald körning för att begränsa misstag. Kontrollera alla behörigheter för projekt, offert, körning och resultat.

Vem får skapa nycklar

Projektmedlemmar med rollen ADMIN eller DEVELOPER får skapa nycklar. Även organisationsadministratörer behöver uttryckligt medlemskap i projektet. Skaparens och projektets behörigheter gäller. Nyckeln slutar fungera om skaparkontot inaktiveras, skaparen tas bort från projektet eller nyckeln återkallas.

Hantera giltighet

Välj giltighetstiden i Developer Platforms vy för att skapa nycklar och kontrollera den i nyckellistan efteråt. Hela nyckeln visas bara en gång; spara den säkert innan du stänger vyn. Skapa en ny nyckel före utgången, byt i integrationerna och återkalla den gamla. Återkalla direkt vid misstänkt läcka.

Lagra nycklar säkert

Behandla nycklar som serverhemligheter som aldrig skickas till användares webbläsare.
  • Använd miljövariabler eller en hemlighetshanterare.
  • Skriv inte till Git, loggar, felsidor eller analyshändelser.
  • Bädda inte in i webb- eller mobilappar.
  • Separera nycklar och projekt för produktion, test och utveckling.
  • Skapa nycklar per användningsfall med minsta nödvändiga behörigheter.

Felsök autentisering

Kontrollera HTTP-status och nyckelns tillstånd.
  • 401 — Kontrollera Authorization, hela nyckeln, giltighet och återkallelse.
  • 403 — Kontrollera behörigheter och ägarens projektåtkomst.
  • 429 — Kontrollera anropsgränser, saldo och organisationens eller projektets månadsgränser.
Vid osäkerhet om nyckel och ändpunkt, använd GET /tools/project före betalt arbete.

Relaterade sidor

Dessa sidor beskriver nyckelskapande och gemensamma specifikationer.