Tenants

View and modify the settings for each of your tenants, including the provisioning credentials and whitelist IP addresses.

Tenants are a segment of the business. They could be a site, location, line of business, etc. On the Tenants tab, you can access and configure all of the settings for each tenant. In this guide, we’ll review the settings you’re able to modify.

GENERAL INFORMATION

In this section, you can edit or add the tenant name, address, and contact information.

PROVISIONING CREDENTIALS

For extra device security, you can add provisioning credentials here. This requires every device under this tenant to log in with these credentials before receiving configuration.

WHITELIST IPS

To further protect and secure your account, you can set a tenant-specific list of IP addresses, or hostnames (that the system resolves to an IP address) that devices can provision from. This also applies to API requests.

If a request comes into Phonism for a device in that tenant but does not originate from one of the whitelisted IP addresses, the request is denied.

Note: If Authentication Allowed Outside Whitelist is enabled and tenant credentials are being used, this does not apply.

To configure whitelist IPs for a tenant, follow these steps:

Select the Tenants tab.
Find and select the tenant you’d like to configure.
In the Whitelist IP Addresses section, modify the following fields, as needed.

Your Current IP Address - The IP address of the device you’re accessing this page with.
Enable Whitelist - The default setting is OFF. To enable, toggle ON.
Authentication Required for Whitelist IPs - The default setting is OFF. Toggle to require the phone to authenticate using the tenant username and password. When the IP whitelist is enabled, requests from within the whitelist must authenticate with the provisioning credentials for the tenant. If provisioning credentials are not set, the request is denied.
Authentication Allowed Outside Whitelist - The default setting is OFF. When the IP whitelist is enabled, requests from outside the whitelist are allowed if the device successfully authenticates with the provisioning credentials for this tenant. If provisioning credentials are not set, the request is denied.
IP Addresses and Hostnames - Enter a list of IP addresses, hostnames, and notes for each record. You only need to enter either the IP address or the hostname for the entry. The system auto-resolves your hostnames to the correct IP address.

Warnings:

Hostnames are auto-resolved on a periodic basis so that Dynamic DNS entries are handled properly.
IP Range or CIDR notation are not currently supported.
DNS SRV is not currently supported.