Namespaces
A namespace (also called an application) is a top-level container for your authorization model. Everything — resource types, resources, subjects, roles, groups, and policies — belongs to a namespace.
When to use namespaces
Create a namespace for each application or service that has its own authorization model.
| Scenario | Namespaces |
|---|---|
| Single product | 1 namespace |
| CRM + Docs app | 2 namespaces |
| Microservices sharing auth model | 1 namespace |
| Microservices with separate auth models | 1 per service |
How they work
- Each namespace has its own set of resource types, resources, subjects, roles, groups, and policies.
- Roles and policies can be scoped to specific namespaces.
- Your API key is scoped to your tenant, which can contain multiple namespaces.
Creating a namespace
In the Console, go to Namespaces and click Create Namespace. Provide a name and optional description.