OpenShell explicado: límites de actuación de un agente
Seguridad operativa de OpenShell: origen de política y credenciales
Comprueba política efectiva y barrera de red antes de confiar en la carga.
Qué aprenderás
- Ver la política elegida
- Mantener credenciales fuera
- Decidir telemetría y respuesta
Antes de empezar
- Una carga desechable y un runtime soportado
- Permiso para revisar política y proveedores
Convierte los controles descritos en un informe acotado que otro operador pueda revisar.
Conclusiones clave
- Omitir un flag de política no demuestra restricción efectiva.
- La inyección de credenciales exige revisar destino y método.
- El sandbox limita capacidades, no decide la intención.
Ver la política elegida
La política restrictiva predeterminada se usa solo si no existe una política global, guardada o dentro de la imagen. Los proveedores adjuntos también pueden añadir reglas de red. Guarda vistas base y efectiva con sus revisiones.
La política documenta rutas añadidas cuando hay reglas de red. Las rutas CA y GPU concedidas solo en ejecución pueden faltar en ambas vistas. Prueba el sandbox activo; omitir `--policy` no revela todos sus permisos.
Mantener credenciales fuera
Un proveedor relaciona nombre de servicio y secreto almacenado; el supervisor lo añade a solicitudes autorizadas. Revisa destino, método y restricciones por binario. Rota una credencial de prueba y confirma que el acceso desaparece.
Una inyección en el prompt todavía puede inducir acciones dentro del permiso concedido. Reduce el alcance, usa datos sintéticos y lee rechazos. El aislamiento no sabe si el usuario quería realmente una acción permitida.
Decidir telemetría y respuesta
El README describe recuentos operativos anónimos y la opción `OPENSHELL_TELEMETRY_ENABLED=false` para desactivarlos. Lee el documento de telemetría y verifica la configuración real antes de procesar datos sensibles.
El registro de incidentes debe conservar logs, cambios de política, imágenes y aprobaciones de proveedores. Esta serie no atacó la frontera ni certifica el software para entornos regulados.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Guardar política base y efectiva antes de iniciar el agente.
- 2
Probar revocación del proveedor y salida directa denegada.
- 3
Definir telemetría y conservación de incidentes.
Ejemplo para copiar
review:
base_policy: registrar-revision
effective_policy: registrar-revision
direct_egress: denegado-en-prueba
provider_revocation: verificada
telemetry: ajuste-explicitoPreguntas frecuentes
¿La clave reside dentro del contenedor del agente?
El diseño fijado dice que permanece con el supervisor fiable y se añade solo a peticiones autorizadas.
¿La telemetría está siempre desactivada?
No. El README describe estadísticas anónimas y un ajuste explícito para desactivarlas.
Fuentes
- OpenShell / docs/how-it-works/policies/default-policy.mdxFuente verificada 2026-10-04
- OpenShell / docs/how-it-works/providers/overview.mdxFuente verificada 2026-10-04
- OpenShell / docs/observability/telemetry.mdxFuente verificada 2026-10-04
- OpenShell / docs/about/architecture.mdxFuente verificada 2026-10-04