# Configure IDOL Server

NOTE: Mapped Security for Salesforce requires IDOL Server 11.4 or later.

This section describes the configuration changes that are required in IDOL Server to enable mapped security for documents that originate from Salesforce. For more information about configuring mapped security in IDOL Server, refer to the IDOL Document Security Administration Guide.

## Content Component

The first requirement is to add a field processing rule so that the IDOL Content component can determine whether a document is protected by Salesforce security. Field processing rules are configured in the `[FieldProcessing]` section of the Content component configuration file.

The following example instructs the Content component to search for a field named `SECURITYTYPE` and check for the value `SALESFORCE`. You should have configured your Salesforce Connector to add this field to every document (see Retrieve and Index Access Control Lists).

    [FieldProcessing]
    ...
    29=DetectSalesforceSecurity

    [DetectSalesforceSecurity]
    Property=SecuritySalesforce
    PropertyFieldCSVs=*/SECURITYTYPE
    PropertyMatch=SALESFORCE

    [SecuritySalesforce]
    SecurityType=Salesforce_V4

After the Content component has determined that a document is protected by Salesforce security, it must process the ACL that the Salesforce Connector has added to the document in the `AUTONOMYMETADATA` field.

To process ACLs added to documents by the Salesforce Connector, configure custom mapped security (`Type=AUTONOMY_SECURITY_V4_GENERIC_MAPPED`). Document security is configured in the `[Security]` section of the Content component configuration file.

    [Security]
    ...
    6=Salesforce_V4

    [Salesforce_V4]
    SecurityCode=6
    Library=C:\HPE\IDOLServer/content/modules/mapped_security
    Type=AUTONOMY_SECURITY_V4_GENERIC_MAPPED
    ReferenceField=*/AUTONOMYMETADATA
    //Logging=TRUE
    //DebugDecrypt=TRUE
    SecurityACLFormat=U:<U=SLEC>:G:<G=SLEC>
    SecurityACLCheck=U=[U]?P:-,G=[G]?P:F

IMPORTANT: Ensure that the `SecurityACLFormat` and `SecurityACLCheck` parameters are set exactly as shown in the example above.

## Community Component

The final requirement is to configure user security so that when a user logs on to a front-end application, IDOL Server can return a security token that includes their Salesforce group memberships. User security is configured in the `[Security]` section of the Community component configuration file.

Add a new section for Salesforce, similar to the following example:

    [Security]
    7=Salesforce

    [Salesforce]
    DocumentSecurity=TRUE
    GroupServerHost=localhost
    GroupServerPort=3057
    GroupServerRepository=Salesforce
    SecurityFieldCSVs=username
    DocumentSecurityType=Salesforce_V4
    CaseSensitiveUserNames=FALSE
    CaseSensitiveGroupNames=FALSE

The `GroupServerHost` and `GroupServerPort` parameters should specify the host name or IP address, and ACI port, of your OmniGroupServer. The `GroupServerRepository` parameter should specify the name of the repository that you created when you configured OGS (see Retrieve Security Group Information).

_FT_HTML5_bannerTitle.htm