Los agentes están en beta. Lo que describe esta página es lo que el servidor aplica hoy.
Qué es un permiso
Un permiso es un canal, más dos interruptores, más la clave de ese canal sellada para la clave pública del agente.zas_edit_item y zas_replace_file necesitan los dos interruptores: leen el envío primero y después lo escriben encima.
Enviar viene por defecto cuando aprobás una vinculación. Leer es un interruptor aparte, y queda apagado hasta que lo prendas.
Son independientes. Un agente que solo envía es el caso común: deja un build o una captura en un canal y no se entera de qué más hay ahí.
Recibir una transferencia por Directo pide el interruptor de lectura, no el de envío. Escribe un archivo en la máquina donde corre el agente, y eso es una lectura del canal, vaya para donde vaya el archivo.
Dónde se cambian
Configuración → Agentes. Cada agente muestra su nombre, su harness, su host y su último envío, y abajo una fila por canal con los dos interruptores y un link para quitarlo. Agregar un canal abre el mismo selector que usa la página de vinculación. Cada canal que tiene un agente también lleva una franja arriba de los envíos, con cada agente y sus interruptores. Desde ahí también podés sacar un agente del canal.El cambio corre en el próximo pedido del agente. El servidor lee el permiso vivo cada vez, así que no hay caché que esperar.
Revocar
Configuración → Agentes → el agente → Revocar. Se corta la sesión, se revocan sus tokens y la próxima llamada del agente responde que el dueño lo revocó. Lo que ya envió queda donde está. Los envíos de un agente son tus envíos: vencen con el reloj de siempre y los borrás como cualquier otro. Para achicar en vez de revocar, sacale un canal y dejale el resto.Los números
En una organización, un administrador define cuántos agentes puede tener cada persona, y no hay tope de canales por agente. Mirá Agentes en una organización.
Canales de una organización
Un canal que administra una organización se puede habilitar solo si esa organización prendió los agentes. El interruptor es Permisos → Agentes en canales de la organización, viene apagado y lo maneja un administrador. De dónde corre el control se desprenden dos cosas:- El interruptor se lee en cada llamada, no al habilitar. Apagarlo cierra en el acto todos los permisos sobre esos canales. Un permiso es solo una clave; la puerta se revisa cada vez.
- Tu propio lugar en el canal es el techo. Salir del canal, o salir de la organización, le cierra el acceso a tu agente diga lo que diga el interruptor.
Qué no puede cubrir un permiso
- Un canal al que solo entraste. El permiso existe sobre canales que tu cuenta posee, y sobre canales de organización que la organización abrió.
- Tu canal Privado se puede habilitar como cualquier canal tuyo, pero pensalo. Es el único lugar donde nada se comparte.
- Un canal en solo lectura.
Qué revisa el servidor igual
Los interruptores de la interfaz no son la única línea. Atrás:- La API le responde a un agente en una lista fija de rutas y le niega todas las demás. Agregar una ruta a Zas nunca amplía por accidente lo que un agente puede hacer.
- Las reglas de la base le niegan el documento de tu cuenta, tus dispositivos y cualquier canal sin permiso de lectura activo.
- Los límites de frecuencia corren en sus propios baldes, y la derivación de claves se cobra a tu cuenta, así que diez agentes no son diez veces tu cupo.
- El servidor nunca ve la clave de un canal, el nombre de un canal ni el contenido de un envío. Eso no cambia porque el que envía sea un agente. Mirá Cifrado.
Por dónde seguir
Recomendaciones
Qué canal habilitar, y qué no enviar nunca.
Agentes en una organización
Las dos palancas de un administrador, y qué muestran.
Canales
Canales privados y compartidos, y los topes por plan.
Privacidad
La lista completa, sin rodeos.