Troubleshooting
The guidelines below cover general cases where a scanner integration is not working, and what may help remedy it. For help with a specific tool, please refer to its documentation, or reach out to the SD Elements support team.
Cannot connect to the Scanner Tool server
- 
SD Elements can only connect to the scanner server through a proxy - 
Configure the server to support the proxy. 
 
- 
- 
HTTPS certificate validation fails - 
Select the option Bypass server certificate validation for https. - 
This option is not recommended for production contexts. 
 
- 
- 
Install the certificate on the SD Elements server. 
- 
The organization re-writes the certificates used in SSL/TLS connections. - 
Add the signing CA cert to the SD Elements server. 
 
- 
 
- 
- 
A firewall or IPS is blocking the traffic - 
Request an exemption for the traffic from the SD Elements server to the Issue Tracker server. - 
The connection is typically https, which uses protocol TCP, port 443. 
 
- 
 
- 
- 
There is no access to the scanner server - 
"No route to host" or "Invalid server or server unreachable" are indications of lack of access. - 
Work with support teams to facilitate a solution. 
- 
Root cause may be a DNS or connectivity issue. 
 
- 
- 
Consider using the Remote Integration Agent. 
 
- 
File cannot be imported
- 
The file format is not supported - 
Check the format and re-upload a file having the correct format 
 
- 
Unexpected error during remote scan import
- 
The user doesn’t have permission to access the project’s scan details - 
Grant permission to the user or change connector settings to connect with a user that does have permission. 
 
- 
HTTP Errors
- 
Error 5xx (for example: "HTTP Error 500") - 
An unexpected error occured on the scanner server. Contact the server’s support team for help. 
- 
An unexpected error may have occured on an upstream proxy (if applicable). Contact the proxy support team for help. 
 
- 
- 
Error 4xx - 
"HTTP Error 400": The version of the verification may not be compatible. Reach out to SD Elements support about this issue. 
- 
"HTTP Error 401": The connection user is not valid or has an incorrect password. 
- 
"HTTP Error 403": The connection user may have insufficient permissions. 
- 
"HTTP Error 404": The server connection details may be incorrect. Check the domain name, port, and context root details of the server. 
 
- 
