Layer7 Access Management

Expand all | Collapse all

TECH TIP: How to send a RelayState parameter on a SAML federation from Access Gateway?

  • 1.  TECH TIP: How to send a RelayState parameter on a SAML federation from Access Gateway?

    Posted 10-10-2017 02:27 PM

    SUMMARY

     

    Sometimes an SP will need to be sent the RelayState parameter in the access URL as a requirement in order to establish the federation.

     

    If you try to put an & sign on a proxy rule may you recieve an error message saying:

     

    Error: Problem occurred in while Saving Proxy Rules TreeThe reference to entity "RelayState" must end with the ';' delimiter

     

    INSTRUCTIONS

     

    - Write & instead the & sign.

     

     

    i.e:

    - Save the Proxy Rule.

    - Once you save the Proxy Rule the link will show the & sign before the word RelayState 

     

     

    & denotes the start of an encoded entity. In this case the parser tries to interpret &RelayState as an entity. But entities are always terminated by a ;, thus if the ; is missing you get the error message.

     

     

     

    NOTES

     

    - The RelayState parameter is case-sensitive, so be sure to write it down as well: RelayState

    RelayState should point to the target resource at the Service Provider (full URL)

    - This URL must be encoded. May use URL Decode and Encode - Online for this task.



  • 2.  Re: TECH TIP: How to send a RelayState parameter on a SAML federation from Access Gateway?

    Posted 10-11-2017 12:54 AM

    Thanks for sharing Luis