Team: Huntress Dashboard
Product: Huntress Dashboard
Summary: The Huntress partner portal lets you add an unlimited number of users at the account or organization level, each with their own permissions.
Huntress allows you to have an unlimited number of user accounts at no additional cost. You can add users at the account level or the organization level.
Users added at the account level can view and manage all organizations under the account.
Users added at the organization level can only view and manage the specific organization(s) the user is assigned to.
Note: Only account-level users can view the Account Key and installer, which are used to deploy the Huntress agent. This helps prevent unauthorized agent installs, since the account is responsible for billing.
2 Adding Organization-level Users
Adding Account-level Users
To add a user at the account level:
- In the Huntress partner portal, open the hamburger menu and select Users, or click Users in the top navigation bar.
- On the Users page, select + Add.
- Enter the user's details and select the appropriate role.
- The user will now appear in the Pending Users page and receive an Invitation Email to set up their account.
For details on user privileges, see User Permissions.
Adding Organization-level Users
To add a user at the organization level, first select the specific organization, then follow a similar process.
- Use the organization selector in the top-left corner of the portal to choose the desired organization.
- Once you are in the desired organization, click Users in the navigation bar or open the 3-bar hamburger menu and select Users.
- On the Users page, select + Add.
- Enter the user's details and select the appropriate role. The user will now appear on the Pending Users page at the organization level and receive an Invitation Email to set up their account.
For details on user privileges, see User Permissions.
Invitation email
When you add a new user, Huntress sends an invitation email to the address you specify. The new user will click the Review Invitation button in that email to set up their account and password.
The invitation email is sent from noreply@huntress.io with the subject line: "<Full Name>, you've been invited to join Huntress." If the user does not receive the email, ask them to:
- Check their spam or junk folder.
- Ensure that noreply@huntress.io is allowed in their email security tools.
If the invitation still does not arrive or you have questions, please open a ticket with Huntress Support.
Invitation Workflow
- Select the Review Invitation button from the invitation email.
- On the next screen, you will create a password and download and accept the end-user license agreement. All new users will need to create a password, even if SSO is configured.
- After selecting Accept & Continue, you will have officially accepted the Invitation. The following steps will walk through Multi-Factor Authentication (MFA) setup.
- Huntress uses authentication apps for MFA. Some examples include Google Authenticator, Microsoft Authenticator, and Duo. Scan the QR code in your app, then enter the code. Select Next.
- Lastly, save your backup codes (you can always reset these later in your preferences). The last page will give you the option to enter the Huntress Dashboard.
Pending users
You can view users whose portal invitations are still pending on the Users page. This helps you confirm who has not yet completed their account setup.
Pending User Actions
- Edit Invitation - Updates a recipient's permission level before they accept.
- Re-send - Moves the invitation to the top of the recipient’s inbox for easier access.
- Delete - Removes stale links or unwanted invitations. Users who interact with the invitation email after deletion will receive an "Invitation no longer exists" page.
Troubleshooting
The invitation redirects to the Huntress login page without a password creation step.
Please open the "Review Invitation" button using a private/incognito browser. If you are still redirected to a login page without being prompted to create a password, this generally indicates that there is an existing user record associated with the email address.
- If you are an active user in another Huntress account, please follow the invitation email and log in with your existing credentials. After signing in, your user record will be associated with both Huntress accounts. If you are unable to get past MFA, please see our Resetting your MFA article.
- If you had an account in the past, it's possible a user record is still in the system. Please contact Support so that they can check for any existing records and assist with troubleshooting.
One-time “Magic Link” is not being sent.
One-time Magic links are for users who have never completed password setup. This one-time link is typically used during initial onboarding or new trials. If you have previously set a password or have been invited as a new user, you are likely not eligible to receive the link. Please follow the steps below after opening the invitation email:
- For existing account users: Please sign in with your existing credentials.
- For new users: Please follow the instructions in the invitation email to set up your password and MFA.
“Unable to find SAML configuration for user” Error.
Configuring SAML Single Sign-on (SSO) does not automatically create Huntress users. You will need to manually invite each user to Huntress before they sign in through SSO, and confirm that they accept their Huntress invitation. Pending Users will not be able to use SSO.
For more information, please review our SAML SSO documentation.
"Cannot be added to an account with incompatible SSO enabled" Error.
This error will appear if the user record is associated with another Huntress account that has an incompatible Sign-on (SSO) configuration. Users who belong to multiple Huntress accounts cannot use SSO unless all accounts share the same configuration. For more information, please review our SAML SSO documentation.
- If the user needs access to multiple accounts, align the SSO configurations when possible or consider using an email alias for the secondary account.
- If the user no longer needs access to the other account, an administrator for that account can remove the user’s membership to resolve the conflict.
The invitation no longer exists.
If you receive this message, the invitation may have already been accepted by the user or deleted by an administrator via the Huntress portal.