Tenant Provisioning API

This document describes CII tenant provisioning API.

Security Cloud Developer Portal

https://developer.security.cisco.com/

CII Tenant Provisioning Endpoints

POST {baseURL}/v1/Tenants/

PUT {baseURL}/v1/Tenants/{id}

Base URL

OIDC Application Redirect URL

Preview

Stytch Redirect URLs

https://test.stytch.com/v1/b2b/sso/callback/oidc-connection-test-031240e6-55d2-4001-a4e5-67b7a4b22f61

https://test.stytch.com/v1/b2b/sso/callback/oidc-connection-test-135281f8-5bab-48e4-b286-96a1d8285a71

https://test.stytch.com/v1/b2b/sso/callback/oidc-connection-test-d5fb3408-41c5-4384-8e97-712b3e2094bf

Auth0 Redirect URL

https://login.stage.oort.io/login/callback

Staging

Stytch Redirect URLs

https://api.stytch.com/v1/b2b/sso/callback/oidc-connection-live-0cdff1c0-98cc-407a-96d1-550a84dfd316

Auth0 Redirect URL

https://login.stage.oort.io/login/callback

Production US

Stytch Redirect URL

https://api.stytch.com/v1/b2b/sso/callback/oidc-connection-live-039d66e0-b3f8-420a-809c-0892ca25278a

Auth0 Redirect URL

https://login.oort.io/login/callback

Production EU

Stytch Redirect URL

Pending PIAM OIDC client...

Auth0 Redirect URL

https://login.eu.oort.io/login/callback

Production AU

Stytch Redirect URL

Pending PIAM OIDC client...

Auth0 Redirect URL

https://login.au.oort.io/login/callback

Production JP

Stytch Redirect URL

Pending PIAM OIDC client...

Auth0 Redirect URL

https://login.jp.oort.io/login/callback

CII Tenant Entitlements

Entitlement nameValuesDescription

tier

FREE

e.g. Demo

INTERNAL

Internal customer

PAID

Paid customer

PARTNER

Partner's tenant, e.g. Okta

TRIAL

Trial customer

Request Examples

Create Tenant (synchronously)

Request

POST /v1/Tenants/

```postman_json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "processing_meta": {
        "send_welcome_email": false,
        "requestID": "3ee83993-448d-4a69-865e-ef93749dd19d"
    },
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": [
        {
            "name": "tier",
            "value": "INTERNAL"
        }
    ]
}
```

Response

```json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "id": "e3d1e6e5-3958-4327-92e6-9c71741ee574",
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": [
        {
            "name": "tier",
            "value": "INTERNAL"
        }
    ],
    "meta": {
        "resourceType": "Tenant",
        "created": "2024-06-06T08:05:49.024Z",
        "lastModified": "2024-06-06T08:05:49.024Z",
        "location": "https://management-api.integration.oort.io/v1/Tenants/e3d1e6e5-3958-4327-92e6-9c71741ee574"
    }
}
```

Disable Tenant

Request

PUT /v1/Tenants/e3d1e6e5-3958-4327-92e6-9c71741ee574

```postman_json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "id": "e3d1e6e5-3958-4327-92e6-9c71741ee574",
    "processing_meta": {
        "send_welcome_email": false,
        "requestID": "3ee83993-448d-4a69-865e-ef93749dd19d"
    },
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": []
}
```

Response

```json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "id": "e3d1e6e5-3958-4327-92e6-9c71741ee574",
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": [],
    "meta": {
        "resourceType": "Tenant",
        "lastModified": "2024-06-06T06:38:46.200Z",
        "location": "https://management-api.integration.oort.io/v1/Tenants/e3d1e6e5-3958-4327-92e6-9c71741ee574"
    }
}
```

Enable Tenant

Request

PUT /v1/Tenants/e3d1e6e5-3958-4327-92e6-9c71741ee574

```postman_json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "id": "e3d1e6e5-3958-4327-92e6-9c71741ee574",
    "processing_meta": {
        "send_welcome_email": false,
        "requestID": "3ee83993-448d-4a69-865e-ef93749dd19d"
    },
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": [
        {
            "name": "tier",
            "value": "INTERNAL"
        }
    ]
}
```

Response

```json
{
    "schemas": [
        "urn:cisco:security:scim:tenant:core:1.0"
    ],
    "id": "e3d1e6e5-3958-4327-92e6-9c71741ee574",
    "enterprise_id": "ab820f93-ba17-451d-8e4e-7da6ff8b8ff7",
    "customer": {
        "customer_name": "example-corporation"
    },
    "entitlements": [
        {
            "name": "tier",
            "value": "INTERNAL"
        }
    ],
    "meta": {
        "resourceType": "Tenant",
        "created": "2024-06-06T08:05:49.024Z",
        "lastModified": "2024-06-06T08:05:49.024Z",
        "location": "https://management-api.integration.oort.io/v1/Tenants/e3d1e6e5-3958-4327-92e6-9c71741ee574"
    }
}
```

Last updated