Configuring the tenant
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.
To view or modify the tenant contact information, you need the administrator role.
Procedure
In the top-level menu of the Tenant Management Console, click Overview.
On the tenant Overview page, click Contact Information.
In the Contact Information window, fill in the contact information.
The list below describes the values you can specify. Except as indicated, all fields are optional.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.
Click Update Contact Info.
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.
Before you begin
Procedure
In the top-level menu of the Tenant Management Console, click Overview.
On the tenant Overview page, click 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.Select or deselect permissions as needed to modify the permission mask.
Selecting Purge automatically selects Delete. Selecting Search automatically selects Read.Click Submit.
Changing the tenant description
The tenant description is optional. You can enter a description or modify the existing description at any time.
Before you begin
Procedure
In the top-level menu of the Tenant Management Console, click Overview.
On the tenant Overview page, click the edit link for the Description section.
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.Click Submit.
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.
Before you begin
Procedure
In the top-level menu of the Tenant Management Console, click Overview.
On the tenant Overview page, take either of these actions:
- To grant access, select Allow HCP system-level users to manage me and search across my space.
- To deny access, deselect Allow HCP system-level users to manage me and search across my space.
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 .
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.
- 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.
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 .
Before you begin
Procedure
Enable the management API.
In the Management API Settings section:Select Enable the HCP management API.
Click Update Settings.
(Optional) In the Allow/Deny section, specify IP addresses to be allowed or denied access to HCP through the management API.
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.
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 .
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.
- 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.