API-tokens

Et API-token lader et script eller et andet system arbejde med Flowtly på dine vegne, uden at nogen logger ind på login-skærmen. Du opretter og tilbagekalder dine egne tokens under "Profile" → "Security", i afsnittet "API tokens".

Et token handler som dig

Læs dette, før du giver et token til nogen eller noget.

Et token bærer din identitet og dine tilladelser. Alt, hvad du kan se og ændre i Flowtly, kan alt, der har dit token, også se og ændre, og alt, hvad der gøres med det, gøres som dig.

• Det er ikke en nøgle for organisationen. Det tilhører den person, der oprettede det, og når det samme, som den person når.
• Det kan ikke begrænses. Der findes intet token kun til læsning og intet token til kun ét modul: hvert token har al din adgang.

At give et token til en integration er altså at give den din egen adgang. Giv det kun til et system, du ville betro din konto, og opret det som den person, hvis adgang integrationen faktisk har brug for.

Det kræver intet token at forbinde en AI-assistent som Claude eller ChatGPT: se Tilslutning af AI-værktøjer (Claude, ChatGPT).

Opret et token

1. Åbn "Profile" → "Security", og gå til afsnittet "API tokens".
2. Giv tokenet et navn, der fortæller, hvor det skal bruges, for eksempel navnet på integrationen. Navnet må være op til 32 tegn. Uden et navn får tokenet et standardnavn.
3. Vælg "Generate token".

Flowtly viser derefter tokenet, én gang. Kopiér det, og gem det et sikkert sted, for eksempel i en adgangskodeadministrator eller i integrationens eget lager til hemmeligheder, før du lukker vinduet. Flowtly gemmer ingen kopi, det kan vise dig igen: når vinduet er lukket, kan tokenet ikke hentes frem, hverken af dig eller af andre. Hvis det går tabt, så tilbagekald det og opret et nyt.

Hvor længe et token gælder

Et token oprettet her gælder i 365 dage fra det øjeblik, du opretter det. Det er standardlevetiden, og 730 dage er det længste, Flowtly udsteder et token for, så intet token gælder på ubestemt tid. Et token kan ikke forlænges: opret et nyt, før det udløber, giv det til integrationen, og tilbagekald derefter det gamle.

Listen viser hvert af dine tokens med navn, datoen for hvornår det udløber (eller udløb), og hvornår det sidst blev brugt. Et udløbet token bliver på listen, indtil du tilbagekalder det. Et token, der ikke har været brugt i flere måneder, er et godt bud på et, der kan tilbagekaldes.

Tilbagekald et token

Vælg skraldespandsikonet ud for et token for at tilbagekalde det. Der bedes ikke om bekræftelse.

Tilbagekaldelsen virker med det samme: allerede den næste forespørgsel med det token bliver afvist, i stedet for at tokenet kører videre til sin udløbsdato. Et tilbagekaldt token kan ikke gendannes; hvis der stadig er brug for det, så opret et nyt.

Nogle ting stopper dine tokens, uden at du tilbagekalder dem:

• En nulstilling af adgangskoden. Når du har nulstillet din adgangskode, holder alle tokens, du oprettede før, op med at virke, sammen med dine andre sessioner. De bliver stående på listen, som om de stadig var gyldige, så tilbagekald dem også, og opret nye tokens til dine integrationer.
• En deaktiveret konto. Hvis din Flowtly-konto bliver deaktiveret, virker ingen af de tokens, du har oprettet, så længe kontoen forbliver deaktiveret. Tilbagekald dem, hvis de ikke må komme tilbage.

Ingen andre kan se eller tilbagekalde dem fra deres egen "Profile" → "Security".

Eksempler på brug

• En teamleder forbinder et script til tidsregistrering med Flowtly via et token, der er opkaldt efter scriptet og gemt i dets hemmelige indstillinger.
• En konsulent, der har indsat et token det forkerte sted, tilbagekalder det straks, vel vidende at det holder op med at virke ved næste brug.
• En administrator sætter en påmindelse elleve måneder efter at have oprettet en integrations token og udskifter det, før de 365 dage er gået.
• Før en leder giver et token til et eksternt værktøj, tjekker hun, hvad hendes egen konto kan nå, for værktøjet kommer til at nå præcis det samme.