# Mapped Security Architecture

The mapped security architecture includes the following components:

- OneDrive Connector
- Micro Focus OmniGroupServer
- Micro Focus IDOL Content component (which includes the mapped security plug-in)
- Micro Focus IDOL Community component
- A front-end application

Items in OneDrive have associated permissions that specify the users and groups who are permitted to view them. The OneDrive Connector retrieves the items from OneDrive. The connector adds an Access Control List (ACL) to each IDOL document, which contains the security information. Each time the connector synchronizes with the repository, it updates the ACLs for any documents where the associated permissions have changed.

The IDOL Content component needs the ACL to determine whether a user can view a document that is returned as a result to a query. However, IDOL must also consider the groups that the user belongs to. A user might not be permitted to view a document, but they could be a member of a group that has permission. This means that IDOL requires the user and group information from the OneDrive repository - and from Azure Active Directory if you are processing drives in a OneDrive for Business environment.

The connector can extract user and group information from OneDrive. This functionality is available through the `SynchronizeGroups` action. You can configure OmniGroupServer to run this action. OmniGroupServer also includes a module to retrieve users and groups from Azure Active Directory. If you are processing drives in a OneDrive for Business environment, you must configure OmniGroupServer to retrieve users and groups from both sources and then combine them into a single repository that can be queried by the IDOL Community component.

When a user logs on to a front-end application, the application requests the user’s security information and group memberships from Community. Community returns a token containing the information. The front-end application includes this token in all queries the user sends to the Content component.

When a user submits a query, IDOL sends the result documents and the user's security token to the mapped security plug-in. The mapped security plug-in compares the user's security information and group memberships to each document's ACL. The plug-in determines which documents the user is permitted to view and returns the results. The IDOL Content component then sends only the documents that the user is permitted to view to the front-end application.

_FT_HTML5_bannerTitle.htm