Connect to Outbound WebSocket Assertion

The
Connect to Outbound WebSocket
assertion allows you to establish an outbound WebSocket connection using a specified WebSocket connection entity that is selected implicitly from the policy context. The assertion fails for invalid configurations and unsuccessful connection upgrade.
Using the Assertion:
  1. Do one of the following:
    1. To add the assertion to the policy development window, see Add an Assertion. You can also right-click anywhere in the policy development window and then select Add 'All' Folder. This creates an assertion folder in the policy window.
    2. To change the configuration of an existing assertion, proceed to
      Step 2
      below.
  2. When adding the assertion, the
    Connect to Outbound WebSocket Properties
    dialog automatically appears; when modifying the assertion, right-click
    Connect to Outbound WebSocket
    in the policy window and select
    Connect to Outbound WebSocket Properties
    or double-click the assertion in the policy window. The assertion properties are displayed.
  3. Configure the connection properties as necessary:
    1. The
      Source
      field is auto-filled to
      request
      . You cannot edit this field.
    2. The
      Destination
      field is auto-filled to
      response
      . You cannot edit this field.
    3. The
      Falsify if the connection upgrade is not successful
      checkbox, when selected, fails the assertion if unsuccessful connection upgrade response is received from the backend. If this checkbox is cleared, the backend response is populated into the response message. By default, this checkbox is selected.
  4. Click
    OK
    to save.
This assertion populates the following properties with a common prefix,
websocket
, as shown below:
  • websocket.url:
    Specifies the outbound WebSocket connection URL.
  • websocket.statusCode:
    Specifies the outbound WebSocket connection upgrade status.
  • websocket.reason:
    Specifies the outbound WebSocket connection upgrade reason text.