CA API Gateway 9.1

9.4 9.1

Manage Interfaces

The Managing Interfaces task is used to configure interfaces that can be monitored by a listen port. Defining an interface gives you greater control over the IP addresses that will be monitored—you can specify multiple IP address patterns—and you can name an interface to make it easier to identify. For example, you can define that:
gateway
The Managing Interfaces task is used to configure interfaces that can be monitored by a listen port. Defining an interface gives you greater control over the IP addresses that will be monitored—you can specify multiple IP address patterns—and you can name an interface to make it easier to identify. For example, you can define that:
  • listen ports tagged with "external" will monitor the IP address 192.168.1.77
  • listen ports tagged with "internal" will monitor the IP range 10.48.20, 192.168/16, 208
  • listen ports tagged with "loopback" will monitor 127.0.0.1
If you do not create interfaces, then you can still choose any single IP address or choose to monitor all addresses for a given protocol in a listen port's properties.
 
Configuring interfaces is an advanced feature. Please consult your system administrator on the need to change existing interfaces or create new ones.
 
To manage interfaces
:
  1. Do one of the following:
    • Run the Manage Listen Ports task and then click [
      Interfaces
      ] on the Manage Listen Ports dialog.
    • Open the Listen Port Properties for a specific port and then click [
      Manage
      ] on the [
      Basic Settings
      ] tab.
    • The Manage Interfaces dialog is displayed.
  2. Select an action from the following table:
    To...
    Do this...
    Create a new interface
    1. Click [
      Create Interface
      ].
    2. Type a name for the interface. The name must begin with either a letter or an underscore "_" character.
    3. Click [
      OK
      ] to add the tag.
    4. Add one or more IP address patterns. An interface must have at least one IP address or address range associated with it.
    Delete an interface
    1. From the Interfaces list, select the interface to delete. This interface must not currently be used by any listen port.
    2. Click [
      Delete Interface
      ]. The interface and its address patterns are removed from the list.
    Add an IP address pattern to an interface
    1. From the Interfaces list, select the interface to edit.
    2. Click [
      Add Address Pattern
      ].
    3. Enter the IP address pattern.
      • The pattern is an IP address followed by an optional netmask specifier.
      • The netmask specifier is indicated with a forward slash followed by a number between 0 and 32 (inclusive). Example: 10.77.92.128/30
      • Both IPv4 and IPv6 addresses are accepted
    4.    Click [
    OK
    ] to add the pattern.
    Repeat steps 2 to 4 to enter additional address patterns for the interface.
    The Policy Manager allows you to enter any address pattern. If a nonexistent address is entered and then associated with a listen port, the listen port will not be opened. If the address pattern matches multiple IP addresses, the listen port will be opened only for the numerically
    lowest
     matching address on each host. In both cases, the Gateway logs the appropriate error or warning messages.
    Edit an IP address pattern for an interface
    1. From the Interfaces list, select the interface.
    2. From the list of addresses, select the pattern to edit.
    3. Click [
      Edit Address Pattern
      ].
    4. Modify the IP address pattern.
    5. Click [
      OK
      ] to save the changes.
    Remove an IP address pattern from an interface
    1. From the Interfaces list, select the interface to edit.
    2. From the list of addresses, select the pattern to remove.
    3. Click [
      Remove Address Pattern
      ].
  3. Click [
    OK
    ] when done.
Any changes to an interface will cause all affected listeners to restart. This is the same as editing a listener's properties.

Content feedback and comments