Xperience Portal

This page discusses Xperience Portal administration (available at https://xperience-portal.com). To prepare your project:

• Access your Xperience Portal project
• Provide access to the project for your team members
• Set up the resources (hash string salt and personal access tokens) needed before deploying to the SaaS environment
• Select preferred timeslots for the scheduled Xperience Portal project maintenance

Use the Dashboard application to see the information about your project, including the region where your application is deployed (service region), service plan, project expiration date, and project GUID.

Access Xperience Portal projects

To access Xperience Portal, you need to receive an invitation to a specific Xperience Portal project. Kentico sends the invitation to join the project for the first project user, and you can send further invitations from the Xperience Portal, see Invite a new user to a project.

Access your Xperience Portal project:

1. Select the link in the email invitation.
2. Accept the Terms of Service.
3. Set a password. You will use the email and password to access all projects you were invited to.
4. Set up the Multi-Factor Authentication (MFA) in Xperience Portal:
   1. Use One-Time Passwords (OTP) with your preferred authenticator application.
   2. After you set up the authenticator, a recovery code is displayed. Copy this code and store it somewhere safe, as it can be used to access the portal in case you lose the device used as the second factor.

You now have access to your Xperience Portal project. If you encounter issues with accessing your Xperience Portal project, contact Kentico support.

Users

Access to Xperience Portal is restricted to accounts associated with unique email addresses using Role-based access control (RBAC) and is managed via Auth0 by Kentico. To learn more about roles in Xperience Portal and their privileges, see Reference - Xperience Portal user roles.

Log in as a user with the Tenant Administrator role to access the Users application where you can:

• Invite a new user to a project
• Change a role of an existing user
• Remove a user from the project

Invite a new user to a project

1. Open the Users application.
2. Select Invite user.
3. Enter the email add`ress of the user you want to invite.
4. Assign an Xperience Portal role to the user and select Invite.
5. Refer the invited user to Access Xperience Portal for the first time.

The user will receive an email with an access link to join a project in Xperience Portal. If the email address is not associated with an Xperience Portal account, the user will receive an invitation to create an Xperience Portal account.

Change a role of an existing user

1. In the Users Application, select the Edit () icon of a user whose role you want to change.
2. Select the role from the Role drop-down menu. See Reference - Xperience portal user roles to decide which role to assign to the existing user.
3. Select Save.

Remove a user from the project

1. In the Users application, select the Remove () icon of a user you want to remove from the project.
2. Confirm by selecting Remove.

The user is removed from the project, and the Personal access token associated with the account are revoked. The user does not lose access to other projects after removal from a specific project.

Hash string salt for the Xperience Portal project

Set your .NET project hash string salt to the hash string salt available in the Project info section of the Xperience Portal project Dashboard.

Personal access tokens

Personal access tokens are used to authenticate API requests to Xperience Portal, for example, when you upload the deployment package to Xperience Portal.

Use the Personal access tokens application to Create, Edit, or Revoke tokens.

Create a new Personal access token (PAT)

1. In the Personal access tokens application, select Create token.

2. Enter the required data into the form:

   • Display name – is used to identify the token in the listing of tokens.

   • Expiration date – defines a period during which the token is valid. By default, a token is valid for one year.

   • Permissions – select permissions to associate with the currently created token.

     At least one permission has to be associated with a token.

3. Create the token.

4. Store the created token in a safe location before you proceed. After you close the dialog, the token string cannot be displayed again. 

   Lost personal access token strings cannot be recovered. You will need to revoke the lost token and create a new one.

Schedule maintenance of Xperience Portal projects

Kentico regularly provides updates to Xperience Portal, ensuring the required infrastructure for your projects is always up to date. To ensure the integrity of the update, certain Xperience Portal features become unavailable during the maintenance:

• Deployments application and deployment package upload – the deployment API will respond with 503 Service unavailable
• Channels and Domains applications
• Monitoring → Outages application
• Production site availability may be affected

To minimize the impact on your projects, Tenant administrator and DevOps engineer users can scheduled the maintenance for specific weekdays and timeslots:

1. Open the System -> Update schedule application.
2. Edit schedule.
3. Select the preferred timeslots for the scheduled maintenance.
   • The timeslots are in the UTC time zone.
   • Due to technical limitations, certain timeslots cannot be selected.
4. Confirm the selection.

Your preferred update schedule is now set. Tenant administrators will be notified of any upcoming maintenance in advance via email. A notification bar with the date and time of the scheduled maintenance is displayed in Xperience Portal.