WINDOWS CNG/KSP

Hợp đồng nhà cung cấp NCrypt

Hướng dẫn CNG/KSP mô tả cài đặt, nhận diện provider, vòng đời khóa lưu bền vững, thuộc tính, ký và hành vi backend được bảo vệ.

01

Thông tin phiên bản provider

TrườngGiá trị release bắt buộc
Registered provider nameChuỗi chính xác từ manifest phát hành đã ký
PackageTên MSI/MSIX/DLL và checksum SHA-256
Architecturex64/ARM64 theo release
WindowsBản build Windows 11/Server chính xác
BackendTrusted Key, HSM/QSCD, Trusted SIC hoặc backend test
Installation scopeTheo máy/theo user
LoggingEvent source, mức log và support bundle

02

Ma trận hỗ trợ hàm NCrypt

HàmTrạng tháiHợp đồng
NCryptOpenStorageProviderTheo profileTên provider phải khớp với manifest phát hành đã ký.
NCryptCreatePersistedKeyTheo profileLoại khóa, phạm vi user/machine và backend policy.
NCryptFinalizeKeyTheo profileXác thực policy và bằng chứng tạo tại backend.
NCryptOpenKeyTheo profileĐặt tên container, ACL và tính sẵn sàng.
NCryptEnumKeysTheo profileVisibility khi enumerate và hành vi phân trang.
NCryptSignHashTheo profileThuật toán, padding/encoding và authentication.
NCryptVerifySignatureTheo profileXác minh local/provider và ánh xạ lỗi.
NCryptImportKeyHạn chếChỉ định dạng migration/import đã phê duyệt.
NCryptExportKeyHạn chếPublic key hoặc wrapped export đã phê duyệt rõ ràng.
NCryptGetPropertyTrong danh sách cho phépMa trận property đã công bố.
NCryptSetPropertyTrong danh sách cho phépPolicy cho property có thể thay đổi.
NCryptDeleteKeyTheo profileKết quả xóa, zeroization và audit.

03

Mô hình key container và chính sách

NAM

Container naming

Đặt tên ổn định, tiền tố tenant/application và quy tắc tránh trùng.

ACL

Identity & ACL

Windows identity, service account và phạm vi machine/user.

EXP

Export policy

Private key không thể export; chỉ export public hoặc wrapped theo profile.

AUT

Authentication

PIN, step-up cục bộ hoặc phê duyệt từ xa với thời gian sống session xác định.

ROT

Rotation

Rollover certificate/key, chồng lấp và re-binding ứng dụng.

DEL

Deletion

Xóa theo fail-closed, kết quả zeroization và audit không thể sửa đổi.

04

Luồng NCrypt tối thiểu

NCryptOpenStorageProvider
  → NCryptCreatePersistedKey
  → NCryptSetProperty
  → NCryptFinalizeKey
  → NCryptSignHash
  → NCryptVerifySignature
  → NCryptFreeObject