Inicie sesión con acceso que usted controla

Cómo funciona el inicio de sesión

screenRIG emite tokens de acceso firmados de corta duración y tokens de actualización de larga duración. El CLI incluido guarda ambos en su archivo de configuración privado y los renueva automáticamente, por lo que un agente nunca maneja un token ni lo pega en una conversación.

Hay cuatro formas de entrar:

Las personas inician sesión en el dashboard con un passkey o una contraseña, o mediante el proveedor de identidad de su organización; consulte el inicio de sesión único y el aprovisionamiento de usuarios.

Iniciar sesión con screenrig login

Use screenrig login cuando la persona ya tiene screenRIG y quiere que esta instalación de agente funcione en uno de sus proyectos. Una instalación nueva sin cuenta comienza con screenrig agent enroll en su lugar; vea Inicio.

screenrig login

1. El CLI muestra una dirección de panel y un código de ocho letras como BCDF-GHJK, luego espera.
2. La persona abre https://screenrig.ai/dashboard/connect, inicia sesión e ingresa el código, o sigue el enlace completo que ya lo lleva.
3. El dashboard muestra la solicitud en una pantalla: el nombre de la instalación que reportó el dispositivo, cuándo y dónde pidió, y el código. La persona verifica que el código coincida con el terminal, ajusta el proyecto, el nivel de acceso o las capacidades si desea, y presiona Conectar. Un inicio de sesión en el dashboard de la última hora es la prueba, por lo que Conectar no pide nada más; un inicio de sesión más antiguo pide una passkey. El dashboard entonces abre el nuevo agente.
4. El CLI almacena la sesión, selecciona el proyecto aprobado e informa status: signed_in con el proyecto, organización y nivel de acceso.

Aprobar solo un inicio de sesión que usted mismo haya iniciado, en su propia computadora. El dashboard nunca aprueba nada al cargar, y un código expirado necesita un nuevo screenrig login.

Cuando el agente debe pasar la dirección a una persona en otro canal primero, use --no-wait. El identificador no contiene ningún secreto, y el inicio de sesión pendiente permanece en el archivo de configuración privado:

screenrig login --no-wait
screenrig login --resume login_HANDLE

La dirección de inicio de sesión y su código son para la persona que lo aprueba. Envíelos solo a esa persona y manténgalos fuera de registros y canales compartidos.

Agregar un proyecto o aumentar acceso

Una instalación que ya ha iniciado sesión ejecuta screenrig login nuevamente para agregar otro proyecto, o para elevar un proyecto Solo lectura o Proponer a Administrar:

screenrig login --project prj_ID --access manage

La persona aprueba ese cambio, y la instalación mantiene sus otros proyectos. screenrig project list muestra todos los proyectos que la instalación puede usar, y screenrig project use ID selecciona uno.

Solo lectura, proponer y administrar

Cada sesión tiene uno de tres niveles de acceso, elegido por la persona que la aprueba. Cada nivel incluye todo lo que puede hacer el anterior.

Solo lectura significa que la sesión no puede cambiar ni comprar nada. No significa gratis: cada solicitud de agente y evento facturado de listen-stream cuenta contra las solicitudes incluidas de la organización, como ocurre con Proponer y Administrar.

Proponer permite que un agente haga el trabajo mientras una persona mantiene la última palabra sobre lo que se reproduce. Sus cambios en la lista de reproducción y pantalla responden a 202 con status: pending_review y un enlace a la revisión, y nada cambia en una pantalla hasta que una persona aprueba. Sus cargas de medios, y sus cambios de etiqueta y carpeta a medios aprobados, también esperan revisión: las pantallas siguen reproduciendo lo aprobado hasta que una persona aprueba el cambio, un rechazo devuelve un elemento cambiado, y una carga rechazada permanece fuera de las pantallas. No puede eliminar, controlar pantallas ni gastar.

Una sesión que intenta algo que su nivel no puede hacer recibe 403 insufficient_access. La CLI nombra el siguiente paso: una persona aprueba Manage con screenrig login --access manage.

Los inicios de sesión de agentes predeterminados son para Gestionar, y las aplicaciones conectadas solo para Lectura. Para reducir el nivel de una instalación, desconéctela y luego inicie sesión de nuevo con screenrig login --access read o --access propose. El nivel de una sesión nunca se reduce en silencio: las configuraciones de revisión a continuación mantienen las sesiones en Proponer sin cambiarlas, y la página de Acceso muestra cuándo lo hacen.

Capacidades

Dentro de su nivel de acceso, una sesión funciona solo en las áreas de capacidad que la persona aprobó: screens, content, playlists, advertising, reports y project. La inscripción concede las seis en el proyecto que crea. Un comando fuera de las áreas aprobadas devuelve 403 forbidden nombrando la capacidad faltante. Las capacidades permanecen aprobadas para un proyecto de instalación; para más, una persona aprueba una nueva instalación que las tenga.

Requiere revisión para cambios de agente

Dos configuraciones mantienen a los agentes en Proponer sin volver a iniciar sesión. Ambas aplican en cada solicitud, cubriendo sesiones ya existentes.

• Requiere revisión para cambios de agentes, en la página Configuración del panel. Mientras esté activado, cada agente, aplicación conectada y cliente de servicio en el proyecto trabaja como Proponer como máximo: los cambios en lo que se reproduce esperan en Revisiones hasta que una persona los apruebe. El propietario del proyecto o un administrador de su organización lo cambia, y desactivarlo solicita su passkey. Las revisiones ya pendientes permanecen abiertas para decidir.
• Puede aprobar, para cada miembro en la página Acceso del proyecto. El propietario del proyecto siempre puede aprobar. Un miembro que no puede aprobar no decide revisiones y no puede otorgar a un agente la gestión; los agentes que ese miembro supervisa trabajan como máximo en Proponer.

El nivel más bajo que se aplica gana. screenrig agent status informa el access de la sesión, su effective_access y, cuando una configuración lo reduce, access_limited_by: project o person. Iniciar sesión nuevamente no eleva una configuración; el propietario del proyecto la cambia. Mientras se aplica una configuración, las pantallas de inicio de sesión y aprobación de conexión ofrecen Solo lectura y Proponer, y muestran por qué Gestionar no está disponible.

Usuarios de carga

Un usuario de carga trabaja en las listas de reproducción y carpetas de medios que usted elige, y en ningún otro lugar. Sube medios a esas carpetas y añade, reemplaza y elimina páginas de esas listas de reproducción, con fechas de inicio y fin. No puede leer ni cambiar otras listas de reproducción, pantallas, programaciones, miembros, tokens, enlaces de flota, facturación ni ajustes. Una persona del equipo de una agencia es un miembro usuario de carga; el agente de una agencia es un cliente de servicio usuario de carga.

• Invitar o asignar. En la página Acceso del panel, invite a una persona como usuario de carga o convierta a un miembro en usuario de carga, y elija las carpetas y las listas de reproducción. Desde la CLI, screenrig invitations create --kind uploader --email designer@example.com --folder-id mfd_FOLDER --playlist-id pl_PLAYLIST invita a uno, y screenrig service-client create --name "Agency agent" --uploader --folder-id mfd_FOLDER --playlist-id pl_PLAYLIST --secret-file agency.secret da a un agente su propio token. Las carpetas son exactamente las que elija, no las carpetas que contienen. El propietario edita el alcance o le pone fin en cualquier momento, y el cambio se aplica a la siguiente solicitud del usuario de carga.
• Proponer o publicar sin revisión. Los cambios de un miembro usuario de carga esperan en Revisiones hasta que el propietario del proyecto o un miembro que pueda aprobar los resuelva. El propietario puede permitir que un miembro publique sin revisión (--access manage) al invitar o asignar. Un cliente de servicio usuario de carga actúa con el acceso con el que se creó, Proponer salvo que elija otro, y Requiere revisión para cambios de agente lo mantiene en Proponer como a cualquier agente. Un usuario de carga nunca aprueba revisiones ni conecta agentes: un agente recibe en su lugar un token de usuario de carga.
• Subir y añadir páginas. screenrig media upload FILE --folder mfd_FOLDER sube a una carpeta del usuario de carga. screenrig playlist page add pl_PLAYLIST --media med_IMAGE --from 2026-12-01 --until 2026-12-24 añade el medio como una página que se muestra desde el inicio del 1 de diciembre hasta el final del 24 de diciembre, en la zona horaria de cada pantalla; playlist page replace cambia el medio o las fechas, y playlist page remove elimina la página. Una página que añade el usuario de carga es una imagen o un vídeo de sus carpetas; las demás páginas del proyecto se quedan como están. Varias cargas seguidas de un mismo usuario de carga se unen a una misma revisión, así que el propietario las aprueba juntas, y una página que aún espera en ella se puede reemplazar o quitar. El cambio de otro usuario de carga en la lista de reproducción espera a que se decida esa revisión.
• En el panel. Un miembro que es usuario de carga inicia sesión en un panel con una sola página, Subir, que muestra sus listas de reproducción y sus carpetas. En una carpeta sube archivos; en una lista de reproducción añade una página a partir de una imagen o un clip, define el primer y el último día en que se muestra la página, reemplaza o elimina sus propias páginas y retira un cambio que espera revisión. Las demás páginas del proyecto indican Definida por el proyecto.
• Fuera del alcance. Todo lo demás responde outside_upload_scope, cuyo upload_scope enumera las listas de reproducción y las carpetas que el usuario de carga puede usar.

Para limitar a un miembro o a un agente a carpetas de pantallas y pantallas en lugar de contenido, véase Permisos por carpeta de pantallas.

La página de acceso

La página Acceso del dashboard lista todo lo que puede actuar en el proyecto actual:

Cada entrada muestra cómo obtuvo acceso y quién lo aprobó, su nivel de acceso y capacidades, y cuándo fue creada y utilizada por última vez. Cuando una configuración de revisión mantiene una entrada por debajo de su nivel, la entrada muestra el nivel en el que opera y el motivo, por ejemplo "Proponer — el proyecto requiere revisión". Desconectar finaliza un agente o aplicación; Revocar finaliza un cliente de servicio. Cada uno solicita a la persona que confirme con su llave de acceso.

Cerrar sesión y revocar

screenrig logout revoca el inicio de sesión en el servidor y luego elimina los tokens almacenados. Si la solicitud podría no haber llegado al servidor, los tokens permanecen, por lo que ejecutarlo de nuevo es seguro. Una sesión solo lectura siempre puede desconectarse a sí misma.

Una sesión revocada no puede renovarse: no se emite un nuevo token después de la revocación. Sus tokens de acceso dejan de funcionar en segundos. Desactivar a la persona responsable de un agente termina sus sesiones de la misma manera, y eliminar un proyecto termina el acceso de todas las sesiones a ese proyecto.

Duración de la sesión

Cada uso del token de actualización extiende su vigencia 90 días, hasta un año después de iniciar sesión. screenrig doctor muestra cuándo finaliza la sesión de esta instalación y cada comando avisa en sus últimos 30 días. Para continuar, una persona debe aprobar un nuevo screenrig login.

Credenciales existentes

Las instalaciones que iniciaron sesión antes de estas sesiones siguen funcionando. En su próximo comando, la CLI incluida intercambia la credencial almacenada por una sesión con los mismos proyectos y capacidades, sin solicitud ni salida. Actualice el plugin oficial para obtener esa CLI; no cambia nada más para el agente.

Referencia

Estos puntos finales siguen OAuth 2.0. El CLI incluido, las aplicaciones conectadas y los clientes de servicio los usan; un agente que trabaja a través del plugin nunca los llama directamente.

Los tokens de acceso son JWT firmados con Ed25519 (EdDSA): un perfil solo EdDSA que usa las convenciones de reclamos de RFC 9068 (typ: at+jwt, iss, aud, sub, client_id, scope, jti, iat, exp). Trátelos como opacos: envíe cada uno como Authorization: Bearer y solicite uno nuevo cuando expire.

Los errores del punto de token son JSON RFC 6749 (error, error_description) con Cache-Control: no-store:

Las solicitudes a /api con un token de acceso expirado o revocado responden 401 con WWW-Authenticate: Bearer error="invalid_token"; la CLI renueva una vez y reintenta una vez. Un token que llama a algo que su nivel de acceso no puede hacer responde 403 insufficient_access con WWW-Authenticate: Bearer error="insufficient_scope" y el scope que lo permite.

Los endpoints de token y revocación aceptan 1,200 solicitudes por dirección cliente por hora, 60 renovaciones por sesión por hora y 600 tokens de cliente de servicio por cliente por hora. Los inicios de sesión están limitados a 10 por dirección por hora.

Relacionado

• Comenzar: instale el plugin oficial y cree un proyecto.
• Clientes del servicio: inicie sesión en servidores, scripts y trabajos CI con credenciales de cliente.
• Revisiones: apruebe, rechace o solicite cambios a lo que un agente propone.
• Referencia CLI: login, logout y los comandos de agente.
• Servidor remoto: conecte Claude, ChatGPT o Grok.