Skip to main content
Outside service Partner
Hitachi Vantara Knowledge

Configuring the tenant


You can change these properties of the current tenant:

The tenant contact information

The tenant permission mask

The tenant description

Whether HCP system-level users have administrative access to the tenant

Which IP addresses have access to the Tenant Management Console for the tenant

Whether programmatic access for tenant and namespace management is enabled for the tenant and, if so, which IP addresses have access to the tenant through the applicable APIs

Which IP addresses have access to the Search Console for the tenant

You can also specify whether HCP should send tenant log messages to syslog servers, SNMP managers, and/or specified email addresses if these features are enabled at the HCP system level. For information on these options, see:

Enabling syslog logging

Enabling SNMP logging

Configuring email notification

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Changing the tenant contact information


When creating a tenant, the HCP system administrator has the option of entering contact information for it. Once the tenant exists, both system-level administrators and tenant-level administrators can modify this information.

RoleWebHelp.png

Roles: To view or modify the tenant contact information, you need the administrator role.

To provide contact information for the current tenant or to update the existing contact information:

1.In the top-level menu of the Tenant Management Console, click on Overview.

2.On the tenant Overview page, click on Contact Information.

3.In the Contact Information window, fill in the contact information. The table below describes the values you can specify. Except as indicated, all fields are optional.

Field Description
First Name First name of the tenant contact. First names can be up to 64 characters long and can contain any valid UTF‑8 characters, including white space.
Last Name The last name of the tenant contact. Last names can be up to 64 characters long and can contain any valid UTF‑8 characters, including white space.
Email A valid email address for the tenant contact. Email addresses cannot be more than 254 characters long.
Confirm Email A repeat of the email address for the tenant contact. This field is required if you specify an email address in the Email field.
Phone

A telephone number for the tenant contact. Do not include a telephone number extension. Instead, put the extension, if any, in the Extension field.

Telephone numbers can contain only numbers, parentheses, hyphens (-), periods (.), plus signs (+), and spaces and can be up to 24 characters long (for example, (800) 123-4567).

Extension A telephone number extension for the tenant contact. Telephone number extensions can contain only numbers and can be up to five characters long.
Address Line 1 The first line of an address for the tenant contact. Address lines can be up to 100 characters long and can contain any valid UTF‑8 characters, including white space.
Address Line 2 The second line of an address for the tenant contact.
City The city for the tenant contact. City names can be up to 64 characters long and can contain any valid UTF‑8 characters, including white space.
State/Province The state or province for the tenant contact. State and province names can be up to 64 characters long and can contain any valid UTF‑8 characters, including white space.
Postal Code The postal code for the tenant contact. Postal codes can be up to 64 characters long and can contain only alphanumeric characters and hyphens (-).
Country The country for the tenant contact. Country names can be up to 64 characters long and can contain any valid UTF‑8 characters, including white space.

4.Click on Update Contact Info.

For more information on tenant contact information, see Tenant contact information.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Changing the tenant permission mask


When a tenant is created, its data access permission mask includes all permissions. You can change the permission mask for the current tenant at any time.

RoleWebHelp.png

Roles: To change the tenant permission mask, you need the administrator role.

To change the tenant permission mask:

1.In the top-level menu of the Tenant Management Console, click on Overview.

2.On the tenant Overview page, click on the edit link for the Permissions section.

The Console displays a set of checkboxes for the possible permissions. The permissions that are currently in the tenant permission mask are selected.

3.Select or deselect permissions as needed to modify the permission mask.

Selecting Purge automatically selects Delete. Selecting Search automatically selects Read.

4.Click on Submit.

For an introduction to permission masks, see Data access permission masks. For more information on the tenant permission mask, see Tenant permission mask.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Changing the tenant description


The tenant description is optional. You can enter a description or modify the existing description at any time.

RoleWebHelp.png

Roles: To change the tenant description, you need the administrator role.

To change the tenant description:

1.In the top-level menu of the Tenant Management Console, click on Overview.

2.On the tenant Overview page, click on the edit link for the Description section.

3.In the edit area for the description, type the new description of the tenant. The description can be up to 1,024 characters long and can contain any valid UTF-8 characters, including white space.

4.Click on Submit.

For more information on the tenant description, see Tenant description.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Enabling or disabling system-level administrative access


You can choose whether to grant HCP system-level users administrative access to the current tenant. By default, when a tenant is created, this access is not enabled. You can change this at any time.

RoleWebHelp.png

Roles: To enable or disable system-level administrative access to the tenant, you need the administrator role.

To enable or disable system-level administrative access to the current tenant:

1.In the top-level menu of the Tenant Management Console, click on Overview.

2.On the tenant Overview page, take either of these actions:

oTo grant access, select Allow HCP system-level users to manage me and search across my space.

oTo deny access, deselect Allow HCP system-level users to manage me and search across my space.

For more information on system-level administrative access, see System-level administrative access.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Controlling access to the Tenant Management Console


You can choose to allow access to the Tenant Management Console only from specific IP addresses. Similarly, you can choose to deny access to the Console from specific IP addresses.

You use the Console Security page in the Tenant Management Console to configure access to the Console. To display this page, in the top-level menu of the Tenant Management Console, select Security Console Security.

RoleWebHelp.png

Roles: To view or modify the Console Security page, you need the security role.

To control access to the Tenant Management Console, on the Console Security page:

Optionally, in the Allow/Deny section, specify IP addresses to be allowed or denied access to the Console. For instructions on doing this, see Adding and removing entries in Allow and Deny lists.

To specify how HCP should handle IP addresses that appear in both or neither of the Allow and Deny lists, select or deselect Allow request when same IP is used in both lists. Changes to this option take effect immediately.

For the effects of this option, see Allow and Deny list handling.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Controlling access to HCP through the management API


For you to use the HCP management API with a tenant-level user account, the API must be enabled for both the HCP system and the tenant. Additionally, the API must be configured at the tenant level to allow access from your client IP address.

Enabling the management API also enables the use of the S3 compatible and HSwift APIs to perform these bucket (S3 compatible API) and container (HSwift API) activities:

Create buckets or containers

List the buckets or containers you own

Enable, disable, or check the status of versioning for a bucket (S3 compatible API only)

Add, retrieve (S3 compatible API only), or remove an access control list (ACL) for a bucket or container

Delete a bucket or container

You use the Management API page in the Tenant Management Console to enable and configure the management API at the tenant level. To display this page, in the top-level menu of the Tenant Management Console, select Security MAPI.

RoleWebHelp.png

Roles: To view and modify the HCP management API configuration, you need the security role.

To enable and configure the HCP management API, on the Management API page:

To enable the management API, in the Management API Settings section:

1.Select Enable the HCP management API.

2.Click on Update Settings.

Optionally, in the Allow/Deny section, specify IP addresses to be allowed or denied access to HCP through the management API. For instructions on doing this, see Adding and removing entries in Allow and Deny lists.

To specify how HCP should handle IP addresses that appear in both or neither of the Allow and Deny lists, select or deselect Allow request when same IP is used in both lists. Changes to this option take effect immediately.

For the effects of this option, see Allow and Deny list handling.

For a brief introduction to the management API, see Tenant Management Console. For information on using the management API, see HCP Management API Reference.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.

Controlling access to the Search Console


To use the HCP Search Console to search one or more namespaces, users log into the Search Console for the tenant that owns those namespaces. You can choose to allow access to the Search Console only from specific IP addresses. Similarly, you can choose to deny access to the Search Console from specific IP addresses.

You use the Search Security page in the Tenant Management Console to configure access to the Search Console. To display this page, in the top-level menu of the Tenant Management Console, select Security Search Security.

RoleWebHelp.png

Roles: To view or modify the Search Security page, you need the security role.

To control access to the Search Console, on the Search Security page:

Optionally, in the Allow/Deny section, specify IP addresses to be allowed or denied access to the Search Console. For instructions on doing this, see Adding and removing entries in Allow and Deny lists.

To specify how HCP should handle IP addresses that appear in both or neither of the Allow and Deny lists, select or deselect Allow request when same IP is used in both lists. Changes to this option take effect immediately.

For the effects of this option, see Allow and Deny list handling.

© 2015, 2019 Hitachi Vantara Corporation. All rights reserved.