diff --git a/serverless/images/custom-roles-ui.png b/serverless/images/custom-roles-ui.png new file mode 100644 index 00000000..cd2c3a98 Binary files /dev/null and b/serverless/images/custom-roles-ui.png differ diff --git a/serverless/pages/custom-roles.mdx b/serverless/pages/custom-roles.mdx new file mode 100644 index 00000000..3980ca0d --- /dev/null +++ b/serverless/pages/custom-roles.mdx @@ -0,0 +1,32 @@ +--- +slug: /serverless/custom-roles +title: Custom roles +description: Create and manage roles that grant privileges within your project. +tags: [ 'serverless', 'Elasticsearch', 'Observability', 'Security' ] +--- + + +This content applies to: + +The built-in organization-level roles and instance access roles are great for getting started with ((serverless-full)), and for system administrators who do not need more restrictive access. +With so many features, it's not possible to ship built-in roles that accommodate everyone's needs. +This is where custom roles come in. +{/* Derived from https://www.elastic.co/guide/en/kibana/current/tutorial-secure-access-to-kibana.html#_roles */} + +{/* +TBD: Accurate for serverless? +When you assign a user multiple roles, the user receives a union of the roles’ privileges. This means that you cannot reduce the privileges of a user by assigning them an additional role. You must instead remove or edit one of their existing roles. + +The `manage_security` cluster privilege is required to access role management. +*/} +You can manage custom roles in **((project-settings)) → ((manage-app)) → Custom Roles**: + +![Custom Roles app](../images/custom-roles-ui.png) +{/* TO-DO: This screenshot needs to be refreshed and automated. */} + +{/* ## Create a custom role */} + +{/* After your roles are set up, the next step to securing access is to assign roles to your users. */} + +{/* ## View and delete custom roles */} + diff --git a/serverless/pages/project-settings.mdx b/serverless/pages/project-settings.mdx index 56fd3ca5..af13d2dc 100644 --- a/serverless/pages/project-settings.mdx +++ b/serverless/pages/project-settings.mdx @@ -63,6 +63,17 @@ To learn more about roles, refer to + + + + Create and manage roles that grant privileges within your project. + + + + + + +