Resolving the integration error "Please enter a valid port number"
Issue description
The error Please enter a valid port number appears on the integration configuration page when attempting to integrate ADSelfService Plus with one of the following applications:
- ADManager Plus
- ServiceDesk Plus
- Splunk
- Syslog
- Log360
This error indicates that the specified port is either invalid or unreachable, preventing the integration from completing successfully.
Possible causes
- Incorrect port number: The number entered does not match the port the target application is using.
- Invalid port range: The number entered is outside the standard TCP/IP valid range, which is 1 to 65535.
- Firewall is blocking the port: A firewall on the ADSelfService Plus server, the target server, or the network is preventing the connection.
- Service not running: The port number is correct, but the application service on the target server is stopped.
Prerequisite
- You need administrative access to the ADSelfService Plus portal and the integration target server.
Resolution
Step 1: Verify port range
- Ensure the entered port number falls within the valid range: 1–65535.
Step 2: Test network connectivity to the port
This step verifies that the ADSelfService Plus server can communicate with the target application on the specified port.
- On the ADSelfService Plus server, open PowerShell as an administrator.
- Run the following command, replacing <hostname> and <portnumber> with the details of the server you are trying to integrate with:
Test-NetConnection <hostname> -Port <portnumber>
Example: Test-NetConnection -ComputerName sdpserver.yourcompany.local -Port 8080
- Analyze the results:
- TcpTestSucceeded: True: This is a success. This confirms that the port is open and reachable, and the problem likely lies elsewhere in the configuration (for example, an incorrect API key or password).
- TcpTestSucceeded : False: This is a failure and indicates a network block.
Step 3: Resolve connectivity failures
If the Test-NetConnection command fails, take the following actions:
- Check firewalls: Investigate any firewalls between the ADSelfService Plus server and the target server. This includes the local Windows Defender Firewall on both machines as well as any corporate network firewalls. Ensure an outbound rule exists on the ADSelfService Plus server and an inbound rule exists on the target server to allow traffic on that port.
- Confirm the listening port: Verify in the target application's settings that it is indeed configured to listen on the port you are using.
- Ensure the service is running: Check that the corresponding service or application is running on the target machine.
Once connectivity is confirmed (i.e., TcpTestSucceeded : True), reenter the port number in the ADSelfService Plus integration settings and save the configuration again.
How to reach support
New to ADSelfService Plus?
Related Articles
Resolving the integration error "Invalid parameter length"
Issue description When integrating ADSelfService Plus with third-party applications such as ServiceDesk Plus, Splunk, or ServiceDesk Plus Cloud, the following error may appear on the integration configuration page: Invalid parameter length This error ...Resolving the integration error "Invalid server name. Please try again with a different server name"
Issue description The Invalid server name. Please try again with a different server name error appears on the integration configuration page when trying to integrate ADSelfService Plus with one of the following applications: ADManager Plus ...Resolving the integration error "API key received is not associated with any technician. Authentication failed"
Issue description When integrating ADSelfService Plus with applications such as ServiceDesk Plus, Splunk, or ServiceDesk Plus Cloud, the following error may appear: API key received is not associated with any technician. Authentication failed. This ...ADSelfService Plus integration with a workflow provider to maintain control over self-service actions
Description With great power comes great responsibility but not everyone are equipped to react favorably to the huge amount of power at their hand. Self-service tools are not an exception to this rule. With ADSelfService Plus’s complete self-service ...Resolving the error SAML assertion attribute limit exceeded. Please contact your administrator
Issue description The error SAML assertion attribute limit exceeded. Please contact your administrator occurs when a user attempts to log in to a SAML application via ADSelfService Plus. Possible cause The total number of attributes or attribute ...