agent_id_list statement

Use the agent_id_list statement to specify which agents are allowed to connect to the Advisor. This statement is optional.

Rules:
  • If you are using AT-TLS with SERVAUTH access control checks to validate all Agent connections to this Advisor, this statement is optional. If you specify this statement, but AT-TLS is used for the connection, this statement is ignored. If you omit this statement, AT-TLS is required and the security checks must succeed.
  • If you are not using AT-TLS with SERVAUTH access control checks to validate all Agent connections to this Advisor, this statement is required.

Syntax

Read syntax diagramSkip visual syntax diagram
                     .-------------------------------.      
                     V                               |      
>>-agent_id_list--{------agent_ipaddr ..agent_port---+--}------><

Parameters

agent_ipaddr..agent_port
Use agent_ipaddr..agent_port to specify a list of Agents that are allowed to connect to the Advisor. This parameter is required. The list consists of one or more blank-delimited IP address and port pairs each specified on a separate line, which are all contained within braces. There should be no spaces between the IP address, the two ellipses (..), and the port. These pairs represent the IP address and port of a given Agent.

There is no limit to the length of a line. The IP address can be an IPv4 or an IPv6 address. The IPv4 INADDR_ANY address (0.0.0.0) and the IPv6 unspecified address (::) are not allowed. If agent_ipaddr..agent_port is specified, this parameter must match the addresses specified in the host_connection configuration statement on the Agents.

The valid range of port values is 1 - 65 535.

Rule: You can specify only complete IP addresses. You cannot specify host names, prefixes, or subnets. Any given agent_ipaddr..agent_port pair must be specified on one line; it cannot be continued to a subsequent line.