Okta Access Gateway Version 2024.5.0 Removes SSH Access
Last Updated:
Overview
Okta Access Gateway (OAG) version 2024.5.0 removes Secure Shell (SSH) access for the oag-mgmt account because the upgrade process updates the AllowUsers directive in the Secure Shell daemon configuration. Resolve this by logging into the appliance through console access and updating the configuration file to include the missing account. Following the upgrade, Secure Shell access fails, but console access remains available to implement the fix before the support Virtual Private Network (VPN) is removed.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Okta Access Gateway (OAG)
- Secure Shell (SSH)
- Version 2024.5.0
Cause
The Okta Access Gateway version 2024.5.0 upgrade process updates the AllowUsers directive in the Secure Shell daemon (sshd) configuration and removes the oag-mgmt account. This omission prevents Secure Shell access for the account.
Solution
How is Secure Shell access restored for the management account?
Log in to the appliance using the management account through console access, launch the privileged shell, update the Secure Shell daemon configuration file, and restart the service.
- Log in to the appliance using the
oag-mgmtaccount through console access. - Navigate to 5 - System.
- Select 0 - Launch Shell to launch the privileged shell.
- Open the Secure Shell daemon configuration file for editing.
sudo vi /etc/ssh/sshd_config
- Add the following line or update the existing
AllowUsersdirective to include all the required accounts.AllowUsers icsadmin oag-mgmt appgw-mgmt oagha
- Restart the Secure Shell daemon service.
sudo systemctl restart sshd
