25 KiB
title, description, ms.author, ms.localizationpriority, ms.topic, ms.prod, ms.technology, author, ms.date, ms.reviewer, manager
| title | description | ms.author | ms.localizationpriority | ms.topic | ms.prod | ms.technology | author | ms.date | ms.reviewer | manager |
|---|---|---|---|---|---|---|---|---|---|---|
| Policy CSP - ADMX_Smartcard | Learn about Policy CSP - ADMX_Smartcard. | vinpa | medium | article | w10 | windows | vinaypamnani-msft | 09/23/2020 | aaroncz |
Policy CSP - ADMX_Smartcard
Tip
These are ADMX-backed policies and require a special SyncML format to enable or disable. For details, see Understanding ADMX-backed policies.
You must specify the data type in the SyncML as <Format>chr</Format>. For an example SyncML, refer to Enabling a policy.
The payload of the SyncML must be XML-encoded; for this XML encoding, there are a variety of online encoders that you can use. To avoid encoding the payload, you can use CDATA if your MDM supports it. For more information, see CDATA Sections.
ADMX_Smartcard policies
- ADMX_Smartcard/AllowCertificatesWithNoEKU
- ADMX_Smartcard/AllowIntegratedUnblock
- ADMX_Smartcard/AllowSignatureOnlyKeys
- ADMX_Smartcard/AllowTimeInvalidCertificates
- ADMX_Smartcard/CertPropEnabledString
- ADMX_Smartcard/CertPropRootCleanupString
- ADMX_Smartcard/CertPropRootEnabledString
- ADMX_Smartcard/DisallowPlaintextPin
- ADMX_Smartcard/EnumerateECCCerts
- ADMX_Smartcard/FilterDuplicateCerts
- ADMX_Smartcard/ForceReadingAllCertificates
- ADMX_Smartcard/IntegratedUnblockPromptString
- ADMX_Smartcard/ReverseSubject
- ADMX_Smartcard/SCPnPEnabled
- ADMX_Smartcard/SCPnPNotification
- ADMX_Smartcard/X509HintsNeeded
ADMX_Smartcard/AllowCertificatesWithNoEKU
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you allow certificates without an Extended Key Usage (EKU) set to be used for signing in.
In versions of Windows, prior to Windows Vista, smart card certificates that are used for a sign-in require an enhanced key usage (EKU) extension with a smart card logon object identifier. This policy setting can be used to modify that restriction.
If you enable this policy setting, certificates with the following attributes can also be used to sign in on with a smart card:
- Certificates with no EKU
- Certificates with an All Purpose EKU
- Certificates with a Client Authentication EKU
If you disable or don't configure this policy setting, only certificates that contain the smart card logon object identifier can be used to sign in with a smart card.
ADMX Info:
- GP Friendly name: Allow certificates with no extended key usage certificate attribute
- GP name: AllowCertificatesWithNoEKU
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/AllowIntegratedUnblock
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you determine whether the integrated unblock feature will be available in the logon User Interface (UI).
In order to use the integrated unblock feature, your smart card must support this feature. Check with your hardware manufacturer to see if your smart card supports this feature.
If you enable this policy setting, the integrated unblock feature will be available.
If you disable or don't configure this policy setting then the integrated unblock feature won't be available.
ADMX Info:
- GP Friendly name: Allow Integrated Unblock screen to be displayed at the time of logon
- GP name: AllowIntegratedUnblock
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/AllowSignatureOnlyKeys
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you allow signature key-based certificates to be enumerated and available for a sign in.
If you enable this policy setting, then any certificates available on the smart card with a signature only key will be listed on the sign-in screen.
If you disable or don't configure this policy setting, any available smart card signature key-based certificates won't be listed on the sign-in screen.
ADMX Info:
- GP Friendly name: Allow signature keys valid for Logon
- GP name: AllowSignatureOnlyKeys
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/AllowTimeInvalidCertificates
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting permits those certificates to be displayed for a sign-in, which are either expired or not yet valid.
Under previous versions of Microsoft Windows, certificates were required to contain a valid time and not be expired. The certificate must still be accepted by the domain controller in order to be used. This setting only controls displaying of the certificate on the client machine.
If you enable this policy setting, certificates will be listed on the sign-in screen regardless of whether they have an invalid time or their time validity has expired.
If you disable or don't configure this policy setting, certificates that are expired or not yet valid won't be listed on the sign-in screen.
ADMX Info:
- GP Friendly name: Allow time invalid certificates
- GP name: AllowTimeInvalidCertificates
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/CertPropEnabledString
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to manage the certificate propagation that occurs when a smart card is inserted.
If you enable or don't configure this policy setting then certificate propagation will occur when you insert your smart card.
If you disable this policy setting, certificate propagation won't occur and the certificates won't be made available to applications such as Outlook.
ADMX Info:
- GP Friendly name: Turn on certificate propagation from smart card
- GP name: CertPropEnabledString
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/CertPropRootCleanupString
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to manage the cleanup behavior of root certificates.
If you enable this policy setting, then root certificate cleanup will occur according to the option selected.
If you disable or don't configure this setting then root certificate cleanup will occur on a sign out.
ADMX Info:
- GP Friendly name: Configure root certificate clean up
- GP name: CertPropRootCleanupString
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/CertPropRootEnabledString
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to manage the root certificate propagation that occurs when a smart card is inserted.
If you enable or don't configure this policy setting then root certificate propagation will occur when you insert your smart card.
Note
For this policy setting to work this policy setting must also be enabled: "Turn on certificate propagation from smart card".
If you disable this policy setting, then root certificates won't be propagated from the smart card.
ADMX Info:
- GP Friendly name: Turn on root certificate propagation from smart card
- GP name: CertPropRootEnabledString
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/DisallowPlaintextPin
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting prevents plaintext PINs from being returned by Credential Manager.
If you enable this policy setting, Credential Manager doesn't return a plaintext PIN.
If you disable or don't configure this policy setting, plaintext PINs can be returned by Credential Manager.
Note
Enabling this policy setting could prevent certain smart cards from working on Windows. Please consult your smart card manufacturer to find out whether you will be affected by this policy setting.
ADMX Info:
- GP Friendly name: Prevent plaintext PINs from being returned by Credential Manager
- GP name: DisallowPlaintextPin
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/EnumerateECCCerts
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to control whether elliptic curve cryptography (ECC) certificates on a smart card can be used to sign-in to a domain.
If you enable this policy setting, ECC certificates on a smart card can be used to sign in to a domain.
If you disable or don't configure this policy setting, ECC certificates on a smart card can't be used to sign in to a domain.
Note
This policy setting only affects a user's ability to log on to a domain. ECC certificates on a smart card that are used for other applications, such as document signing, are not affected by this policy setting. If you use an ECDSA key to log on, you must also have an associated ECDH key to permit logons when you are not connected to the network.
ADMX Info:
- GP Friendly name: Allow ECC certificates to be used for logon and authentication
- GP name: EnumerateECCCerts
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/FilterDuplicateCerts
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you configure if all your valid logon certificates are displayed.
During the certificate renewal period, a user can have multiple valid logon certificates issued from the same certificate template. This scenario can cause confusion as to which certificate to select for a sign in. The common case for this behavior is when a certificate is renewed and the old one hasn't yet expired. Two certificates are determined to be the same if they're issued from the same template with the same major version and they're for the same user (determined by their UPN).
If there are two or more of the "same" certificate on a smart card and this policy is enabled, then the certificate that is used for a sign in on Windows 2000, Windows XP, and Windows 2003 Server will be shown, otherwise the certificate with the expiration time furthest in the future will be shown.
Note
This setting will be applied after this policy: "Allow time invalid certificates"
If you enable or don't configure this policy setting, filtering will take place.
If you disable this policy setting, no filtering will take place.
ADMX Info:
- GP Friendly name: Filter duplicate logon certificates
- GP name: FilterDuplicateCerts
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/ForceReadingAllCertificates
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to manage the reading of all certificates from the smart card for a sign-in.
During a sign-in, Windows will by default only read the default certificate from the smart card unless it supports retrieval of all certificates in a single call. This setting forces Windows to read all the certificates from the card. This setting can introduce a significant performance decrease in certain situations. Contact your smart card vendor to determine if your smart card and associated CSP supports the required behavior.
If you enable this setting, then Windows will attempt to read all certificates from the smart card regardless of the feature set of the CSP.
If you disable or don't configure this setting, Windows will only attempt to read the default certificate from those cards that don't support retrieval of all certificates in a single call. Certificates other than the default won't be available for a sign in.
ADMX Info:
- GP Friendly name: Force the reading of all certificates from the smart card
- GP name: ForceReadingAllCertificates
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/IntegratedUnblockPromptString
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to manage the displayed message when a smart card is blocked.
If you enable this policy setting, the specified message will be displayed to the user when the smart card is blocked.
Note
The following policy setting must be enabled: "Allow Integrated Unblock screen to be displayed at the time of logon".
If you disable or don't configure this policy setting, the default message will be displayed to the user when the smart card is blocked, if the integrated unblock feature is enabled.
ADMX Info:
- GP Friendly name: Display string when smart card is blocked
- GP name: IntegratedUnblockPromptString
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you reverse the subject name from how it's stored in the certificate when displaying it during a sign in.
By default the User Principal Name (UPN) is displayed in addition to the common name to help users distinguish one certificate from another. For example, if the certificate subject was CN=User1, OU=Users, DN=example, DN=com and had an UPN of user1@example.com then "User1" will be displayed along with "user1@example.com." If the UPN isn't present, then the entire subject name will be displayed. This setting controls the appearance of that subject name and might need to be adjusted per organization.
If you enable this policy setting or don't configure this setting, then the subject name will be reversed.
If you disable, the subject name will be displayed as it appears in the certificate.
ADMX Info:
- GP Friendly name: Reverse the subject name stored in a certificate when displaying
- GP name: ReverseSubject
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to control whether Smart Card Plug and Play is enabled.
If you enable or don't configure this policy setting, Smart Card Plug and Play will be enabled and the system will attempt to install a Smart Card device driver when a card is inserted in a Smart Card Reader for the first time.
If you disable this policy setting, Smart Card Plug and Play will be disabled and a device driver won't be installed when a card is inserted in a Smart Card Reader.
Note
This policy setting is applied only for smart cards that have passed the Windows Hardware Quality Labs (WHQL) testing process.
ADMX Info:
- GP Friendly name: Turn on Smart Card Plug and Play service
- GP name: SCPnPEnabled
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/SCPnPNotification
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting allows you to control whether a confirmation message is displayed when a smart card device driver is installed.
If you enable or don't configure this policy setting, a confirmation message will be displayed when a smart card device driver is installed.
If you disable this policy setting, a confirmation message won't be displayed when a smart card device driver is installed.
Note
This policy setting is applied only for smart cards that have passed the Windows Hardware Quality Labs (WHQL) testing process.
ADMX Info:
- GP Friendly name: Notify user of successful smart card driver installation
- GP name: SCPnPNotification
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx
ADMX_Smartcard/X509HintsNeeded
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
[!div class = "checklist"]
- Device
This policy setting lets you determine whether an optional field will be displayed during a sign-in and elevation that allows users to enter their user name or user name and domain, thereby associating a certificate with the users.
If you enable this policy setting, then an optional field that allows a user to enter their user name or user name and domain will be displayed.
If you disable or don't configure this policy setting, an optional field that allows users to enter their user name or user name and domain won't be displayed.
ADMX Info:
- GP Friendly name: Allow user name hint
- GP name: X509HintsNeeded
- GP path: Windows Components\Smart Card
- GP ADMX file name: Smartcard.admx