Signup a new tenant

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 https://hooli.crossid.io

Web

curl -X POST -d '
{
  "displayName": "Hooli Corp",
  "tenantId": "hooli",
  "type": "developer",
  "user": {
    "displayName": "Gavin Belson",
    "email": "gavin@hooli.io",
    "password": "initial_pass"
  }
}' https://cid.crossid.io/api/global/v1/tenants/.register

Curl

1. Go to https://crossid.io/signup
2. Signup for a new tenant.

Check your email for tenant activation.

Get API token

note

API token is only required if you plan to interact with the REST API using an HTTP client 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 interact with Crossid API.

Console

1. From the admin console, navigate to Applications -> Crossid.
2. Select the API Access tab.
3. Click Generate Token and copy it.

Next Steps

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.