Programming Guides › Programming Guide for C › Customizing the Policy Server › Integration with the Web Agent

Integration with the Web Agent

The Policy Server works in tandem with the Web Agent. While it is authenticating and authorizing, the Policy server sends certain information about the outcome of the operation to the Web Agent. The Web Agent makes this information available to the application as follows:

Authentication events without a redirect:

• The user message is exposed as the HTTP_SM_USRMSG header variable.
• The reason code is exposed as the HTTP_SM_AUTHREASON header variable.

Authentication events with a redirect:

• The user's message is stored in the SMUSERMSG cookie as SMUSRMSG=<text>.
• The reason code is appended to the redirect URL as ?SMAUTHREASON=<reason code>

  If the reason code is included in the following form:

  SMAUTHREASON=$$SMAUTHREASON$$

  the value is used in the authentication reason field for SM_AGENTAPI_LOGIN, along with the username and password.

• The redirect text is stored in the SMTEXT cookie as SMTEXT=<text>.

Authorization events without a redirect:

• No reason code is available.

Authorization events with a redirect:

• The reason code is stored in the SMREASON cookie as SMREASON=<reason code>.
• The redirect text is stored in the SMTEXT cookie as SMTEXT=<text>.