Troubleshoot a Remote Repository Definition

Troubleshoot Cortex XSOAR 6.14 remote repository definition issues.

The following instructions describe how to troubleshoot when defining a remote repository.

dial TCP Error Message

If a **dial tcp...**error message appears when defining your remote repository and loading the list of repository branches, contact your system administrator to enable connectivity. This may occur due to connectivity issues, such as a closed port or a proxy that is not enabling the connection.

Invalid HTTP/SSH URL Error

If an Invalid SSH URL error label appears when defining your remote repository and entering the Repository URL, ensure the URL ends with \.git such as ssh://[e-mail]:20017/\~/my-project.git.

Permission Denied Error

If a permission denied error occurs when attempting to fetch the repository branches:

1. Ensure you have set the correct passphrase and are using the correct key type.
2. Navigate to the directory in which you saved the private key file.
3. Open the private key file in a text editor and verify that the file begins with -----BEGIN RSA PRIVATE KEY-----.

   If the file does not begin with this text, regenerate the private key and add the -m pem flag. For example: ssh-keygen -t rsa -b 4096 -C "[e-mail]" -m pem

   (This is because Cortex XSOAR currently supports only RSA PRIVATE KEY.)

If the key and permissions are confirmed as correct and you still get a permission denied error:

1. Stop the server.
2. Delete all git-cached folders under /var/lib/demisto/temp/cached_git_repositories
3. Restart the server.

Internal Server Error

If the internal server error. Something went wrong. error message appears when attempting to fetch the repository branches:

1. In the server log files, search for Host keyverification failed error message.
2. Connect to the server by SSH.
3. Run the following command:

   ssh-agent bash -c "ssh-add PATH/TO/PRIVATE/KEY; git clone GIT_SSH_URL"

   For example: ssh-agent bash -c "ssh-add ~/.ssh/my_id_rsa; git clone ssh://[e-mail]:443/myusername/myreponame.git"
4. Copy the file ~/.ssh/known_hosts to /var/lib/demisto/.