Skip to content

Role-Based Access Control

Role-Based Access Control (RBAC) in DeepIntShield Enterprise provides fine-grained access management for your organization. RBAC allows you to define roles with specific permissions, controlling what users can view, create, update, or delete across all DeepIntShield resources.

Key Benefits:

  • Principle of Least Privilege - Grant users only the permissions they need
  • Centralized Access Management - Manage all permissions from a single interface
  • Audit-Ready - Track who has access to what for compliance requirements
  • Flexible Role Design - Use system roles or create custom roles for your organization

RBAC integrates seamlessly with identity-provider authentication (Okta or Microsoft Entra), automatically assigning roles based on your IdP groups and claims.


Navigate to Governance Hub → Roles in the DeepIntShield dashboard to open the Roles & Permissions page.

DeepIntShield includes pre-configured system roles that cover common access patterns:

RoleDescription
AdminFull access to all resources and operations
ViewerRead-only access to all resources

Roles synchronized from your identity provider resolve to one of these two access levels: any mapped role that is not viewer resolves to Admin. System roles cannot be deleted.

Create custom roles when system roles don’t match your organizational structure. Custom roles are useful for:

  • Specialized Teams - Create roles for QA, Security, or Compliance teams
  • Project-Based Access - Limit access to specific resources per project
  • Temporary Access - Grant limited permissions for contractors or auditors

To create a custom role:

  1. Click New Role in the top-right corner
  2. Enter a Name (e.g., “Auditor”, “QA Team”)
  3. Add a Description explaining the role’s purpose
  4. In the permission table, tick the operations the role needs for each resource
  5. Click Create role (enabled once the role has a name and at least one permission)

RBAC permissions are defined as combinations of Resources and Operations.

DeepIntShield protects access to the following resources:

ResourceDescription
LogsRequest and response logs
ModelProviderAI model provider configurations
ObservabilityMonitoring and metrics dashboards
PluginsPlugin configurations and management
VirtualKeysVirtual key management
UserProvisioningUser and group provisioning settings
UsersUser account management
AuditLogsAudit trail and compliance logs
GuardrailsConfigGuardrail configurations
GuardrailRulesIndividual guardrail rules
ClusterCluster configuration and nodes
SettingsWorkspace settings
MCPGatewayMCP Gateway configurations
AdaptiveRouterAdaptive routing settings

Each resource supports up to five operations:

OperationDescription
ViewRead-only access to view the resource
CreateAbility to create new instances of the resource
UpdateAbility to modify existing resources
DeleteAbility to remove resources
DownloadAbility to export or download data from the resource

To assign or modify permissions for a role:

  1. Navigate to Governance Hub → Roles
  2. Click Edit on the role you want to modify
  3. Change the role in the edit card that opens above the role list

The edit card shows the role’s Name and Description above a single permission table:

Rows - Resources:

  • Lists all available resources, grouped by area (Gateway, Security, Agentic, Prompts, Observability, Governance, Platform)
  • Shows each resource’s name with a short description

Columns - Operations:

  • One checkbox per operation: View, Create, Update, Delete, and Download
  • An All checkbox that selects or clears every operation for the resource
  • Ticking any other operation also ticks View
  1. Find the Resource row in the permission table
  2. Toggle the operations you want to enable for this role
  3. Repeat for other resources as needed
  4. Click Save role to apply changes

The role list shows each role’s granted permissions as badges, next to its member count.


  • Start with System Roles - Use Admin and Viewer as templates
  • Follow Least Privilege - Only grant permissions that are necessary
  • Document Role Purpose - Use clear descriptions to explain each role’s intent
  • Review Regularly - Audit role assignments quarterly

For Development Teams:

- Frontend team: VirtualKeys (View), Logs (View), Observability (View)
- Backend team: ModelProvider (CRUD), Plugins (CRUD), Logs (View)

For Security/Compliance Teams:

Custom "Auditor" role with:
- AuditLogs (View)
- Logs (View)
- GuardrailsConfig (View)
- Users (View)

For Operations Teams:

Custom "Ops" role with:
- Cluster (CRUD)
- Observability (View)
- Logs (View)
- Settings (View, Update)

When using Okta or Microsoft Entra for authentication, roles can be automatically assigned based on:

  • IdP Groups - Map identity provider groups to DeepIntShield roles
  • App Roles - Sync application roles from your IdP
  • Claims - Use custom claims to determine role assignment

Users authenticated via SSO receive their role assignments automatically on first login, with permissions synchronized on each session.

A provisioned user’s role can be changed at any time from Governance Hub → User Manager in the DeepIntShield dashboard.