Smart Card on iOS Troubleshooting

Running into issues using the Smart Card on iOS feature? Check the guidance below for possible solutions.

Web browser does not trigger the Yubico Authenticator application

Problem: when trying to authenticate to a website, the browser does not trigger the Yubico Authenticator application, and the pop-up that allows you to complete your authentication request does not appear. You may have received a timeout error or a message about an inability to create a secure connection.

Solution: iOS Focus modes, such as Do Not Disturb, Sleep, Personal, and Work, suppress notifications, including the Yubico Authenticator pop-up. If you have a Focus mode turned on, you will see the mode’s symbol on your lock screen (e.g. Do Not Disturb uses a moon symbol). To use the Smart Card on iOS feature with Yubico Authenticator, you must turn off all focus modes or add Yubico Authenticator as an Allowed Notification for each mode.

Toggle Focus modes off

To toggle your Focus modes off, do the following:

Open your Control Center.
Select the Focus icon and toggle all modes to the off position.

Add Yubico Authenticator as an allowed notification

If your device is running iOS/iPadOS 15 or higher, and you would like to keep your Focus modes on while using the Smart Card on iOS feature, you may instead add Yubico Authenticator as an Allowed Notification.

Go to Settings > Focus.
Click on each Focus mode (Do Not Disturb, Personal, Sleep, and Work), select Allowed Notifications, and choose the Yubico Authenticator application.

S/MIME decryption or signing fails

Problem: when trying to perform S/MIME decryption or signing, the operation fails outright or the email is sent without the correct signature applied.

Possible causes and solutions:

Your mail client does not support the feature.
- Check the Supported mail clients table to verify feature support.
You did not configure your mail client correctly.
- The S/MIME functionality in your mail client may not have been enabled or the wrong certificate was selected for signing/decryption operations in your app settings. Refer back to the Configure Your Mail Client for Digital Signatures and/or Decryption chapter to verify that you have completed the correct configuration steps for your specific mail client.
The certificate with the public key has not been provisioned to the iOS Keychain and/or the accompanying private key is not on your YubiKey.
- See Import a Certificate and Private Key onto Your YubiKey and Provision Your Certificate onto Your iOS Keychain for more information on these processes.

To file a support ticket with Yubico, click Support.