Portal Passkey
Let customers and partners sign in to the portal with biometrics or security keys
The auth_passkey_portal module extends Passkey support to portal users so they can sign in quickly without entering a password every time.
This is especially useful for customers who regularly access orders, invoices, or self-service areas in the portal.
What is Passkey for portal?
Key points
• Allows customers and partners to use Passkey just like internal users.
• Supports fast sign-in with fingerprint, Face ID, Touch ID, or Windows Hello.
• Removes the need to remember passwords while improving security over traditional login.
• Supports multiple passkeys for multiple devices.
Manage passkeys in the portal
Steps
1. Sign in to the portal with the existing account.
2. Open My Account or My Profile.
3. Go to the Security tab to find the Passkeys section.
4. Review the passkey list with Name, Created, Last Used, and Actions columns.
Create a passkey in the portal
Steps
1. In the Security page, click Add Passkey.
2. Give the passkey a clear name such as iPhone, Work Laptop, or Home PC.
3. Confirm on the device using Face ID, Touch ID, fingerprint, or Windows Hello.
4. Finish the setup and verify that the new passkey appears in the list.
Rename and delete passkeys
Key points
• Rename: Click the pencil icon, enter a new label, and save it.
• Delete: Click the trash icon and confirm the removal.
• Keep at least one other passkey or remember the password to avoid being locked out.
Sign in to the portal with a passkey
Steps
1. Open the company portal login page.
2. Click Sign in with a Passkey.
3. Authenticate on the device using biometrics or a security key.
4. Access the portal immediately after successful verification.
Common use cases
Typical scenarios
| Scenario | How to apply it | Benefit |
|---|---|---|
| Frequent portal customer | Create a passkey on the personal phone | Fast sign-in for orders and invoices. |
| Partner working across multiple devices | Create one passkey per device | No need to share or remember multiple passwords. |
| Lost device | Sign in with password or another passkey, then remove the old one | Reduces risk when a device is lost. |
Portal vs internal comparison
Key differences
| Feature | Portal | Internal |
|---|---|---|
| Create passkey | Yes | Yes |
| Rename / delete passkey | Yes | Yes |
| Sign in with passkey | Yes | Yes |
| Manage inside portal | Yes | No |
| Manage inside backend | No | Yes |
System requirements
Supported browsers and devices
| Category | Requirement |
|---|---|
| Browsers | Chrome 67+, Firefox 60+, Safari 13+, Edge 18+ |
| iPhone / iPad | iOS 14+ with Face ID or Touch ID |
| Android | Android 7+ with fingerprint or screen unlock |
| Windows | Windows 10+ with Windows Hello |
| Mac | macOS with Touch ID |
| Connection | HTTPS is required in production; localhost may use HTTP for development |
Troubleshooting
Common issues
| Issue | Cause | Solution |
|---|---|---|
| Passkeys section not visible | Module is not installed or the account is not a portal user | Check auth_passkey_portal installation and account type. |
| Error while creating a passkey | Unsupported browser, no HTTPS, or biometrics not enabled on the device | Use a modern browser, enable HTTPS, and configure biometrics. |
| Cannot sign in with passkey | Passkey was deleted or the wrong portal is being used | Sign in with password, review the passkey list, and create a new one if needed. |