Using the advanced editor
Read time: 2 minutes
Last edited: Sep 21, 2023
Overview
The advanced editor is a tool for experienced LaunchDarkly members who want to create their own custom roles. You can use it to create custom roles and policies that are more complex and detailed than those supported by the simple editor. For example, inverse action and resource sets (notActions and notResources, respectively) are only available in the advanced editor.
You can copy example roles or templates that assign the same permissions as LaunchDarkly's built-in roles from the topic Example roles. In the advanced editor, you can modify those templates to do exactly what you want.
The advanced editor can cause large permissions changes to sensitive or confidential resources. If you use the advanced editor incorrectly, it is possible to disable your LaunchDarkly project, lock yourself out of your account, or cause other irrevocable changes.
It is critically important that you read all the documentation in the "Custom roles" section thoroughly before you use the advanced editor to create or modify any custom roles.
To learn more, read Custom role concepts.
Creating custom role policies with the advanced editor
To access the advanced editor:
- Navigate to Account settings.
- Click into the Roles tab.
- Click Create role. The "Create custom role" panel appears.
- Click Advanced editor. The advanced editor appears:
- (Optional) If you do not wish to use the advanced editor, click Simple editor to close the advanced editor.
- Specify the effects, resources, and actions you wish.
- Click Save role.
When you create a policy with the advanced editor, you must use resource keys, which are case sensitive. For example, if the production environment of your default project has the key production, then the policy proj/default:env/Production will not work.
To ensure you're using the correct resource key, type CMD + period ( . ) to launch the resource finder. Alternatively, click the link beneath the advanced editor.
For advanced policy examples, read Example policies and templates.