Límites de identidad y confianza
La identidad del usuario del portal, la identidad del publicador de la máquina, la autorización de Tareas y el acceso del operador de la LAN son límites de confianza diferentes. Un rol visible para el cliente o un nombre de host de red por sí solos no otorgan permiso al Portal. Fuentes: portal · dashboard/api/mobile/v1/lib/runtime.php, portal-api · docs/TASKS.md, infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
Inicio de sesión del personal (Google)
Portal PHP es responsable de la política de inicio de sesión/cuenta de Google del navegador y crea su sesión PHP. La autorización móvil comienza en la API y redirige al flujo de Google del Portal. Los tokens se emiten solo después de las verificaciones de cuenta/permiso del Portal; el Worker no es un segundo directorio de usuarios. Fuentes: portal · dashboard/login/google_login.php, portal · dashboard/api/mobile/v1/auth/start.php, portal · dashboard/api/mobile/v1/token.php.
OAuth con PKCE (aplicación iOS y BFF web)
Los pares de ID de cliente/callback están en una lista de permitidos. El código de autorización es de un solo uso, vinculado a PKCE y se almacena como un hash; el intercambio de tokens lo bloquea/consume en una transacción SQL. Los tokens opacos utilizan 32 bytes aleatorios y hashes de búsqueda SHA-256. Fuentes: portal · dashboard/api/mobile/v1/lib/core.php, portal · dashboard/api/mobile/v1/token.php.
Los valores predeterminados son un código de cinco minutos, un token de acceso de 15 minutos, un límite de inactividad de actualización de 30 días y un techo familiar de 90 días. Estos son valores configurables en tiempo de ejecución, no constantes de protocolo inmutables. La rotación de actualizaciones preserva el techo familiar; reutilizar un token de actualización inactivo revoca su familia. Fuentes: portal · dashboard/api/mobile/v1/lib/core.php, portal · dashboard/api/mobile/v1/lib/tokens.php, portal · dashboard/api/mobile/v1/token.php.
Cada solicitud de portador recarga al usuario y verifica el estado activo; los manejadores de recursos aplican los permisos actuales. Los fallos de SQL/límite de velocidad devuelven errores del servicio, no una identidad anónima válida. Fuentes: portal · dashboard/api/mobile/v1/lib/runtime.php, portal · dashboard/api/mobile/v1/bootstrap.php.
La aplicación nativa valida el callback del navegador OAuth y almacena los tokens en el almacenamiento AfterFirstUnlockThisDeviceOnly de Keychain. El manejo de errores de actualización distingue una concesión explícitamente inválida de fallos transitorios, preservando las sesiones a través de fallos temporales de red/servicio. Fuentes: portal-ios · RiverOaksPortal/App/WebAuthenticationService.swift, portal-ios · RiverOaksPortal/App/KeychainTokenVault.swift, portal-ios · Sources/PortalCore/APIClient.swift.
Portal web detrás de la API (BFF)
La sesión PHP almacena los tokens de la API en el lado del servidor. El BFF valida el par de entorno, restringe las rutas de recursos de la API, coordina la actualización y borra las credenciales no coincidentes; los tokens no se entregan a JavaScript del navegador. Fuentes: portal · dashboard/v2/api/lib/client.php, portal · dashboard/v2/api/callback.php.
Abrir una página web desde la aplicación (transferencia)
web-session emite un secreto de fragmento de un solo uso y de corta duración para una lista de destinos permitidos propiedad del servidor. web-continue.php lo consume y vincula la sesión PHP a la familia de tokens. Esto está separado de copiar tokens de portador nativos en cookies del navegador. Fuentes: portal · dashboard/api/mobile/v1/web-session.php, portal · dashboard/api/mobile/v1/web-continue.php, portal · dashboard/api/mobile/v1/lib/tokens.php.
Publicadores HMAC
| Límite | Contrato de firma/repetición | Fuente |
|---|---|---|
| Ingesta de alertas | HMAC-SHA256 sobre marca de tiempo + . + cuerpo sin procesar; política del publicador, idempotencia y destinatarios seleccionados por el servidor |
portal · dashboard/api/mobile/v1/lib/alert-ingest.php |
| Comms/pánico | HMAC-SHA256 sobre marca de tiempo + nueva línea + cuerpo sin procesar; verificación de desfase de 30 segundos y orden de flujo/secuencia; clave compartida por estas dos fuentes dentro de un carril | portal · dashboard/api/mobile/v1/lib/comms.php, portal · dashboard/api/mobile/v1/comms-ingest.php, portal · dashboard/api/mobile/v1/panic-ingest.php |
| Pasarela de correo electrónico | Cadena canónica de marca de tiempo/método/ruta/idempotencia/digest del cuerpo; cuotas con ámbito de llamador | cloudflare-email · README.md, cloudflare-email · src/index.ts |
| Administración de enlaces cortos | Límite de acceso más solicitudes de administración firmadas y controles de repetición | cloudflare-short-links · src/admin.ts |
| Productores de línea de tiempo | mTLS más contrato de productor/época/secuencia/cuerpo firmado; verificaciones duraderas de duplicados/brechas | infrastructure/service-timeline · src/service_timeline/signing.py, infrastructure/service-timeline · src/service_timeline/storage.py |
Estos formatos no son intercambiables. El productor de comunicaciones mantiene solo la última instantánea limitada y continúa la transcripción local cuando la publicación de la API falla. Fuente: infrastructure/lyric-follower · macos/WorshipDataCaptureApp/Sources/WorshipDataCaptureApp/CommsPublisher.swift.
Afirmación de tareas (desarrollo)
La API valida la identidad del Portal, luego crea una afirmación de corta duración vinculada a la solicitud para la vinculación de Tareas del desarrollador. Tareas es el propietario de los permisos de tareas/proyectos; la lista de permisos del Portal no es una ACL de reemplazo. Fuentes: portal-api · src/index.ts, portal-api · docs/TASKS.md.
Authentik y Cloudflare Access
El control de letras del navegador y el visor interactivo de canciones utilizan la autenticación de reenvío de Authentik de nginx. Las rutas de control exactas de iPad omiten deliberadamente la autenticación del navegador pero conservan los límites de ACL/método/cuerpo de origen; nginx sobrescribe la cabecera del marcador local, y el seguidor valida su límite de control local. Fuentes: infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf, infra · nginx/hosts/rocc-db/sites-enabled/songs.riveroaks.cc.conf, infrastructure/lyric-follower · src/lyric_follower/rehearsal.py.
La programación de capturas tiene una ruta y un backend protegidos por portador por separado. Su ubicación nginx permite explícitamente fuentes no LAN antes de delegar a las verificaciones de portador; no debe describirse como un punto final anónimo solo para LAN. Fuente: infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf, infrastructure/lyric-follower · server/planning_center_api.py.
La documentación tiene un corpus de contenido, publicado tanto en
docs.ro.church (accesible desde Internet a través de Cloudflare Access) como en
docs.riveroaks.cc (red privada). IT/portal-system no es una sección separada y privada: MkDocs no tiene exclusión de secciones y la CI compila el mismo corpus para ambos destinos. El acceso es un límite del sitio, no una etiqueta de carpeta. Mantenga las credenciales, el material de recuperación, los registros personales y los inventarios de nuevos puntos finales privados de administración fuera de esta sección. Los nombres de host operativos existentes no son prueba de que agregar más sea apropiado. Fuentes: docs · mkdocs.yml, docs · .gitlab-ci.yml,
docs · README.md.
El 3 de noviembre, las solicitudes anónimas de raíz/página de origen al nombre de host público devolvieron 403; el registro de origen en la ruta de la red privada autorizada devolvió 200. Eso verifica estas solicitudes, no todas las políticas de Cloudflare Access o las rutas de omisión. La evidencia de la CI de publicación se rastrea en T-100498.
Límites de secretos y privacidad
Las credenciales de Planning Center permanecen en adaptadores del lado del servidor; los clientes del portal/captura reciben datos filtrados o una credencial de API dedicada. Eso no significa que solo un componente del servidor pueda poseer credenciales de PCO: tanto el adaptador de canciones como el generador de feeds de captura son consumidores del lado del servidor. Fuentes: portal · lyrics/songs/api.php, infrastructure/lyric-follower · server/planning-center-feed.php,
infrastructure/lyric-follower · server/planning_center_api.py.
Los secretos del Worker se configuran a través de entradas sensibles de IaC y enlaces de secretos. Los planes/estados guardados pueden contener esos valores; enmascarar una variable de CI o declararla sensible no hace que el artefacto sea seguro para publicar. Los registros de invocación están habilitados en la IaC de la API revisada. No capture cabeceras de credenciales, cargas útiles, transcripciones, grabaciones o datos personales en la documentación/evidencia. Fuentes: portal-api · infra/modules/portal-platform/main.tf,
portal-api · infra/modules/portal-platform/variables.tf, portal-api · .gitlab-ci.yml.
La opción ?comms=1 en el socket de letras selecciona tipos de mensajes; no es una verificación de autenticación. El emisor PHP revisado no distingue entre suscriptores de LAN y públicos. La ACL privada de nginx es visible en el código fuente, pero aquí no se ha establecido un filtrado seguro en cada borde de WebSocket público. No reclame la confidencialidad de las comunicaciones sin verificar por separado ese límite. Fuentes: portal · lyrics/server.php, portal · lyrics/comms_feed.php,
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.