Ports
API Gateway listens for requests on ports that you specify. Each port is associated with a specific type of protocol, HTTP or HTTPS. In addition to these port types, API Gateway also provides three ports; API Gateway external port, API Gateway internal listener port, and the WebSocket listener port.
You can specify one or more HTTP or HTTPS ports on which API Gateway and the deployed APIs are available for consumption. API Gateway, by default, is available on the primary HTTP port. The primary HTTP port is the port specified on the Integration Server's Security > Ports page.
If your API Gateway is behind an internal firewall and is not allowed to accept communications from external clients through the DMZ, then you can configure the API Gateway instance in DMZ with an external port to listen to requests from external clients and using reverse invoke route them to the internal servers. The API Gateway internal listener port or the WebSocket listener port pulls the requests from the registration port of API Gateway in DMZ thus safeguarding from any malicious attacks.
External clients send requests to API Gateway. API Gateway external port listens to this client information from each request and evaluates the request against any API Gateway rules that have been defined. It then passes requests that have not violated a rule to the API Gateway internal port or the WebSocket listener port . These listener ports process the requests and send the responses to API Gateway, which then passes the responses back to the client.
The Ports page displays the following information about the configured ports:
Field | Description |
Ports | Specifies the port number. Click on the port number to edit the port configuration. |
Alias | Specifies the port alias that can be used across to refer to the corresponding port. |
Protocol | Specifies the protocol used by the port to communicate. |
Type | Specifies the type of port. |
Enabled | Specifies the status of the port; whether it is enabled or disabled. |
Primary port | Specifies whether the port is used as a primary port. ![](../yai-webhelp/images/port_enabled.png) specifies that it is set as a primary port and ![](../yai-webhelp/images/port_disabled.png) depicts it is not set as a primary port. Only the HTTP and HTTPS ports can be set as primary ports once they are enabled. You can click ![](../yai-webhelp/images/port_disabled.png) for a port to set it as a primary port. Note: You can not disable or delete the primary port. |
Description | Provides a short description of the port. |
Action | Specifies the actions that can be performed on the port. |
Note:
![*](chapterTOC_bullet.png)
Any modifications to the ports in
Integration Server may not reflect in
API Gateway UI. Hence,
Software AG recommends that you do not configure or modify the ports through
Integration Server Administrator UI.
![*](chapterTOC_bullet.png)
Software AG recommends that you do not modify
API Gateway ports through Command Central as it is not supported in
API Gateway 10.3.