Delphi 프로그램에서 Windows Hello로 본인 확인 — UserConsent
Delphi VCL 데스크톱 프로그램에서 지문, 얼굴, PIN 같은 Windows Hello로 사용자를 확인하는 유닛 하나와 데모입니다. 비밀번호 입력을 생체 인증으로 바꿀 때 씁니다.
중요한 작업 전에 비밀번호를 한 번 더 묻는 프로그램이 많습니다. Windows 10 이상에는 Windows Hello가 들어 있어 지문, 얼굴, PIN으로 사용자를 확인할 수 있습니다. 앱은 지문이나 얼굴 데이터를 만지지 않습니다. OS가 자기 보안 화면에서 확인한 뒤 성공했는지 실패했는지만 알려 줍니다.
문제는 Delphi에서 부르는 방법입니다. WinRT의 UserConsentVerifier.RequestVerificationAsync는 UWP용이라, 일반 Win32 프로그램에서 부르면 확인 창이 내 창에 붙지 않아 제대로 뜨지 않을 수 있습니다. UserConsent는 이 부분을 해결한 SCUserConsent 유닛과 데모입니다.
써 보기
uses에 SCUserConsent 하나만 넣으면 됩니다. 다른 의존성은 없습니다.
uses
SCUserConsent;
// 1) Windows Hello 를 쓸 수 있는지 확인
if TSCUserConsent.IsAvailable then
begin
// 2) 인증 요청 — 다이얼로그가 끝날 때까지 대기(동기)
// 두 번째 인자는 다이얼로그를 연결할 창 핸들. 0 이면 현재 활성 창.
if TSCUserConsent.Verify('로그인하려면 인증하세요.', Handle).IsVerified then
begin
// 인증 성공 → 로그인/보호된 작업 진행
ShowMessage('환영합니다!');
end
else
begin
ShowMessage('인증에 실패했거나 취소되었습니다.');
end;
end
else
begin
// 지문/PIN 미설정 등 — 비밀번호 등 대체 수단으로 폴백
ShowMessage('이 PC 에서는 Windows Hello 를 사용할 수 없습니다.');
end;
함수는 세 개입니다. CheckAvailability는 쓸 수 있는 상태인지, IsAvailable은 그 결과를 참/거짓으로, Verify는 실제 확인을 요청합니다. Verify가 돌려주는 결과는 다음과 같습니다.
| 값 | 뜻 |
|---|---|
ucrVerified |
인증 성공 |
ucrCanceled |
사용자가 취소 |
ucrRetriesExhausted |
재시도 횟수 초과 |
ucrNotConfigured |
Windows Hello 미설정 |
ucrDeviceNotPresent |
생체 장치 없음 |
ucrDisabledByPolicy |
정책으로 꺼짐 |
ucrDeviceBusy |
장치 사용 중 |
ucrNotSupported |
지원하지 않음 |
ucrError |
기타 오류 |
결과 값에는 IsVerified와 ToString(예: 'verified', 'canceled')이 붙어 있어 로그 남기기도 편합니다.
어떻게 만들었나
Delphi RTL에는 IUserConsentVerifierInterop 인터페이스가 없습니다. SCUserConsent는 이 인터페이스를 직접 선언해 폼의 HWND를 확인 창에 연결합니다. 그래서 일반 VCL 데스크톱 프로그램에서도 창이 제대로 뜹니다. WinRT 비동기 호출은 STA 메시지 펌프로 기다리므로, Verify는 확인 창이 닫힐 때까지 기다렸다가 결과를 돌려줍니다.
알아 둘 점
- Windows 10 이상, Windows Hello에 PIN·지문·얼굴 중 하나가 등록되어 있어야 합니다.
Winapi.Security.CredentialsWinRT 바인딩이 있는 Delphi가 필요합니다. Delphi 13(RAD Studio 37.0)에서 확인했습니다. Win32와 Win64 모두 됩니다.- MSIX 패키지로 묶지 않은 일반 Win32 데스크톱 앱에서 그대로 동작합니다.
- 지원하지 않는 환경에서는 예외를 던지지 않고
NotSupported,NotConfigured같은 상태를 돌려줍니다. 이때는 비밀번호 같은 다른 수단으로 넘어가면 됩니다. - 데모(
src\UserConsentDemo.dpr)는 명령줄에서 이렇게 빌드합니다. 라이선스는 MIT입니다.
dcc64 -B src\UserConsentDemo.dpr -NSWinapi;System;System.Win;Vcl -Usrc -Ebin
소스는 GitHub 저장소에 있습니다.