When installing the Okta Windows Credential Provider on a Windows Server Domain Controller, an Admin may run into the following error:
Module C:\Program Files\OKTA\Okta Windows Credential Provider\bin\OktaCredentialProvider.dll failed to register. HRESULT -2147024770. Contact your support personnel.
Based on the documentation: "The installing account must have administrative rights to install the Okta MFA Credential Provider Agent for Windows agent, Visual C++ Redistributable, and .NET 4.0+". The Visual C++ Redistributable requirements are for the .dll library required for the installation; otherwise, the installation will fail.
- Okta Windows Credential Provider
- Windows Server Domain Controller
- Multi-Factor Authentication (MFA)
When the Visual C++ Redistributable is not installed, up to date, or has been affected during installation, the following error is received:
Module C:\Program Files\OKTA\Okta Windows Credential Provider\bin\OktaCredentialProvider.dll failed to register. HRESULT -2147024770. Contact your support personnel.
To understand the issue, the error code "-2147024770" that is shown translates to:
ERROR_MOD_NOT_FOUND
The specified module could not be found.
There are two approaches to solving this issue. The first method is to update/reinstall/repair the C++ redistributable. If that does not work, the second method is to use a third-party utility named Dependency Walker to find the specific missing dependency and then reinstall/repair the relevant application.
Reinstall / Repair C++ Redistributable
Most known agent dependencies come installed with the Windows OS except for the C++ redistributable. These will need to be reinstalled or repaired. The following instructions outline the steps to repair them.
- Open Apps and Features (Add / Remove Programs).
- Find Microsoft Visual C++ <version> x86.
- Right-click and select modify and then repair.
- Repeat the same process with Visual C++ <version> x64.
- Reboot.
- Retry the Okta Windows Credential Provider Agent install.
If the issue persists, then try the second method below.
Using Dependency Walker To Find Missing Dependencies
This utility is designed to help find the dependencies for .dll files. It will also show if the dependencies are missing or not registered correctly.
- Download the latest x64 Dependency walker from http://www.dependencywalker.com/.
- Extract to a folder.
- Run Dependency Walker (depends.exe).
- Go to File > Open and browse to the .dll that is reporting the error. If the .dll is not present on the system, copy the .dll from a known good source or run the dependency walker before closing the error/warning during a manual (not silent) Okta WCP agent install. Once the .dll is selected, it can take a few minutes for the system to scan for dependencies.
- Review the children of the .dll from the error in the tree view.
- Any .dlls shown with a red icon are not installed properly and need to be either reinstalled or repaired. To reinstall/repair the .dll, find the parent program by doing a Google search "How to install ****.dll". In most cases, that .dll belongs to the C++ redistributable.
- Once the source for the .dll has been reinstalled/repaired, restart the client machine.
- Do Steps 3 - 5 again. The dependencies should no longer have a red icon next to them.
- Attempt to install the agent again.
