Crear y revocar tokens de API
Qué puede hacer un token
Un token actúa en nombre de la persona que lo creó, en el equipo que estaba activo en ese momento. Solo puede hacer lo que le permitas al crearlo. Eliges uno de estos accesos:
- Controlar pantallas y escenas: ver pantallas, contenido y escenas, mostrar contenido en una pantalla, e iniciar y detener escenas. Úsalo para Bitfocus Companion.
- Solo lectura: ver pantallas, contenido y escenas, nada más.
- Acceso completo, incluida la creación de diseños: todo lo anterior, y además crear diseños.
Si la persona que creó el token pierde el acceso al equipo, el token deja de funcionar.
Crear un token
- Ve a Configuración > Conexiones.
- En Tokens de API, haz clic en Nuevo token de API.
- Ponle un nombre al token, por ejemplo el del recinto o el del programa que lo usa.
- En Acceso, elige lo que puede hacer el token.
- Haz clic en Crear token.
- Haz clic en Copiar y guarda el token en un lugar seguro, por ejemplo en el programa que lo necesita.
- Haz clic en Hecho.
El token solo se muestra una vez. Si lo pierdes, revócalo y crea uno nuevo.
El token funciona en el equipo que está activo cuando lo creas. Para las pantallas de otro equipo, cambia primero a ese equipo y crea un token aparte. Usa un token distinto para cada programa, así puedes revocar uno sin detener los demás.
De forma predeterminada, el propietario y los administradores pueden crear tokens. Lo decide tu rol. Esto se cambia por rol en Gestionar equipos.
Correo al crear un token
Cuando alguien crea un token, esa persona y los propietarios de la cuenta reciben un correo. El correo indica de qué token se trata, quién lo creó, para qué equipo, cuándo y qué puede hacer. El correo nunca contiene el token en sí. Si no esperabas ese token, revócalo de inmediato.
Ver tus tokens
La tarjeta Tokens de API muestra, para cada token:
- el nombre y el tipo de acceso;
- los últimos cuatro caracteres del token, para distinguir unos de otros;
- el equipo;
- cuándo se usó por última vez, o Nunca usado.
El propietario ve los tokens de todos los miembros de la cuenta. Los demás solo ven los suyos.
Revocar un token
- Ve a Configuración > Conexiones.
- Haz clic en Revocar junto al token.
- Confirma con Revocar.
Todo lo que use el token se detiene al instante.
Tokens que caducan
Un token que lleva un año sin usarse se revoca solo. Un token que nunca se usó cuenta desde el día en que se creó. Crea un token nuevo si vuelves a necesitar uno.
Límite
Una cuenta puede tener un número limitado de tokens. Al llegar a ese límite, Screenbird te pide que revoques uno antes.
Apps conectadas
Las apps que conectas con un inicio de sesión de Screenbird, en lugar de con un token, aparecen en su propia tarjeta Apps conectadas de la misma página. Haz clic en Desconectar para quitar una.
Crea tu propia conexión
Screenbird tiene una API pública. Envía tu token como bearer token en cada petición. La descripción completa de la API, con todas las peticiones y los permisos que necesita cada una, está en api.screenbird.app/v1/openapi.json.