Security Overview service

Overview

The Security Overview service gives you the possibility to get an overview of site wide set permissions. It also allows you to search and narrow down search results by path, role, and user or group name. 

Activating the service

In order to use the Security overview the  Security Overview service (service_securityoverview) must be available. If you have a fresh Silva installation you’ll need to activate the Security Overview service in the Extensions Service. (Fig. 1.)

Activating the Security Overview service

Fig. 1. Activating the Silva Security Overview.

Configuring the service

After this step the Security Overview service will be appear in Silva Services.

Click on the link to go into the service. (Fig. 2.)

Security overview service

Fig. 2. Going into the Silva Security Overview service.

Before you can start searching you’ll need to index your site so the service is aware of roles in your site.

Go to the Configuration tab of the service. (Fig. 3.)

Security overview configuration tab

Fig. 3. Configurations tab of the Security Overview service.

This will bring you to a form which allows you to reindex the site. Keep in mind that depending on the size of your site, this could be an expensive operation and is best done during a quiet time.

Click the Reindex button to start the reindexing of the site. (Fig. 4.)

Security overview reindex

Fig. 4. Reindexing the site.

Using the service

After reindexing we are ready to start searching. Go back to the service by clicking the Security overview tab. You will then see a form which allows you to search for role assignment throughout your Silva site. (Fig. 5.) The form allows you to search on certain criteria or combinations of those criteria.

Security overview form

Fig. 5. Search for role assignment form.

Searching by path

This option is useful if you have a big site and only want to search part of your site.
Fill in
a path starting from the Silva root of your site followed by the path to the Silva container you want to search in.
Click
the Search button. (Fig. 6.)

Security overview search by path

Fig. 6. Search by path.

Searching by role

This option is useful if you need to find the locations where a certain roles has been applied.
Select
the role you want to search for from the role dropdown.
Click
the Search button. (Fig. 7.)

Security overview search by role

Fig. 7. Searching for all users site wide with the Viewer role.

Searching by user or group name

When looking for permissions of a specific user or group the user or group name field is your friend.
Fill in
the user or group name you would like to see the permissions of.
Click
the Search button. (Fig. 8.)

Security Overview search by user or group

Fig. 8. Searching for permissions set for the user with the user name “user1”.

Combining criteria fields

The more criteria you use, the more you can narrow down your search results. If you fill in a path, a role, and/or fill in a user or group name you will be able to do a specific query and therefore limit the search results. (Fig. 9.)

Security overview search by role and username

Fig. 9. Combining criteria fields. Here we search location(s) where “user1” has a “Manager” role assigned.

Search results

When performing a search the search results are ordered by location (path). If more than one search criteria match the whole row will get highlighted, if one criteria is matched, that criteria only will be highlighted. (Fig. 10.)

Security overview search results

Fig. 10. Highlighted search results.

Exporting site permissions into a CSV file

This is functionality that makes it possible to export site wide set permissions, ordered into three columns path, user and role in a CSV file.

Go to the Configuration tab of the Security Overview service.

Click the Export button and save/open the generated CSV file. (Fig. 11.)

Security overview CSV export

Fig. 11. Exporting as CSV file.