API-tokens
Met een API-token kan een script of een ander systeem namens u met Flowtly werken, zonder dat iemand inlogt via het inlogscherm. U maakt en intrekt uw eigen tokens onder "Profile" → "Security", in het onderdeel "API tokens".
Een token handelt als u
Lees dit voordat u een token aan iemand of iets geeft.
Een token draagt uw identiteit en uw rechten. Alles wat u in Flowtly kunt zien en wijzigen, kan alles wat uw token heeft ook zien en wijzigen, en alles wat ermee gebeurt, gebeurt als u.
- Het is geen sleutel van de organisatie. Het hoort bij de persoon die het heeft gemaakt en reikt zo ver als die persoon.
- Het kan niet worden beperkt. Er bestaat geen token dat alleen kan lezen en geen token voor één module: elk token heeft al uw toegang.
Een token aan een integratie geven is dus uw eigen toegang aan die integratie geven. Geef het alleen aan een systeem dat u uw account zou toevertrouwen, en maak het aan als de persoon wiens toegang de integratie echt nodig heeft.
Voor het koppelen van een AI-assistent zoals Claude of ChatGPT is geen token nodig: zie AI-tools verbinden (Claude, ChatGPT).
Een token aanmaken
- Open "Profile" → "Security" en ga naar het onderdeel "API tokens".
- Geef het token een naam die zegt waar het gebruikt wordt, bijvoorbeeld de naam van de integratie. De naam mag tot 32 tekens lang zijn. Zonder naam krijgt het token een standaardnaam.
- Kies "Generate token".
Flowtly toont het token daarna één keer. Kopieer het en bewaar het op een veilige plek, zoals een wachtwoordbeheerder of de geheimenopslag van de integratie zelf, voordat u het venster sluit. Flowtly bewaart geen kopie die het u opnieuw kan tonen: zodra het venster dicht is, kan het token door niemand meer worden opgehaald, ook niet door u. Raakt het kwijt, trek het dan in en maak een nieuw aan.
Hoe lang een token geldig is
Een token dat u hier aanmaakt, is 365 dagen geldig vanaf het moment van aanmaken. Dat is de standaardlooptijd, en 730 dagen is de langste looptijd waarvoor Flowtly een token uitgeeft, dus geen enkel token blijft onbeperkt geldig. Een token kan niet worden verlengd: maak voor het verloopt een nieuw aan, geef dat aan de integratie en trek daarna het oude in.
De lijst toont elk van uw tokens met de naam, de datum waarop het verloopt (of verliep) en wanneer het voor het laatst is gebruikt. Een verlopen token blijft in de lijst staan tot u het intrekt. Een token dat al maanden niet is gebruikt, is een goede kandidaat om in te trekken.
Een token intrekken
Kies het prullenbakpictogram naast een token om het in te trekken. Er wordt niet om bevestiging gevraagd.
Intrekken werkt meteen: al het volgende verzoek met dat token wordt geweigerd, in plaats van dat het token doorloopt tot de vervaldatum. Een ingetrokken token kan niet worden hersteld; is het nog nodig, maak dan een nieuw aan.
Sommige dingen stoppen uw tokens zonder dat u ze intrekt:
- Een wachtwoordherstel. Na het voltooien van een wachtwoordherstel werken alle tokens die u daarvoor hebt aangemaakt niet meer, samen met uw andere sessies. Ze blijven in de lijst staan alsof ze nog geldig zijn, dus trek ze ook in en maak nieuwe tokens aan voor uw integraties.
- Een gedeactiveerd account. Als uw Flowtly-account wordt gedeactiveerd, werken alle tokens die u hebt aangemaakt niet meer zolang het account gedeactiveerd blijft. Trek ze in als ze niet mogen terugkomen.
Niemand anders kan ze bekijken of intrekken vanuit zijn eigen "Profile" → "Security".
Voorbeelden van gebruik
- Een teamleider koppelt een urenregistratiescript aan Flowtly met een token dat naar het script is genoemd en in de geheime instellingen van het script staat.
- Een consultant die een token op de verkeerde plek heeft geplakt, trekt het meteen in, in de wetenschap dat het bij het volgende gebruik niet meer werkt.
- Een beheerder zet elf maanden na het aanmaken van het token van een integratie een herinnering en vervangt het voordat de 365 dagen om zijn.
- Voordat ze een token aan een extern hulpmiddel geeft, controleert een manager waar haar eigen account bij kan, omdat het hulpmiddel precies daar ook bij kan.