Okta Access Gateway release notes

Release: 2021.05.2

Deployment date: May 4th, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2021.05.2 is now Generally Available. This release includes enhancements, bug fixes, and updated documentation.

Known issues

  • Syntax errors in previously valid policy custom configuration may not be detected. Okta recommends validating any updated policy custom configuration statements in a new policy, which is only used for the purposes of policy code validation and later discarded.

    See Developing advanced Access Gateway policy for more information on creating anadvanced policy.

Enhancements

Fixes

  • OKTA-320126 - After admin renomination was successfully completed, the Access Gateway Management console incorrectly displayed a final status of FAILURE RC=-15.
  • OKTA-362259 -Admins were able to save settings where Idle session duration exceeded Maximum session duration. Additionally, after correcting the error, corrected settings could not be saved.
  • OKTA-366367- Log rotation failed in Access Gateway versions 2020.12.3 and 2021.1.0.
  • OKTA-370756 - When using the Access Gateway Management console was used to replace a self-signed certificate with a real certificate, an error message briefly appeared and the certificate is not replaced.
  • OKTA-372417 - When the Access Gateway Admin UI console was used to enter a valid protected group rule containing the special character dollar sign($), the rule passed validation but failed back end validation silently.
  • OKTA-377415 - After Access Gateway was upgraded from 2020.2.1 accessing the admin hostname over http on port 80 displayed the wrong Resource not found page.
  • OKTA-380448 - If Force reauthentication at IDP was specified, and no session existed, a SP-initiated login resulted in a Resource not found error.
  • OKTA-381066 - When an application defined logout behavior with a custom URL was specified, and Single LogOut (SLO) was enabled, the custom URL was ignored.


Release: 2021.04.1

Deployment date: March 31st, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2021.04.1 is now Generally Available. This release includes new features, bug fixes, and updated documentation.

Features

  • Admins can now define Protected Web Resources which are not currently active, generating a warning rather than an error and allowing the application definition to be completed.

Enhancements

Fixes

  • OKTA-366166 - When specifying application session timeouts, admins could disable all session behaviors, which resulted in user reauthentication requests even when the Maximum Session Duration had not been exceeded.
    See Application session timeout interaction for details.
  • OKTA-376110 - Enabling debug mode after upgrading Access Gateway instances to version 2021.02.1 on CentOS 7 caused the Access Gateway Admin UI console and applications to be inaccessible.
  • OKTA-377724 - After updating to the latest release, Access Gateway instances that had previously changed the default Access Gateway Management console password were required to change it again.

Release: 2021.03.6

Deployment date: March 4, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2021.03.6 is now Generally Available. This release includes new features, bug fixes, and updated documentation.

Features

Enhancements

Fixes

  • OKTA-356503 - After removing all workers from a high availability cluster re-adding a second or subsequent worker failed with synchronization errors.
  • OKTA-366367 - On Access Gateway versions 2020.12.3 and 2021.01.0 log rotation sometimes failed with an error.
  • OKTA-367735 - After a certificate was successfully deleted, the Access Gateway management console continued to display the deleted certificate.
  • OKTA-372468 - When a no proxy list was specified with an Access Gateway proxy, configuration errors occurred because the list was ignored.

Release: 2021.02.1

Deployment date: February 3, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2021.02.1 is now Generally Available. This release includes new features, bug fixes, and updated documentation.

Features

  • Access Gateway now supports both case-sensitive and insensitive policy URIs. Case-insensitive URIs allow customers to apply the same URI policy regardless of case. This helps admins create a single policy for all case variations instead of managing multiple advanced policies for the same URI. Creating one policy for all case variations saves admins time and makes URIs less vulnerable.
    Because most customers want to treat URIs of different case variants as the same resource, case-insensitive URIs will become the default behavior for all new policies starting with v2021.02.1. Existing policies created prior to v2021.02.1 remain unchanged and will continue to be case-sensitive.
    Okta recommends that customers review all existing policy statements to confirm their behavior matches expectations.
    See About application policy precedence and Managing application policy for more information.

Enhancements

Fixes

  • OKTA-320621 - During Oracle EBS app integration, selecting an OID Data Source would cause the associated attribute to be removed from the attribute list and caused all application settings to be uneditable.
  • OKTA-340130 - In situations where a DHCP assigned IP address was not assigned to Access Gateway, the syslog-ng service wouldn't start and the Access Gateway Management console would be unavailable.
  • OKTA-350962 - In the Chrome browser, because the SameSite application attribute was set to none rather than true, requests that originated from a different application resulted in the error iframe is not able to share cookies from browser."
  • OKTA-353959 - When using static networking, the Access Gateway Management console couldn't persist network setting changes if no DHCP server was available.
  • OKTA-361165 - When application session settings were configured as:

    • Browser Session Expiration: disabled
    • Idle Session Duration: disabled
    • Maximum Session Duration: enabled

    Cookies were incorrectly marked as session rather than persistent, and required the user to re-authenticate after reopening the browser, even if maximum session duration hadn't been exceeded.


Release: 2021.01.0

Deployment date: January 9, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2021.01.0 is now Generally Available. This release includes new features, bug fixes, and updated documentation.

Features

Enhancements

Fixes

  • OKTA-327549 - When a certificate previously associated with an application was deleted on the Access Gateway Management console and application changes were later made on the Access Gateway Admin UI console, user requests for the original application returned Unknown Host.
  • OKTA-329724 - When Browser Session Expiration was enabled on the Access Gateway Admin UI console and the browser session had not expired but reached either idle or maximum session limit, users were unexpectedly redirected to the No session / Session Expired link.
  • OKTA-351762 - On CentOS8, the Access Gateway Management console sometimes displayed subject information for certificate issuer instead of certificate name.

Release: 2020.12.3

Deployment date: December 15, 2021

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.12.3 is now Generally Available. This release includes new features, bug fixes, and both new and updated documentation.

Important notes

  • Oracle VirtualBox is only supported for development and testing and is not intended for production use.
  • An upgrade to the Access Gateway Admin UI components is causing the text in the topology view to be enlarged on some browsers. This will be resolved in a future release.

Features

Enhancements

Fixes

  • OKTA-322679 - When Access Gateway had multiple network interfaces, some interfaces didn’t return the instance hostname, and localhost was reported in corresponding log messages.
  • OKTA-350471 - When Access Gateway 2020.11.2 was deployed to VMWare vSphere on a DHCP-disabled network, the instance became unusable if an invalid IP/netmask combination was specified.


Release: 2020.11.2

Deployment date: November 9, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.11.2 is now Generally Available. This release includes vulnerability hardening, new features, bug fixes, and both new and updated documentation.

Features

Enhancements

Fixes

  • OKTA-301413 -Access Gateway returned the default Access Gateway icon instead of the protected web resource icon.
  • OKTA-340130 - When Access Gateway was not assigned a DHCP IP address, the network service failed to start and the Access Gateway Management console failed to start after logging in.
  • OKTA-329128 - When validating database-based datastores, valid Table names were evaluated as invalid unless Advanced query mode was enabled.


Release: 2020.10.5

Deployment date: October 12, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.10.5 is now Generally Available. This release includes bug fixes, and both new and updated documentation.

Important updates
  • The operating system that powers Access Gateway has been updated to take advantage of the more modern capabilities, security features, and performance benefits. Customers should not expect any visible differences and are not required to upgrade at this time. Please note, in late 2021 we expect to stop supporting older OS versions.
    For details on how to upgrade now, see Update Access Gateway OS

Enhancements

Fixes

  • OKTA-324582 - When adding or modifying applications, valid IP addresses entered in the Public Domain field failed validation with Invalid domain format errors.

Release: 2020.10.5

Deployment date: October 12, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.9.3 is now Generally Available. This release includes enhancements, bug fixes, and both new and updated documentation.

Enhancements

Fixes

  • OKTA-300184 - When using the Access Gateway Admin UI console to update an application, the updates overwrote the Okta org Cross-Origin Resource Sharing (CORS) settings.
  • OKTA-313764 - When configuring the No Session/Session Expired setting on the Access Gateway Admin UI console to force reauthentication, the Resource not found error occurred.
  • OKTA-324392 - When the number of entries for a given host name decreased before a valid Domain Name System (DNS) host name resolution request was initiated, the error attempt to index a nil value appeared in the Lua log and the process timed out.
  • OKTA-325103 - After an upgrade where the Access Gateway node was using a proxy, the Access Gateway Admin UI console would become unreachable with error Admin UI service is not Available.
  • OKTA-325545 - When using the Access Gateway Admin UI console to add or modify an application, valid URLs failed to resolve and the error Domain must resolve in DNS and connect with TCP/IP appeared.

Release: 2020.8.4

Deployment date: August 12, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.8.4 is now Generally Available. This release includes bug fixes only.

Fixes

  • OKTA-321124 - When validating an advanced policy directive, valid directives failed with a Config generation error.

Release: 2020.8.3

Deployment date: August 6, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

Okta Access Gateway 2020.8.3 is now Generally Available. This release includes new features, bug fixes, and both new and updated documentation.

Features

Enhancements

  • Documentation has been enhanced to include new log events in support of Trusted domains, Admin renomination and Certificate management.
    See Monitor log Access Gateway monitor log for more information.
  • Documentation restructured and extended for Monitor, Access and Audit logs.

Fixes

  • OKTA-277067 - When adding worker nodes to an Access Gateway cluster, the immutable flag for resolve.conf was not reset, leading to potential DNS issues.
  • OKTA-304742 - Applications updated using the Access Gateway Admin UI console overwrote some Okta Org application settings.
  • OKTA-278891 - Corrects an issue with unauthenticated open redirects.

Release: 2020.7.1

Deployment date: July 7, 2020

Download: Okta Admin Console (Settings > Downloads)

Release summary

The Okta Access Gateway 2020.7.1 is now Generally Available. This release includes new features, bug fixes, and both new and updated documentation.

Features

Enhancements

Fixes

  • OKTA-270300 - In some situations, the Access Gateway Management console didn’t accurately reflect the latest updates.
  • OKTA-270924 - After upgrading to the latest version of Okta Access Gateway, the child menu elements in the Access Gateway Management console still displayed the previous version number.
  • OKTA-294411 - After restoring from a previous backup to a new instance of Okta Access Gateway, the Access Gateway Admin UI console displayed an error message “Admin UI has invalid token.
  • OKTA-297153 - Attributes weren't correctly persisted to LDAP data stores during concurrent updates.
  • OKTA-303208 - During upgrades benign errors were displayed.
  • OKTA-303956 - When using the Access Gateway Management console, admins were able to enter invalid DNS entries.
  • OKTA-304058 - When checking advanced policy during a session timeout where a session integrity check failed, an incorrect error code was returned.
  • OKTA-306020 - After upgrading from Access Gateway 2020.1.0 to 2020.6.3, Admins were unable to login to the Access Gateway Admin UI console. This also happened when upgrading from 2019.4.2 and 2019.4.5 to 2020.6.3.
  • OKTA-309427 - The default Access Gateway error page had a typo.

Release: 2020.6.3

Deployment date: June 3, 2020

Download: Okta Admin Console (Settings > Downloads)

Features

  • Administrators can now delete and rename backups in the Access Gateway Admin UI console.
    For more information see Manage backups.

Enhancements

Fixes

  • OKTA-254374 - When localhost was configured as the DNS nameserver, the Access Gateway Management console displayed the loopback address instead of the hostname.
  • OKTA-286718 - Adding a high availability worker node to an Access Gateway cluster failed with an initialization error.
  • OKTA-288224 - When an Access Gateway disk was at or near full capacity, the SNMP agent stopped working.
  • OKTA-295495 - Duplicate log entries were created when some SNMP error messages were incorrectly marked as INFO instead of ERROR.
  • OKTA-295590 - In some situations, during initial session creation when submitting forms, Access Gateway would redirect GET requests as POST requests.
  • OKTA-298878 - When trying to remove an LDAP data store on the Access Gateway Admin UI console, some data stores incorrectly reported their status as in use.
  • OKTA-298939 - On high availability clusters, worker node events were missing when capturing log events using system loggers.

Release: 2020.5.5

Deployment date: May 5, 2020

Download: Okta Admin Console (Settings > Downloads)

Features

Enhancements

  • Documentation added for Oracle Hyperion applications.
  • Documentation added for Oracle BI Enterprise Edition applications.
  • Documentation added for Oracle Demantra applications.
  • Target specific download links added for Amazon EC2, Microsoft Azure, and VMWare virtual environments.
  • User authentication events are now written to logs.

Fixes

  • OKTA-283885 - In some situations, the Network Connectivity Test in the Access Gateway Management console would fail with an invalid host name error for valid hosts.
  • OKTA-290632 - Access Gateway didn't honor the maximum session duration setting. Some sessions were still valid after the maximum session duration was exceeded.
  • OKTA-291181 - When there was no user session and the behavior Force reauthentication at IdP was enabled, reauthentication didn't occur as expected.

Release: 2020.4.4

Deployment date: April 8, 2020

Download: Okta Admin Console (Settings > Downloads)

Features

Enhancements

Fixes

  • OKTA-275433 - When importing attributes in datastore’s, commas were inserted at the start and end of the attribute list. Removing the commas resulted in a partial list.

 


Release: 2020.3.3

Deployment date: March 3, 2020

Download: Okta Admin Console (Settings > Downloads)

Enhancements

Fixes

  • OKTA-275362- When modifying the field list in an existing LDAP datastore, removing all fields resulted in a field list with a single non-editable field with a blank name.
  • OKTA-278510 - When initially accessing the Access Gateway Management console, the string "Repodata is over N weeks old. Install yum-cron? Or run yum makecache fast." was inadvertently displayed.
  • OKTA-280578 - After upgrading from Access Gateway version 2020.01.0 or earlier, configuring high availability through the Access Gateway Management console caused the console to stop responding.
  • OKTA-280615 - After upgrading from Access Gateway version 2020.1.0 or earlier, when attempting to place an application in maintenance mode, the Access Gateway Admin UI console would redirect to the application page rather than the maintenance page.

 


Release: 2020.2.1

Deployment date: February 13, 2020

Download: Okta Admin Console (Settings > Downloads)

Features

  • High Availability is now available.

Enhancements

Fixes

  • OKTA-257420 - When the system time was updated through the Access Gateway Management console, the User-Defined Cookie Domain value and Access Gateway Hostname values were reset.
  • OKTA-274930 - The Unbound networking service log events weren't being captured to the syslog.
  • OKTA-274975 - When using the Access Gateway Admin UI console to create or update EBS applications in high availability clusters, the changes weren't propagated to worker nodes.
  • OKTA-275416 - When performing updates on worker nodes in high availability clusters, the bootstrap process produced an invalid configuration causing the node not to start.
  • OKTA-275757 - The Okta Access Gateway update process deleted the high availability configuration file on admin nodes.
  • OKTA-276986 - When using the Access Gateway Admin UI console to configure datastore definitions in high availability clusters, definitions with names that contain spaces weren't synchronized with worker nodes.

Release: 2020.1.0

Deployment date: January 8, 2020

Download: Okta Admin Console (Settings > Downloads)

Features

  • Documentation is enhanced for examples applications.

Enhancements

Fixes

  • OKTA-252228 - When setting the system time via the Access Gateway Management console (Services > NTP > Set system time), the current date and time was not displayed.
  • OKTA-252305 - When escaping from either of the NTP entry menus the user was returned to the Services menu rather than the NTP menu.
  • OKTA-258911 - When changing session cache, the fixed MB example shows 100MB for the 1000MB example. For more information see the Command Line Console > Services menu.
  • OKTA-262774 - When resetting the system using the management console (System> Reset) Access Gateway as incorrectly identified as SPGateway. 
  • OKTA-269513 - When configuring NIC bonding using the management console (Networking >Setup NIC bonding)
    "Error command not found" was displayed and the command failed.

Release: 2019.4.5

Deployment date: December 1, 2019

Download: Okta Admin Console (Settings > Downloads)

Features

  • Access Gateway has been hardened around certain vulnerability issues.
  • Documentation is enhanced for applications, and capacity planning.

Enhancements

Fixes

  • OKTA-258541 - Okta Access Gateway upgrades incorrectly prompted for passwords via sudo.
  • OKTA-257725 - Okta Access Gatewayupgrades failed with EBS SSO Agent errors.

Release: 2019.4.2

Deployment date: October 31, 2019

Download: Okta Admin Console (Settings > Downloads)

Features

  • Access Gateway has been hardened around certain vulnerability issues.
  • Documentation is enhanced for applications, capacity planning and sizing, and ports and protocols. SeePrerequisites for deploying Access Gateway for more information.

Enhancements

Fixes

  • OKTA-245678 - Validation failed when API token is Org + App Admin-scoped.
  • OKTA-252302 - Input validation errors caused Access Gateway to unexpectedly delete ciphers.
  • OKTA-256348 - AutoSession expired when user session creation exceeded one second.
  • OKTA-256778 - NGINX did not restart when updated certificates were in place.
  • OKTA-256796 - Hostname updates in the management console displayed an error.

 


Release: 2019.2.0

Deployment date: October 2, 2019

Download: Okta Admin Console (Settings > Downloads)

Features

  • Admins can now use the Access Gateway Management console to upgrade their instance of Access Gateway. For more information see Upgrade Access Gateway nodes .
  • Admins can more easily add, update and manage certificates. For more information see Manage certificates and certificate chains.
  • All Access Gateway product and documentation has been updated and re-branded.

Fixes

  • OKTA-249758 - Okta Access Gateway updated to address a reporting error during start up.
  • OKTA-249457 - Okta Access Gateway has been updated to correctly reload its configuration on start or restart.
  • OKTA-247108 - When configuring static networks DNS server is now set correctly.
  • OKTA-244460 - On application logout Access Gateway now correctly destroys session cookies in Internet Explorer 11.
  • OKTA-244453- When editing an existing IWA application, Kerberos realm drop down list is populated with realm selected while adding the application.
  • OKTA-242871- Rapid SSO w/EBS updated to support Internet Explorer.
  • OKTA-251020- Management console now displays memcache statistics.
  • OKTA-249510- Access Gateway Management console enable/disable debug option now functions as expected.
  • OKTA-240656- Duplicate realms no longer displayed when setting Kerberos realm in IIS IWA applications.
  • OKTA-240544- Mixed case public domain entries are now correctly treated as all lower case.
  • OKTA-251603- Application short name is now visible via tooltip when mouse hovers over the application name in the Admin UI.
  • OKTA-243275- Access Gateway Admin UI console now raises errors when invalid domain names are entered due to illegal characters.
  • OKTA-241517- Access Gateway now supports certificate generation in the advanced application settings.
  • OKTA-241516- Empty Protected Web Resource field are now handled correctly.
  • OKTA-241515- Access Gateway now supports custom delimiters and disabling default csv splitting for attribute import.