You can use the Add Tenant page to add tenant data and other objects associated with a tenant, such as tenant user, network details, deployment scenario, service profiles, and custom properties. A single tenant can support one or more of the following services:
SD-WAN service
Hybrid WAN service
Next Gen Firewall service
LAN service
Tip A single tenant with SD-WAN service supports both full mesh or hub-and-spoke topologies.
To connect sites in hub-and-spoke topology,
Select the SD-WAN mode as bandwidth-optimized in the Add Tenant page, or
Select the SD-WAN mode as real-time optimized, and do not enable the Enable Meshing toggle button in the Configure Site page.
To connect sites in full mesh topology,
Select the SD-WAN mode as real-time optimized (or you must have selected both real-time optimized and bandwidth-optimized) in the Add Tenant page, and
Select the Enable Meshing toggle button for at least one WAN link in the Configure Site page.
In earlier versions of CSO, when a tenant user logs in to the Customer Portal for the first time, the user is assigned the Tenant Administrator role by default. With the introduction of object-based custom roles, the tenant user that logs in to Customer Portal for the first time might have customized roles and the role is not restricted to Tenant Administrator.
The information listed on the Tenants page changes depending on the authentication mode configured:
Local Authentication—You can add the administrative user information as the first step from the Tenants page.
Authentication and Authorization with SSO Server—The Admin User information is not displayed on the Tenants page because users are not created in CSO and they are managed in the SAML identity provider. In addition, users are dynamically authorized to the CSO role based on the mapping rules configured in the SAML authentication.
Authentication with SSO Server—When you create the administrative user, the login page does not require you to configure a password because the user is created in the SSO without the password and you can enter only the username.
To add a tenant:
The Add Tenant page appears.
If you click OK, the tenant that you configured appears on the Tenants page. An e-mail is sent to the tenant, which includes a URL to access Customer Portal. The URL is active for only 24 hours and is valid only for the first log in.
Table 84: Fields on the Add Tenant Page
Field | Description |
---|---|
Tenant Info | |
Name | Enter a unique name for the tenant. You can use alphanumeric characters and hyphen (-); the maximum length is 15 characters. Example: test-tenant |
Admin user | |
First Name | Enter the first name of the user. |
Last Name | Enter the last name of the user. |
Username (Email) | Enter the e-mail ID of the user. The e-mail ID is also the username for the user. This field is automatically populated after you enter the tenant name. Example: test-tenant_admin@test-tenant.com |
Roles | Select one or more roles (both predefined and custom roles) that you want to assign to the tenant user. Note: In the Available column, all tenant scope roles are listed. Click the right arrow(>) to move the selected role or roles from the Available column to the Selected column. Note that you can use the search icon on the top right of each column to search for role names. To preview the access privileges assigned to a role, click the role name. |
Password Policy | |
Password Expiration Days | Specify the duration (in days) after which the password expires and must be changed. The range is from 1 through 365. The default value is 180 days. |
Deployment Info | |
Service for Tenant | Select one or more services for the tenant:
Note: The options listed in Customer Portal > Resources > Site Management > Add are filtered based on the service that you have selected for a tenant. For example, if you have selected SD-WAN and LAN for a tenant, in Customer portal > Resources > Sites Management > Add > On-Premise Spoke, only the following capabilities are listed:
|
SD-WAN Mode | Note: This field appears only if you selected the SD-WAN sites check box in the Deployment Type field. Select the SD-WAN mode:
|
Tenant Properties | |
SSL Settings Note: This setting is applicable only to the SD-WAN deployment scenario. | |
Default SSL Forward Proxy Profile | Click the toggle button to enable a default SSL proxy profile for the tenant. If you enable this option, the following items are created when a tenant is added:
This option is disabled by default. Note: You use this option to create a tenant-wide default profile; enabling or disabling this option does not mean that SSL is enabled or disabled. If you enable this option, you must add a root certificate. |
Root Certificate | You can add a root certificate (X.509 ASCII format) by importing the certificate content from a file or by pasting the certificate content:
After the tenant is successfully added, a default root certificate, a default SSL proxy profile, and a default SSL proxy profile intent are created. Note:
|
VPN Authentication Note: This setting is applicable only to the SD-WAN deployment scenario. | |
Authentication Type | Select the VPN authentication method to establish a secure IPsec tunnel:
|
Overlay Tunnel Encryption Note: This is applicable only to the SD-WAN deployment scenario. | |
Encryption Type | For security reasons, all data that passes through the VPN tunnel must be encrypted. Select the encryption type:
The default encryption type is AES-256-GCM. Note: The MX Series routers do not support encryption types, AES-128-GCM and AES-256-GCM. The default encryption type for MX Series routers is, AES-256-CBC. |
Network Segmentation | |
Network Segmentation | Enable network segmentation on the tenant. |
Dynamic VPN Threshold Note: This is applicable only to the SD-WAN deployment scenario in real-time optimized mode. | |
Threshold for Creating a Tunnel Set a threshold value, above which a tunnel is created between two sites. | |
Sessions closed | Specify the maximum number of sessions closed (for a time duration of 2 minutes) between two spoke sites. The dynamic VPN tunnel is created between two spoke sites if the number of sessions closed (for a time duration of 2 minutes) is greater than or equal to the value that you specified. The default threshold value (the number of sessions for 2 minutes) is 5. For example, if you specify the number of sessions as 5, dynamic VPN tunnels are created if the number of sessions closed between two spoke sites in 2 minutes exceeds 5. |
Threshold for Deleting a Tunnel Set a threshold value, below which a tunnel is deleted between two sites. | |
Sessions closed | Specify the minimum number of sessions closed (for a time duration of 15 minutes) between two spoke sites. The dynamic VPN tunnel is deleted between two spoke sites if the number of sessions closed (for a time duration of 15 minutes) is lesser than or equal to the value that you specified. The default threshold value (the number of sessions for 15 minutes) is 2. For example, if you specify the number of sessions as 2, the dynamic VPN tunnels are deleted if the number of sessions closed is lesser than or equal to 2. |
Maximum DVPN Tunnels | |
Max tunnels allowed per CSO | Displays the maximum number of DVPN tunnels that can be created in CSO. The total number of DVPN tunnels that can be created by all tenants in CSO is limited to 125000. A major alarm is raised if the number of DVPN tunnels created by all tenants reaches seventy percent of the maximum value. A critical alarm is raised if the number of DVPN tunnels created by all tenants reaches ninety percent of the maximum value. To view alarms, see Monitor > Alerts & Alarms > Alarms in the Administration Portal. For more information about alarms, see About the Alarms Page. |
Max tunnels allowed per tenant | Specify the maximum number of DVPN tunnels that the tenant can create. Range: 0 through 50000. A major alarm is raised if the number of DVPN tunnels created by all sites in a tenant reaches seventy percent of the maximum value. A critical alarm is raised if the number of DVPN tunnels created by all sites in a tenant reaches ninety percent of the maximum value. To view alarms, see Monitor > Alerts & Alarms > Alarms in the Customer Portal. For more information about alarms, see About the Alarms Page. |
Service Profiles | |
VIM Name | If you use a dedicated OpenStack Keystone for Contrail Service Orchestration in a centralized deployment, then select the virtualized infrastructure manager (VIM) for the tenant. A tenant can be associated with multiple VIMs. Example: test-vim |
Service Profile Name | If you use a dedicated OpenStack Keystone for Contrail Service Orchestration in a centralized deployment, then select the service profile that specifies the authentication information for the tenant. You configure the service profile when you create the VIM. Example: service-profile-for-test-vim |
Tenant-specific Attributes | If you have set up a third-party provider edge (PE) device by using software other than Contrail Service Orchestration, then configure settings on that router by specifying custom parameters and its corresponding values. |
Name | Specify any information about the site that you want to pass to a third-party router. Example: Location |
Value | Specify a value for the information about the site that you want to pass to a third-party device. Example: Boston |