Tenant configuration

Chef 360 Platform uses a multi-tenant software architecture. A tenant is a group of users that share common access to a software application’s instance. In Chef 360 Platform, a tenant is represented by a unique domain name and unique identity store.

This configuration section describes how to set the default tenant for your installation.

Tenant configuration

In the Tenant Configuration section, configure Chef 360 Platform with the name of the tenant and the unique domain name attached to the tenant.

Warning

Currently, changing any value in this section is only supported during the initial installation.

Field	Description
Name	This is a friendly name for the primary tenant. The tenant name must be unique and is typically the name of the company/organization.
Top Level Domain (TLD)	This sets the top-level domain (TLD) name the tenant will use, for example `chef.io`.
Subdomain	This is the subdomain unique to this tenant. This is the subdomain users/nodes use to access chef-360.
Fully Qualified Domain Name	(readonly) `subdomain` + `TLD` This will be Chef 360 Platform is deployed from.

Note

If you are evaluating Chef 360 Platform and can’t assign a routable domain, create a host file on every node that requires access to Chef 360 Platform.

Organizational unit

This is the default organization unit.

Field	Description
Name	This is a friendly name for the primary organizational unit. The name must be unique.
Description	(optional) A description of the organizational unit. Typically this describes the internal users or scope/intent of the organizational unit.

Warning

Be careful when naming the OU because changing this value later has implications.

SMTP configuration

An active SMTP server is required to use Chef 360 Platform. It’s used during the installation process to send the administrative account a one-time password that’s used to set the password.

SMTP Server Type `add-on`

If add-ons are enabled you are presented with the option to use MailHog instead of an external mail server. MailHog isn’t intended for use outside of evaluation or testing purposes. For additional information on MailHog, refer to the following page: MailHog.

Mailhog NodePort `add-on` `advanced`

The Kubernetes NodePort that the Mailhog web UI will use. For additional information on Kubernetes NodePorts, refer to the Kubernetes networking guide.

SMTP Server Name

This is the name of the SMTP integration registered to the tenant.

SMTP Host

This is the hostname, DNS entry, or IP Address of the SMTP server.

SMTP Port

The port number the SMTP server is listening on.

SMTP Retries Enabled

If enabled, Chef 360 Platform attempts to deliver email multiple times (upon a failure).

Number of Retries

The number of retries Chef 360 Platform should attempt.

Note

This is only visible if SMTP Retries are enabled.

SMTP Check TLS

Enable if Chef 360 Platform requires a valid TLS certificate.

Note

Only enable this if your email server doesn’t support TLS or you are using a self-signed certificate on the SMTP server.

Administrator

The Tenant Administrator is the user who is provisioned during installation. Upon creation, a One-Time Password (OTP) is emailed to this user for activation.

First Name

The first name of the tenant administrator.

Last Name

The last name of the tenant administrator.

Email Address

The email address of the tenant administrator. Upon creation, a One-Time Password (OTP) is emailed to this user for activation.

Tenant configuration