Sample Proxy Application


The purpose of this tutorial is to walk through the process of setting up a sample proxy application through the Access Gateway AdminAn abbreviation of administrator. This is the individual(s) who have access to the Okta Administrator Dashboard. They control the provisioning and deprovisioning of end users, the assigning of apps, the resetting of passwords, and the overall end user experience. Only administrators have the Administration button on the upper right side of the My Applications page. Console.
Proxy applications are typically used to redirect a request from one URL to another, or often to use a query or similar mechanism to redirect from a root URL plus a resource path to a specific URL.
Example proxy forwarding

Before You Begin

Create Sample Proxy Application

  1. Navigate to your Access Gateway InstanceAn instance, or computer instance, is a virtual machine (VM) or individual physical computer, used to host a software appliance. and sign in as admin.
  2. Click the Applications tab
    .Select applications tab
  3. Click + Add to add a new application.
    Click Add.
  4. Select the Access Gateway Sample Policy option from the left column menu, and click Create.

    Select add and click Sample Proxy App.

    The New Protected Application wizard will start and display the Setting tab for the application being added.

  5. In the Essentials pane specify the following:

    Field Value
    Label A name for the application. Default is Sample Policy AppAn abbreviation of application. Essentially, it is a web-based site used to perform any number of specific tasks, and requires authentication from end users by signing in..
    Public DomainA domain is an attribute of an Okta organization. Okta uses a fully-qualified domain name, meaning it always includes the top-level domain (.com, .eu, etc.), but does not include the protocol (https). A fully qualified host name such as policy.<your domain tld>
    Protected Web Resource Web resource protected by application
    Group Enter the group containing the users who should have access to the application.
    Description [optional] An appropriate description for your application.
  6. Review the Essentials pane and then click Next.

  7. Review the Attributes pane and then click Next.

  8. Review the Policy pane which includes a set of sample policies for redirecting requests.

  9. Select one of the policy statements and click the pencil() icon to open it.
    Examine policy for redirection.

  10. Each Policy statement includes a resource path and advanced configuration.
    Expand the Advanced section.
    Examine a redirect policy.
    Redirecting requests can require changes to the request. Changes often include resetting header or cooke fields as well as others.
    Some common examples are provided below.

    Examine Advanced configuration.
    For more information see:

  11. When Complete click Okay.

  12. When complete click Done.
    Access Gateway will add the new application and then redirect to the Applications tab.

Test Sample Proxy Application

  1. Select IDP Initiated from the drop down menu to verify the application is working.

    Test a sample proxy application

  2. In the application page, review and verify that the Sample Policy App matches your profile information.
    Example proxy application

Next Steps