Environments are isolated, standalone workspaces that support all of the API and dashboard operations provided by Warrant. Each environment's data (users, roles, permissions, etc.) is separate from that of other environments, making it easy to implement and test changes to the authorization model for an application without impacting the authorization workload of that application in production. By default, all organizations have a production and a test environment and support creation of new environments. Users have the ability to manage which users have access to each environment and what level of access each user has (owner, manager, or member).
Separate environments for development/testing and production are a common practice on most engineering teams as a way to improve team productivity, prevent bugs, and speed up release cycles by giving the team more confidence in the changes being made before releasing a feature to customers. Environments in Warrant are built to work seamlessly with your team's development process by allowing you to create environments that match your team's application environments and workflow. You can then implement and test new access rules in a test or development environment before making the change in production.
Environments are only accessible to users who have been granted access to them. Users can have one of three levels of access to an environment: owner, manager, or member.
member - Members can view the environment's keys and view or modify the data in the environment via API or Dashboard.
manager - Managers have the abilities of a member and can also modify an environment's name and manage user access to the environment. This includes adding, removing, or editing a user's access to that environment.
owner - Owners have the abilities of a manager. The user who created an environment is automatically assigned as the owner of the environment. The user who first created a Warrant organization for their team is automatically assigned as the owner of the default production and test environments. An environment can only have one owner.
Getting Started with Environments
To get started with your own custom environments, go to the
Account page in the Warrant Dashboard and find the
Environments section. This section lists all environments that you have access to within your team's organization.
To create a new environment, click
Create Environment and enter an environment ID and a name. By default, each environment will be created with the following:
- Default object types (Read more)
Once you've created an environment, you can switch to that environment by selecting it in the
Environment dropdown in the left nav. Once selected, all actions performed in the dashboard will operate on the selected environment. To make API calls in this environment, use the API key listed in the
API Keys section of the
If you're an owner or manager of an environment, you'll see buttons in the
Environments section allowing you to manage user access to that environment and edit its name.