# AgentSecurityField

The document field in stored AgentBoolean documents that contains the SecurityInfo for the agent or category. Use this parameter when your index contains secure documents that you want to match against agents and categories.

When you index AgentBoolean documents, you can include a security field to store the security information for the user that owns the agent, or for the category. When you use the agent or category to query for secure documents, IDOL Content Component uses this information (in the SecurityInfo parameter) to return only documents that the agent or category has permission to view.

Similarly, when you use a document to query for agents or categories, you set `AgentSecurityField` to the name of this field in your indexed agents and categories, and IDOL Content Component checks the document ACL against the security information in the agents and categories. In this case, IDOL Content Component returns only agents and categories that have permission to view the document that you use to query.

If you use this parameter, you must also use the AgentBooleanField and TextParse parameters. The XML or IDX document that you supply can contain an ACLType field and a SecurityType field, which must be configured in the Agentstore and IDOL Content Component configuration files.

NOTE: Before you index AgentBoolean agents and categories, you must index a dummy document that contains any ACLType, SecurityType, AgentBoolean and FieldText fields that exist in the XML or IDX documents that you use to query (withTextParse set to `True`). For example:

    #DREREFERENCE dummy
    #DREFIELD SECURITYTYPE=""
    #DREFIELD AUTONOMYMETADATA=""
    #DRECONTENT
    #DREENDDOC

The fields can be empty to ensure that the dummy document never matches any queries, or you can delete the dummy document from the database after you index it.

For more information, refer to the IDOL Server Administration Guide.

Actions: | Query GetQueryTagValues
Type: | String
Default: |
Example: | `AgentSecurityField=MySecurityField`
See Also: | SecurityInfo AgentSecurityCacheField configuration parameter

_FT_HTML5_bannerTitle.htm