oktsec / Deployment

Local enforcement. Evidence you can use.

Run Oktsec Node where your agents work. Use Cloud to manage policy, review reported activity and prepare evidence for your security and compliance workflows.

Two responsibilities

Node runs with your agents. Cloud coordinates your team.

Connect the agent workflows you want to govern to Oktsec Node. Manage their policy, reporting and review through Oktsec Cloud.

Oktsec Cloud

Policy, review and reporting

Signed policyEvidence
Your environment

AI agent

Requests an action

Oktsec Node

Apply policy · record evidence

Tool or system

Executes the action

Actions run locally. Blocked requests stop at Node.Node opens the outbound connection to Cloud. No inbound access.

Coverage follows the integration: requests that bypass the configured gateway, proxy, wrapper or hook are outside its enforcement and action evidence. Destination tools and model providers retain their own data flows.

Alongside your existing controls

Let the agent investigate. Keep production changes with your team.

A support agent needs checkout logs to diagnose failed requests. Route its MCP tool calls through Node and allow the read tool. Keep the restart tool outside that agent’s permissions.

ILLUSTRATIVE MCP CONFIGURATION

Investigate failed checkout requests

Agent access: read checkout logs. Production restart: restricted.

Read checkout logs
Permitted by the tool allowlist

Other Node checks still apply. If forwarded, the log service enforces the account’s read access.

Restart checkout
Blocked at Node

The restart tool is not on the agent’s allowlist. The gateway rejects the call before forwarding it.

The team reviews the diagnosis and handles any production change through its existing change process.

Follow the decision and the result.

Review Node’s access decision alongside the destination’s logs. A denied call establishes that this route was blocked; it does not establish what happened through another route.

Keep the destination’s permissions.

Use credentials limited to the required logs. If the agent can reach the service directly, that path needs its own controls and records.

What to validate in this integration

Configure the agent’s tool allowlist for the read operation and confirm that the restart operation is excluded. Check the caller identity, routing, destination credentials and the policy actually applied by Node.

Exercise both calls in a test environment. Inspect Node’s decision and the backend invocation records. Also test direct access and Node unavailability; do not assume the client fails closed. Export only the evidence available for that integration and record any gaps.

This example describes the configured MCP gateway path. It is not a recorded test result or a claim of integration with a particular agent platform.

Know what crosses the boundary

Different workflows carry different evidence.

Agree on collection and review requirements before rollout. Routine reporting is reduced; an approval workflow needs the context of the action being reviewed.

Data sent from Node to Cloud by workflow
WorkflowWhat Cloud receivesWhat to review
Policy and system stateCloud receivesSystem identity, software and configuration state, reported inventory, policy assignment and evidence health.ReviewEnable the inventory and reporting capabilities needed for the systems in scope.
Routine activity and action receiptsCloud receivesAgent or principal identifiers, decisions, rule metadata, timestamps and integrity records. Action receipts carry request and response hashes.ReviewRoutine activity omits message bodies and tool arguments. Evidence can still identify systems, agents and resources.
Workstation baselineCloud receivesReduced control statuses, recognized provider identifiers and screen-lock timeout in a signed snapshot.ReviewBaseline reporting must be enabled. The baseline block does not include filesystem paths or a full application list.
Quarantine and step-up reviewCloud receivesCredential-redacted quarantine messages and full tool arguments for step-up approvals.ReviewThese review items can contain business information. Agree on reviewer access and handling of the context sent to Cloud.
Evidence for compliance

Bring agent security into your audit workflow.

Use the observations already collected by Node and organized in Cloud to prepare evidence for SOC 2, ISO 27001 and internal reviews. Give the reviewer a system, an owner, an observation time and a record to examine.

Workstation baseline

Review eight checks across enrolled workstations: seven host observations from Node and device ownership recorded in Cloud. Find failed and unobserved controls by system or group.

CSV · systems, owners, controls and observation dates

Policy review reports

Review coverage, policy state, exceptions, activity and change history for a selected group and period. Report sections include references to relevant SOC 2 and ISO 27001 controls.

Markdown · review periods of 30, 90, 180 or 365 days

Action and audit evidence

Export recorded activity and administrative changes. Use a signed action-evidence bundle when the reviewer needs to verify node identity, signatures and the included action lifecycle.

CSV / JSON exports · independently verifiable action bundles

For a broader handoff, an organization owner can also download a ZIP of systems, policies, members, alerts and audit/activity records, with a manifest identifying export limits.

What does the workstation baseline check?
  • Anti-malware presence and reported provider
  • Full-disk encryption
  • Screen lock enabled
  • Password required on unlock
  • Screen lock within 15 minutes
  • Automatic security updates
  • Known password manager installed
  • Device inventoried and assigned to an owner

Enable baseline reporting for the workstations in scope. Unsupported or unreadable checks remain unobserved; non-applicable systems are excluded. These eight checks are Oktsec’s workstation baseline, not the complete SOC 2 control set.

Use the evidence in the platform your team already works in.

Export from Oktsec, select the records for the review period, and attach them to the relevant controls in your compliance platform or auditor workspace. Review file format, access and scope before sharing.

This is an export-and-upload workflow. Vanta and Drata support custom evidence uploads; a native Oktsec connector is not currently provided.

Choose the evidence for your audit question

Oktsec provides supporting evidence. Your organization and auditor determine the applicable controls, sufficiency of evidence and audit outcome.

Independent verification

Keep evidence your team can verify.

Export the action-evidence bundle and check it against the enrolled node identity. The verifier reports signatures, lifecycle chains and the coverage of the included records.

  1. Export action evidence

    Export the action-evidence bundle for the node and period under review from the control plane.

  2. Confirm the node identity

    Obtain the enrolled node fingerprint through a trusted channel, independently of the bundle. The node reports it with oktsec node status.

  3. Verify the exported records

    Use the Oktsec Node verifier to check signatures and lifecycle chains, then review the reported coverage and completeness.

Copy the Oktsec Node verification commands

Use the Oktsec Node build supplied with your deployment. Obtain the trusted enrolled node fingerprint independently of the bundle.

Terminal
# Verify an exported action-evidence bundle with the trusted node identity
oktsec verify action-evidence \
  --file ./action-evidence.json \
  --expected-node-fingerprint '<trusted-node-fingerprint>'

# Machine-readable verification result
oktsec verify action-evidence \
  --file ./action-evidence.json \
  --expected-node-fingerprint '<trusted-node-fingerprint>' \
  --json

Verification establishes the integrity of included records. Review export limits and completeness separately; a valid signature does not establish that every action was captured.

Explore framework mappings
A practical first rollout

Agree on the workflow. Prove the coverage.

Start with a defined group of systems and the evidence your security, engineering and compliance teams need.

  1. 01

    Connect and enroll

    Identify supported agent integrations, outbound endpoints, system owners and the Node installation channel supplied for your deployment.

  2. 02

    Apply and observe

    Assign policy, confirm its application and exercise allowed, held and blocked actions. Enable workstation baseline reporting where it applies.

  3. 03

    Review and export

    Check reported coverage and missing observations. Prepare the policy report, baseline export and action evidence needed for your review.

Deployment options

Choose the operating model with your team.

AVAILABLE TODAY

Hosted Cloud. Local Node.

Oktsec manages the control plane. Your team operates the enrolled systems and configured enforcement points. Confirm hosting location, retention, access and network requirements during the deployment review.

PLANNED / NOT YET AVAILABLE

Private and isolated control planes.

Customer VPC, self-hosted and fully disconnected control-plane options are planned. Bring those requirements into the scope discussion before choosing a deployment.

Before you deploy

Deployment questions.

Does Cloud need inbound access or a remote shell?

No. Node initiates outbound connections to retrieve signed policy, send evidence and poll review decisions. Cloud does not open a remote shell. Configure the required endpoints and network access for the deployment.

Does all activity on the machine pass through Oktsec?

No. Enforcement and action evidence cover the configured gateways, proxies, wrappers or hooks. Direct routes around those integration points must be reviewed separately. Workstation baseline observations are a separate reporting capability.

Does request content ever reach Cloud?

Routine event exports omit message bodies and tool arguments, and action receipts use hashes. Central review is different: quarantine items include credential-redacted message content, and step-up approval items include full tool arguments so the reviewer can approve the exact action.

Can we send evidence to our compliance platform?

Yes, through an export-and-upload workflow. Select the report or export for the systems and period under review, then attach it to the relevant control in the destination platform. File support and audit requirements depend on that platform.

Is offline evidence verification the same as an air-gapped deployment?

No. Offline verification checks an exported action-evidence bundle with a trusted node identity. A fully disconnected control plane is a separate deployment mode and is planned.

Walk your security team through the deployment.

Bring your agent workflows, network requirements and audit evidence needs. We will define the integration, reporting scope and first rollout with your team.