> ## Índice de la documentación > Consulta el índice completo de la documentación en: https://developer.rhombus.com/llms.txt > Úsalo para descubrir todas las páginas disponibles antes de seguir explorando. # Tokens federados > Genera en tu servidor tokens federados de Rhombus de corta duración para navegadores, apps móviles, reproductores de video y cámaras de tu LAN: campos, cómo limitarlos con deviceUUid y domain, dónde enviarlos, vigencia, renovación y revocación. > **Note**: Esta página se tradujo automáticamente. Si encuentras errores o tienes sugerencias, [escríbenos](mailto:support@rhombus.com). Un token federado es una credencial de corta duración que tu **servidor** genera con su propia credencial y entrega al código al que no le confías esa credencial: una página web, una app móvil, un reproductor de video o un cliente que se comunica con una cámara de tu red local. El token actúa con **la misma organización y el mismo rol** que la credencial que lo generó, hasta que vence o hasta que se revoca esa credencial. ```mermaid sequenceDiagram participant C as Navegador o app participant B as Tu backend participant R as Rhombus C->>B: Pide un token (tu propia autenticación) B->>R: generateFederatedSessionToken (clave de API) R-->>B: federatedSessionToken, expiresAtMs B-->>C: token C->>R: Solicitud de medios, LAN, API o WebSocket de eventos con el token ``` ## Generar un token Llama a [`POST /api/org/generateFederatedSessionToken`](https://developer.rhombus.com/api-reference/org-webservice/generate-federated-session-token) desde tu servidor: ```bash cURL curl -X POST "https://api2.rhombussystems.com/api/org/generateFederatedSessionToken" \ -H "x-auth-scheme: api-token" \ -H "x-auth-apikey: $RHOMBUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"durationSec": 3600, "deviceUUid": "CAMERA_UUID"}' ``` ```javascript Node.js (Express) // Tu backend: primero autentica a tu propio usuario y luego genera un token para la página que usa. app.post("/api/federated-token", requireUser, async (req, res) => { const r = await fetch( "https://api2.rhombussystems.com/api/org/generateFederatedSessionToken", { method: "POST", headers: { "x-auth-scheme": "api-token", "x-auth-apikey": process.env.RHOMBUS_API_KEY, "Content-Type": "application/json", }, body: JSON.stringify({ durationSec: 3600, deviceUUid: req.body.cameraUuid, domain: "https://app.example.com", // el origen de la página que usa el token }), }, ); if (!r.ok) return res.status(502).json(await r.json()); const { federatedSessionToken, expiresAtMs } = await r.json(); res.json({ federatedSessionToken, expiresAtMs }); }); ``` ```python Python import os import requests res = requests.post( "https://api2.rhombussystems.com/api/org/generateFederatedSessionToken", headers={ "x-auth-scheme": "api-token", "x-auth-apikey": os.environ["RHOMBUS_API_KEY"], "Content-Type": "application/json", }, json={"durationSec": 3600, "deviceUUid": "CAMERA_UUID"}, ) res.raise_for_status() body = res.json() token = body["federatedSessionToken"] expires_at_ms = body["expiresAtMs"] ``` Respuesta: ```json { "federatedSessionToken": "AAAAAAAAAAAAAAAAAAAAAA", "expiresAtMs": 1792371600000 } ``` - **`federatedSessionToken` (string)**: El token. - **`expiresAtMs` (integer)**: Cuándo vence el token, en milisegundos de época Unix. Programa la siguiente generación a partir de este valor. ### Campos - **`durationSec` (body, integer, default: 3600)**: Cuánto dura el token, en segundos: una hora si lo omites, 86400 (24 horas) como máximo. Una solicitud más larga se limita a 24 horas, así que lee `expiresAtMs` para conocer el vencimiento real. Pide la vigencia más corta que cubra la sesión (una hora para un reproductor, minutos para una sola imagen) y genera un token nuevo antes de que venza. - **`deviceUUid` (body, string)**: Limita el token a un dispositivo: el UUID del dispositivo, opcionalmente con un sufijo de faceta (`CAMERA_UUID.v0`). Un token limitado a un dispositivo funciona en las URL de medios que nombran su dispositivo y en las transmisiones LAN de esa cámara. Descarga un clip guardado solo cuando todas las cámaras del clip son su dispositivo. Las URL de medios que no nombran un dispositivo, incluidas las URL de enlaces compartidos, lo rechazan con 403, una URL de otro dispositivo devuelve 403 `DEVICE_SCOPE_MISMATCH`, y no puede llamar a la API REST. Úsalo siempre que el cliente solo necesite una cámara. - **`domain` (body, string)**: El origen web autorizado a usar el token, como origen absoluto `http` o `https`: esquema, host y puerto si no es el predeterminado (`https://app.example.com`). Cualquier otro valor se rechaza con 400. Consulta [El campo domain](https://developer.rhombus.com/es/authentication/federated-tokens#el-campo-domain). Omítelo para servidores y apps nativas y móviles. Puedes generarlo con una clave de API, con un [access token de OAuth](https://developer.rhombus.com/es/oauth-authentication) (el token actúa como el usuario que inició sesión) o con una [credencial de partner](https://developer.rhombus.com/es/partner-api-calls) más `x-auth-org` (el token pertenece a esa organización cliente). Un token federado no puede generar otro token federado (403), y las sesiones de la consola (navegador) no pueden generar tokens federados. ## Usar un token Envía el esquema y el token como `x-auth-scheme: federated-token` y `x-auth-ft: `, como encabezados o como parámetros de consulta. Los mismos dos valores funcionan en todas partes: | Destino | Cómo enviarlo | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | API REST (`api2`) | Encabezados o parámetros de consulta. No con tokens con `deviceUUid`. | | Hosts de medios y video | Encabezados o parámetros de consulta. En un navegador, ponlos en la URL. | | WebSocket de eventos | Encabezados del handshake o parámetros de consulta. Los eventos se filtran según el rol del token, como con cualquier credencial. Consulta [Autenticación de WebSocket](https://developer.rhombus.com/es/websocket/authentication). | | Cámaras en tu LAN | Encabezados o parámetros de consulta. Los tokens federados son la única credencial que acepta una cámara de tu LAN. | Los navegadores no pueden definir encabezados en un ``, un `