On Networking, view and configure the primary network interface, and if applicable, a proxy server to relay web traffic, and the sessions network interface.

The Network Interface (X1) can be used to add additional virtual network adapters associated with X1 in the web client.

It is the responsibility of the Appliance Administrator to ensure the network interfaces are configured correctly.

CAUTION: For AWS or Azure, network settings user interfaces are read-only. Network settings configured by the AWS or Azure Administrator. Changing the internal network address on a clustered appliance will break the cluster and require the appliance to be unjoined/rejoined.

To modify the networking configuration settings

1. Navigate to Appliance > Networking.
2. For Network X0, complete the network settings below. For more information, see Modifying the IP address.
   • MAC Address: (Read-Only) The media access control address (MAC address), a unique identifier assigned to the network interface for communications.
   • IPv4 Address: The IPv4 address of the network interface.
   • IPv4 Subnet Mask: The IPv4 subnet mask of the network interface.
   • IPv4 Gateway: The IPv4 default gateway.
   • DNS Servers: The IP address for the primary DNS servers.

   • DNS Suffixes: The network suffixes for the DNS servers.

     NOTE: You can also use the Global DNS Suffixes field on the Appliance > Networking page.
     

   • IP6 Address: The IPv6 address of the network interface.
   • IPv6 Prefix Length: The IPv6 subnet prefix length which is range-validated. Valid values are 1 through 127 when an IPv6 address is present.
   • IPv6 Gateway: The IPv6 default gateway.
3. For Network X1 (web client), complete the network settings below to add additional virtual network adapters on up to 31 VLANs.
   • MAC Address: (Read-Only) The media access control address (MAC address), a unique identifier assigned to the network interface for communications.
   • IPv4 Address: The IPv4 address of the network interface.
   • IPv4 Subnet Mask: The IPv4 subnet mask of the network interface.
   • IPv4 Gateway: The IPv4 default gateway.
   • DNS Servers: The IP address for the primary DNS servers.

   • DNS Suffixes: The network suffixes for the DNS servers.

     NOTE: You can also use the Global DNS Suffixes field on the Appliance > Networking page.
     

   • IP6 Address: The IPv6 address of the network interface.
   • IPv6 Prefix Length: The IPv6 subnet prefix length which is range-validated. Valid values are 1 through 127 when an IPv6 address is present.
   • IPv6 Gateway: The IPv6 default gateway.
   • VLAN ID: The VLAN ID for the network. This is only applicable to network interfaces added by the administrator. Changes to this field will also update the name of the adapter.
4. For the Proxy Server (web client), complete the network settings below.
   • Proxy URI: The IP address or DNS name of the proxy server.
   • Port: The port number used by the proxy server to listen for HTTP requests. The value is an integer from 1 to 65535. If different ports are specified in the proxy URI and the Port field, the Port field takes precedence.
   • Username: The user name used to connect to the proxy server. The username and password are only required if your proxy server requires them to be specified.
   • Password: The password required to connect to the proxy server. The username and password are only required if your proxy server requires them to be specified.
5. Click Show Static Routes and make changes using the information which follows. When you are done, click Save. When you click Save, a message like the following displays: Changing these values may cause all users to lose connection to the appliance. This is a general Saving network settings error and not specific to static routes.
   • Use the following toolbar buttons, as needed.
     • To add a route, click and complete the information.
     • To modify the information for a route, select the route, click Edit, and then change the information.
     • To delete a route, select the route then click Delete Static Route. The route is immediately deleted.
     • To discard unsaved changes and revert to what was last retrieved from the database, select the route and click Revert all unsaved Static Route edits.
       
   • The following information can be added or changed:
     • IP Version: Select IPv4 or IPv6.
     • Prefix: The IPv4 or IPv6 IP address.
     • Prefix Length: The IP subnet prefix length.
     • Next Hop: The IP address of the next closest or most optimal router in the routing path.
     • Metric: A value that identifies the cost that is associated with using the route.

Modifying the IP address

You can change the IP address of an SPP Appliance as long as the other appliances in the SPP cluster are able to see the new subnet.

It is recommended you use the procedure below in a test environment and then deploy the steps in production. Allow plenty of time for the IP address to change. The operation will take several minutes to complete before the cluster has adjusted to the change.

1. Ensure you are using SPP 2.4 or above.
2. Before changing the X0 IP address, make a backup.
3. Generate a support bundle on the appliance you plan to modify the IP address on. Start with the replica first.
4. After the X0 IP address change, verify clustering is working. It is recommended you change some data on the primary and verify it appears on the replica by logging on to the replica.
5. Repeat step 3, 4, and 5 for the other replicas.
6. Once the replicas are changed, proceed with the Primary.

Safeguard for Privileged Sessions IP address change

CAUTION: When SPP (SPP) and Safeguard for Privileged Sessions (SPS) are linked and then the IP address of either the Safeguard for Privileged Sessions cluster master (Central Management role) or the SPP primary appliance are changed, then the SPP/SPS link will need to be redone. See the information that follows.

1. Use the following information in the Safeguard for Privileged Sessions documentation to understand Safeguard for Privileged Sessions cluster roles, settings, and IP address updating.
   • Cluster roles: Assigning roles to nodes.

   • Network settings: Setting Safeguard for Privileged Sessions network interface and naming settings, including IP addresses.

   • Building a cluster: Assigning the Central Management node in a cluster (which cannot be undone) and then link other nodes.

   • Assigning roles to nodes in your cluster: Assigning roles, including the Central Management role, to nodes in a cluster.

   • Updating the IP address of a node in a cluster: Updating the IP address of Safeguard for Privileged Sessions Managed Nodes.

   • Managing a High Availability One Identity Safeguard for Privileged Sessions (SPS) cluster: Setting up Safeguard for Privileged Sessions to handle nodes if the primary node stops functioning.
2. If the IP address is changed, you must relink the cluster. For more information, see Linking SPS to SPP.
3. Once the Safeguard for Privileged Sessions IP addresses are successfully changed, you will need to delete the session connection in the SPP settings and relink the Safeguard for Privileged Sessions cluster master to the SPP primary. For more information, see SPP and Safeguard for Privileged Sessions appliance link guidance.