PingGateway 2024.6

Create and edit routes with Freeform Designer

The following sections describe how to create a simple route in the FreeForm Designer of Studio, and then add configuration to the route. For examples of routes created with the FreeForm Designer that can be tested with the examples in the Gateway guide, refer to Example routes created with Freeform Designer.

Create a simple route

  1. In PingGateway Studio, create a route:

    1. Go to http://ig.example.com:8080/openig/studio, and then select Create a route.

    2. Select freeform Freeform to use the FreeForm Designer.

  2. Select Basic to create a route from a blank template.

  3. Enter a URL for the application you want to protect, followed by a path condition to access the route. For example, enter http://app.example.com:8081/my-basic-route.

    The route is displayed on the freeform Flow tab of the canvas.

  4. On the top-right of the screen, select and Display to review the route.

    {
      "name": "my-basic-route",
      "baseURI": "http://app.example.com:8081",
      "condition": "${find(request.uri.path, '^/my-basic-route')}",
      "handler": "ReverseProxyHandler",
      "heap": [
        {
          "name": "ReverseProxyHandler",
          "type": "ReverseProxyHandler"
        },
        {
          "type": "BaseUriDecorator",
          "name": "baseUri"
        },
        {
          "type": "TimerDecorator",
          "name": "timer",
          "config": {
            "timeUnit": "ms"
          }
        },
        {
          "type": "CaptureDecorator",
          "name": "capture",
          "config": {
            "captureEntity": false,
            "captureContext": false,
            "maxEntityLength": 524288
          }
        }
      ]
    }

Change the basic settings of a route

  1. Using the route created in Create a simple route, on the top-right of the screen select Route settings.

  2. Using the on-screen hints for guidance, change the name, condition, or other features of the route, and save the changes.

  3. On the top-right of the screen, select and Display to review the route.

Add objects to a route heap

  1. Using the route created in Create a simple route, select All Objects > Create Object.

  2. In Node Type, select an object type from the drop down list. For example, create an AmService object, using the following values:

    • Name: AmService-1

    • URI: http://am.example.com:8088/openam/

    • Agent:

      • Agent: ig-agent

      • Password: password

        Use secure passwords in a production environment. Consider using a password manager to generate secure passwords.

      When you save, the object is added to route heap but is not used in the route.

  3. On the top-right of the screen, select and Display to review the route.

Add configuration to a route

  1. Using the route created in Create a simple route, select the freeform Flow tab, and delete the connector between Start and ReverseProxyHandler.

  2. Drag a Chain from the side bar onto the canvas, and then drag a SingleSignOnFilter into the chain.

  3. In the menu for the SingleSignOnFilter, enter the name of the AmService object you created in Add objects to a route heap, AmService-1. The filter uses the object previously defined in the heap.

  4. Connect Start to Chain-1, and Chain-1 to ReverseProxyHandler.

  5. On the top-right of the screen, select and Display to review the route.

Decorate objects in the route

  1. Using the route created in Create a simple route, select the All Objects tab.

    A list of objects in the route is displayed. By default, all available decorators are included in the route heap, but they do not decorate any objects.

  2. For the ReverseProxyHandler or filter, select , select the Decorations tab, and then enable one or more of the decorators.

  3. On the top-right of the screen, select and Display to review the route.

Copyright © 2010-2024 ForgeRock, all rights reserved.