# SynchronizeGroups

The `SynchronizeGroups` action instructs the connector to retrieve security group information from the data repository. IDOL requires this information to provide document security, which ensures that documents can be viewed only by authorized users.

FlowFiles containing the user and group information are routed to the "Groups Output" relationship of the connector group. You can use a PutOGS processor to send this information to your IDOL OmniGroupServer.

For more information about mapped security, refer to the IDOL Document Security Administration Guide.

Type: asynchronous

Parameter | Description | Required
--- | --- | ---
`ConnectorGroup` | The name of the connector group to send the request to. This must match the name you specified when you configured the ConnectorGroupRouter processor in your dataflow. | Yes
Custom parameters | Any other parameters that you set are added to the FlowFile, created by the HandleAciRequest processor, that represents the action. When a connector processes the action, it adds the parameters to any FlowFiles that it generates. The parameters are added as FlowFile attributes named `idol.aci.param.name`, where `name` is the name of the parameter that you set. FlowFile attributes can be referenced by processor properties that support expression language, and can be read by Lua scripts. You can therefore set custom parameters to customize processing within NiFi. The maximum size for a custom parameter value is 4KB. | No

## Example

    http://host:10000/action=SynchronizeGroups&ConnectorGroup=SharePoint

## Response

This is an asynchronous action, so you receive a token in response to the request. You can use the QueueInfo action to determine whether synchronization has finished.

_FT_HTML5_bannerTitle.htm