Location Definitions

The Location Definitions page lets you create a location to assign to your users. You can currently only use this page to enable IP address verification when users log in to CXone. Users assigned to a login authenticator associated with a location need to have both the correct credentials and IP address to log in to CXone.

Set Up a Location

Required permissions: Location Management Create

If you want to require that users log in from a certain IP address, create a location with the IP addresses, IP address ranges, or IP address subnets you want to allow. When you require a configured location for a user, that user must have both the correct credentials and IP address to log in. Otherwise, their login attempt fails and they receive an error. You can have up to 20 locations at a time and up to 10 rules per location.

1. Click the app selector and select Admin.
2. Go to Locations > Location Definitions.
3. Click New Location.
4. Give the location a descriptive Name. If you want to add more details about the location, enter a Description.
5. You can select the Set as Default Location or Remote Location to indicate the type of location. You can only have one default location. These fields don't currently affect any functionality and selecting them is for your own reference.

6. Add any other information you would like using the remaining fields, including the physical address, country, GPS coordinates, time zone, or assigned groups. These fields don't currently affect anything, and the information entered there would be only for your own reference.

   If you add groups to the Assigned Groups field, the users belonging to those groups appear on the Assigned Users tab. However, the location settings won't apply to them. If you assign a location to a login authenticator, the location applies to users who are assigned to that login authenticator and restricts their ability to log in based on their IP address. However, those users will not appear on the Assigned Users tab.

7. Click Save.

8. Back on the Location Definitions page, click the location you just created to open it.

9. Click the Auto-Detection Rules tab.

10. Create a new rule. To do so: 

    1. Click New Rule.

    2. Give the rule a descriptive Name.

    3. Select the Rule Type from the following: 

       • List: A list of specific IP addresses allowed for this location. For example, 100.0.1.100, 100.0.1.101, and 100.0.1.102.

       • Range: An IP address range allowed for this location. For example, 100.0.1.100-100.0.1.125.

       • Subnet: A subnet allowed for this location. For example, 100.0.0.1/32.

    4. Specify the IP Version as one of the following:

       • IPV4: A 32-bit IP address

       • IPV6: A 128-bit hexadecimal address.

    5. Enter the actual IP addresses, range, or subnet in the Rule Definition field, following the formats of the examples in the preceding steps. If you selected List, you can enter up to 100 IP addresses. If you selected Range or Subnet, you can only enter one value.

    6. Click Confirm.

11. Add more rules as needed. You can have up to 10.

12. Click Save.

Once you have created the location, you can assign it to a login authenticator using the Location field in the login authenticator profile.

Deactivate a Location Definition

You can have up to 20 location definitions at a time. You cannot deactivate the default location.

1. Click the app selector and select Admin.
2. Go to Locations > Location Definitions.
3. Find the location you want to deactivate. If it's the default location, unset it as the default location. To do so:
   1. Click the location to open it.
   2. Clear the Set as Default Location checkbox.
   3. Click Save.
4. In the Actions column of the location you want to deactivate, click the Options icon . Click Deactivate.

You can reactivate an inactive location by clicking the Options icon and selecting Activate.