56 lines
2.2 KiB
Markdown
56 lines
2.2 KiB
Markdown
---
|
|
page_type: sample
|
|
languages:
|
|
- cpp
|
|
products:
|
|
- windows-api-win32
|
|
name: V2 Credential Provider Sample
|
|
urlFragment: credential-provider
|
|
description: Demonstrates how to build a v2 credential provider that makes use of the new capabilities in credential provider framework in Windows 8 and Windows 8.1.
|
|
---
|
|
|
|
# V2 Credential Provider Sample
|
|
|
|
This sample implements a simple v2 credential provider. A credential provider allows a 3rd
|
|
party to provide an alternate way of logging on. For example, a fingerprint solution vendor
|
|
would write a credential provider to interact with the user and send the appropriate
|
|
credentials to the system for authentication.
|
|
|
|
This sample implements a simplified credential provider that is based on the password
|
|
credential provider that ships with Windows. When run, the credential provider
|
|
should enumerate two tiles, one for the administrator and one for the guest account. Note
|
|
that the guest account must be enabled for that tile to log on successfully. (The guest account
|
|
is disabled by default.)
|
|
|
|
This sample demonstrates simple password based log on and unlock behavior. It also shows how to construct
|
|
a simple user tile and handle the user interaction with that tile.
|
|
|
|
Note that this sample does not demonstrate the following:
|
|
- other credential provider scenarios, like participating in credui or handling change password.
|
|
- every possible field that you can put in your user tile
|
|
- any network access prior to local authentication (the Pre-Logon Access Provider (PLAP) behavior)
|
|
- an event based credential provider (like a smartcard or fingerprint based system)
|
|
|
|
## Operating system requirements
|
|
|
|
Client
|
|
|
|
Windows 8.1
|
|
|
|
Server
|
|
|
|
Windows Server 2012 R2
|
|
|
|
## Build the sample
|
|
|
|
1. Start Visual Studio and select **File** \> **Open** \> **Project/Solution**.
|
|
2. Go to the directory named for the sample, and double-click the Visual Studio Solution (.sln) file.
|
|
3. Press F7 or use **Build** \> **Build Solution** to build the sample.
|
|
|
|
## Run the sample
|
|
|
|
Copy SampleV2CredentialProvider.dll to the System32 directory
|
|
and run Register.reg from an elevated command prompt. The credential should appear the next
|
|
time a logon is invoked (such as when logging off or rebooting the machine).
|
|
|