Serveren accepterer OAuth-adgangstokens og API-nøgler til arbejdsområdet. Begge bruger samme tilladelser, licenser, credits og grænser. En nøgle hører til ét arbejdsområde, handler som den ejer eller admin, der oprettede den, og kan kun nå de endpoints, dens tilladelser giver adgang til. Nøgler ser ud som gr_live_ efterfulgt af 43 bogstaver, tal, bindestreger og understregninger.
Tilføj en brugerdefineret forbindelse med ChatGPT: https://; Claude: https://, og vælg OAuth-login. Log ind på Gradiently, vælg et arbejdsområde, og gennemgå tilladelserne. Kun ejere og administratorer kan forbinde en assistent. Forbindelser udløber efter en time og fornyes automatisk i op til 30 dage. Tilbagekald en forbindelse i Indstillinger › API og agenter for at stoppe adgang og fornyelse med det samme.
Opret en nøgle
- 1
Åbn API og agenter
Gå til Indstillinger › API og agenter i Gradiently, og vælg det arbejdsområde, nøglen er til. Kun ejere og admins af arbejdsområdet kan oprette nøgler.
- 2
Navngiv den
Under Opret en nøgle giver du den et Navn efter, hvor du vil bruge den, fx Claude Code eller Natlig eksport, så du ved, hvilken du skal tilbagekalde senere.
- 3
Vælg, hvad den kan gøre
Under Hvad den kan gøre vælger du de tilladelser, den har brug for, mindst én. Næste afsnit forklarer hver af dem.
- 4
Kopiér den én gang
Vælg Opret nøgle. Nøglen vises i Kopiér din nøgle nu, og det er den eneste gang, den vises. Kopiér den ind i en password manager eller dit hemmelighedslager, og vælg derefter Jeg har gemt den.
Den, der oprettede en nøgle, får en e-mail, når den oprettes, og når den tilbagekaldes, med dens navn, starten af nøglen og dens tilladelser. Listen i Indstillinger viser for hver aktiv nøgle navnet, starten af nøglen, hvornår den sidst blev brugt, og hvor mange tilladelser den har.
Tilladelser
En tilladelse (scope) er én rettighed. En forespørgsel kræver alle de tilladelser, dens endpoint angiver, og hvert MCP-værktøj kræver tilladelserne til alle de forespørgsler, det laver. Giv kun det, opgaven kræver.
designs:readI Indstillinger
Hvad den giver adgang til
designs:writeI Indstillinger
Hvad den giver adgang til
marks:readI Indstillinger
Hvad den giver adgang til
marks:claimI Indstillinger
Hvad den giver adgang til
brand:generateI Indstillinger
Hvad den giver adgang til
workspaces:readI Indstillinger
Hvad den giver adgang til
designs:read også læse / api/ me.personalities:writeI Indstillinger
Hvad den giver adgang til
members:writeI Indstillinger
Hvad den giver adgang til
Nye nøgler starter med Læs designs, Opret og redigér designs, Søg Marks, Generér brands og Læs arbejdsområdet valgt. Sikr dig Marks er slået fra, indtil du vælger den, fordi du som nøglens skaber bliver indehaver af de Marks, nøglen sikrer sig.
Udskift en nøgle
Nøgler udløber ikke, og en nøgles navn og tilladelser kan ikke ændres, efter den er oprettet. For at udskifte en nøgle, eller ændre hvad den kan, erstatter du den:
- 1
Opret den nye nøgle
Opret en nøgle med de tilladelser, du vil have, med et navn, så du kan skelne den fra den gamle.
- 2
Skift dine værktøjer over
Sæt den nye nøgle ind alle de steder, der brugte den gamle: din MCP-klient, dit hemmelighedslager eller dine deployment-indstillinger.
- 3
Tilbagekald den gamle nøgle
Når den gamle nøgles brugt-dato holder op med at flytte sig i listen, tilbagekalder du den.
Tilbagekald en nøgle
I Indstillinger › API og agenter vælger du Tilbagekald ud for nøglen og bekræfter med Tilbagekald nøgle. Alt, der bruger den, holder straks op med at virke, og det kan ikke fortrydes. Ejere og admins af arbejdsområdet kan tilbagekalde alle dets nøgler.
En nøgle holder også selv op med at virke, når dens skaber forlader arbejdsområdet, bliver degraderet til under admin eller får sin konto deaktiveret. Nøgler, som en person har lavet, tilbagekaldes, når personen fjernes fra arbejdsområdet eller degraderes.
Det kan en nøgle aldrig
Nogle ting kræver altid, at en person er logget ind på Gradiently, uanset nøglens tilladelser:
- Oprette, vise eller tilbagekalde nøgler.
- Ændre kontoen: profil, e-mail, adgangskode, loginsessioner eller sletning af den.
- Nå betaling: abonnementer, checkout, betalinger, optankning af AI-kreditter, Saldo og udbetalinger. At sikre sig en Mark eller et køb, der kræver betaling, stopper og beder om checkout i Gradiently.
- Give en Mark væk: overdrage den til en anden, frigive den, sætte den til salg, forny den eller udgive den.
- Flytte ejerskabet af en Mark eller dens licens til arbejdsområdet. Marks, som en nøgle sikrer sig, ejes af dens skaber, og en eventuel licens forbliver skaberens.
- Ændre, hvem der er i arbejdsområdet, eller deres roller, eller omdøbe, overdrage eller slette arbejdsområdet. Med
members:writekan den kun sende invitationer. - Nå et andet arbejdsområde end sit eget, heller ikke et, som dens skaber er med i.
- Bruge Gradientlys administration.
Hold nøgler sikre
Gør ikke
- Committe en nøgle til et repository eller indsætte den i en delt konfigurationsfil.
- Lægge en nøgle i en webside, en mobilapp eller noget, der kører på en andens enhed.
- Dele én nøgle mellem personer eller værktøjer.
- Sende en nøgle via e-mail eller chat.
- Lade Sikr dig Marks være slået til for en nøgle, der ikke sikrer sig Marks.
Gør
- Lav én nøgle til hvert værktøj eller hver assistent, navngivet efter det.
- Giv så få tilladelser, som opgaven kræver.
- Opbevar nøgler i en password manager, et hemmelighedslager eller en miljøvariabel.
- Tilbagekald en nøgle, så snart den kan være lækket, og lav så en ny.
- Tjek datoerne for sidste brug en gang imellem, og tilbagekald nøgler, som ingen bruger.
Gradiently gemmer kun en hash af hver nøgle og starten af den til visning, så en mistet nøgle kan ikke vises igen: tilbagekald den, og opret en ny. Tror du, at en nøgle er blevet misbrugt, så tilbagekald den, og fortæl os det.