Security

Security at z-gateway

How z-gateway protects AI agent tool access at runtime.

This page summarizes z-gateway’s security posture and control objectives. Specific implementation mechanics are available under NDA for enterprise evaluations — book a security review.

Runtime policy enforcement

z-gateway is designed to sit between AI agents and the tools they call. Runtime policies help determine whether a tool action should be allowed, monitored, approved, or blocked before it reaches connected systems such as GitHub or Postgres.

Trust controls

Short-lived agent credentials

Agent access is scoped and designed to avoid long-lived upstream credentials in the agent runtime.

GitHub App permission model

GitHub access is based on app installation permissions and repository scoping rather than broad personal access tokens.

Encrypted database credentials

Postgres connection strings are stored encrypted and never exposed to compact Overview cards or public logs.

Approvals for high-risk actions

Risky database writes can require human approval before connector execution.

Runtime sessions and decision trails

Runtime decisions are grouped into sessions so teams can review agent activity, policy outcomes, and operational context.

Sensitive data handling

z-gateway avoids exposing raw upstream credentials to agents and limits sensitive request detail retained for review.

Short-lived agent credentials

Agents authenticate to z-gateway with credentials intended for scoped runtime access. This keeps governance centered at the gateway and reduces the need to place broad, durable service credentials directly into agent clients.

GitHub App permission model

For GitHub workflows, z-gateway uses a GitHub App installation model so access can be scoped to selected repositories and permissions. Agents authenticate to z-gateway, and z-gateway mediates the connected GitHub action according to workspace policy.

Postgres credential handling

Database connectors store DSNs encrypted, validate public hosted Postgres targets, and route agent access through governed MCP tools. z-gateway does not expose raw connection strings, raw SQL, or credentials in compact dashboard surfaces.

Audit logs and decision trails

z-gateway records runtime decisions to help teams understand what an agent attempted, how policy was applied, and what outcome occurred. Runtime sessions group related GitHub and database actions into one execution timeline, while detailed logs retain redacted evidence for rollout, troubleshooting, and security review.

Quota-aware enforcement

Enforce-mode usage is checked against plan limits. If an enforce quota is exhausted, z-gateway records the quota reason and the dashboard shows the workspace as Enforce Paused rather than silently changing the configured mode.

Sensitive data handling

z-gateway is built to limit unnecessary exposure of sensitive data in agent workflows. Public documentation intentionally avoids detailed descriptions of internal storage, signing, and key-management mechanics.

Responsible disclosure

If you are an early access user and believe you have found a security issue, report it to security@z-gateway.com with enough detail for the team to reproduce and assess the issue. Please avoid public disclosure until we have had a reasonable opportunity to investigate.

Security documentation

Review setup, MCP client configuration, GitHub and Postgres connectors, runtime sessions, and approvals before moving from monitor mode to enforce mode.