Skip to main content

Category filter

Configuring Technicians and Roles in Hexnode

Hexnode UEM encompasses the basic to the most advanced device management functionalities under a single console to help administrators during their course of action. Just like how it takes on a different approach to device administration combined with user management, Hexnode also helps organizations distinctly manage the users on Hexnode who administer the devices. Device administrators operating on the Hexnode console are referred to as technicians, and you can have the console managed by multiple technicians.

The technician who signs up for the portal is the Super Admin, who can then create other technicians. As new technicians are created, are assigned technician profiles which determine their role, scope of operation, password requirements and sign-in security settings associated with the technician.

Roles

The role assigned to a technician determines the features the technician can access on the portal. Five roles are available by default – Admin, Reports Manager, Apps and Reports Manager, Incident Manager and Read Only Technician.

  • Admin: Admins have full privileges and access to all the features in the portal.
  • Reports Manager: Reports managers can access only the dashboard, Reports tab and the features there.
  • Apps and Reports Manager: Apps and Reports managers have access to the features in both the Apps and Reports tabs. They can also view the dashboard.
  • Incident Manager: Incident Manager has access to the Incidents tab and the dashboard.
  • Read Only Technician: Read Only Technician has view-only access to all configurations in the Hexnode UEM console, without the ability to make modifications.

Screenshot of the default roles present in the Hexnode UEM console under Technicians and Roles in the Admin tab.

More roles can be defined depending on how the technicians should work with the Hexnode portal.

Create technicians in Hexnode UEM

To create a technician,

  1. On your Hexnode console, navigate to Admin > Technicians and Roles > Technicians.
  2. Click on Add Technician.
  3. You can configure the following account information and settings:

    Screenshot of Hexnode UEM dashboard displaying the technician creation settings under Technicians and Roles.

    Account Information

    1. Enter the first and last name of the technician.
    2. Choose the Login identity (Email/UPN).
      • If Email is selected, enter the email address of the technician.
      • If UPN is selected, enter the technician’s User Principal Name (UPN) and their communication email.
    3. Enter the Phone number of the technician.
    4. Specify the name of the organization where the technician belongs.
    5. Under Assign Profile, choose a technician profile. The technician profile contains the pre-configured settings that define sign-in and security behavior, role, scope and password policy for the technician.
    6. Click Save.

    Setting up Technician Account

    Creating a technician account will send an email invitation link to the given email ID. The link will automatically expire in a day or if it is used once. The technicians can activate the account by clicking on the Setup account in the email invitation.
    set up a technician account from the invitation link
    Next, the technician will be asked to set up a local password for the account or sign in with Google, Microsoft, or Okta (when SSO login is enabled).

    Note:

    • Suppose the new technician tries to log in to the portal using Google, Microsoft or Okta authentication without setting up login via the email activation link. In that case, a message will be displayed asking them to set up signing in.
    • Click on Sign in with Okta to log in to your Hexnode account via Okta. You will be asked to enter your email. Enter the email and click on Submit; this will redirect you to the Okta sign-in page to authenticate your Okta credentials.

    The next step is to enable two-factor authentication. To set up the authenticator app for 2FA,

    1. Install the Google Authenticator or Microsoft Authenticator app on your device.
    2. Open the authenticator app on your device and scan the QR code shown or enter the code displayed on the login page.
    3. Navigate to your Hexnode portal and log in with the local/SSO account credentials.
    4. Enter the verification code generated by the app on the portal for successful app setup.

    Note:

    • Hexnode UEM restricts the technician to only log in on a single machine or browser at a time.
    • If a technician proceeds to log in to the Hexnode portal that is already logged in from a different browser or machine, the technician will be prompted to log in by terminating the currently active session.

    Managing Existing Technicians

    Edit Technician

    An admin or super admin can log in to their technician account to edit the settings or information for themselves or other technicians.

    1. Go to Admin > Technicians and Roles > Technicians.
    2. Click on the more icon and select View Technician corresponding to the technician you want to edit.
    3. Click on Edit on the Technician Overview page.
    4. Under the Account Information section, , you can edit all the fields other than Login identity. Under the Assign Profile, you can choose a new technician profile to assign to the technician.
    5. Note:

      1. A technician editing its own Account Information details can add an image as the profile image. The supported file formats are jpeg, png, svg, bmp, and jps.
      2. Admins can’t change their own Username/Email, and organization name, but they can reconfigure the authenticator app if their phone is lost or changed. For other technicians, they can modify the profile details except Username/Email and SSO login methods.
        Super admins also can’t change a technician’s Username/Email but can update their organization name, role, SSO login methods, and the 2FA settings.
      3. An admin cannot change its Username/Email, organization name, Role, SSO login methods and the 2FA settings that are previously enabled. However, an admin can reconfigure the authenticator app by self-editing their details if their phone is lost or is changed.
      4. If the Username/Email is changed, the given technician will be immediately logged out. They will be asked to reconfigure the authenticator app as it is linked to the previous email.
      5. Suppose the login method for Single Sign On previously set up for the technician is disabled or allowed SSO logins are modified. In that case, the technician will need to use the local credentials to log in or set up SSO login again for the newly selected login option. An email with an SSO reset link will be automatically sent to the technician.
      6. You can reconfigure the authenticator app under the Two Factor Authentication settings by clicking on the Reconfigure Authenticator app. A technician who has lost their device, uninstalled the Authenticator app, or wants to reconfigure the authenticator app on another device, can edit these details to reconfigure the app on a new device. A new QR Code will be displayed on the screen, and the technician can scan this code to set up the authenticator app.

      Reconfiguring the Authenticator App for a technician

    6. On the Roles sub-tab, you can assign a different role to the technician. You may also define the scope if you are assigning a custom-created role. Learn more on custom technician roles.

    For an Admin or Super Admin to resend the account activation link of another technician,

    1. Go to Admin > Technicians.
    2. Click on the more icon and select Resend account activation link corresponding to the required user.

    It will resend the activation link to the technician’s email account. This option will not be available once the technician sets up their Hexnode account.

    Reset Password

    If an Admin or Super Admin wants to reset the password of another technician,

    1. Go to Admin > Technicians.
    2. Click on the more icon and select Reset Password corresponding to the technician whose password you want to reset.
    3. Click on Proceed.

    A password reset link will be sent to the technician at the specified email ID. The email will expire in a day. The technician has to set up a new password using this link to sign in. The technician will be blocked from logging in to the portal until he uses the password reset link to set up a new password.

    Note:


    If a technician wants to reset their local password, use the Change Password option (Click on the user icon at the top-right corner of the portal and choose the option Change Password). The technician will be asked to enter the old password, provide a new password and verify it.

    Reset SSO

    A super admin and an admin can reset his own or other technician’s SSO accounts using this option.

    1. Go to Admin > Technicians.
    2. Click on the more icon and select Reset SSO corresponding to the required technician.
    3. A confirmation dialog box stating that an email will be sent to the technicians to reset the SSO account will be displayed. Click on Yes.
    4. Complete the user authentication to confirm the process.

    Deactivate Technician

    A technician can be deactivated without removing their account from the portal. Likewise, an Admin can deactivate the account of other technicians except for a Super Admin. To deactivate a technician:

    1. Go to Admin > Technicians and Roles.
    2. Among the list of technicians, disable the toggle button corresponding to the technician whose account is to be deactivated.
    3. Complete user authentication to confirm the deactivation process.
    Note:

    If the technician has a currently active session, he will receive a session expiry prompt once the account deactivation is initiated. Any further sign-in from the deactivated account raises an error message ‘User is inactive! Please contact your administrator’ on the login window.


    A deactivated technician account can be activated by re-enabling the toggle button and completing the user authentication.

    Delete Technician

    If an admin or a super admin wants to delete a technician,

    1. Go to Admin > Technicians and Roles.
    2. Click on the more icon and select Delete Technician corresponding to the technician name.
    3. Click on Yes.
    4. Complete the user authentication and confirm the deletion process.
    Note:


    Suppose an SSO logged-in technician has disabled the pop-up notification for the Hexnode portal on the device browser, the Hexnode actions that enforce technician authentication cannot be completed.

    Since the SSO logged-in technicians are redirected to the Google/Microsoft/Okta authentication page in a new tab for authentication, disabling pop-up notifications for the Hexnode portal will block the authentication. So, actions like device wipe, edit technician, etc., that require technician authentication cannot be completed.

    Change Super Admin

    If the Super Admin wants to transfer their role to a new technician or promote an admin to Super Admin, follow the steps below.

    To make a new technician the Super Admin

    1. Go to Admin > Technicians and Roles.
    2. Click the more icon next to the Super Admin’s name and select Change Super Admin.
    3. Use the Change Super Admin action to create a technician with the Super Admin role in MDM

    4. Enter the required details for the new technician and click Save.
    5. The existing Super Admin must authenticate using their password to complete the process.

    Until the invitation is accepted, the existing Super Admin will retain the role. Once the new technician accepts the email invitation, the existing Super Admin will be logged out and downgraded to an Admin on the next login.

    The invited technician appears in the list of technicians with an hourglass icon corresponding to the name. The Super Admin can click the more icon beside the entry to resend the account activation link (if it has expired) or delete the technician if the decision is reconsidered.

    To promote an existing admin to Super Admin

    1. Go to Admin > Technicians and Roles.
    2. Click the more icon next to the name of the admin you want to promote and select Upgrade to Super Admin.
    3. Use the Upgrade to Super Admin action to promote a technician with the Admin role to Super Admin in MDM

    4. Click Continue and authenticate with your password.

    Completing this action will demote the existing Super Admin to an Admin role, as only one Super Admin is allowed. The session will be logged out to enforce the role change. After logging back in, the role will be updated to Admin.

    Limiting the number of technicians as per the pricing plan

    The number of technicians that can be configured depends on the pricing plan you have subscribed to.

    For the Pro plan,

    • Two technicians are available by default.
    • The primary technician is Super Admin, and the other technician is Admin. No other technician roles are available.
    • More technicians can be purchased from the portal. They will be assigned the role of Admin.
    • The CAPTCHA limit for failed technician login is set to the default value 3.
    • Includes two-factor authentication for technician login.

    For the Enterprise plan,

    • Three technicians are included in this pricing plan.
    • The primary technician is Super Admin. Other technicians, including the additional technicians purchased from the portal, can be assigned with any of the roles, Admin, Reports Manager or Apps and Reports Manager.
    • The CAPTCHA limit for failed technician login can be customized.
    • Includes two-factor authentication for technician login.

    For the Ultimate plan,

    • There are four technicians included by default.
    • The primary technician is Super Admin. The other technicians, including the additional technicians purchased from the portal, can be assigned with any of the roles, Admin, Reports Manager or Apps and Reports Manager. Also, you could manage access to the various tabs on the Hexnode portal for a custom role assigned to a technician and define the access scope individually.
    • The CAPTCHA limit for failed technician logins can be customized.
    • Includes two-factor authentication for technician login.
    • Technician SSO login using Google, Microsoft and Okta is also included.

    For the Ultra plan,

    • Five technicians are available by default.
    • The primary technician is Super Admin. The other technicians, including the additional technicians purchased from the portal, can be assigned with any of the roles, Admin, Reports Manager, Apps and Reports Manager, Incident Manager, and Read Only Technician. Additionally, technicians can be assigned custom roles. You may also set granular level permissions for sub-tabs within each tab for a custom role assigned to a technician and define access scope.
    • The CAPTCHA limit for failed technician logins can be customized.
    • Includes two-factor authentication for technician login.
    • Technician SSO login using Google, Microsoft and Okta is also included.

    When the number of active technicians reaches the maximum limit allocated to each plan, you have to either deactivate or delete any active technicians or upgrade your pricing plan to add new technicians. You can also purchase additional technicians if and when required via the License tab in Admin. The cost for an additional technician is as follows:

    • Annual subscription – $324/year per technician
    • Monthly subscription – $30/month per technician
    Note:


    Only those technicians assigned the roles, Super Admin or Admin, can access the subscription page. The subscription page appears when you navigate to Admin > License > Subscribe to change the pricing plan.

Frequently Asked Questions

Q: How long is the verification code sent during two-factor authentication valid?

A: The verification code sent to your email or phone number is valid for 3 minutes, but you must request a new one if it expires, has already been used, or is entered incorrectly three times.

Q: Which verification method takes priority if both email/SMS and an authenticator app are set up?

A: By default, during the technician authentication process the system will ask to enter the authenticator app code or one of the recovery codes generated while setting up the app. If you prefer to log in using the email or text message code instead, click Try another way displayed on the pop-up wizard shown during authentication.

Q: When does a technician session completely expire?

A: Regardless of the inactivity timeout configured in the technician profile, all technician sessions will automatically expire after 4 days.

Q: What happens to existing technicians when downgrading from a higher pricing plan to a lower one?

A: When you downgrade from a higher pricing plan to a lower one, not all technicians in the initial plan can be availed in the new plan unless the technician slots are additionally purchased. Consequently, while downgrading the plan, additional technicians will get automatically added as Add-ons on the subscription page. Therefore, you should either deactivate or delete the technicians from there if you do not wish to retain the additional technicians.

Q: Can technicians with roles other than Super Admin and Admin access the subscription page via the user icon?

A: No. Technicians except for the Super Admin and Admin cannot access the subscription page from the Billing option, which appears while clicking on the user icon displayed on the top-right of the portal.

Technicians