Troubleshoot Okta Verify on macOS devices

Learn how to troubleshoot Okta Verify problems on macOS devices and how to report issues.

If your problem persists, contact your help desk.

Note for administrators: Okta Verify for macOS is only available on Okta Identity Engine.

Okta Verify features are available based on configurations made by your organization.

  • How do I report Okta Verify issues?

    • In the menu bar extras, go to Okta Verify > Report Issue. Provide the required information and submit your report. Logged data is included automatically. This data is anonymous and can help Okta troubleshoot your problem.

    See Share diagnostic information with Okta from your macOS device.

  • Can I install Okta Verify on multiple devices and add the same accounts to each installation?

    • Yes. If you want to install Okta Verify on multiple mobile and desktop devices, first install Okta Verify on your mobile device (iOS or Android) and set up multiple authentication factors (for example, Yubikey or SMS), and then install Okta Verify on your macOS device.

  • My Account Details screen has a “Your device or account was invalidated for use on Okta Verify” error. How do I fix this?

    • Your Okta Verify account is no longer valid, so it can no longer be used. If you have the option to re-enroll, re-enroll your account. Otherwise, contact your help desk if you need additional support.

    See Re-enroll an Okta Verify account on macOS devices.

  • How do I disable Touch ID?

    • See Disable Touch ID on macOS devices. Note that if Touch ID is required by your organization, you can’t disable it. Also, if your app requires Touch ID, it might not be accessible if Touch ID is disabled.

  • Why does the Setup Touch ID screen appear when I use a Magic Keyboard with Touch ID for authentication?

    • This is a known issue. It occurs if the Magic Keyboard with Touch ID disconnects from your desktop device during enrollment or authentication. Okta Verify assumes that Touch ID is not set up on the device, so it prompts you to enable Touch ID. To avoid this issue, make sure the Magic Keyboard is correctly connected to the desktop device, the Touch ID sensor is accessible, and that the hardware works as expected.

  • I changed the Touch ID setting on my device. Now, the Sign in with Okta FastPass option still appears in the list of authenticators, but it’s not working. How can I fix this?

    • Disable Touch ID in Okta Verify, and then enable it again.

    See Disable Touch ID on macOS devices, and Enable or update Touch ID on macOS devices.

  • Sometimes I’m not prompted for Touch ID when I try to access a restricted resource through Okta Verify. Why?

    • This a known issue for macOS 11 (Big Sur) and earlier, but Apple has fixed the issue for macOS 12 (Monterey). You can avoid this issue in the future by updating your device to macOS 12 (Monterey). To resolve this issue now, restart Okta Verify.

    See Restart Okta Verify on macOS devices.

  • I was locked out of Touch ID, how do I enable it again?

  • I am unable to access the Google Drive File Stream native app. Why?

    • This is a known issue. As a workaround, click the Sign in with your browser instead link in the lower portion of the page to access the app.

  • How do I delete Okta Verify from my device?

  • I deleted Okta Verify from my device. Can I reinstall it and set up Okta Verify myself without contacting the help desk?

    • If you are able to, install Okta Verify from the Apple App Store and then add an account to register your macOS device. If you don't have an Apple ID or if your laptop is managed by your organization, contact your help desk.