--PRODAdmin

Provisioning Kioskos

Genera credenciales por kiosko y descarga el kiosk.device.json listo para instalar.

No hay sesion Admin activa. Entra primero al Dashboard para iniciar sesion.

Kioskos existentes

KioskoSucursalAliasNCFSalud
Sin kioskos en catalogo.

Click en una fila para prellenar formulario.

Alta / rotacion credenciales

Documentacion operativa (Alta / rotacion)

De donde sale la informacion

  1. Kioskos existentes: se consulta GET /v1/ncf/masters/kiosks?limit=500.
  2. Salud ONLINE/OFFLINE: se consulta GET /v1/kiosks/status (heartbeat).
  3. Alta / rotacion credenciales: se ejecuta POST /v1/auth/kiosk/provision usando token admin guardado en autogo_admin_token (obtenido desde POST /v1/auth/login).

Que hace Alta / rotacion

  1. rotate=true: genera clientId nuevo y clientSecret nuevo.
  2. rotate=false: conserva credenciales actuales y solo actualiza metadatos/fingerprint/estado.
  3. active=false: deja el kiosko inactivo para bloquear login.
  4. Siempre revoca refresh tokens vigentes del kiosko para cortar sesiones antiguas.
  5. La opcion recomendada para operacion normal es rotate=false para no romper identidad remota.

Persistencia en backend

  • Tabla principal: central_kiosk_clients (kioskId, tenantId, branchId, clientId, secret hash, fingerprint hash, active).
  • Sesion/refresh: central_kiosk_refresh_tokens (revocados en rotacion).
  • Login de agente: POST /v1/auth/kiosk/login valida kioskId + clientId + clientSecret + deviceFingerprint.

Archivos en hardware y estabilidad

  • Archivo fuente de identidad: C:\AutoGo\device\kiosk.device.json.
  • Servicio local: AutoGoKioskAgentNSSM (puerto local 17777).
  • Autocheck recomendado: C:\AutoGo\device\kiosk-agent-autocheck.ps1 (cada 1 minuto).
  • Log local autocheck: C:\AutoGo\device\kiosk-agent-autocheck.log.
  • Si clientSecret queda vacio o invalido, el kiosko cae a OFFLINE por falla de login/heartbeat.

Diagnostico rapido (Soporte)

Kiosko local (Windows)

# PowerShell (Admin) en el hardware del kiosko
Get-Service AutoGoKioskAgentNSSM
Invoke-RestMethod http://127.0.0.1:17777/health
Invoke-RestMethod http://127.0.0.1:17777/identity
Invoke-RestMethod -Method Post http://127.0.0.1:17777/session/login
Test-NetConnection api.autogo.com.do -Port 443
Get-Content C:\AutoGo\device\kiosk-agent-autocheck.log -Tail 50

VPS (Docker/API)

# SSH a la VPS
cd /opt/autogo
docker compose --env-file .env.production -f docker-compose.prod.yml ps
docker compose --env-file .env.production -f docker-compose.prod.yml logs --tail=120 api
docker compose --env-file .env.production -f docker-compose.prod.yml logs --tail=120 kiosk
curl -sS https://api.autogo.com.do/health