Role-Based Access Control
Overview
Section titled “Overview”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.
Roles & Permissions
Section titled “Roles & Permissions”Navigate to Governance Hub → Roles in the DeepIntShield dashboard to open the Roles & Permissions page.
System Roles
Section titled “System Roles”DeepIntShield includes pre-configured system roles that cover common access patterns:
| Role | Description |
|---|---|
| Admin | Full access to all resources and operations |
| Viewer | Read-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.
Custom Roles
Section titled “Custom Roles”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:
- Click New Role in the top-right corner
- Enter a Name (e.g., “Auditor”, “QA Team”)
- Add a Description explaining the role’s purpose
- In the permission table, tick the operations the role needs for each resource
- Click Create role (enabled once the role has a name and at least one permission)
Resources & Operations
Section titled “Resources & Operations”RBAC permissions are defined as combinations of Resources and Operations.
Protected Resources
Section titled “Protected Resources”DeepIntShield protects access to the following resources:
| Resource | Description |
|---|---|
| Logs | Request and response logs |
| ModelProvider | AI model provider configurations |
| Observability | Monitoring and metrics dashboards |
| Plugins | Plugin configurations and management |
| VirtualKeys | Virtual key management |
| UserProvisioning | User and group provisioning settings |
| Users | User account management |
| AuditLogs | Audit trail and compliance logs |
| GuardrailsConfig | Guardrail configurations |
| GuardrailRules | Individual guardrail rules |
| Cluster | Cluster configuration and nodes |
| Settings | Workspace settings |
| MCPGateway | MCP Gateway configurations |
| AdaptiveRouter | Adaptive routing settings |
Operations
Section titled “Operations”Each resource supports up to five operations:
| Operation | Description |
|---|---|
| View | Read-only access to view the resource |
| Create | Ability to create new instances of the resource |
| Update | Ability to modify existing resources |
| Delete | Ability to remove resources |
| Download | Ability to export or download data from the resource |
Managing Permissions
Section titled “Managing Permissions”To assign or modify permissions for a role:
- Navigate to Governance Hub → Roles
- Click Edit on the role you want to modify
- 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
Assigning Permissions
Section titled “Assigning Permissions”- Find the Resource row in the permission table
- Toggle the operations you want to enable for this role
- Repeat for other resources as needed
- Click Save role to apply changes
The role list shows each role’s granted permissions as badges, next to its member count.
Best Practices
Section titled “Best Practices”Role Design
Section titled “Role Design”- 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
Permission Strategies
Section titled “Permission Strategies”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)Integration with Identity Providers
Section titled “Integration with Identity Providers”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.
Next Steps
Section titled “Next Steps”- Setting up Okta - Configure Okta for SSO with role sync
- Setting up Microsoft Entra - Configure Entra ID for SSO with role sync
- Audit Logs - Track permission usage and access patterns
- Audit Logs - Evidence of who changed what, and when