SentinelOne icon

SentinelOne

SentinelOne Management Console API specification.

Actions281

Role → Get template for new role

AI-generated

Overview

This node interacts with the SentinelOne Management Console API to retrieve a template for creating a new Role in the Role-Based Access Control (RBAC) system. It is useful for administrators who want to programmatically obtain the structure and default settings of a new role before creating or customizing it. This can help in automating role management and ensuring consistency in role definitions.

Use Case Examples

  1. An administrator wants to automate the creation of new user roles with specific permissions. They use this node to get the template for a new role, modify it as needed, and then create the role via the API.
  2. A security team needs to audit the default permissions available for roles in their SentinelOne deployment. They use this node to fetch the role template and review the permissions structure.

Properties

Name Meaning
Site Ids List of Site IDs to filter the role template by.
Group Ids List of Group IDs to filter the role template by.
Account Ids List of Account IDs to filter the role template by.
Tenant Indicates a Global (tenant) scope request for the role template.

Output

JSON

  • id - Role ID
  • name - Role name
  • description - Role description
  • permissions - Permissions assigned to the role
  • createdAt - Timestamp when the role was created
  • updatedAt - Timestamp when the role was last updated

Dependencies

  • An API key credential for SentinelOne Management Console

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access RBAC roles.
  • If the API returns an error about missing or invalid parameters, verify that the input properties are correctly set.
  • Network issues or API rate limits may cause request failures; check connectivity and retry as needed.

Links

Discussion