Administer API Manager network traffic

Traffic is always initiated by the Agent to API Manager, API Gateway, and Amplify Central. No sessions are ever initiated back to the Agent.

5 minute read

Overview

Agent networking

All communications are initiated by the agents so there are no requirements to change the inbound rules on your network infrastructure.

Data destinations

The destination for:

  • Agent Authentication data is login.axway.com
  • API definition (Swagger or WSDL) and API documentation data is apicentral.axway.com
  • API Event data, the transaction summary and headers, is ingestion-lumberjack.datasearch.axway.com
  • Subscription notification for getting platform user information is platform.axway.com
  • API usage statistics, the number of calls placed to, is https://lighthouse.admin.axway.com

Data exchanged

Discovery Agent

Use variable apimanager.filter to select which API should be sent to Axway Amplify platform. Only the matching APIs are transferred to Axway Amplify platform. See Discover APIs. The Discovery Agent sends the following information to the Axway Amplify platform:

  • API definition using Swagger or WSDL depending on the API type (REST vs SOAP)
  • API documentation

Traceability Agent

Only traffic related to discovered APIs is sent to the platform.

The agent reads the logs written on the file system ([INSTALL_DIR]/apigateway/events/group-X_instance-Y.log) by the Gateways to get the transaction summary:

  • Transaction HTTP status
  • Transaction URLs (frontend / backend API)
  • Transaction duration and timestamp
  • Transaction service called: method (POST / GET…) + uri path

In order to submit details of the transaction, the Traceability Agent reads the Gateway system to get the transaction details:

  • Request/response headers from each API call

Once the information is extracted it is sent to the Axway platform using the TLS encryption.

Communication ports

All outbound traffic is sent over SSL via TCP / UDP.

Open the following ports so that agents can communicate to the Amplify platform:

Outbound:

Region Host IP port Protocol data
EU/US platform.axway.com 34.211.114.227 443 HTTPS
54.201.86.113
EU/US lighthouse.admin.axway.com 443 HTTPS API usage statics
EU/US login.axway.com 52.58.132.2 443 HTTPS
52.29.4.35
54.93.140.145
US apicentral.axway.com 3.94.245.118 443 HTTPS API definitions, Subscription info
54.208.199.251
3.212.78.217
52.202.95.208
107.23.176.64
3.225.16.120
EU central.eu-fr.axway.com 52.47.84.198 443 HTTPS API definitions, Subscription info
13.36.25.69
35.181.21.87
13.36.2.143
13.36.52.216
15.236.7.112
US ingestion-lumberjack.datasearch.axway.com or ingestion.datasearch.axway.com 54.225.171.111 453 or 443 TCP or HTTPS API event data
54.225.2.221
54.146.97.250
54.147.98.128
52.206.193.184
54.225.92.97
EU ingestion-lumberjack.visibility.eu-fr.axway.com or ingestion.visibility.eu-fr.axway.com 15.236.125.123 453 or 443 TCP or HTTPS API event data
35.180.77.202
13.36.27.97
13.36.33.229

Note: Region column is representing the region where your Amplify organization is deployed. EU means deployed in European data center and US meaning deployed in US data center. Be sure to use the corresponding Host/Port for your agents to operate correctly.

Other ports which may need to be opened so that the Agent may monitor API Gateway / Manager are:

Internal:

Host Port Protocol Data
API Manager Host 8075 (default) HTTPS API Discovery
API Gateway Host 8090 (default) HTTPS API Transaction Header data (see APIGATEWAY GETHEADERS)

Inbound (used for the agent status server):

Host Port Protocol Data
Agent Host(s) 8989 (default) HTTPS Serves the status of the agent and its dependencies for monitoring

Subscription notifications

SMTP and/or a webhook URL can be set up to send subscription notifications on both subscribe and unsubscribe actions. You can find the configuration to set up the SMTP or webhook URL at Deploy your agents.

Using proxies

If your network policy restricts outbound traffic such that outbound traffic must pass through a proxy. A proxy can be configured in the configuration file of the agents.

HTTP/HTTPS Proxy

Use a HTTP/HTTPS Proxy for communication to the Amplify Platform. This configuration is set for both the Discovery and Traceability Agents.

SOCKS5 Proxy

Use a SOCKS5 Proxy for communication to the Amplify Platform when sending API Traffic Events. This configuration is set only for Traceability Agents.

Proxy authentication

Both proxy types will use one of two authentication mechanisms, none or username/password authentication. The username authentication is specified within the URL http://{user}:{pass}@{proxy}:{port}.

Validation

Direct Connection

Connecting to Amplify Central and Login hosts:

curl -s -o /dev/null -w "%{http_code}"  https://apicentral.axway.com
curl -s -o /dev/null -w "%{http_code}"  https://login.axway.com

A return of “200” validates the connection was established.

Connecting to Amplify Central Event Traffic host, HTTPS:

curl -s -o /dev/null -w "%{http_code}" https://ingestion.datasearch.axway.com

A return of “200” validates the connection was established.

Connecting to Amplify Central Event Traffic host, Lumberjack:

curl ingestion-lumberjack.datasearch.axway.com:453

A return of “curl: (52) Empty reply from server” validates the connection was established.

Connection via Proxy

Connecting to Amplify Central and Login hosts:

curl -x {{proxy_host}}:{{proxy_port}} -s -o /dev/null -w "%{http_code}"  https://apicentral.axway.com
curl -x {{proxy_host}}:{{proxy_port}} -s -o /dev/null -w "%{http_code}"  https://login.axway.com

A return of “200” validates the connection was established.

Connecting to Amplify Central Event Traffic host, HTTPS:

curl -x {{proxy_host}}:{{proxy_port}} -s -o /dev/null -w "%{http_code}" https://ingestion.datasearch.axway.com

A return of “200” validates the connection was established.

Connecting to Amplify Central Event Traffic host, Lumberjack:

curl -x socks5://{{proxy_host}}:{{proxy_port}} ingestion-lumberjack.datasearch.axway.com:453

A return of “curl: (52) Empty reply from server” validates the connection was established.

Troubleshooting

Curl connection to ingestion-lumberjack.datasearch.axway.com

  • Error:

    curl: (6) Could not resolve host: ingestion-lumberjack.datasearch.axway.com
    
    • Cause: The host making the call can’t resolve the ingestion-lumberjack DNS name.

    • Possible Resolution: Tell curl to resolve the hostname on the proxy:

    curl -x socks5h://{{proxy_host}}:{{proxy_port}} ingestion-lumberjack.datasearch.axway.com
    
  • Error:

    curl: (7) No authentication method was acceptable.
    
    • Cause: The SOCKS proxy server expected an authentication type other than what was specified.

    • Possible Resolution: Provide authentication to the proxy:

    socks5://{{username}}:{{password}}@{{proxy_host}}:{{proxy_port}}
    

    The Agents only support the use of username/password authentication method for SOCKS connections.