<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-M74D8PB" height="0" width="0" style="display:none;visibility:hidden">
Loading
Skip to NavigationSkip to Main Content
How to Identity an OAG Application by its UUID
Access Gateway
Overview

When troubleshooting an issue, the logs or nginx status may show an "emerg" level error referencing an issue with an application's configuration file (/etc/nginx/conf.d/icsgw_app_<uuid>.active.conf).  This may also result in a UI error that the OAG configuration is "Not Valid".

This is likely due to a misconfiguration in one of the application's policies. This article describes how to identify that application based on the UUID of the configuration file to make the necessary fix.

Example error:


nginx: [emerg] directive "proxy_redirect" is not terminated by ";" in /etc/nginx/conf.d/icsgw_app_cca31722-eae4-4057-b802-e74c6a77d8da.active.conf:82

 

Applies To
  • Okta Access Gateway (OAG)
Solution

Either option can be used to get the label from the UUID of the application:

  1. From the Command Line:
    1. Login to the appliance shell.

    2. From the error message, copy the path in the error message (/etc/nginx/conf.d/icsgw_app_cca31722-eae4-4057-b802-e74c6a77d8da.active.conf) and paste it where <path> is to view the name of the application.

      sudo grep 'set $label "' <path> 

      Example:

      sudo grep 'set $label "' /etc/nginx/conf.d/icsgw_app_cca31722-eae4-4057-b802-e74c6a77d8da.active.conf


  2. From the Browser:
    1. Login to the OAG UI.
    2. Open the browser's developer tools (Ctrl+Shift+I) and go to the Network tab.
    3. Navigate to the Applications page of the OAG UI.
    4. Within developer tools, click on the magnifying glass and search for the UUID from the error message.
      • This should return a match for the response from an "app?sparse=true" call.
    5. Click the search result to open the response body section.
    6. Click anywhere in the response section and search (Ctrl+f) for the UUID.
      • The UUID is the first key in the application's JSON object, which also includes its label/name and other details.
Loading
How to Identity an OAG Application by its UUID