Test the SAML pass through application

To test a SAML pass through application, we first enable debug and start monitoring and then test the application normally. The following topics describe the process.

Topics

Configure application for testing

To enable debug for application testing:

  1. Navigate to the Access Gateway Admin UI console
  2. From the Topology tab or the Applications tab, open the application.
  3. Select the Settings pane.
  4. Expand the Advanced sub-tab.
  5. Set the Debug toggle to Enable.
    The debug toggle, which can be found in the Advanced application settings.
  6. Click Done.
    7. Tip

    Tip

    When debugging applications: Consider testing attributes with static known good values. For example, change dynamic IDP based fields to static with known good values.
    When debugging policy based applications: Test with no policy or open policy first.

Configure Access Gateway for debug and monitoring

The Access Gateway Management console can be used to provide a running display of all system log messages. In this optional section we enable debug and monitor Access Gateway using this functionality.

  1. Open a terminal and using SSH connect to the Access Gateway Management console for example.
    ssh oag-mgmt@gw-admin.<domain.tld>
    or
    ssh oag-mgmt@gw-admin.mysite.myco.com
  2. Navigate to the log monitoring page:
    1. Enter 4 - Monitoring.
    2. Enter 2 - Enable Debug.
    3. Enter 1 - Monitor logs.

    The a running display of all log messages will begin to display. Return to the Access Gateway Admin UI console console and exercise the application being examined.
    See command line Access Gateway Management console/monitoring for a complete list of all monitoring and related commands.

  3. Enter [ctrl][c] to exit the log display.
Important Note

Important

The debug logging level rapidly generates log message. Be sure to always disable debug logging when you have finished examining logging.
Failure to disable debug logging could result in rapid log file growth and out of disk errors.

Test application

Test application

  1. Connect to your Okta org as a user in the group associated with the bookmark application created in task Add an Okta bookmark application.
  2. Click the bookmark application icon to connect to the SAML application.
  3. Repeat as required to test.

Disable application and Access Gateway debug

If displaying debug statements at the command line:

  1. Return to the Access Gateway Management console.
  2. Enter [ctrl][c] to exit the log display.
  3. Enter 3 - Disable debug.
  4. Exit the command line console

If application debug is enabled:

  1. Return to the Access Gateway Admin UI console
  2. Navigate to the application being tested
  3. Expand the Setting sub tab.
  4. Expand the Essentials sub tab.
  5. Return the Protected Web Resource field back to its original value.
  6. Expand the Advanced sub tab.
  7. Set the Debug toggle to Disable.
  8. Save your changes.