Closed User Groups (CUGs) are used to limit access to specific pages that reside within a published internet site. Such pages require the assigned members to login and provide security credentials.
To configure such an area within your website you:
apply this group to the required pages and select (or create) the login page for use by the members of the CUG; also specified when applying a CUG to a content page.
create a link, of some form, to at least one page within the protected area, otherwise it will not be visible.
configure the Dispatcher if in use.
Closed user groups (CUGs) should always be created with performance in mind.
Although the number of users and groups in a CUG is not limited, a high number of CUGs on a page may slow down rendering performance.
The impact of CUGs should always be considered when doing performance testing.
To create a closed user group:
Go to Tools - Security from the AEM homescreen.
See Managing Users and Groups for full information on creating and configuring users and groups.
Select the Groups card from the next screen.
Press the Create button in the top right corner, to create a group.
Name your new group; for example,
Go to the Members tab and assign the required users to this group.
Activate any users that you have assigned to your CUG; in this case, all members of
Activate the closed user group so that it is available in the publish environment; in this example,
To apply the CUG to a page, or pages:
Navigate to the root page of the restricted section you want to assign to your CUG.
Select the page by clicking on its thumbnail and then selecting Properties in the top toolbar.
In the following window, open the Advanced tab.
Scroll down to the Authentication Requirement section.
Activate the Enable tickbox.
Add the path to your Login Page.
This is optional, if left blank the standard login page is used.
Next, go to the Permissions tab and select Edit Closed User Group.
CUGs in the Permissions tab cannot be rolled out to Live Copies from Blueprints. Plan around this when configuring Live Copy.
For more information, see this page.
The Edit Closed User Group dialog opens. Here you can search for, and select, your CUG, then confirm the group selection with Save.
The group will be added to the list; for example, the group cug_access.
Confirm the changes with Save & Close.
See Identity Management for information about profiles in the publish environment and providing forms for logging in and out.
Since the target of any links to the CUG pages are not visible to the anonymous user, the linkchecker will remove such links.
To avoid this, it is advisable to create non-protected redirect pages that point to pages within the CUG area. The navigation entries are then rendered without causing the linkchecker any problems. Only when actually accessing the redirect page will the user be redirected inside the CUG area - after successfully providing their login credentials.
If you are using Dispatcher, you need to define a Dispatcher farm with the following properties:
Configure session management in the dispatcher.any file for the CUG. The authentication handler that is used when access is requested for CUG pages determines how you configure session management.
/sessionmanagement ... /header "Cookie:login-token" ...
When a Dispatcher farm has session-management enabled, all pages that the farm handles are not cached. To cache pages that are outside of CUG, create a second farm in dispatcher.any
that handles the non-CUG pages.