Manage Custom Roles

A custom role is an admin-defined role which allows Sysdig administrators to bundle a set of permissions and assign then to one or more users or teams. This page explains how to create and manage custom roles in Sysdig.

Prerequisites

Custom roles are supported in:

  • Sysdig SaaS
  • Sysdig On-Prem version 6.0 or later.

Understand Custom Roles

Custom roles let you grant granular access to users based on a selected set of permissions. If the default user and team roles don’t meet your organization’s needs, you can create your own custom roles.

Custom roles let you:

  • Select the permissions you want users to have based on their access to resources.
  • Restrict access of users to only the necessary resources.
  • Assign roles to users and teams, like built-in Sysdig roles.

Custom roles follow principles similar to role-based access control (RBAC) systems.

Benefits of Using Custom Roles

Custom roles allow you to:

  • Give access to a specific set of predefined dashboards, while restricting users from modifying or sharing the dashboards, or viewing any additional data.

  • Create service accounts for Sysdig Secure that are not tied to a particular user, for use in automating your Continuous Integration and Continuous Deployment (CI/CD) pipeline.

    • Give a custom set of permissions to the CI/CD account.
    • Give permission to create these accounts to a certain set of users.
  • Identify the owner of a particular image so the security issue can be assigned to the team who owns the issue.

  • Create a team role that can invite users but not manage the team.

Create a Custom Role

  1. Log in to Sysdig Monitor or Sysdig Secure as administrator.

  2. Select Settings > Access & Secrets > Roles.

  3. Click New Role. The New Role page is displayed.

  4. Specify the following:

    • Role Name: A unique name to identify the role you create.
    • Role Description: A short explanation of the role that you have created.
    • Product: Choose whether the role is for Secure, Monitor, or both.
  5. Select the features and do one of the following:

    • From the drop-down, select one of the following: No Access, Read Only, Full Access, or Custom.
    • Click Customize to grant granular permissions to a sub-set of features. This is an alternative to clicking Custom from the drop-down. See Custom Roles and Privileges for a detailed outline of the options.
  6. Click Save to create the role.

Assign a Custom Role to Teams

You can set up a custom role as the default user role for teams. To do so:

  1. Log in to Sysdig Monitor or Sysdig Secure as administrator and select Admin.

  2. Select Teams.

  3. Do one of the following:

    • Select the relevant team from the list of teams.
    • Click Add Team.
  4. From the Default User Role drop-down, select one of the custom role you have created.

  5. Complete creating or editing the team as described in Manage Teams and Roles.

  6. Click Save.

Custom Roles and Privileges

When creating a custom role, you can select Customize to grant granular permissions for each product feature. The following table details the options:

Sysdig Monitor

CategoryItemPermissionDescription
Dashboards
Dashboard Metrics Data
READView Dashboard Metrics Data
Dashboards
READAccess dashboards in scope of a team
EDITModify dashboards in scope of a team
Automations
Automations
READView Automations.
IntegrationsCustom Integrations
READAccess custom integrations in spotlight
EDITModify custom integrations in spotlight
Infrastructure
READView discovered infrastructure
Integrations
READView discovered workload integrations
Monitoring Integrations
EDITChange monitoring integration type or status
READView monitoring integrations.
VALIDATEChange monitoring integration status to Pending Metrics
Spotlight
READAccess spotlight
Sysdig Sage
Use Sysdig Sage chat
EXECAbility to run Sysdig Sage chat.
Advisor
Advisor
READAccess Overview/Advisor.
Kubernetes API
READAccess Kubernetes API.
Live Logs
VIEWAccess LiveLogs feature
Costs
Cost Advisor
EDITMake changes in Cost Advisor.
READAccess Cost Advisor.
Cost Explorer
READAccess Cost Explorer.
Cost Reports
EDITEdit Cost Reports.
READAccess Cost Reports.
Explore/Metrics
Agent Console
VIEWUse Agent Console commands
Agent Console - Agent Status
READUse Agent Console commands which access agent status.
Agent Console - Configuration
VIEWUse Agent Console commands to view the configuration of the agent which does not contain sensitive information like passwords
Agent Console - Diagnostics
READUse Agent Console commands which access internal diagnostics of the agent
Agent Console - Network Calls
EXECUse Agent Console commands which make network calls to remote pods and endpoints
Agent Console - Sensitive Configuration
VIEWUse Agent Console commands to view the configuration of the agent which does contain sensitive information like passwords. There are currently no commands that implement this permission
Explore
READMetric querying with Explore
EDITN/A
Shared Groupings with Team
TOGGLEShare metrics grouping with the team
Alerts
Alert Events
READAccess the events generated by triggered alerts in scope of a team
EDITAcknowledge an event triggered by an alert in the events feed in scope of a team
Alerts
READAccess the alerts in scope of a team
EDITModify alerts in scope of a team
Events
Custom Events
READAccess the infrastructure & other events created by Sysdig Agent or Sysdig API
EDITAcknowledge the infrastructure and other events created by Sysdig Agent or Sysdig API
Captures / Investigate
Captures
VIEWView captures in the UI
READAccess captures
EDITModify captures
Data Access Settings
Datastream
READAccess data stream configuration
Groupings
READAccess default and custom groupings
EDITCreate and edit custom groupings
Ingest Platform Metrics
WRITEN/A
Metrics Data
READAccess metrics data
Metrics Descriptors
READAccess metrics descriptors
PromQL Metadata
READAccess Prometheus metrics and labels
Settings
API Access Token
VIEWView your API token
READAccess users API token in scope of a team
EDITReset users API token in scope of a team
AWS Settings
READAccess Amazon Web Service (AWS) settings
Agent Installation
READGet agent access key (required for agent installation)
Alert Downtimes
READList alert downtimes for the customer
Global Notification Channels
READAccess global notification channels
Notification Channels
READAccess notification channels in scope of a team
EDITModify notification channels in scope of a team
Service Accounts
READAccess service accounts in scope of a team
EDITModify service accounts in scope of a team
Subscriptions
READAccess customer subscription details
Sysdig Storage
READView Sysdig storage configuration
Team Agent Console Access Toggle
READSee the agent console access settings for a team
EDITToggle access to agent console for a team
Team Captures Access Toggle
READSee the capture settings for a team
EDITToggle access to captures for a team
Team Membership
READAccess team members
EDITModify team members
Team Membership Roles
EDITModify team members role
Teams
MANAGEModify team settings without the ability to modify team membership for users
Users
READAccess existing users data
CREATEInvite new users
Users List
READSee the list of users for a customer

Sysdig Secure

CategorySubcategoryItemPermissionDescription
Attack Surface
Risks
Risks
WRITEAbility to modify existing risks.
READAbility to view Risks.
Identity Findings
CIEM
EDITAbility to modify Identity Findings (CIEM), such as updating identities and creating, editing, or revoking identity exceptions.
READAbility to view Identity Findings (CIEM), such as identities, their permissions, and identity exceptions.
Posture Findings
Posture Controls
EDITCreate and modify posture controls.
READView posture controls.
Vulnerability Findings
Admission Controller (Legacy)
EDITCreate and modify policy mappings.
READAccess policy mappings.
Scan Results
READView scan results on the Pipeline, Runtime, and Registry UI as well as list and get results from the public API. Retrieve SBOM results from the SBOM API.
Scanning Image Results
WRITEModify scanning alerts and registry credentials.
READAccess scan results.
Registry Scanner
EXECAbility to run the Registry Scanner.
CLI Execution
EXECAbility to run the CLI Scanner.
Registry Credentials
WRITEAbility to add and modify registry credentials.
READAbility to list registry credentials.
Scanning Registry Credentials
EDITAbility to add and modify scanning registry credentials.
READAbility to list scanning registry credentials.
Scanning Events (Legacy)
CREATECreate scanning events.
Run Scan (Legacy)
EXECExecute backend scanning.
Scanning Alerts (Legacy)
EDITModify scanning alerts.
READAccess scanning alerts.
Scanning Images (Legacy)
READList scanning images.
Image Import (Legacy)
EDITImport scanning images.
Query Containers (Legacy)
EDITQuery runtime containers API (API only, not enforced in UI).
Compliance Findings
Compliance
READAccess Compliance results.
Compliance (legacy)
READAccess Compliance (Legacy) Results.
Benchmarks (Legacy)
READAccess legacy Compliance results.
Benchmark Tasks (Legacy)
EDITCreate and modify scheduled legacy Compliance tasks.
READAccess scheduled legacy Compliance tasks.
Exceptions
Risk Acceptance — Vulnerabilities
WRITECreate, modify, and remove exceptions.
READView exceptions.
Risk Acceptance — Posture / Risks / Identity
EDITAccept posture, risk, and identity findings, and revoke or edit existing acceptances.
READAccess the risk acceptances for posture, risk, and identity findings.
Vulnerability Exceptions
EDITEdit vulnerability exceptions.
READAccess vulnerability exceptions.
Trusted Images
EDITModify the trusted images list.
READAccess the trusted images list.
Untrusted Images
EDITModify the untrusted images list.
READAccess the untrusted images list.
Scan Now
Scan Now
EXECAbility to instantly scan by using Scan Now.
Threat Intelligence Feed
Threat Intelligence Feed
READAbility to view the Threat Intelligence Feed.
Graph Search
Search
VIEWAbility to access graph search.
EXPORTAbility to export data from graph search.
API
READAbility to access SysQL API.
Detection & Response
Events
Secure Threats
EDITAbility to modify threat events, such as editing threat exclusions.
READAbility to view threat events.
Policy Events
READAccess policy events.
Activity Audit Commands
READAccess activity audit commands.
Respond
Rapid Response
EXECUse rapid response.
Rapid Response Sessions
READAbility to view all Rapid Response sessions.
Captures
EDITModify captures.
READAccess captures.
VIEWView captures in the UI.
Containment Response Actions
EXECExecute Containment Response Actions.
READView Containment Response Actions executions, their outcomes and the artifacts produced.
Data Gathering Response Actions
EXECExecute Data Gathering Response Actions.
READView Data Gathering Response Actions executions, their outcomes and the artifacts produced.
Inventory
Inventory
VIEWAbility to access Inventory.
EXPORTAbility to export data from Inventory.
Network Security
READAccess Kubernetes Network Security policy advisor.
Reporting
Platform Reporting
Reports
EDITAbility to create and modify platform reports.
READAbility to view platform reports.
Report Schedules
EDITAbility to create and modify platform report schedules.
READAbility to view platform report schedules.
Report Downloads
READAbility to download generated reports.
Vulnerability Reporting (Legacy)
VM Reporting
WRITECreate, modify, and delete reports.
READView and download scan reports.
Scanning Scheduled Reports
EDITCreate and modify reports.
READView and download existing reports.
Automations
Automations
EDITAbility to create and modify automations.
READAbility to view automations.
Policies
Attack Surface Policies
Vulnerability Policy
WRITECreate and edit vulnerability policies.
READRead vulnerability policies.
Scanning Policy (legacy)
EDITModify legacy scanning policies.
READAccess legacy scanning policies.
Posture Policies
EDITCreate and modify posture policies.
READView posture policies.
Supply Chain Policies
WRITEAbility to create and modify supply chain policies.
READAbility to view supply chain policies.
SLA
EDITAbility to create, modify, and delete SLA configurations, which define the remediation thresholds per severity and the SLA target, optionally scoped to zones.
READAbility to view SLA configurations.
IaC Scanning
READAbility to view Infrastructure as Code (IaC) scanning results.
CLI IaC Scanning
EXECAbility to run IaC scans with the CLI.
Open PR (Posture remediation)
EDITCreate pull requests from the posture remediation panel.
Detection & Response Policies
Runtime Policies
EDITModify policies.
READAccess policies.
Policy Advisor
WRITECreate Pod Security Policy (PSP) advisor simulation.
READRead PSP advisor simulations.
EXECExecute PSP advisor simulation.
Image Profiles
WRITEWrite image profiles.
READView existing image profiles.
EXECExecute image profiling.
Integrations
Environments
Integrations
READAbility to view integration providers.
Cloud Accounts
READAccess cloud accounts.
Third Party
Third Party Integrations
READAbility to view third party integrations.
Notification Channels
EDITModify notification channels in scope of a team.
READAccess notification channels in scope of a team.
Global Notification Channels
READAccess global notification channels.
Ticketing Integration
WRITEAbility to create and modify ticketing integrations.
READAbility to view ticketing integrations.
Notification Templates
EDITAbility to create and modify notification templates.
READAbility to view notification templates.
Remote Storage
EDITAbility to edit remote storage settings.
READAbility to view remote storage settings.
Settings
Users & Teams
Users
CREATEInvite new users.
READAccess existing users data.
User List
READSee the list of users for a customer.
Teams
MANAGEModify team settings without the ability to modify team membership for users.
Team Membership
EDITModify team members.
READAccess team members.
Team Membership Roles
EDITAbility to change team member roles.
Team Captures Access
EDITToggle access to captures for a team.
READSee the capture settings for a team.
Access & Authentication
API Access Token
EDITReset users API token in scope of a team.
READAccess users API token in scope of a team.
VIEWView your API token.
Service Accounts
EDITModify service accounts in scope of a team.
READAccess service accounts in scope of a team.
Service Account Roles
EDITAbility to modify service account roles.
Service Account Notification Settings
EDITAbility to modify service account notification settings.
READAbility to view service account notification settings.
Agents
Agent Installation
READGet agent access key (required for agent installation).
Access Keys
READAbility to view team access keys.
Agent Console Access
EDITToggle access to agent console for a team.
READSee the agent console access settings for a team.
Agent Console Commands
VIEWAbility to use the agent console to view agent information.
Agent Console — Agent Status
READAbility to view agent status in the agent console.
Agent Console — Diagnostics
READAbility to view agent internal diagnostics in the agent console.
Agent Console — Network Calls
EXECAbility to run agent console commands that make network calls to remote pods and endpoints.
Agent Console — Configuration
VIEWAbility to view agent configuration in the agent console.
Agent Console — Sensitive Configuration
VIEWAbility to view sensitive agent configuration, such as passwords, in the agent console.
Platform
Zones
EDITModify Zones.
READView Zones that are assigned to current team.
Events Forwarder
READAccess event forwarding configuration.
Secure Onboarding
EDITModify Sysdig Secure configuration.
Subscriptions
READAccess customer subscription details.
AWS Settings
READAccess Amazon Web Services (AWS) settings.
High Value Assets
EDITAbility to edit high value assets.
READAbility to view high value assets.
S3 Capture Storage (Legacy)
READView Sysdig storage configuration.
Data Access
Metrics Data
READAccess metrics data.
Metrics Descriptors
READAccess metrics descriptors.
Groupings
READAccess default and custom groupings.
Sysdig Sage
Use Sysdig Sage chat
EXECAbility to use Sysdig Sage chat.
Next
Next plans and jobs
EDITAbility to create and modify Next plans and jobs.
READAbility to view Next plans and jobs.
Ticketing
Tickets
WRITEAbility to create and modify tickets.
READAbility to view tickets.
DSPM
Push DSPM findings
SENDAbility to push DSPM findings to Sysdig.