Dispositius i tokens d'API

A Els meus dispositius gestiones el que pot entrar al teu compte sense passar pel navegador.

Dispositius mòbils

Cada sessió activa de l'app mòbil apareix amb el seu nom, quan es va connectar i el seu últim ús. Si perds un mòbil, prem Revocar accés: haurà d'iniciar sessió de nou. Un dispositiu que fa més de 90 dies que no s'usa es desconnecta sol.

Crear un token d'API

Un token serveix per a integracions i scripts (s'envia a la capçalera Authorization: Bearer). Per crear-lo:

1. Posa-li un nom que expliqui per a què és (per exemple, «Tauler de Grafana»).
2. Tria el permís: Accés complet o Només lectura. Un token de només lectura únicament pot consultar dades.
3. Tria la caducitat: sense caducitat, 30 dies, 90 dies o 1 any.
4. Opcionalment, limita'l a certes àrees. Si no en marques cap, accedeix a totes.
5. Prem Crea el token i copia'l en aquell moment: no es torna a mostrar.

Els tokens sense caducitat es desactiven sols per inactivitat. Guarda cada token com una contrasenya.

Limitar des d'on es pot fer servir un token

En crear el token pots afegir dues restriccions opcionals (separa-les amb comes o salts de línia):

• Adreces IP permeses (per exemple 203.0.113.7, 10.0.0.0/24): el token només funciona des d'aquestes adreces. Útil per a servidors amb IP fixa. Des d'una altra IP, l'API respon 403.
• Orígens web permesos (CORS) (per exemple https://panel.exemple.com): permeten fer servir el token des d'una pàgina web concreta. Sense orígens, el navegador no pot cridar l'API amb aquest token (els scripts de servidor no es veuen afectats).

Un token compromès amb aquestes restriccions és molt menys útil per a qui el robi. Per saber si l'API és viva, GET /api/v1/health respon sense necessitat de token.

Per a desenvolupadors

La documentació de l'API, amb un explorador interactiu, és a https://app.guildawork.com/docs/.