Tenant Creation Process

Prev Next

For Knovvu Real-Time Guidance, 2 seperate tenant needs to be created; 1 in Knovvu Analytics and 1 in Knovvu Core.

Attention!

Tenants are created in Knovvu Portal. You can find more details in the document.

Until RTG tenants can be created in Portal, the steps highlighted later in the document must be performed manually in addition to the Portal steps.

If RTG tenants are created manually, all the steps mentioned below needs to be performed.

1. Knovvu Analytics

1.1. Create the Tenant

  1. Log into the Admin Panel
  • Product URL: https://ca.eu.knovvu.com/
  • Click "Login with host tenant button"
  • User name: admin
  • Password: **********
  1. In the menu, go to the Administration > SaaS > Tenants.
  2. Click on the New Tenant button and fill in the following details:
  • Tenant Name: abccorp
  • Edition: Standard RTG, Premium RTG (for edition information please visit Packages)
  • Tenant admin's email address: admin@abccorp.com
  • Tenant admin's password: DummyPassword456
  • Tenant activation state: Active

Ensure that the "Use the Shared Database" option is checked under Connection Strings.

  1. Click the Save button to complete the tenant creation process.

image.png

1.2. Add License Information

To enter tenant-specific license information, go to the Administration > SaaS > Tenants and click on License Settings of the tenant.

Example:

  • Client ID: ABCCompanyRTG.ApiClient.QELPr100nEGRI4EDzzMHbQ
  • Client Secret: GzhfLjDS6ry8L7Rvom0L8RqpJt2rk9tvXz78cF9n0uk=
  • Portal Identity Server URL: https://identity.ldm.knovvu.com/connect/token

Click the "Save" button to complete the credential creation process.

Client ID & Secret will be provided on the Knovvu Portal.

1.3. Edit Applications (Clients) for the Tenant

The applications, i.e. clients, are being used to access product APIs.

Application Format
  • CA applications (clients) are formatted as CA.{tenantName}.{Scope}
  • Scopes represent Application permissions to access required APIs.

For RTG, 2 clients are required:
1. Customer client: This client will be in the format of CA.{tenantName}.Customer and contain Customer scope to access CA-related APIs. (or C.{tenantName}.Guid, if it's created via Portal)
2. Analyzer Client: This client will be in the format of CA.{tenantName}.Analyzer and contain Analyzer scope to access RTG-related APIs.

Applications must be edited by giving unique Client Secrets.

1.3.1. Customer Client

  • Go to Administration > OpenId > Applications
  • Select CA.{TenantName}.Customer from Application list. Go to Actions > Edit and you will see below figure.
  • Enter a unique Client secret.
  • This information will be shared to the customer or Integration Provider.

image.png

1.3.2. Analyzer Client

  • Go to Administration > OpenId > Applications
  • Select CA.{TenantName}.Analyzer from Application list. Go to Actions > Edit and you will see below figure.
  • Enter a unique Client secret.
  • This information will be shared to the customer or Integration Provider.

image.png

1.4. Test the Tenant

After creating a new tenant, follow the steps below to ensure everything is functioning correctly.

1.4.1. User Login

Verify that tenant users can log in to the system successfully.
Example login credentials:

  • Tenant: abccorp
  • Username: johndoe
  • Password: DummyPassword456

1.4.2. Tenant Information after 1st Login

The settings below should be filled according to customer requirements and preferences.

image.png

2. Knovvu Core

2.1. Create the Tenant

  1. Log into the Admin Panel
  • Product URL: https://core.eu.knovvu.com/
  • Tenant: Not selected
  • User name: admin
  • Password: **********
  1. In the menu, go to the Administration > SaaS > Tenants.
  2. Click on the New Tenant button and fill in the following details:
  • Tenant Name: abccorp
  • Edition: Standard
  • Tenant admin's email address: admin@abccorp.com
  • Tenant admin's password: DummyPassword456
  • Tenant activation state: Active

Ensure that the "Use the Shared Database" option is checked under Connection Strings.

  1. Click the Save button to complete the tenant creation process.

image.png

2.2. Edit Application (Client) for the Tenant

The applications, i.e. clients, are being used to access product APIs. Applications must be edited by giving unique Client Secrets.

Application Format

Core applications (clients) are formatted as core-{tenantName}-Guid.

  • Go to Administration > OpenId > Applications
  • Select core.{TenantName}.Guid from Application list. Go to Actions > Edit and you will see below figure.
  • Enter a unique Client secret.
  • This information will be shared to the customer or Integration Provider.

image.png

2.3. Test the Tenant

After creating a new tenant, follow the steps below to ensure everything is functioning correctly.

Verify that tenant users can log in to the system successfully.
Example login credentials:

  • Tenant: abccorp
  • Username: johndoe
  • Password: DummyPassword456