Windows Troubleshooting
Windows Hello Prompt Does Not Appear
Ente Auth uses Windows Hello when an action requires system authentication.
If Ente Auth asks you to authenticate but Windows does not display a security prompt:
- Open Windows Settings → Accounts → Sign-in options.
- Verify that your Windows Hello PIN is configured and works.
- If Windows reports a PIN as configured but it does not work, use the Windows PIN recovery options to reset or recreate it.
- Restart Ente Auth and try again.
HandshakeException During Login
This error usually happens when the Trusted Root certificates on your Windows machine are outdated.
To update the Trusted Root Certificates on Windows, you can use the certutil command. Here are the steps to do so:
Open Command Prompt as Administrator:
- Press
Windows + Xand selectCommand Prompt (Admin)orWindows PowerShell (Admin).
- Press
Run the following command to update the root certificates:
bashcertutil -generateSSTFromWU roots.sstThis command will generate a file named
roots.sstthat contains the latest root certificates from Windows Update.Install the new root certificates:
bashcertutil -addstore -f ROOT roots.sstThis command will add the certificates from the
roots.sstfile to the Trusted Root Certification Authorities store.Clean up: After the installation, you can delete the
roots.sstfile if you no longer need it:bashdel roots.sst
Make sure to restart your application after updating the certificates to ensure the changes take effect.
If the above steps don't resolve the issue, please follow this guide to update your trusted root certicates, and try again.
