Documentation Index

Fetch the complete documentation index at: https://help.maestra.io/llms.txt

Use this file to discover all available pages before exploring further.

If you use SSO (Single Sign-On) and enforced login is enabled, passkey authentication is not required.

​

Managing Passkeys: Owner/Admin Guide

To manage passkeys, you need the View user settings and Edit users permissions. By default, these permissions are granted to project owners and administrators. If needed, you can assign them to other team members. Owners, administrators, and any staff members with the above permissions can:

• View which users have passkeys set up.
• Send an email to create a new passkey for users who’ve lost access or need an additional passkey for another device.
• Reset existing passkeys.

​

How to send a setup email to a new user

You can add new users manually or via import. After adding them, go to the staff editing page and click Send new passkey. The user will receive an email with a link to set up their passkey.

​

How to set up an additional passkey for a user

A user may need an additional passkey if they access Maestra from multiple devices that cannot share the same passkey. For example, when one is stored locally in Windows Hello or Google Password Manager under a corporate account. To set up an additional passkey:

1. Go to Settings → Security → Users.
2. Open the user’s profile.
3. Click Send new passkey.

​

Helping users with passkey issues

If a user reports that:

• Their password manager has changed, but the passkeys weren’t transferred.
• They lost the device on which their passkey was set up.
• A passkey has been compromised.

follow these steps:

1. Go to Settings → Security → Users.
2. Open the user’s profile.
3. Click Reset keys.
4. Send a new key.

​

Passkey Setup: From Email Invitation to Sign-In

​

New users

Once the project owner creates your profile, you’ll receive an email with a link to set up your access.

1. Follow the link from the email. ​
2. In the window that opens, click Set up. ​​
3. Choose where to store your passkey:

Using iCloud Keychain

It is available for selection in the system window when setting up the passkey on Apple devices.

Once configured, you can access the project from any Apple device that is logged into your iCloud account.

1. In the system window, select “iCloud Keychain.”

2. Confirm saving the passkey in the keychain.

Using Apple or Android mobile phone

This option is available in the system window of your browser if it supports passkeys and your device supports Bluetooth.

After setting up your passkey, access the project by scanning the QR code and confirming your login with the passkey on your phone. Use your mobile phone camera (Apple or Android) to scan the QR code. To set up the access key on a Macbook, follow these steps:

1. In the system window, select “Use a phone, tablet, or security key.”

2. Use your device’s camera to scan the QR code and save the security key for logging in.If your phone cannot read the QR code, use authentication apps to save the passkey. For example, Google Authenticator or Microsoft Authenticator. 3. Follow the instructions on your phone after scanning the QR code. To set up the passkey on a Windows computer, follow these steps:

1. In the system window, select “Iphone, Ipad or Android device”. ​
2. Use your device’s camera to scan the QR code and save the passkey for logging in.

If your phone cannot read the QR code, use authentication apps to save the access key. For example, Google Authenticator or Microsoft Authenticator. 3. Follow the instructions on your phone after scanning the QR code.

If the system prompts you to insert a security key into the USB port but does not show you how to save the key using your phone, follow these steps:

1. Make sure your device supports Bluetooth, and that it is turned on on both your phone and computer during setup.
2. If Bluetooth was turned off, turn it on and refresh the page to start setting up the keys again. When the system window appears asking if you want to continue with USB port, click “Cancel”. ​ 3. After that, the system may offer other ways to save the security key. Select “Iphone, Ipad or Android device”. ​

If the above method does not work and the system does not offer any options except for a USB key, please contact Maestra Support.

Using Google Password Manager

It is available for selection in the system window of the Chrome browser. To save the passkey, you need to be authorized in your Google account.

Once configured, you can access the project from any device logged into your Google account. If you need to access the project from a device that does not have access to your Google account, you can use QR login with your phone, which must be logged into your Google account. When logging in, select the “Use a phone, tablet, or security key” option, scan the QR code, and confirm the use of the key saved in Google Password Manager. This method is available only if your device supports Bluetooth.

1. In the system window, select “Google Password Manager”
2. Save the passkey in your Google account.

Using Chrome profile

This option is available for selection in the system window of the Chrome browser.

The passkey is stored locally in the current Chrome profile on the device and is not synchronized. Therefore, logging into the project with this key will not be possible from other devices or browsers.

1. In the system window, select “Your Chrome profile”
2. Save the access key in your profile.

3. To complete saving your passkey, confirm your identity with your PIN, fingerprint, or Face ID.

Using Windows Hello

Available for selection in the system window on Windows computers that have PIN or fingerprint sign-in enabled.

The passkey will be stored locally on your Windows device. If you use multiple devices under the same Microsoft account, the passkey will sync across them.

1. In the system window, select “Windows Hello or external security key.” ​
2. Verify your identity by entering your PIN or scanning your fingerprint.

If the system asks you to insert a security key into a USB port and doesn’t display the option to store the passkey using Windows Hello: ​

1. Make sure your computer has PIN or fingerprint sign-in enabled. If not, change your sign-in method accordingly.
2. After enabling PIN or fingerprint login, refresh the page and start the passkey setup process again. When prompted to insert a USB security key, click “Cancel”. ​ After that, the system should offer alternative storage options. Select “Windows Hello or external security key”. ​

If the steps above don’t resolve the issue and the system still only offers a USB key option, please contact Maestra Support.

Using Bitwarden Password Manager

In this section, we’ll look at how to store your passkey in the Bitwarden password manager. You can also use other password managers, such as 1Password, Dashlane and others.

1. Register an account on the Bitwarden website.
2. Sign in to your Bitwarden account and install the browser extension. ​
3. Complete the extension setup following Bitwarden’s instructions.
4. Go to the Maestra passkey setup page and click “Set up”. ​
5. The Bitwarden extension will automatically prompt you to save your passkey. Click “Save passkey as new login”. ​ To sign in using the passkey stored in Bitwarden:

• Enter your username or email.
• Confirm authentication by selecting the appropriate passkey. ​

4. That’s it — passkey saved.

​

Existing users

The system will prompt existing users to set up a passkey during their next login to Maestra. Follow the same setup steps described above, starting from step 2. If needed, you can postpone the setup and return to it later.

​

How to set up passkeys on a new device

• If your passkey is stored in a password manager or iCloud Keychain: Log in to your account on the a device — the passkey will sync automatically.
• If your passkey is linked to a specific device: Contact the project owner or administrator to generate an additional passkey for a new device.

​

How to log into Maestra using a passkey

1. Enter your email or username on the login page.

2. Confirm your identity using your passkey. ​