Skip to content
DeviceQuest DeviceQuest DeviceQuest Docs User Documentation

Documentation

Invitations and passwords

Accept an invitation to DeviceQuest, choose a password, and reset a forgotten password with a reset link.

Overview

DeviceQuest accounts are created by invitation. An administrator invites you by email from Admin → Users, and you open the link to choose your name and password. If you later forget your password, an administrator sends you a one-time reset link. The pages described here open for anyone with a valid link, without signing in.

Accept an invitation

Your invitation email contains a link of the form https://<your-devicequest-host>/accept-invite/<token>. The link is valid for 7 days.

  1. Join organisation: the organisation you’re joining. Below it, DeviceQuest shows the role you’re invited as and the email address the invitation was sent to. That email becomes your sign-in email.
  2. Your name: the name other people see in DeviceQuest, for example on assignments and comments.
  3. Password: the password you’ll sign in with.
  4. Password checklist: each rule turns green with a ✓ as soon as your password meets it.
  5. Confirm password: type the password again.
  6. Accept invitation: creates your account. While it works, the button reads Setting up your account….
  1. Open the link in your invitation email.
  2. Check the organisation, role and email shown at the top.
  3. In Your name, type your name.
  4. In Password, type a new password. Watch the checklist until every rule shows ✓:
    • At least 12 characters
    • One uppercase letter
    • One lowercase letter
    • One number
    • One special character
  5. In Confirm password, type the same password again.
  6. Click Accept invitation.
  7. Account created appears: Your account is ready. Sign in to continue and complete MFA setup if your role requires it. Click Continue to sign in.
  8. Sign in with your email and new password. If your role requires MFA, DeviceQuest walks you through setting it up.
If someone else is already signed in to DeviceQuest in the same browser, use a private window or sign them out first, then sign in with your new account.

Invitation messages

MessageMeaningWhat to do
Invitation not found: This invitation link is invalid.The link is incomplete or mistyped.Copy the full link from the email, or ask your administrator to send a new one.
Invitation no longer valid: This invitation has expired or has already been used.More than 7 days have passed, the invitation was already accepted, or an administrator revoked it.Ask your administrator to send a new invitation.
Something went wrong: We couldn’t validate this invitation right now.DeviceQuest couldn’t check the invitation.Try again later.
Password does not meet all requirements.A checklist rule is still open.Adjust the password until every rule shows ✓.
Passwords don’t match.Password and Confirm password differ.Type the same password in both fields.
This invitation is no longer valid. Ask your administrator to send a new one.The invitation expired or was revoked while the page was open.Ask your administrator for a new invitation.

Reset a forgotten password

Password resets are administrator-initiated: your administrator sends you a secure, one-time reset link, so every reset is approved by your organisation.

  1. Back to sign in: returns to the sign-in page.
  1. On the sign-in page, click Forgot password?. The Forgot password page explains the process: Reset links expire after 24 hours and can only be used once.
  2. Ask your administrator to send you a reset link. They open your user record under Admin → Users, click Send password reset, and confirm with Send reset email.
  3. Open the link in the email. It has the form https://<your-devicequest-host>/reset-password?token=<token> and is valid for 24 hours, once.
  4. On Set a new password, type your new password in New password. The checklist below the field shows each rule turning green as you meet it: At least 12 characters, One uppercase letter, One lowercase letter, One number, One special character.
  5. Type it again in Confirm password.
  6. Click Reset password. The button reads Resetting… while it works.
  7. Your password was reset. You can sign in now. appears. Click Continue to sign in.

  1. New password: your new password.
  2. Password checklist: each rule turns green as your password meets it.
  3. Confirm password: the same password again.
  4. Reset password: saves the new password.

When the reset completes, DeviceQuest signs your account out everywhere it was signed in, and the link stops working. Your MFA settings stay as they were.

Reset messages

MessageMeaningWhat to do
This reset link is missing its token. Ask your administrator to send you a new one.The link was cut off.Copy the full link from the email, or ask for a new one.
Password does not meet all requirements.A checklist rule is still open.Adjust the password.
Passwords do not match.The two fields differ.Type the same password in both fields.
reset link is invalid or expiredThe link is older than 24 hours or was already used.Ask your administrator for a new link.
password reset failedDeviceQuest had an internal error.Try again in a moment.
Unable to reset password. Please try again.Your browser couldn’t reach DeviceQuest.Check your connection and try again.

Back to sign in under the form returns you to the sign-in page at any time.

Password policy

The same rules apply everywhere you choose a password: at first-run setup, when you accept an invitation, and when you reset your password.

RuleCharacters that count
At least 12 characters
One uppercase letterA–Z
One lowercase lettera–z
One number0–9
One special characterany printable symbol, such as ! # $ % - _ .