| Note | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
In This Topic
| Table of Contents | ||||
|---|---|---|---|---|
|
Logging in to XperienCentral
Once you have successfully installed XperienCentral, you can start it and log in. To log in to XperienCentral, navigate to the following URL:
<xperiencentral-server>/web/edit
where <xperiencentral-server> is the name of the server on which XperienCentral is running. You will then see the XperienCentral login screen:
The very first time that a new XperienCentral installation is logged in to, most likely by the main application manager or a developer, use the following username/password combination:
Username: Administrator
Password: Administrator
After successfully logging in, you will be prompted to change the password for the Administrator user. After doing so as described below, you can proceed with configuring XperienCentral and creating new users and assigning roles. Direct all your users to the following URL to log in to XperienCentral:
<xperiencentral-server>/web/edit
...
...
- Is at least 12 characters long.
- Contains a mix of uppercase and lowercase letters.
- No string of letters spells out a word that appears in the dictionary of the language of the user.
- Contains one or more numbers, but the numbers do not represent anything associated with the user such as their birth date, age, house address, and so forth.
- Contains one or more special characters. A special character is anything that is not a letter or a number or a space.
- Does not contain any string of letters that spell their first or last name, their company name, their job description, nickname, or any other word that could be associated with them personally.
...
...
| Info |
|---|
After a user has logged in to XperienCentral for the first time, they will no longer see the GUI language choice on the Login screen. Hereafter, users can select their GUI language on the Personal Settings tab in My Settings. |
Logging in to the XperienCentral Setup Tool
To log in to the XperienCentral Setup Tool, navigate to the following URL:
<xperiencentral-server>/web/setup
where <xperiencentral-server> is the name of the server on which XperienCentral is running. The password is the same as the one used to log in to the Workspace.
Logging in to the XperienCentral Administrative Pages
The XperienCentral Administrative Pages are used to monitor an XperienCentral installation. See Administrative Pages for complete information.
| Panel | ||||
|---|---|---|---|---|
| ||||
The following applies to XperienCentral versions 10.13.0 and higher. |
Navigating Directly to the XperienCentral Login Page
In all cases when not using backend container authentication, when a user navigates to .../web/edit, they will be redirected to the login screen if they are not already logged in. If they are already logged in, navigating to .../web/edit will take them directly to the XperienCentral Workspace, bypassing the login screen. If a user wants to navigate directly to the login screen, in order to switch users for example, use the following URL:
<xperiencentral-server>/web/login
where <xperiencentral-server> is the name of the server on which XperienCentral is running.
Login Lockout Mechanism
If a user attempts to log in 5 consecutive times without success, they will be locked out of XperienCentral for 10 minutes, after which they can attempt to log in again. This holds true even if their password is changed by an administrator. There is no time limit for the 5 consecutive unsuccessful attempts which means that a user will be locked out even if a year passes between the first and fifth unsuccessful attempts.
| Panel | ||||
|---|---|---|---|---|
| ||||
The following applies to XperienCentral versions 10.13.0 and higher. |
Logging in with Backend Container Authentication
If you implement the Backend Container Authentication functionality for your project, your users do not have to log in to XperienCentral with a username and password if they have already logged in to the backend container. In this situation, refer your users to the following URL to directly access XperienCentral:
<xperiencentral-server>/web/edit
where <xperiencentral-server> is the name of the server on which XperienCentral is running.
...
| Panel | ||||
|---|---|---|---|---|
| ||||
The following applies to XperienCentral versions R24.2 and R26 and higher. |
Two factor authentication is a user authorization scheme in which two separate authentication challenges must be satisfied in order to gain access to a resource. XperienCentral contains a two factor authentication setting which requires a user to provide a username/password combination followed by a security token which he or she receives by email. When two factor authentication is enabled, a user must pass both authentication checks in order to gain access to the XperienCentral backend. The two authentication steps must be satisfied every time they log in.
Enabling Two Factor Authentication
| Warning |
|---|
Important: Before you enable two factor authentication, it is extremely important that you correctly configure the XperienCentral SMTP host setting in the application_settings section of the General tab in the Setup Tool as well as the email address for all users in the User Authorization panel. Confirm the following:
Proceed with the steps below only after you successfully receive an email from XperienCentral using the method described above or by some other means. |
Follow these steps to enable two factor authorization:
- Open the Setup Tool.
- Navigate to the General tab.
- Under "website_settings", locate the property
enable_email_two_factor_authenticationand select it in order to enable it. - Click [Save Changes] at the bottom of the General tab.
Testing Two Factor Authentication
Once you have enabled two factor authentication, test it:
...
| Info |
|---|
Once you have determined that two factor authentication is working properly, notify your XperienCentral users about the steps required to log in. Be sure to inform them that the security token is valid for the duration of an XperienCentral session. If a session times out (after 30 minutes of inactivity by default), a user must start a new session and receive a new security token in order to log in. |
Troubleshooting Two Factor Authentication
If something goes wrong with the configuration of the SMTP host and/or your personal email address, you could be locked out of XperienCentral. If you have configured any other users with the role Application Manager, try to log in using one of those accounts. If this is successful, it means that your personal email is not configured correctly. Fix your email address in the Users tab in User Authorization.
If you cannot log in to XperienCentral with any user, you need to disable two factor authentication and start again. To disable two factor authentication from outside the XperienCentral GUI, stop the XperienCentral web server. Restart XperienCentral and pass the following JAVA_OPTS option in the startup command:
-Ddisable_2fa
...
Login Page Parts
The following shows an example XperienCentral Login page.
The three parts of the Login page that you can customize are:
A - Company Name
B - Channel Name
C - Announcement
...
Customizing your Company Name
A company name (A) does not appear on the XperienCentral Login page by default, however you can add one. To do so, follow these steps:
- Open the XperienCentral Setup Tool.
- Navigate to the General tab.
- Search for the setting
company_namein theapplication_settingssection. - In the field next to
company_name, enter the string that you want to appear on the Login page above the Channel name. For best results, limit the string to 25 characters (including spaces) or less. - Scroll to the bottom of the Setup Tool and click [Save Changes]
The company name you configured will now appear on the Login page for all users just above the channel name. For example:
| Tip |
|---|
While the name of the setting is |
...
Customizing the Channel Name
The name of the channel (B) that displays on the Login page is taken from the "Title" field on the General tab in the Channel Configuration panel. To show a different Channel name on the Login page, modify the title of the channel. The following shows a channel name on the Login page:
| Note |
|---|
Before changing the name of a channel in XperienCentral, you should determine whether the naming convention has dependencies on other parts of your project or vice versa, especially projects that contain multiple channels. |
...
Customizing the Announcement
By default, no announcement (C) is shown on the XperienCentral Login page, however you can add one. The Announcement text is defined in My Settings. See Announcement for complete information. For example:
