중요
Windows 기준 보호는 Windows 참가자 프로그램을 통해 미리 보기 로 제공됩니다. 일반 공급은 2027년 봄에 계획되어 있습니다. 일부 정보는 상업용으로 출시되기 전에 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 명시적 또는 묵시적 보증을 하지 않습니다.
Warning
이 문서의 API 이름과유형 이름은 변경될 수 있습니다. 미리 보기 API는 Experimental_WldpQueryBaselineSecurityMode로 노출됩니다. API 계약이 마무리되면 Microsoft에서 함수, 해당 형식 및 열거형 이름을 바꾸거나 실험적 내보내기를 완전히 제거할 수 있습니다. API는 기본 기능이 꺼져 있는 경우에도 E_NOTIMPL를 반환할 수 있습니다. 실험적 내보내기에 종속된 프로덕션 코드는 제공하지 마세요. 열거형의 숫자 값과 구조체의 레이아웃은 wldp.dll와의 이진 계약이며 이름이 변경되더라도 의미가 변경되지 않습니다.
참고
Windows 기준 보호는 이전에 Windows BSM(기본 보안 모드)이라고 했습니다. 미리 보기 API 및 해당 형식은 여전히 이전 이름(예: WLDP_BASELINE_SECURITY_MODE_STATE_IN)을 사용합니다. 기준 보호를 위한 장치 관리는 기준 보안 모드의 Microsoft 365 관리 센터에 표시됩니다.
Windows 기준 보호는 Windows가 부팅 시 평가하는 단일 버전 관리 장치 보안 상태로 기본적인 Windows 보안 보호를 함께 제공합니다. 앱에서 TPM, 보안 부팅 또는 가상화 기반 보안과 같은 개별 설정을 직접 확인하는 대신 Windows에 한 가지 질문을 할 수 있습니다. 이 장치가 기본 보호 요구 사항을 충족합니까?
기준 보호는 시스템이 배치되는 스위치가 아닙니다. 현재 실행 중인 부팅에 대한 설명입니다. 기준의 모든 요구 사항이 해당 부팅에 대한 보안 상태일 때 부팅은 기준 보호를 충족합니다.
이 미리 보기에서 기준 보호 API는 로컬 감사 모드 API입니다. 앱은 장치의 기준 보호 상태 및 장치에서 요구 사항별 세부 정보를 읽을 수 있으며 해당 정보를 원격 분석, 감사, 진단 및 사용자 지침에 사용할 수 있습니다. 적용 시나리오를 위한 클라우드 검증 증명 지원 API는 이후 릴리스에서 제공될 예정입니다.
이 가이드에서는 다음을 설명합니다.
- 기준 보호란 무엇이며 어떤 보호를 포함하나요?
- Windows가 기준 보호 상태를 보고하는 방법
- 미리 보기 API를 호출하고 결과를 해석하는 방법
- 오늘 감사 및 원격 분석에 결과를 사용하는 방법
- 기준을 충족하는 장치에서 앱이 작동하는지 테스트하는 방법
Windows 기준 보호를 사용하는 이유
지금까지 Windows 장치의 무결성을 이해해야 하는 앱은 자체 보안 검사를 실행했습니다. 뱅킹 앱이 TPM을 테스트하고, 게임의 부정 행위 방지가 드라이버 서명을 검사하고, 시험 감독 서비스가 보안 부팅을 확인할 수 있습니다. 앱마다 다른 항목을 찾고 결과를 다르게 해석했습니다.
미리 보기 중에 신호로 수행할 수 있는 가장 유용한 작업은 다음과 같습니다.
측정. 사용자 장치 중 기준 보호를 충족하는 비율과 가장 자주 누락되는 요구 사항을 알아보세요.
안내하다. 장치가 기준을 충족하지 않을 때 사용자에게 알리고 설정으로 보내 수정합니다.
호환성을 확인합니다. 모든 보호 기능이 켜져 있을 때 앱이 작동하는지 확인합니다.
준비하다. 나중에 증명 지원 인증에 연결할 배관 및 정책 논리를 빌드합니다.
기준 보호 요구 사항
장치는 평가된 버전의 모든 요구 사항을 충족하는 경우에만 기준 보호를 충족합니다. 현재 기준선에는 다음이 필요합니다.
| 요구 사항 | API 조건 값 | 하는 일 |
|---|---|---|
| 보안 프로세서 | WLDP_BASELINE_SECURITY_CRITERION_TPM | 전용 하드웨어(TPM 2.0 또는 Microsoft Pluton)를 사용하여 중요한 데이터를 보호합니다. |
| 보안 부팅 | WLDP_BASELINE_SECURITY_CRITERION_SECURE_BOOT | 장치를 시작할 때 악성 소프트웨어가 로드되지 않도록 방지합니다. |
| VBS(가상화 기반 보안) | WLDP_BASELINE_SECURITY_CRITERION_VBS | 하드웨어 가상화를 사용하여 중요한 프로세스를 보호하는 데 도움이 되는 격리된 환경을 만듭니다. |
| 메모리 무결성 | WLDP_BASELINE_SECURITY_CRITERION_MEMORY_INTEGRITY | Windows의 보호된 부분에서 악성 코드가 실행되는 것을 방지합니다. |
| 서명된 드라이버만 | WLDP_BASELINE_SECURITY_CRITERION_SIGNED_DRIVERS_ONLY | 서명된 드라이버만 로드할 수 있습니다. |
| 커널 디버거 보호 | WLDP_BASELINE_SECURITY_CRITERION_KERNEL_DEBUGGER_PROTECTION | 도구가 커널 디버거를 통해 Windows 보안 보호를 우회하지 못하도록 방지합니다. |
| Windows 인증 드라이버 | WLDP_BASELINE_SECURITY_CRITERION_WHQL_ONLY | WHQL(Windows 하드웨어 서명) 요구 사항을 충족하는 드라이버만 허용합니다. |
| 취약한 드라이버 보호 | WLDP_BASELINE_SECURITY_CRITERION_VULNERABLE_DRIVER_BLOCKLIST | 알려진 취약한 드라이버가 Windows 보안 보호를 약화시키지 않도록 방지합니다. |
이러한 모든 보호 기능은 이미 Windows 11에 존재합니다. 새로운 기능은 Windows에서 하나의 결과로 함께 평가한다는 것입니다.
버전 관리 및 새 조건
기준선 보호는 천장이 아닌 바닥입니다. 시간이 지남에 따라 추가 조건이 조인됩니다. 결과는 다음과 같습니다.
이전 헤더에 대해 빌드된 앱은 시스템에서 평가하는 것보다 적 은 수의 조건을 볼 수 있습니다. 전체 버퍼가 전체 기준선을 포함한다고 가정하지 마세요.
앱은 인식하지 못하는 조건 값을 허용해야 합니다. 삭제하거나 실패하지 말고 번호로 보고합니다.
조건의 개수나 ID를 하드 코딩하지 마세요. 전체 판정을 사용하고 API가 반환하는 내용을 열거합니다.
Windows가 기준 보호를 평가하는 방법
Windows는 보안 프로세서의 측정값을 사용하여 부팅 시 기준 보호 상태를 평가합니다. 모든 요구 사항은 부팅 이후부터 적용되며 모든 요구 사항을 끄려면 다시 시작해야 합니다. 따라서 앱에서 폴링하는 대신 세션당 한 번씩 상태를 검사할 수 있습니다.
부팅 상태 및 다음 부팅 상태
앱이 묻는 두 가지 질문은 답변과 출처가 다르기 때문에 모든 기준은 두 번 보고됩니다.
| 보기 | API 필드 | 나타내는 내용 | 전반적인 평결에 기여합니까? |
|---|---|---|---|
| 부팅 상태 | BootState, BootResultCode | 실행 중인 부팅이 시작되었을 때 실제로 사실이었던 것입니다. 나중에 변경될 수 있는 구성이 아니라 부팅 중에 기록된 플랫폼 측정값에서 가져옵니다. | 예. 전체 상태는 각 조건의 부팅 상태에서 파생됩니다. |
| 현재(다음 부팅) 상태 | CurrentState, CurrentResultCode | 디바이스가 지금 수행하도록 구성된 작업, 따라서 다음 부팅 시 예상되는 작업입니다. 라이브 시스템 상태 및 구성에서 가져옵니다. 그것은 약속이 아니라 투사입니다. | 아니요. nextBootState로 별도로 롤업됩니다. |
Windows에서 독립적으로 가져오기 때문에 두 상태는 독립적인 결과 코드를 전달합니다. 다른 하나는 알려져 있지만 둘 중 하나는 사용하지 못할 수 있습니다.
두 상태를 비교하면 앱에서 "이 장치는 보호되지 않습니다"와 "이 장치는 올바르게 구성되어 있으므로 완료하려면 다시 시작해야 합니다"를 구분할 수 있습니다.
전체 상태
| 값 | 의미 |
|---|---|
| WLDP_BASELINE_SECURITY_MODE_STATE_IN | 모든 기준이 평가되었으며 모두 안전한 상태에 있습니다. |
| WLDP_BASELINE_SECURITY_MODE_STATE_NOT_IN | 모든 조건이 평가되었으며 하나 이상의 조건이 보안 상태가 아닙니다. |
| WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN | 하나 이상의 조건 상태를 확인할 수 없으므로 부트에 대해 설명할 수 없습니다. 개별 기준 상태는 어떤 조건과 이유를 말해줍니다. |
조건 상태
| 값 | 의미 |
|---|---|
| WLDP_BASELINE_SECURITY_CRITERION_STATE_ON | 조건이 보안 상태입니다. |
| WLDP_BASELINE_SECURITY_CRITERION_STATE_OFF | 평가에 성공했지만 조건이 보안 상태가 아닙니다. |
| WLDP_BASELINE_SECURITY_CRITERION_STATE_UNKNOWN | 조건을 평가할 수 없습니다. 함께 제공되는 결과 코드는 그 이유를 설명합니다. |
| WLDP_BASELINE_SECURITY_CRITERION_STATE_NOT_SUPPORTED | 디바이스가 이 조건을 충족할 수 없습니다. 예를 들어 필요한 하드웨어 또는 펌웨어 지원이 없기 때문입니다. |
Warning
미리 보기 API는 감사 모드 로컬 평가 API입니다. 결과는 앱이 확인하는 것과 동일한 장치에서 계산되고 반환되며 원격 서비스는 암호화로 확인할 수 없습니다. 보안 경계로 사용하지 마세요. 관찰, 측정 및 안내하는 데 사용합니다. 적용 시나리오는 예정된 릴리스에 대해 계획된 증명 지원 API를 기다려야 합니다.
API 참조(미리 보기)
주의
이름은 변경될 수 있습니다. 이 문서의 맨 위에 있는 주의 사항을 참조하세요.
typedef HRESULT (WINAPI *PFN_Experimental_WldpQueryBaselineSecurityMode)(
_Out_ PEXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE state,
_Out_opt_ PEXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE nextBootState,
_In_ DWORD criteriaCount,
_Out_writes_to_opt_(criteriaCount, *criteriaReturned) PEXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION_STATUS criteria,
_Out_ PDWORD criteriaReturned
);
매개 변수
| 매개 변수 | 설명 |
|---|---|
| 주 | 아웃. 각 조건의 BootState에서 파생된 실행 중인 부팅에 대한 판정입니다. 부팅 측정에서 가져옵니다. |
| nextBootState | 아웃, 선택 사항입니다. 각 조건의 CurrentState에 대해 계산된 동일한 롤업, 즉 장치가 다음 부팅 시 생성하도록 구성된 항목입니다. 약속이 아니라 투영입니다. |
| criteriaCount | 안에. 조건 버퍼의 항목 수입니다. 조건 = NULL인 경우 0을 전달하여 전체 상태와 필요한 개수만 가져옵니다. |
| 기준 | 아웃, 선택 사항입니다. 평가된 조건당 하나의 EXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION_STATUS을 받는 버퍼입니다. |
| criteriaReturned | 아웃. 기록된 항목 수 또는 버퍼가 없거나 너무 작을 때 필요한 수입니다. |
반환 값
| 값 | 의미 |
|---|---|
| S_OK | 쿼리가 완료되었습니다. 여기에는 개별 기준을 평가할 수 없는 경우가 포함됩니다 . 이러한 결과는 이유 코드를 전달 WLDP_BASELINE_SECURITY_CRITERION_STATE_UNKNOWN 합니다. |
HRESULT_FROM_WIN32(ERROR_MORE_DATA) |
조건이 너무 작습니다.
criteriaReturned는 필요한 개수를 보유하며 에 아무 것도 기록되지 않습니다.criteria |
| E_INVALIDARG | 또는 is criteriaReturned , is 와 NULLcriteriaCountcriteria 같은 state 일관성 없는 인수가 있습니다.NULL |
| E_NOTIMPL | 이 시스템에서 기본 기능이 꺼져 있습니다. |
Windows 빌드에 API GetProcAddress 가 포함되어 있지 않은 경우 를 반환합니다 NULL.
API 호출 방법 선택
대부분의 앱에서는 예 또는 아니요라는 대답만 필요하며 해당 대답은 한 번의 호출로 이루어집니다. 기준별 보고서는 두 번째 선택적 호출입니다. 세부 정보가 필요한 경우에만 사용합니다.
| 다음이 필요합니다. | 통화 방법 |
|---|---|
| "이 디바이스가 기본 보호 기능을 충족하나요?" | = 0 및 criteria = NULL인 한 번의 호출 criteriaCount 입니다. 두 전체 상태 모두 여전히 돌아옵니다. |
| 기준별 세부 정보(원격 분석, 진단) | 두 호출 패턴: 개수를 가져오고, 할당하고, 다시 호출하고, 다시 시도합니다.ERROR_MORE_DATA |
함수 확인
미리 보기 기능이 에 wldp.lib없으므로 System32에서 로드 wldp.dll 하고 런타임에 내보내기를 resolve합니다.
HMODULE wldp = LoadLibraryExW(L"wldp.dll", nullptr, LOAD_LIBRARY_SEARCH_SYSTEM32);
if (wldp == nullptr)
{
// Record that the state couldn't be read, and continue normally.
}
auto queryBsm = reinterpret_cast<PFN_Experimental_WldpQueryBaselineSecurityMode>(
GetProcAddress(wldp, "Experimental_WldpQueryBaselineSecurityMode"));
if (queryBsm == nullptr)
{
// This build of Windows doesn't include the API. Continue normally.
}
일반적인 경우: 한 번의 호출입니다.
이 방식은 대부분의 앱에서 유효합니다.
EXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE state = WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN;
EXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE nextBootState = WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN;
DWORD ignoredCount = 0;
HRESULT hr = queryBsm(&state, &nextBootState, 0, nullptr, &ignoredCount);
if (SUCCEEDED(hr) && state == WLDP_BASELINE_SECURITY_MODE_STATE_IN)
{
// The device met the baseline for this boot. Record it.
}
심플한 경우에도 요청합니다 nextBootState . 비용이 들지 않으며 사용자에게 "장치가 보호되지 않았습니다"라고 말하는 것과 "장치가 이미 올바르게 구성되어 있습니다. 다시 시작하여 완료"라고 부릅니다.
세부 사례: 두 호출
기준별 보고서는 주로 원격 분석에 유용합니다. 즉, 앱의 설치 기반에서 어떤 기준이 잘못되었는지 기록하여 합격/불합격률이 아닌 전체 그림을 볼 수 있습니다.
그리고 함께
criteriaCount = 0criteria = NULL한 번 호출하여 개수를 가져옵니다. 두 전체 상태는 여전히 반환됩니다.해당 크기의 버퍼를 할당한 다음 다시 호출합니다.
다음 날짜에 다시 시도하세요.
ERROR_MORE_DATA조건 목록은 시간이 지남에 따라 증가하므로 호출 간에 개수가 변경될 수 있습니다.
전체 패턴은 전체 샘플을 참조하세요.
결과 해석
전체 상태
그리고 nextBootState 함께 사용 state 하세요. 감사 모드에서 앱의 응답은 정보 제공용이어야 하며 차단해서는 안 됩니다.
| 주 | nextBootState | 의미 | 제안된 감사 모드 동작 |
|---|---|---|---|
| 안쪽 | 안쪽 | 장치가 기준 보호를 충족합니다. | 결과를 기록합니다. 사용자 작업이 필요하지 않습니다. |
| 없음/알 수 없음 | 안쪽 | 장치가 올바르게 구성되었지만 다시 시작해야 합니다. | 결과를 기록합니다. 필요에 따라 다시 시작을 제안합니다. |
| 안쪽 | 에 없음 | 장치가 이 부팅의 기준을 충족했지만 이후 보호가 꺼졌습니다. | 결과를 기록합니다. 선택적으로 다시 시작한 후 보호가 해제될 것이라고 사용자에게 알립니다. |
| 에 없음 | 에 없음 | 하나 이상의 보호가 꺼져 있습니다. | 결과를 기록합니다. 필요에 따라 사용자에게 알리고 설정에 연결합니다. |
| 알 수 없음 | 임의 | Windows가 상태를 확인할 수 없습니다. | 조건별 결과 코드를 기록합니다. 사용자에게 장치의 문제로 제시하지 마세요. |
개별 조건
| BootState | CurrentState | 의미 |
|---|---|---|
| 꺼짐 | Windows | 구성됨; 다시 시작한 후에 적용됩니다. |
| Windows | 꺼짐 | 이 부팅은 안전했지만 이후로 꺼져 있습니다. 다음 부팅이 안전하지 않습니다. |
| Windows | Windows | 안정 상태. |
| 알 수 없음 | 임의 | 평가할 수 없습니다.
BootResultCode 이유를 전달합니다. |
누락된 보호 기능을 해결하기 위해 사용자를 설정으로 보내기
앱에서 특정 조건에 대한 정보를 표시하려고 할 수도 있지만 일반적인 지침은 고유한 수정 흐름을 빌드 하지 않는 것입니다. 대신 사용자를 설정 앱으로 보냅니다. 설정은 한 번의 클릭으로 장치를 다시 기준 보호 환경으로 가져오도록 설계되었으며 기준이 변경되어도 올바른 상태를 유지합니다.
고유한 수정 흐름을 만드는 경우 조건이 추가될 때마다 변경되는 논리를 복제합니다. 각 조건은 펌웨어 설정, 정책 또는 드라이버 구성과 같은 다른 위치에서 고정됩니다. 보안 부팅 또는 TPM 켜기와 같은 펌웨어(UEFI) 변경을 통해 사용자를 안내하는 것을 포함하여 설정에서 이미 이를 처리하고 있습니다.
이 URI를 사용하여 설정의 기준 보호 페이지를 시작하거나 설정 > 기준 보호를 방문하세요.
ShellExecuteW(nullptr, L"open", L"ms-settings:baseline-protection", nullptr, nullptr, SW_SHOWNORMAL);
참고
미리 보기 중에 이 설정 페이지가 열려 있으며 테스트 중인 Windows 빌드에 표시되지 않을 수 있습니다.
참고
관리되는 장치에서 사용자는 이러한 설정을 직접 변경하지 못할 수 있습니다. 이 경우 사용자에게 IT 관리자에게 문의하도록 알려 줍니다. IT 관리자는 Microsoft 365 관리 센터, Microsoft Intune 또는 타사 관리 도구에서 기준 보안 모드를 사용하여 기준 보호를 관리합니다.
샘플: 기준 보호 쿼리 및 각 조건 인쇄
이 샘플은 자세한 경로를 사용하므로 모든 호출자에게 필요한 런타임 해결, 크기 조정 루프 및 오류 처리를 보여줍니다. 일반적인 예 또는 아니요의 경우 동일한 설정을 유지하고 단일 통화를 사용합니다.
//
// Sample: query baseline protection and print each criterion.
//
// Build: cl /std:c++17 /EHsc bsmsample.cpp
// The API is a PRIVATE export of wldp.dll, so no import library is needed.
//
#include <windows.h>
//
// wldp_bsm.h is the header from Appendix A. Once your Windows SDK declares the
// API, delete it and include <wldp.h> instead.
//
#include "wldp_bsm.h"
#include <cstdio>
#include <vector>
namespace
{
const wchar_t* ModeStateToString(EXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE state)
{
switch (state)
{
case WLDP_BASELINE_SECURITY_MODE_STATE_IN: return L"In baseline protection";
case WLDP_BASELINE_SECURITY_MODE_STATE_NOT_IN: return L"Not in baseline protection";
case WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN: return L"Unknown";
default: return L"<unrecognized>";
}
}
const wchar_t* CriterionStateToString(EXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION_STATE state)
{
switch (state)
{
case WLDP_BASELINE_SECURITY_CRITERION_STATE_ON: return L"On";
case WLDP_BASELINE_SECURITY_CRITERION_STATE_OFF: return L"Off";
case WLDP_BASELINE_SECURITY_CRITERION_STATE_NOT_SUPPORTED: return L"Not supported";
case WLDP_BASELINE_SECURITY_CRITERION_STATE_UNKNOWN: return L"Unknown";
default: return L"<unrecognized>";
}
}
//
// Criteria are appended over time, so anything past the end of this table is
// reported by number rather than dropped.
//
const wchar_t* CriterionToString(EXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION criterion)
{
switch (criterion)
{
case WLDP_BASELINE_SECURITY_CRITERION_TPM: return L"TPM";
case WLDP_BASELINE_SECURITY_CRITERION_SECURE_BOOT: return L"Secure Boot";
case WLDP_BASELINE_SECURITY_CRITERION_VBS: return L"VBS";
case WLDP_BASELINE_SECURITY_CRITERION_MEMORY_INTEGRITY: return L"Memory Integrity";
case WLDP_BASELINE_SECURITY_CRITERION_SIGNED_DRIVERS_ONLY: return L"Signed Drivers Only";
case WLDP_BASELINE_SECURITY_CRITERION_KERNEL_DEBUGGER_PROTECTION: return L"Kernel Debugger Protection";
case WLDP_BASELINE_SECURITY_CRITERION_WHQL_ONLY: return L"WHQL Only";
case WLDP_BASELINE_SECURITY_CRITERION_VULNERABLE_DRIVER_BLOCKLIST: return L"Vulnerable Driver Blocklist";
default: return nullptr;
}
}
}
int wmain()
{
HMODULE wldp = LoadLibraryExW(L"wldp.dll", nullptr, LOAD_LIBRARY_SEARCH_SYSTEM32);
if (wldp == nullptr)
{
wprintf(L"LoadLibraryExW(wldp.dll) failed: %lu\n", GetLastError());
return 1;
}
auto queryBsm = reinterpret_cast<PFN_Experimental_WldpQueryBaselineSecurityMode>(
GetProcAddress(wldp, "Experimental_WldpQueryBaselineSecurityMode"));
if (queryBsm == nullptr)
{
wprintf(L"This build of wldp.dll does not export the API: %lu\n", GetLastError());
FreeLibrary(wldp);
return 1;
}
EXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE state = WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN;
EXPERIMENTAL_WLDP_BASELINE_SECURITY_MODE_STATE nextBootState = WLDP_BASELINE_SECURITY_MODE_STATE_UNKNOWN;
std::vector<EXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION_STATUS> criteria;
DWORD returned = 0;
//
// Size the buffer, then fill it. The loop re-sizes because the criterion list
// can be longer than the header this sample was built against.
//
HRESULT hr = queryBsm(&state, &nextBootState, 0, nullptr, &returned);
for (int attempt = 0; SUCCEEDED(hr) && attempt < 4; ++attempt)
{
criteria.assign(returned, EXPERIMENTAL_WLDP_BASELINE_SECURITY_CRITERION_STATUS{});
hr = queryBsm(
&state,
&nextBootState,
static_cast<DWORD>(criteria.size()),
criteria.empty() ? nullptr : criteria.data(),
&returned);
if (hr != HRESULT_FROM_WIN32(ERROR_MORE_DATA))
{
break;
}
//
// ERROR_MORE_DATA leaves the buffer untouched and puts the required count
// in returned, so just grow and retry.
//
hr = S_OK;
}
if (hr == E_NOTIMPL)
{
wprintf(L"Baseline protection is not enabled on this system.\n");
FreeLibrary(wldp);
return 0;
}
if (FAILED(hr))
{
wprintf(L"Experimental_WldpQueryBaselineSecurityMode failed: 0x%08X\n", hr);
FreeLibrary(wldp);
return 1;
}
wprintf(L"This boot : %s\n", ModeStateToString(state));
wprintf(L"Next boot : %s\n\n", ModeStateToString(nextBootState));
if (state != WLDP_BASELINE_SECURITY_MODE_STATE_IN &&
nextBootState == WLDP_BASELINE_SECURITY_MODE_STATE_IN)
{
wprintf(L"Configured correctly; restart to finish.\n\n");
}
for (DWORD i = 0; i < returned; ++i)
{
const auto& entry = criteria[i];
const wchar_t* name = CriterionToString(entry.Criterion);
if (name != nullptr)
{
wprintf(L"%-28s", name);
}
else
{
wprintf(L"Criterion %-18u", static_cast<unsigned>(entry.Criterion));
}
wprintf(
L" boot=%-14s (0x%08X) current=%-14s (0x%08X)\n",
CriterionStateToString(entry.BootState),
entry.BootResultCode,
CriterionStateToString(entry.CurrentState),
entry.CurrentResultCode);
}
FreeLibrary(wldp);
return 0;
}
감사 및 원격 분석에 기준 보호 사용
감사 모드는 적용하기 전에 사용자 기반을 파악하기에 적합한 시기입니다. 앱에서 다음을 기록하는 것이 좋습니다.
| 필드 | 유용한 이유 |
|---|---|
| 주 | 현재 기준 보호를 충족하는 디바이스의 비율 |
| nextBootState | 보류 중인 변경 내용이 있는 디바이스의 공유(예: 다시 시작 대기) |
| 조건별 BootState 및 CurrentState | 가장 자주 누락되는 요구 사항 |
| 조건별 BootResultCode 및 CurrentResultCode | 알 수 없는 결과 및 예기치 않은 동작 진단 |
| API HRESULT(E_NOTIMPL 포함 또는 누락된 내보내기) | 장치 상태에서 가용성 오류 구분 |
| Windows 빌드 번호 | 결과와 Windows 버전 상관 관계 지정 |
| 타임스탬프 | 시간 경과에 따른 인구 변화 추적 |
이 데이터를 사용하여 다음을 할 수 있습니다.
나중에 기능에 대한 기준 보호가 필요한 경우 영향을 받을 사용자 수를 추정합니다.
가장 자주 누락되는 요구 사항에 대한 사용자 지침의 우선 순위를 지정합니다.
앱과 특정 보호 기능 간의 호환성 문제를 찾습니다.
증명 지원 확인을 사용할 수 있게 되면 적용할 정책을 계획합니다.
기준 보호를 충족하는 장치에서 앱 테스트
모든 기본 보호 요구 사항이 켜져 있을 때 앱이 작동하는지 확인합니다. 앱이 이러한 보호 기능을 해제한 상태(예: 서명되지 않은 드라이버 또는 인증되지 않은 드라이버를 설치하거나 커널 디버거가 필요한 경우)에 의존하는 경우 약화된 플랫폼 상태에 따라 달라지며 보호된 장치에서 작동하지 않을 수 있습니다.
다음 테스트 흐름을 사용해 보세요.
기준 보호를 충족하는 테스트 디바이스 또는 VM을 설정합니다.
API를 호출하고 기록
state하고nextBootState.조건을 열거하고 각각에 대한 ,
CurrentState및 두 결과 코드를 모두 기록BootState합니다.지원되는 보안 설정 하나를 변경합니다.
다시 시작하기 전에 API를 다시 쿼리하고 결과를 기록합니다.
다시 시작하고, 다시 쿼리하고, 새 부팅 상태와 현재 상태를 비교합니다.
앱의 핵심 시나리오가 모든 보호 기능이 켜져 있는 상태에서 작동하는지 확인합니다.
예기치 않은 결과를 보고할 때 Windows 빌드 번호, 반환된 상태 및 결과 코드, 재현 단계를 포함합니다.
모범 사례
준수하고, 강제하지 마세요. 미리 보기에서는 원격 분석, 감사, 진단 및 사용자 지침에만 결과를 사용합니다. 이를 근거로 사용자를 차단, 거부 또는 다운그레이드하지 마세요.
실험적 내보내기에 대한 종속성을 제공하지 마세요. 이름이 변경되거나 제거될 수 있습니다. 항상 시작
GetProcAddress과 결과를 처리NULL합니다E_NOTIMPL.자체 검사를 빌드하는 대신 플랫폼 신호를 사용합니다. TPM, 보안 부팅, VBS 또는 드라이버 설정을 독립적으로 쿼리하여 기준 보호를 다시 구현하지 마세요.
필요한 경우 통화 한 번만 사용합니다. 사용할 때만 조건별 세부 정보를 요청합니다.
항상 요청
nextBootState. 사용자가 다시 시작하기만 하면 되는지 여부를 알려줍니다.다음 날짜에 다시 시도하세요.
ERROR_MORE_DATA조건 목록이 커질 수 있습니다.인식할 수 없는 조건을 허용합니다. 번호로 보고하십시오. 헤더에 모든 조건이 나열되어 있다고 가정해서는 안 됩니다.
결과 코드를 유지합니다. 로그와 진단에 기준별 결과 코드를 모두 포함합니다.
사용자를 설정으로 보냅니다. 직접 수정을 빌드하는 대신 딥 링크를 만듭니다.
ms-settings:baseline-protection관리되는 장치를 존중합니다. 관리되는 장치의 사용자를 IT 관리자에게 라우팅합니다.
알 수 없다는 것이 안전하지 않다는 의미라고 생각하지 마세요. 알 수 없는 상태는 Windows에서 상태를 설정할 수 없음을 의미합니다. "기본 보호 범위에 없음"과 별도로 처리합니다.
질문과 대답
미리 보기 API를 사용하여 사용자 또는 게이트 액세스를 차단할 수 있나요? 아니요. 미리 보기 API는 로컬 감사 모드 API이며 원격 서비스는 해당 결과를 독립적으로 확인할 수 없습니다. 원격 분석, 감사 및 사용자 지침에 사용합니다. 적용 시나리오는 증명 지원 API를 사용할 수 있게 되면 이를 사용해야 합니다.
API 이름이 변경되나요? 그럴 수도 있습니다. Experimental_WldpQueryBaselineSecurityMode 및 해당 형식 이름은 API가 확정되기 전에 변경될 수 있습니다. 열거형 값과 구조체 레이아웃의 의미는 변경되지 않습니다. SDK의 wldp.h가 최종 API를 선언하면 최종 API로 전환합니다.
Windows 기준 보호는 Intune의 보안 기준과 어떻게 다른가요? Intune 보안 기준은 관리자가 정의한 권장 설정 그룹입니다. Windows 기준 보호는 Windows가 부팅 시 평가하고 앱과 서비스에 보고하는 Microsoft에서 정의한 버전이 있는 장치 보안 상태입니다.
기준 보호는 Microsoft 365 관리 센터의 기준 보안 모드와 동일한가요? Microsoft 365 관리 센터의 기준 보안 모드는 IT 관리자가 다른 Microsoft 365 권장 사항과 함께 organization의 Windows 장치에 대한 기준 보호를 보고하고 관리하는 곳입니다.
앱에서 기준 보호를 켜야 하나요? 아니요. 앱에서 상태를 읽습니다. 사용자는 설정에서 보호 기능을 켜면 IT 관리자가 관리 도구를 통해 이를 관리합니다.