Skip to main content

Login

The Login page is the entry point to priint:suite applications. Depending on the server configuration, users may sign in using a local account (username and password) or through an external identity provider via Single Sign-On (SSO). Both paths lead through the same login window.

For information on how to configure authentication, realms, and available applications, see the AuthService Configuration article.

1 Login Window​

  1. The application logo (for the information about branding see Application Settings ).
  2. The language selector. Clicking it opens a dropdown that lets the user switch the interface language before signing in.
  3. The Sign in with SSO header (only visible when SSO realms are configured). Clicking it expands or collapses the list of SSO provider buttons.
  4. One button per configured SSO realm. Clicking a button redirects the user to the corresponding external identity provider to complete authentication.
  5. The Sign in with account button reveals the local account form (only visible when SSO realms are configured and the local form is not yet shown).
  6. The username and password fields for local account sign-in.
  7. The Sign in button submits the local credentials.

2 Signing in with a Local Account​

When no SSO realms are configured, the login window shows the local account form directly. When realms are configured, the local form is hidden by default and can be revealed by clicking Sign in with account.

To sign in with a local account:

  1. Enter the username in the Login field.
  2. Enter the password in the Password field.
  3. Click Sign in.

If the credentials are incorrect, the input fields are highlighted and an error message is displayed. Correct the values and try again.

3 Signing in with Single Sign-On (SSO)​

When SSO realms are configured by the administrator, a Sign in with SSO section appears at the top of the login form. The section can be expanded or collapsed by clicking the Sign in with SSO header.

Each configured identity provider is shown as a separate button labeled with the realm name. To sign in:

  1. Click the button for the desired identity provider.
  2. The browser redirects to the external identity provider's login page.
  3. After successful authentication with the identity provider, the browser redirects back to priint:suite.

If the user already has an active session with the identity provider, the redirect may complete without requiring any additional credentials.

3.1 App Switcher​

After a successful SSO sign-in, the App Switcher is displayed. It allows the user to choose which application and project to open.

  1. A welcome message showing the authenticated user's name.
  2. The Project dropdown for selecting the priint:suite project (dataset) to work in. If only one project is available, the dropdown is disabled.
  3. The Application dropdown for selecting the target application (e.g. priint:neowise, priint:planner). If only one application is available (e.g. restrictions with access rights or configuration), the dropdown is disabled.
  4. The More options toggle expands an additional section for advanced users.
  5. The Context field (visible after expanding More options) allows passing an optional data context to the target application.
  6. The Get started button opens the selected application. It is enabled only when both a project and an application are selected.
  7. The Use another account link signs out the current SSO session and returns the user to the login form.

The project and application selections are remembered between sessions so that the user does not have to re-select them on the next login.

4 Changing Password​

If the user's account requires a password change before continuing, the Change Password screen is shown automatically after authentication.

  1. A welcome message showing the authenticated user's name.
  2. An information message explaining that a new password must be set before proceeding.
  3. The Password field for entering the new password. An info icon next to the label shows the password requirements when hovered.
  4. The show/hide toggle reveals or conceals the password text.
  5. The Confirm password field for re-entering the new password.
  6. The Next button submits the new password. It is enabled only when both fields are filled in.
  7. The Use another account link signs out and returns the user to the login form.

If the two password entries do not match, or if the new password does not satisfy the configured password rules, an error message is displayed below the form.

After the password is changed successfully, the user is directed to the App Switcher (see section 3.1).

info

Password rules (minimum length, required character types, etc.) are configured on the server side. Hover over the info icon next to the Password (8) field to see the requirements that apply to your installation.