Customize the Home page

Adaxes Web interface can be customized to provide access to the most frequently used features directly from the Home page. The page is divided into the following major sections: Header, Actions pane, Content panes, Cards and Charts.

If necessary, you can disable the Home page. For details, see Disable Web interface components.

The Home page header can contain either navigation elements or user account information with an Edit button. User information in the header can be useful for self-service, as it gives users quick access to their own account.

How to customize the Home page header

Open Adaxes Web interface configurator.
In the top left corner, select the Web interface you want to customize.
In the left navigation menu, click Home page.
In the Header section, configure the settings.
Save the changes.

For instructions on how to change the logo in the header and the color of the Edit button, see Set custom logo and colors.

Actions

The Actions pane allows users to perform frequently used operations right from the Home page. The pane can contain operations on directory objects, custom commands, and links to external web sites.

For instructions on how to configure the Actions pane, see Configure Actions pane.

Content panes

The middle part of the Home page can contain objects users need quick access to. The objects are grouped into lists which are displayed in separate panes. Each pane can contain specific directory objects, members of groups, business units, objects located in specific organizational units, reports, etc.

How to configure content panes

Open Adaxes Web interface configurator.
In the top left corner, select the Web interface you want to customize.
In the left navigation menu, click Home page.
To add, edit, delete and move panes, use the buttons located in the Contents section. To hide a pane, uncheck it in the list.
Save the changes.

In Adaxes Web interface, users can see only the objects they have permissions to view. If you add an object to the Home page and a user doesn't have the rights to view it, the object will not be displayed. For details, see Hide directory objects from users.

Different objects for different users

You can configure a pane on the Home page to display different objects depending on who is logged in. For example, it can display the manager of the logged in user, objects located in the user's organizational unit, members of the group associated with the user's department, etc.

If you want a pane to contain different objects based on the logged in user, you need to use templates. Adaxes will use the template to build the distinguished name (DN) of a directory object that should be placed on a pane. To include the properties of the logged in user in a template, use value references. Value references will be replaced with the corresponding property values of the user's account. For example, value reference %department% will be replaced with the value of the user's Department property.

How to use templates when adding objects

In the Contents section, select the pane where you want to add an object and click Edit.
In the dialog that opens, activate the Contents tab and click Add.
In the Add dialog, select whether you want to add a single object, members of a group, or objects located in an organizational unit. Then click the button embedded into the Object field.
In the dialog that opens, click Template.
In the Template field, specify a template for the distinguished name (DN) of a directory object. To insert a value reference, click the button.
Examples
- %manager% – manager of the logged in user.
- %adm-ParentDN% – the organizational unit where the account of the logged in user resides.
- %adm-DomainDN% – the domain of the logged in user.
- CN=%department%,CN=Users,DC=example,DC=com – the %department% value reference will be replaced with the department of the logged in user. The pane will contain an object that has the same name as the user department and located in the Users container in the example.com domain.
- OU=Contacts,%adm-DomainDN% – the %adm-DomainDN% value reference will be replaced with the distinguished name of the domain of the logged in user. The pane will contain an organizational unit named Contacts located in that domain.
- %adm-CustomAttributeObject1% – the value reference will be replaced with the DN of an object specified in CustomAttributeObject1 of the logged in user. CustomAttributeObject1 is an Adaxes custom property that behaves just like a normal object property, but is available only in Adaxes.

If a pane contains a report instead of specific directory objects, report generation parameters can also be different depending on the logged in user. For example, you may want to set a report parameter to the value of the user's Department property. Or, you can limit the report scope to the organizational unit where the user's account is located.

Screenshot

Cards

Cards allow users to see useful information and initiate some self-service actions right from the Home page. There are four types of cards: My account, Change password, Password self-service and Multifactor authentication.

My account

The card displays brief information about the account of the logged in user and gives them quick access to view and edit their account.

Change password

The card shows how many days are left until the password of the logged in user expires, and when the password was last changed. It also contains a button that allows users to change their password. You can configure the card to highlight the button when, for example, the password expires in less than 3 days.

Password self-service

The card enables users to enroll, re-enroll, and cancel their enrollment for password self-service. The card is not visible when there are no password self-service policies assigned to the logged in user.

Multifactor authentication

The card allows users to activate a mobile authenticator app (Google Authenticator, Authy, Okta Verify, etc.) on another device. This can be helpful if, for example, the device where the app is currently activated was lost.

The card is only visible if the logged in user has already activated an authenticator app and either the app is required to sign in to a Web interface the user has access to, or the user is required to use the app during self-service password reset.

How to configure Home page cards

Open Adaxes Web interface configurator.
In the top left corner, select the Web interface you want to customize.
In the left navigation menu, click Home page.
In the Cards section, configure the settings.
Save the changes.

Charts

Charts provide visual overview of essential information related your directory, allow monitoring security-sensitive object changes, account and password statuses, carry out risk analysis, etc.

How to configure Home page charts

Open Adaxes Web interface configurator.
In the top left corner, select the Web interface you want to customize.
In the left navigation menu, click Home page.
To add, edit, delete, and move charts, use the buttons located in the Charts section. To hide a chart, uncheck it in the list.
Save the changes.

Different chart data for different users

The charts are created based on the data collected during report generation. Parameters for report generation can be different depending on the logged in user. For example, if you want a chart to contain data for the department of the logged in user, you can set a report parameter to the value of the Department property of the user. Or, you can limit the report scope to the organizational unit where the user account resides.

To include the properties of the logged in user to report parameters and scope, use value references. Value references will be replaced with the corresponding property values of the user's account. For example, value reference %department% will be replaced with the value of the Department property of the user.

Screenshot

To increase performance, the data for charts is cached. The cache is updated approximately once a day. To force the charts to refresh, click the
button located in the top right corner of the page.