Agent for SharePoint Guide › Advanced Options › How to Use the Session Linker

How to Use the Session Linker

The SessionLinker synchronizes a SiteMinder session with a third-party application session (such as SharePoint) for better security. If a user logs out from SiteMinder, the SessionLinker invalidates the related session of the third-party application.

Part of this synchronization process uses cookies from the third-party application. The SessionLinker requires certain information about these third-party cookies to link the sessions.

Follow these steps:

1. Enable the session linker.
2. Pick the procedure that matches your agent configuration method from the following list:
   • For agents using an Agent Configuration object (ACO) on a Policy Server, follow these steps:
     1. Open the Administrative UI.
     2. Set the SessionLinker parameter in an Agent Configuration object.
   • For agents using a local configuration file on the, set the Session parameter in a local configuration file.

Enable the SessionLinker

Because the SessionLinker operates on a server, enable it on the server first.

Follow these steps:

1. Log in to the server that runs your Agent for SharePoint.
2. Open the following file with a text editor:

   Agent-for-SharePoint_Home\proxy-engine\conf\defaultagent\WebAgent.conf
   

   Agent-for-SharePoint_Home

   Indicates the directory where the Agent for SharePoint is installed.

   Default: (Windows) C:\Program Files\CA\Agent-for-SharePoint
   Default: (UNIX/Linux) /opt/CA/Agent-for-SharePoint

3. Locate the following line that applies to your operating environment::

   (Windows) #LoadPlugin="Agent-for-SharePoint_Home\agentframework\bin\SessionLinkerPlugin.dll"
   

   (UNIX/Linux) #LoadPlugin="Agent-for-SharePoint_Home\agentframework\bin\LibSessionLinkerPlugin.so
   

4. Delete the # character at the beginning of the line.
5. Save the file and close the text editor.

   The SessionLinker is enabled.