Skip to main content
Skip table of contents

Self-Service Portal

The Self Service Portal is a web-based application allowing users to manage their accounts and perform various tasks independently. This page provides Self-Service Portal's usage guidelines.

To access Self-Service Portal, you log in to:
https://portal.[MY_COMPANY_TENANT_ID].trustbuilder.io/

Update my account information

You can update your account general information:

  1. In the Self-Service Portal, go to My Account > General tab.

  2. Update your account general information.

  3. Click on Save.

Successfully edited your general information.

See my protected applications

You can see your applications protected by TrustBuilder. In the Self-Service Portal, go to Applications. You will see your applications.

Manage my personas

You can see and manage personas assigned to your account.

Set my persona as preferred

  1. In the Self-Service Portal, go to My Account > Personas tab.

  2. Hover the top right of the persona tile to display a star icon.

  3. Click on the star icon to set the persona as preferred.

    persona_set-as-preferred.gif

Your persona is successfully set as preferred. This means that this persona will be used by default at login.

See my persona assignment details

  1. In the Self-Service Portal, go to My Account > Personas tab.

  2. Click on the eye icon.

    image-20240628-133843.png

You can see your persona information related to your assignment.

Delegate my persona

If the "Delegate a persona" feature is not available, this means that it has not been activated at tenant level.

You can delegate your persona to another user for a given period.

  1. Go to My Account > Personas tab.

  2. Click on the eye icon.

  3. Click on Delegate persona at the top right.

    image-20240628-134511.png
  4. Fill the form:

    • To whom? → Enter the e-mail address of the user to whom you are delegating your persona.
      An e-mail will be sent to confirm the persona delegation.

      image-20240628-134819.png
    • How Long? → Define the validity period of your persona delegation.

      image-20240628-134913.png

  5. Click on Save.

The user should now be able to use your persona during the defined period.

Manage security keys

Register a Security key

Prerequisites

  • Compatible browsers:
    (tick) Chrome, Edge, Firefox (latest versions recommended).
    (error) Temporary limitation on Safari: security key registration and authentication are not working.

  1. In the Self-Service portal, go to Security > Security keys > + Add a security key.

  2. On the registration screen, follow the steps:

    1. Click on Register a key.

      image-20241121-101526.png
    2. Enter a name for the new security key.
      It should be unique and cannot contain only spaces. It is limited to 32 characters and supports any characters, including emojis or non-Latin characters.

      image-20241121-103726.png
    3. Follow the instructions in the pop-up window.
      The manipulation differs depending on the type of security key used and the operating system.

  3. Once redirected to the Self-Service portal, check that the security key now appears in the security keys list.

    Fido.png

The security key is successfully registered. It can be used to securely sign-in to protected applications.

Delete a Security key

  1. In the Self-Service portal, go to Security > Security keys.

  2. Click on Delete next to the security key.

    1.png
  3. Confirm the deletion.

The security key is successfully deleted and can no longer be used for login.

Manage my requests

The Self Service Portal includes a "My Work" section that allows you to manage and track requests you have submitted and received. It consists of three tabs: Requests Approval, Requests Follow Up, and Requests History.

Approve or Reject a request

The Requests Approval tab lists all the requests that are awaiting your approval.

image-20240528-140347.png

Here is how to navigate this tab:

  • Search: Enter keywords in the search bar to find requests by their title. This is useful when you have multiple requests and need to locate a specific one quickly.

  • Reject: Reject a request.

  • Accept: Approve a request. On clicking, a confirmation pop-up window appears with more details about the request.

Follow my requests

The Requests Follow Up tab shows all the requests you have submitted with their current status.

image-20240528-142158.png

Here is how to navigate this tab:

  • Search: Enter keywords in the search bar to find requests by their title. This is useful when you have multiple requests and need to locate a specific one quickly.

  • Copy Request ID: Click on the "Copy" button, to copy the request ID. This is useful for referencing the request in communications or for tracking purposes.

  • Delete: Click on the “Delete“ button to delete the request. C’est utile en cas d’erreur

  • View: Click on the “View” button next to a request to see its full details. This includes information such as the request status, creation date, expiration date, and any additional details.

See my requests history

The Requests history tab provides a history of requests over the last month.

image-20240528-142144.png

Here is how to navigate this tab:

  • Search: Enter keywords in the search bar to find requests by their title. This is useful when you have multiple requests and need to locate a specific one quickly.

  • Status: Use the filter option to sort requests based on their current status (e.g., pending, approved, rejected).

  • Copy Request ID: Click on the "Copy" button, to copy the request ID. This is useful for referencing the request in communications or for tracking purposes.

  • View: Click on the “View” button next to a request to see its full details. This includes information such as the request status, creation date, expiration date, and any additional details, initiator, assignee.

Requests list

When a request is created, it gets a pending status.

Request title

Description

Assign a persona

This request is automatically generated when a user, who is assigned to a delegated admin persona or a persona with delegation enabled, assigns a persona to a user.

  • Pending: waiting for user approval or reject. It is the request initial status.

  • Accepted: the user has accepted the request (using the magic link). The request appears in the “Requests history”.

  • Rejected: the user rejected the request. The request appears in the “Requests history”.

  • Failed: an issue occurred. The request cannot be processed.

Activate a persona

This request is automatically created when a user accepts an “Assign a persona” request.

  • Pending: waiting for the user, who is assigned to a delegated admin persona or a persona with delegation enabled, to activate the persona assigned to the user. It is the request initial status.

  • Accepted: the user, who is assigned to a delegated admin persona or a persona with delegation enabled accepted to activate the persona. The persona is now active for the user.

  • Rejected: the user, who is assigned to a delegated admin persona or a persona with delegation enabled refused to activate the persona. The persona is not active for the user.

  • Failed: an issue occurred. The request cannot be processed.

Manage users

You can manage users from your Self-service-portal only if an administrator has assigned to you a persona with delegation enable or a delegated admin persona.

Users overview

In the Self-Service Portal, go to Users. You can see the list of users within your scope.

For each user you can consult user information and manage their personas.

Manage users personas

As a Delegated Admin, you can manage personas for the users in your scope.

  1. Go to Users.

  2. Click the 3 dots of the user to be edited.

  3. Click on View.

  4. Go to Personas tab.

  5. From there you can either:

    • Edit the parameters of the current assigned persona.

    • Add a new persona for this user with the available scopes.
      Make sure to enter valid scopes meaning specified scopes in your delegated admin persona.

  6. Click on Save.

Add a user to your users list

As a Delegated Admin, you can add users in your users list by assigning a persona with your scope to user. This action is subject to approval by the user.

How does it work?

You're going to configure an instance of an existing persona. This persona instance will not be assigned to any user at first. To assign it, you will provide a magic link to a user.

When the user clicks on the magic link, if authenticated by TrustBuilder, he will be able to accept or reject the assignment request. If the user approves, you will have to approve a request to activate the persona.

And that's it, the user will be assigned to the persona and thus appear in your user list.

  1. Go to Users.

  2. Click on Prepare a persona at the top right.

    image-20240301-092407.png
  3. Select a persona among the available personas in the tenant.

  4. Click on Next.

  5. Fill in the persona details. Select the scope values among the available values.

  6. Click on Save.

  7. Copy the magic link and provide it to the user in the secure way of your choice.
    The user can also manage the request from its Self-Service Portal (My work menu > Requests Approval).
    Note that the user must already exist in the TrustBuilder tenant for this to work.

    image-20240301-085735.png
  8. The user should log in to the Self-Service Portal and accept to approve the request.

    image-20240301-085801.png
  9. Go to My work menu > Requests Approval tab.

  10. You should see an “Activate persona” request waiting for your approval. Approve the request.
    If you don’t see it, check the other tabs and search for the relevant “Assign a persona” request:

    • the request is in “Requests follow-up” tab → the user has not yet approved the request.

    • the request is in “Requests history” tab → the request has been rejected by the user or has failed.

You now can manage the user persona. The user should now be able to use this persona.

For the user adding process to work correctly:

  • The user you intend to add must exist in the TrustBuilder tenant,

  • The user must approve the request using the magic link you provided.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.