Security Model | SmythOS Documentation

The SmythOS Runtime Environment (SRE) is designed with security at its core.

Every operation, agent execution, resource access, or collaboration, is protected by a security model that includes zero-trust access control, vault-backed secret management, and real-time role enforcement.

Security by Default

Every request in SRE is checked against role-based permissions and access policies. Only verified candidates with the correct role and explicit access can read, write, or execute.

Identity Enforcement with Candidates and ACLs

SRE enforces access at the identity level using the Candidate and ACL model:

Every time a candidate attempts to access a resource, such as storage or an LLM, SRE checks the ACL for explicit permission.

const candidate = AccessCandidate.agent(agentId);
const storage = ConnectorService.getStorageConnector().user(candidate);
await storage.write('results.json', data);

You can manage these permissions through Roles and Permissions, and they are enforced consistently across Spaces and your Organization.

Vault-Based Secret Management

Sensitive data, like API keys, credentials, and tokens, is never hardcoded or exposed. Instead, SRE uses the Vault subsystem for secure, encrypted secret storage.

To manage secrets, visit the Vault dashboard.

Authentication and Identity Providers

SRE supports both built-in authentication and integration with external enterprise systems:

You can manage users and authentication settings from the Organization Management panel.

Role-Based Access Control (RBAC)

Role-based access control is central to SRE. Roles define who can do what... from the agent runtime to your admin dashboard, and are enforced in real time.

If a candidate does not have the correct permissions, the action is denied before execution.

To adjust or review roles, see the Roles and Permissions guide.

Enterprise Security Features

SRE is built to support production and regulated environments:

To learn more about deploying SRE in enterprise settings, see Enterprise Deployment.

Review Policies Regularly

Security is a shared responsibility. Review your ACLs, vault settings, and audit logs periodically to maintain compliance and minimize risk.

How SRE Security Connects

SRE security spans multiple subsystems. Here’s where to manage each area:

Security Area Where It’s Managed
Identity & ACLs Roles and Permissions
Credential Storage Vault
User Roles & Login Organization Management
Agent Environments Spaces
Advanced Deployment Enterprise Deployment

What’s Next?