Skip to main content

Operator Guide

This guide covers day-to-day operations for teams managing UAPK Gateway.

Overview​

Operators are responsible for:

  • Approval Management: Reviewing and acting on escalated requests
  • Agent Oversight: Monitoring agent activity and health
  • Audit & Compliance: Verifying logs and generating reports
  • Incident Response: Handling security events and anomalies

Dashboard Access​

Access the operator dashboard at:

http://localhost:8000/ui

Login with your operator credentials to access:

  • Approvals - Review and act on pending approval requests - Approvals

  • Audit Logs - View activity logs and verify chain integrity - Audit

  • Dashboard - Monitor agent activity and system health - Dashboard

  • Incidents - Respond to security events and anomalies - Incidents

Quick Actions​

Check Pending Approvals​

curl "http://localhost:8000/api/v1/orgs/$ORG_ID/approvals?status=pending" \
  -H "Authorization: Bearer $TOKEN"

Verify Log Chain​

curl http://localhost:8000/api/v1/orgs/$ORG_ID/logs/verify/my-agent \
  -H "Authorization: Bearer $TOKEN"

Suspend an Agent​

curl -X POST http://localhost:8000/api/v1/orgs/$ORG_ID/manifests/$MANIFEST_ID/suspend \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason": "Security review required"}'

Operator Roles​

RolePermissions
adminFull access, user management, settings
operatorApprove/deny, view logs, manage agents
viewerRead-only access to logs and status

Daily Checklist​

  • Review pending approvals
  • Check for expired approvals
  • Verify log chain integrity
  • Review denied actions for patterns
  • Check agent health metrics