Troubleshoot connectivity failures, authentication errors, and account issues when connecting to servers through Bastionhost.
Server connectivity issues
What do I do if I fail to access a server through Bastionhost?
Symptom
You cannot connect to a server through the Bastionhost instance.
Step 1: Test connectivity
Test connectivity between the Bastionhost instance and the server IP and port using Network diagnostics.
Step 2: Troubleshoot based on the test result
If the connectivity test fails
Check these items in order:
-
Non-standard server port. If the server uses a non-standard port, update it on the Assets page. Modify the service port of a host.
-
Security group rules. Verify that the security group allows traffic from the Bastionhost egress IP, shown in the instance list on the Bastionhost console. For more information about how to add a security group rule, see Manage security group rules.
-
Server-side security policies. Verify that no server-side policies block Bastionhost access. Check:
-
Network ACLs
-
Security groups
-
Cloud Firewall
-
Internal firewalls (iptables, Windows Firewall)
-
-
Host-based access control. Verify that
/etc/hosts.allowand/etc/hosts.denyon the server do not block the Bastionhost instance. -
Cloud Firewall policies. Verify that Cloud Firewall policies do not block the Bastionhost instance. Best practices for access policies in a joint deployment of Cloud Firewall and Bastionhost.
-
Internal network connectivity. If the Bastionhost instance cannot reach the server over the internal network, verify the network path. Best practices for hybrid operations and maintenance (O&M) scenarios.
-
IP address conflict. Verify that the server IP does not conflict with the Bastionhost egress IP or the IP resolved from the internal endpoint. Conflicts prevent server data from reaching Bastionhost.
-
Public IP on a private network. If the server uses a public IP for a private network, adjust the network settings in Configure Bastionhost.
If the connectivity test succeeds
-
Try connecting directly to the server by bypassing the Bastionhost instance.
-
If the direct connection also fails, the issue is server-side. Troubleshoot the server protocol connection:
-
-
If you can connect directly but not through Bastionhost, check the error messages in Common Bastionhost O&M errors.
If these steps do not resolve the issue, submit a ticket.
Authentication issues
What do I do if a password verification error occurs for a new host account?
Symptom 1: The verification times out or fails
Cause
A verification timeout is usually caused by network inaccessibility.
Solution
Test connectivity between the Bastionhost instance and the asset using Network diagnostics.
-
If the connectivity is abnormal, the network between the Bastionhost instance and host may be unavailable. For more information, see What do I do if I fail to access a server through Bastionhost?
-
If the connectivity is normal but verification still fails, network sync may be delayed. Save the account password to Bastionhost and retry O&M. Configure a host account.
Symptom 2: The verification fails due to an incorrect password
Cause
The account password entered in Bastionhost does not match the password set on the asset.
Solution
-
Verify that the password in Bastionhost matches the one set on the asset. Configure a host account.
-
If you are performing O&M on a Linux host, check whether the root account or password authentication is disabled in the
sshd_configfile.
What do I do if I fail to access a server from Bastionhost using key-based authentication?
This issue occurs only on Bastionhost instances that run a version earlier than V3.2.38.
Symptom
Key-based authentication fails when you try to access a server through Bastionhost.
Cause
On some operating systems (Rocky 9, Ubuntu 22.04+), OpenSSH 8.7 and later disables the ssh-rsa algorithm by default, which causes key-based authentication through Bastionhost to fail.
Solution
Enable the ssh-rsa algorithm in sshd_config on the server:
-
Open sshd_config.
vim /etc/ssh/sshd_config -
Add the following lines and save the file.
HostKeyAlgorithms +ssh-rsa PubkeyAcceptedAlgorithms +ssh-rsa -
Restart the sshd service.
systemctl restart sshd
Account and session issues
Why are hosts not displayed on the O&M page?
Symptom
No hosts appear on the O&M page after you log on to Bastionhost.
Cause A: Missing permissions
The Resource Access Management (RAM) user is not granted permissions on the host.
Solution: Grant the RAM user permissions on the host. Grant a user permissions on assets and asset accounts.
Cause B: Wrong user session
You are not logged on as the correct RAM user.
Solution: Log on to the Bastionhost console as the RAM user who is granted permissions on the host.
Why is an EMPTY account displayed after I log on to Bastionhost?
Symptom
After you log on to Bastionhost, an account labeled EMPTY is displayed.
Cause
This occurs when Unauthorized Asset Accounts Are Allowed is enabled in System Settings and a user has permissions on an asset but not on its host accounts.
Solution
Grant the user permissions on a host account. Grant a user permissions on an asset account.