macOS Error Codes
This page lists all the possible errors returned by HYPR Passwordless for macOS.
Code Prefixes
HYPR Passwordless for macOS error codes begin with 14.
Some of the defined ranges of errors are linked here. The easiest way to find an error is still just to search the page.
| Error Prefixes by Component | |
|---|---|
| 1410xxx General | 1420xxx-1450xxx Reg/Auth |
| 1460xxx HYPRspeed | 1470xxx General |
HYPR Passwordless for Mac
| Code | Error | Cause and Resolution |
|---|---|---|
| Back to Top | General Error Codes (1410xxx) | |
| 1410001 | kHyprGeneralError General failure. Something went wrong with that request. Please try again, or contact Support if this keeps happening. | This error indicates that the workstation client experienced an general error. What to do? When encountering this error, you will often be presented information for troubleshooting inline with the error. Generally retrying the pairing process will resolve itself. If this does not work, ask the user to reboot their workstation. |
| 1410002 | kHyprSecureEndpointError General failure. Failed to register the workstation with the server. Obtain a new install token and reinstall the product. | This error indicates that the install token specified at installation time is not valid for this workstation What to do? 1. Check that the token has been inserted correctly and hasn't been revoked 2. If the error persist, obtain a new token from your system administrator and retry |
| Back to Top | Registration / Authentication Error Codes | |
| 1420001 | kHyprRegistrationPendingError Registration failed. We're already waiting for a device to finish registering for this account, please try again in a minute. | This error indicates that the workstation client experienced a network error and a new attempt has been started. What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for pending requests to complete. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1420002 | kHyprSetupClientTimeoutError Registration failed. Something went wrong with that request. Check that you are connected to the internet, then try again. | This error indicates that the workstation client experienced a network error during new device pairing. What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for any pending request or network instability to resolve. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1420003 | kHyprRegistrationTimeoutError Registration failed. Something went wrong with that request. Check that you are connected to the internet, then try again. | This error indicates that the request has timed out. This may be the result of a registration taking longer than the allowed duration, or the failure to receive a response from the server during a step in the pairing process. What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for pending requests to complete. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1420004 | kHyprRegistrationGenericError Registration failed. Something went wrong during device registration. Try again, or contact support if this keeps happening. | This error indicates that device pairing failed. This may happen for a number of reasons with the most common cause due to instability in the network connection at a critical step in the process. What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for pending requests to complete. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1420005 | kHyprDeregistrationGenericError Operation failed. Something went wrong unpairing your device. Please try again. | This error indicates that device unpairing failed. This may happen for a number of reasons with the most common cause due to instability in the network connection at a critical step in the process. What to do? 1. Wait 2 minutes and then proceed to unpair once again. This may allow enough time for pending requests to complete. 2. If the issue persists, reboot the computer and try to unpair. This may ensure the computer did not reach an error state. |
| 1420006 | kHyprRegistrationCertificateError Registration failed. Something went wrong during the creation of the authentication certificate. Check that you are connected to the internet, then try again. | This error indicates that the certificate to be associated with the user could not be generated or installed in the system. This may happen for a number of reasons, including instability in the network connection with the domain controller What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for any pending request or network instability to resolve. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1420007 | kHyprRegistrationCANotFoundError Registration failed. Something went wrong trying to identify the Certification Authority server. Check that you are connected to the domain, then try again. | This error indicates that the MacOS LDAP repository didn't have an entry for the Certification Authority for the current user. What to do? 1. Using Directory Utility, check that the LDAP configuration has an entry in the CertificateAuthorities section of the node /Active Directory/DOMAIN/All Domains. 2. If the issue persists, try re-joining the domain. |
| 1420008 | kHyprRegistrationInvalidKerberosUserError Registration failed. The Kerberos user name isn't in the expected format. Check that you are connected to the domain, then try again. | This error indicates that the Kerberos username isn't in the format user@fully.qualified.domain.name. What to do? 1. Check that the Kerberos name of the user (e.g., by running klist) is in the form user@domain.address. 2. If the issue persists, try re-joining the domain. |
| 1420009 | kHyprRegistrationCANotReachableError Registration failed. Something went wrong trying to contact the Certification Authority server. Check that you are connected to the Internet, then try again. | This error indicates a problem trying to contact the Certification Authority server(s) What to do? 1. Check the network connectivity with the server hosting the domain controller. 2. If the issue persists, an admin may analyze HyprUnlock log for more information to troubleshoot the network configuration. |
| 1420010 | kHyprRegistrationCANotAuthorizedError Registration failed. The Certification Authority server refused to issue the certificate. Check that you are authorized to request certificates, then try again. | This error indicates an authentication problem trying to contact the Certification Authority server(s). What to do? 1. Check the network connectivity with the server hosting the domain controller. 2. If the issue persists, an admin may analyze HyprUnlock log for more information to troubleshoot the network configuration. |
| 1420011 | kHyprRegistrationCAInvalidCertificateTemplateError Registration failed. The Certification Authority server didn't accept the certificate template. Check the configuration, then try again. | This error indicates that the certificate template specified in the configuration file is not valid. What to do? 1. Check that the CertificateTemplate setting in the HYPR Passwordless client application references a certificate template that the domain controller has published and that is readable by the user. 2. If the issue persists, an admin may analyze HyprUnlock log for more information to troubleshoot the network configuration. |
| 1420012 | kHyprRegistrationCAFailureError Registration failed. The Certification Authority server failed to issue the certificate. Check the logs on the server for the underlying reason, then try again. | This error indicates that the Certification Authority server could not complete the operation. What to do? 1. Check the logs in the domain controller; if the certificate has been issued but it's waiting for approval, ensure the configuration is changed so that the certificates are immediately issued when requested. 2. Perform the necessary changes to the server configuration. |
| 1420013 | kHyprRegistrationCATimeSkewError Registration failed. The Certification Authority reported that the clock of the computer is not aligned with the clock on the server. Check the clock, then try again. | This error indicates that the clock of the computer is not synchronized with the clock of the Certification Authority server. What to do? Verify the date and time settings on the domain controller and adjust the clock on the client computer so that it is aligned with it, then retry the operation. |
| 1420014 | kHyprRegistrationInvalidCertificateError Registration failed. Failed to import the certificate issued by the Certification Authority server. Check the encryption scheme of the template, then try again. | This error indicates that the certificate issued by the Certification Authority could not be imported locally. What to do? Verify that the certificate template defined on the domain controller is using the RSA cipher with 2048 bits. |
| 1420015 | kHyprRegistrationCATicketExpiredError Registration failed. The user's Kerberos ticket has expired. Renew it, then try again. | This error indicate that the Kerberos ticket of the user has expired. What to do? 1. Renew the ticket by using the `kinit` utility. 2. Retry the operation. |
| 1420016 | kHyprRegistrationQRFallbackNotEnabledError QR Fallback Authentication is not enabled. | What to do? Verify you are logging into the correct application, and try again. If the issue persists, verify with an administrator or Support that the application in question is using QR Fallback. |
| 1430001 | kHyprRegistrationPasswordError Registration failed. The password you entered is incorrect. | This error indicates that the user was unable to authenticate during the pairing process. Users are asked to enter in their password one last time during pairing to ensure that the person pairing is the individual who logged into the workstation. What to do? 1. Wait 2 minutes and then proceed to pair once again. During the authentication step, enter your credential slowly and carefully. 2. If the issue persists, reboot the computer and try to pair. This may ensure the computer did not reach an error state. |
| 1430002 | kHyprDeregistrationPasswordError Deregistration failed. The password you entered is incorrect. | This error indicates that device unpairing failed. This may happen for a number of reasons with the most common cause due to instability in the network connection at a critical step in the process. What to do? 1. Wait 2 minutes and then proceed to unpair once again. This may allow enough time for pending requests to complete. 2. If the issue persists, reboot the computer and try to unpair. This may ensure the computer did not reach an error state. |
| 1430003 | kHyprRegistrationSmartCardTokenError Unable to complete certificate binding. | This error indicates that the user most likely didn't enter her password when requested by MacOS when binding the user to the certificate. Ensure to enter the user password when requested by the system dialog with the yellow smartcard chip icon. |
| 1440001 | kHyprRegistrationCancelledError Registration failed. You cancelled the registration process so this device was not set up. | This error indicates that the user canceled the pairing process when asked to confirm their authorization with their current password. What to do? 1. Wait 2 minutes and then proceed to pair once again. This may allow enough time for pending requests to complete. 2. During the step where a prompt appears, do not dismiss it. 3. Enter your credentials to complete pairing. |
| 1450001 | kHyprAuthenticationGenericError General Authentication Error. | This error indicates that the workstation client experienced an error while unlocking the user. What to do? Wait 2 minutes and then proceed to authenticate again. If this does not resolve the issue, try a reboot and see if the issue persists. |
| Back to Top | HYPRspeed (Desktop SSO) Error Codes (1460xxx) | |
| 1460001 | kHyprDesktopSSOGenericError Desktop SSO failed. Unable to authenticate on web site. | An attempt to login on a web site using the same session used on the workstation (Desktop SSO) was denied by the server What to do? 1. Ensure that you authenticated on the workstation using HYPR 2. If the error persist, contact support |
| 1460002 | kHyprDesktopSSOConfigurationDisabledError Desktop SSO failed. Feature has not been enabled. | Desktop SSO isn't turned on for this HYPR server. |
| 1460003 | kHyprDesktopSSOConfigurationSecureEndpointError Desktop SSO failed. Secure Endpoint has not been enabled. | Secure Endpoint Protection is not enabled on the workstation. |
| 1460004 | kHyprDesktopSSOBadRequestError Desktop SSO failed. SSO request is not valid. | The arguments of the request don't match the settings of the workstation. |
| 1460005 | kHyprDesktopSSOMissingToken Desktop SSO failed. You must be authenticated with HYPR in order to use Desktop SSO. | An attempt to login on a web site using the same session used on the workstation (Desktop SSO) failed because there is no active session. 1. Lock the workstation and unlock it using HYPR. 2. If the error persists, contact Support. |
| 1460006 | kHyprDesktopSSOCryptoError Failed to sign SSO challenge. | The crypto operations required by DesktopSSO could not be performed. Contact Support. |
| Back to Top | General Error Codes (1470xxx) | |
| 1470001 | kHyprGeneralNetworkError Operation failed. Something went wrong with that request. Check that you are connected to the Internet, then try again. | This error indicates that the workstation client experienced an issue with the network. What to do? 1. Check that the user is on a secure network (office or VPN) before pairing. This will ensure the user is ready to begin pairing. 2. Validate that the user can open a webpage that is not cached and will successfully load on their workstation. Then have the user try to pair with HYPR. 3. If the issue persists, an admin may analyze HYPROneService log for more information and escalate as needed. |
| 1470002 | kHyprGeneralUnknownError Operation failed. Something went wrong with that request. Please try again, or contact Support if this keeps happening. | This error indicates that the workstation client experienced an unrecoverable error. What to do? 1. Check that the user is on a secure network (office or VPN) before pairing. This will ensure the user is ready to begin pairing. 2. Validate that the user can open a webpage that is not cached and will successfully load on their workstation. Then have the user try to pair with HYPR. 3. If the issue persists, an admin may analyze HYPROneService log for more information and escalate as needed. |
| 1470003 | kHyprUnableToRetrievePublicKeyError Unable to retrieve the public key. | This error indicates that the public key for HYPR is not available in the Keychain. Check Keychain for com.hypr.employeeaccess and see if public key is available. |
| 1470004 | kHyprUnableToRetrievePrivateKeyError Unable to retrieve the private key. | This error indicates that the public key for HYPR is not available in the Keychain. Check Keychain for com.hypr.employeeaccess and see if public key is available. |
| 1480001 | kHyprIncompleteConfiguration Product has not been properly configured. Check the configuration, then try again. |