Programming Guides › Programming Guide for C › Authentication API › Authentication API Overview › Redirection

Redirection

The authentication scheme can tell the Policy Server to instruct the agent to perform a redirect. To build an authentication scheme that provides redirection capabilities, place the URL in the lpszErrMsg parameter and return a status code that includes reason code Sm_Api_Reason_ErrorMessageIsRedirect.

For example:

strcpy (lpszErrMsg, "https://12.12.1.1/display/user.cgi?dn=");
strcat (lpszErrMsg, lpUserContext->lpszUserName);
return SM_MAKEAUTH_STATUSVALUE (Sm_AuthApi_Accept,
                          Sm_Api_Reason_ErrorMessageIsRedirect);

This functionality is useful when customizing the workflow of a Web application using a standard Agent. However, configuring redirection is also useful when using custom agents.