Okta Windows Credential Provider Support for Local Accounts on a Windows Server
Last Updated:
Overview
The Okta Windows Credential Provider supports local accounts on a Windows Server, regardless of whether the server is connected to a domain. Administrators can configure the Remote Desktop Protocol (RDP) Multi-Factor Authentication (MFA) application in Okta to authenticate local server accounts by adjusting the application username format.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Okta Windows Credential Provider
- Remote Desktop Protocol (RDP)
- Multi-Factor Authentication (MFA)
Solution
How is the Windows Credential Provider configured for non-domain-joined servers?
Configure the Windows Credential Provider for non-domain-joined servers by creating a matching Okta account, assigning the application, and modifying the username format.
- Install and configure the Windows Credential Provider.
- Create an account in Okta that matches the local account on the non-domain-joined server (for example,
<user@example.com>). - Navigate to Directory, select People, and choose Add Person.
- Fill out the form. If the account lacks a domain suffix, enter the server name to proceed.
- Navigate to Applications and select the Microsoft RDP (MFA) application.
- Select the Assignments tab, choose Assign, and select People to assign the Okta account to the application.
- Select the pencil icon next to the assignment.
- Remove the domain suffix and retain only the local username (for example,
<administrator>), then select Save.
The Windows Credential Provider requires specific configuration for domain-joined servers.
Configure the Windows Credential Provider for domain-joined servers by assigning the application and defining the application username with the hostname prefix.
- Navigate to Applications and select the Microsoft RDP (MFA) application.
- Select the Assignments tab, choose Assign, and select People to assign the Okta account to the application.
- Define the application username as
<HOSTNAME\username>(for example,<SERVER01\Administrator>).
NOTE: When setting the Application username format to Okta username prefix, do not use the <HOSTNAME\> prefix for the username. Use the username itself. If the administrator adds the <HOSTNAME\> prefix, Okta generates the following error message:
Multi-Factor Authentication Failed
