What is a Tenant?
A tenant is an isolated private namespace that holds all resources related to identity management, such as applications, users, groups.
To get started, let's signup a free developer edition tenant.
Create a new tenant
You have to choose a tenant name, which is used in various places such as Login page.
For example, if you choose
hooli as a tenant name, your tenant URL would be
curl -X POST -d '
"displayName": "Hooli Corp",
"displayName": "Gavin Belson",
- Go to https://crossid.io/signup
- Signup for a new tenant.
Check your email for tenant activation.
Get API token
API token is only required if you plan to interact with the REST API using an HTTP clinet such as curl. Skip this step if you plan to use the web admin console.
Let's get a short access token that is required to securely intreact with Crossid API.
- From the admin console, navigate to Applications -> Crossid.
- Select the API Access tab.
- Click Generate Token and copy it.
Your tenant is created and ready to be used, follow email instructions how to login to the admin console.
In the next steps we will add a user sample, an OAuth2 application (client) and use those to perform a login using your favorite stack.