Previous Topic: Add the HTTP Methods for WebDAV to your Existing SiteMinder Rules

Next Topic: Claims Provider

Update your Agent Configuration Settings for Office Client Integration

The parameter settings in the Agent Configuration Object associated with your Agent for SharePoint control how Office Client Integration operates on your Agent for SharePoint.

follow these steps:

  1. Open the Administrative UI.
  2. Click Infrastructure, Agent Configuration, Modify Agent Configuration.

    The Modify Agent Configuration: Search pane opens.

  3. Specify search criteria that apply to the Agent Configuration Object you are using with the Agent for SharePoint, and then click Search.

    A list of Agent configuration objects that match the search criteria opens.

  4. Select an Agent Configuration object for your Agent for SharePoint, and then click Select.

    The Modify Agent Configuration: Name pane opens.

  5. Change the values of the following parameters:
    SPClientIntegration

    Specifies the hostnames of the SharePoint servers protected by the Agent for SharePoint on which you want to permit Office Client Integration. The default parameter is blank and listed as plain. If there are multiple host entries, use the multivalue option button to add multiple hosts.

    Add a port number to the value if the Agent for SharePoint operates on a nondefault port (any port except 80 or 443).

    To use this parameter, verify that the SharePoint resources protected by SiteMinder also have their Office Client Integration enabled on the SharePoint central administration server.

    Client Integration requires a persistent FedAuth cookie, verify that your SharePoint server is not configured to use session cookies. By default, UseSessionCookies in SharePoint is set to NO.

    Default: None

    Limits: Multiple values allowed. Use fully qualified domain names for all values.

    Example: agent_for_sharepoint_host_name.example.com (default ports of 80 or 443)

    Example: agent_for_sharepoint_host_name.example.com:81 (with nondefault port number for HTTP)

    Example: agent_for_sharepoint_host_name.example.com:4343 (with nondefault port number for HTTPS)

    SPDisableClientIntegration

    Specifies the hostnames of the SharePoint servers protected by the Agent for SharePoint on which you want to prohibit Office Client Integration. The default parameter is blank and listed as plain. If there are multiple host entries, then switch over to multi-value parameter. The URL in this parameter requires a port number (even for a default port such as 80 or 443).

    Use this setting to prevent SharePoint administrators from circumventing SiteMinder settings regarding Office Client integration.

    Limit: Multiple values allowed.

    Example: agent_for_sharepoint_host_name:port_number

  6. The following parameter describes the user agent values allowed by the Agent for SharePoint:
    SPAuthorizeUserAgent

    Specifies a list of Microsoft Office user-agent strings for which the Agent for SharePoint allows access. This list is populated automatically with the default values when the Agent for SharePoint starts. The user-agent strings in this parameter act as a whitelist. Changes to this parameter override the default settings. Access is denied to clients whose user-agent string does not appear in the list.

    For example, setting the value to Microsoft Office allows access to all versions of Microsoft Office products associated with the respective user agent string. Conversely, setting the value to Microsoft Office/12.0 allows access to only those versions of Microsoft Office products associated with the respective user agent string.

    Default: Microsoft Office, MS FrontPage, MSFrontPage, Microsoft Data Access Internet Publishing Provider Protocol Discovery, Test for Web Form Existence, Microsoft-WebDAV-MiniRedir

    Limits: Multiple values allowed.

  7. Examine the default values of the previous parameter. Consult with your SharePoint administrator to determine if additional user agent values are required.
  8. Change the value of the CSSChecking parameter to no.

    Note: Because the Agent for SharePoint is a proxy-based solution, this setting is required for Office Client Integration.

  9. Click OK.

    The new values appear next to the parameters in the list.

  10. Click Submit.

    The Create Agent Configuration Task is submitted for processing and the confirmation message appears.