Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

hallpass

Servicio auto-alojado para verificaciones de permisos en tiempo real antes que agentes de IA actúen en sistemas externos como Jira, GitHub, Kubernetes y AWS. Usa credenciales read-only para consultar la fuente de verdad.

Ficha actualizada 24 sept 2026, 6:05 · upstream 24 sept 2026, 5:27 · release v0.3.0

Ver códigoProblemas y ayudaRepositorio ↗Sitio oficial
00

Qué es hallpass

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Hallpass es un servicio pequeño diseñado para resolver una pregunta fundamental: ¿puede el usuario X realizar la acción Y sobre el recurso Z en el sistema C? Los agentes de IA y bots suelen poseer cuentas de servicio con privilegios elevados que superan los permisos del usuario final. Hallpass evita este problema consultando directamente a los sistemas externos con credenciales read-only, sin mantener copias sincronizadas de políticas de permisos.

El servicio opera como un delegado no confiable: lo que puede hacer la credencial del agente nunca decide nada por sí misma. Las reglas se aplican en el gateway de herramientas antes de ejecutar cualquier acción. Hallpass falla hacia abajo (fails closed): si no puede evaluar una consulta, devuelve unknown en lugar de allow. Cada decisión se registra como línea JSON con evidencia de las llamadas upstream.

Soporta 21 sistemas diferentes incluyendo Jira, GitHub, Kubernetes, AWS IAM y más. Ofrece caching por defecto de 30 segundos con opción de checks fresh para acciones destructivas. Es un binario estático único sin base de datos, compatible con múltiples frameworks de agentes de IA.

CASOS DE USO
  • Validar permisos antes que un agente de IA elimine issues en Jira o despliegues en Kubernetes
  • Prevenir que bots ejecuten acciones destructivas cuando el usuario final no tiene los permisos necesarios
  • Auditar decisiones de permisos con registro JSON completo incluyendo evidencia upstream
  • Integrar con frameworks como LangChain, LangGraph, MCP y Claude Agent SDK para protección en tiempo real
PUNTOS DESTACADOS
  • Consulta live a sistemas externos con credenciales read-only, sin copias desactualizadas de políticas
  • Fails closed: unknown se trata como deny por defecto, nunca adivina permisos
  • Binario estático único sin base de datos, solo una dependencia yaml.v3
  • Soporta 21 sistemas diferentes con integración transparente para cada uno
  • Registro completo de decisiones JSON con evidencia upstream y ETags o hashes SHA-256
PRECAUCIONES
  • No proporciona aprobación humana automática; acciones destructivas requieren confirmación adicional en el agente
  • Atomicidad limitada: permisos pueden cambiar entre check y acción, aunque fresh checks reducen la ventana
  • Fresh checks consumen llamadas upstream adicionales para cada verificación sin caché
  • El servicio no autentica al usuario; esta responsabilidad corresponde a la capa de herramientas del agente
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

hallpass demo: an admin is allowed, dana is denied, an unknown user is denied
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA4 GBRAM estimada
DISCO10 GBalmacenamiento base
COMPLEJIDADhighnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Docker detectado

Descargar binario desde releases o usar Docker. Configurar HALLPASS_API_KEY y archivo hallpass.yaml con credenciales read-only para cada sistema. Port 8080 expuesto. Para producción, considerar CPU 4 cores, RAM 4GB mínimo. Actualizar antes de habilitar fresh checks en agentes existentes.

✓Dockerfile
—Compose
—One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
Node.jsGoPython
SERVICIOS
No detectados
BASES DE DATOS
No detectadas
PUERTOS
8080
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

Experiencia real de la comunidad

Ayuda a contrastar la estimación automática con instalaciones reales.

Todavía no hay datos comunitarios para este proyecto.