Menandatangani Data dengan CNG
Penandatanganan data tidak melindungi data. Ini hanya memverifikasi integritas data. Pengirim hash data tersebut dan menandatangani (mengenkripsi) hash dengan menggunakan kunci privat. Penerima yang dimaksudkan melakukan verifikasi dengan membuat hash data yang diterima, mendekripsi tanda tangan untuk mendapatkan hash asli, dan membandingkan dua hash.
Saat data ditandatangani, pengirim membuat nilai hash dan tanda (mengenkripsi) hash dengan menggunakan kunci privat. Tanda tangan ini kemudian dilampirkan ke data dan dikirim dalam pesan ke penerima. Algoritma hash yang digunakan untuk membuat tanda tangan harus diketahui terlebih dahulu oleh penerima atau diidentifikasi dalam pesan. Bagaimana hal ini dilakukan terserah protokol pesan.
Untuk memverifikasi tanda tangan, penerima mengekstrak data dan tanda tangan dari pesan. Penerima kemudian membuat nilai hash lain dari data, mendekripsi hash yang ditandatangani dengan menggunakan kunci publik pengirim, dan membandingkan dua nilai hash. Jika nilainya identik, tanda tangan telah diverifikasi dan data diasumsikan tidak diubah.
Untuk membuat tanda tangan dengan menggunakan CNG
- Buat nilai hash untuk data dengan menggunakan fungsi hashing CNG. Untuk informasi selengkapnya tentang membuat hash, lihat Membuat Hash Dengan CNG.
- Buat kunci asimetris untuk menandatangani hash. Anda dapat membuat kunci persisten dengan Fungsi Penyimpanan Kunci CNG atau kunci sementara dengan Fungsi Primitif Kriptografi CNG.
- Gunakan NCryptSignHash atau fungsi BCryptSignHash untuk menandatangani (mengenkripsi) nilai hash. Fungsi ini menandatangani nilai hash dengan menggunakan kunci asimetris.
- Gabungkan data dan tanda tangan ke dalam pesan yang dapat dikirim ke penerima yang dimaksudkan.
Untuk memverifikasi tanda tangan dengan menggunakan CNG
- Ekstrak data dan tanda tangan dari pesan.
- Buat nilai hash untuk data dengan menggunakan fungsi hashing CNG. Algoritma hash yang digunakan harus algoritma yang sama yang digunakan untuk menandatangani hash.
- Dapatkan bagian publik dari pasangan kunci asimetris yang digunakan untuk menandatangani hash. Cara Anda mendapatkan kunci ini tergantung pada bagaimana kunci dibuat dan dipertahankan. Jika kunci dibuat atau dimuat dengan Fungsi Penyimpanan Kunci CNG, Anda akan menggunakan fungsi NCryptOpenKey untuk memuat kunci yang bertahan. Jika kunci adalah kunci ephemeral, maka kunci tersebut harus disimpan ke BLOB kunci. Anda perlu meneruskan BLOB kunci ini ke BCryptImportKeyPair atau fungsi NCryptImportKey.
- Berikan nilai hash baru, tanda tangan, dan handel kunci ke fungsi NCryptVerifySignature atau BCryptVerifySignature. Fungsi-fungsi ini melakukan verifikasi dengan menggunakan kunci publik untuk mendekripsi tanda tangan dan membandingkan hash yang didekripsi dengan hash yang dihitung pada langkah 2. Fungsi BCryptVerifySignature akan mengembalikan STATUS_SUCCESS jika tanda tangan cocok dengan hash atau STATUS_INVALID_SIGNATURE jika tanda tangan tidak cocok dengan hash. Fungsi NCryptVerifySignature akan mengembalikan STATUS_SUCCESS jika tanda tangan cocok dengan hash atau NTE_BAD_SIGNATURE jika tanda tangan tidak cocok dengan hash.
Contoh Data Penandatanganan dan Verifikasi
Contoh berikut menunjukkan cara menggunakan API primitif kriptografi untuk menandatangani data dengan kunci yang dipertahankan dan memverifikasi tanda tangan dengan kunci ephemeral.
// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
// PARTICULAR PURPOSE.
//
// Copyright (C) Microsoft. All rights reserved.
/*++
Abstract:
Sample program for ECDSA 256 signing using CNG
Example for use of BCrypt/NCrypt API
Persisted key for signing and ephemeral key for verification
--*/
#include <windows.h>
#include <stdio.h>
#include <bcrypt.h>
#include <ncrypt.h>
#define NT_SUCCESS(Status) (((NTSTATUS)(Status)) >= 0)
#define STATUS_UNSUCCESSFUL ((NTSTATUS)0xC0000001L)
static const BYTE rgbMsg[] =
{
0x04, 0x87, 0xec, 0x66, 0xa8, 0xbf, 0x17, 0xa6,
0xe3, 0x62, 0x6f, 0x1a, 0x55, 0xe2, 0xaf, 0x5e,
0xbc, 0x54, 0xa4, 0xdc, 0x68, 0x19, 0x3e, 0x94,
};
void __cdecl wmain(
int argc,
__in_ecount(argc) LPWSTR *wargv)
{
NCRYPT_PROV_HANDLE hProv = NULL;
NCRYPT_KEY_HANDLE hKey = NULL;
BCRYPT_KEY_HANDLE hTmpKey = NULL;
SECURITY_STATUS secStatus = ERROR_SUCCESS;
BCRYPT_ALG_HANDLE hHashAlg = NULL,
hSignAlg = NULL;
BCRYPT_HASH_HANDLE hHash = NULL;
NTSTATUS status = STATUS_UNSUCCESSFUL;
DWORD cbData = 0,
cbHash = 0,
cbBlob = 0,
cbSignature = 0,
cbHashObject = 0;
PBYTE pbHashObject = NULL;
PBYTE pbHash = NULL,
pbBlob = NULL,
pbSignature = NULL;
UNREFERENCED_PARAMETER(argc);
UNREFERENCED_PARAMETER(wargv);
//open an algorithm handle
if(!NT_SUCCESS(status = BCryptOpenAlgorithmProvider(
&hHashAlg,
BCRYPT_SHA1_ALGORITHM,
NULL,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptOpenAlgorithmProvider\n", status);
goto Cleanup;
}
if(!NT_SUCCESS(status = BCryptOpenAlgorithmProvider(
&hSignAlg,
BCRYPT_ECDSA_P256_ALGORITHM,
NULL,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptOpenAlgorithmProvider\n", status);
goto Cleanup;
}
//calculate the size of the buffer to hold the hash object
if(!NT_SUCCESS(status = BCryptGetProperty(
hHashAlg,
BCRYPT_OBJECT_LENGTH,
(PBYTE)&cbHashObject,
sizeof(DWORD),
&cbData,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptGetProperty\n", status);
goto Cleanup;
}
//allocate the hash object on the heap
pbHashObject = (PBYTE)HeapAlloc (GetProcessHeap (), 0, cbHashObject);
if(NULL == pbHashObject)
{
wprintf(L"**** memory allocation failed\n");
goto Cleanup;
}
//calculate the length of the hash
if(!NT_SUCCESS(status = BCryptGetProperty(
hHashAlg,
BCRYPT_HASH_LENGTH,
(PBYTE)&cbHash,
sizeof(DWORD),
&cbData,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptGetProperty\n", status);
goto Cleanup;
}
//allocate the hash buffer on the heap
pbHash = (PBYTE)HeapAlloc (GetProcessHeap (), 0, cbHash);
if(NULL == pbHash)
{
wprintf(L"**** memory allocation failed\n");
goto Cleanup;
}
//create a hash
if(!NT_SUCCESS(status = BCryptCreateHash(
hHashAlg,
&hHash,
pbHashObject,
cbHashObject,
NULL,
0,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptCreateHash\n", status);
goto Cleanup;
}
//hash some data
if(!NT_SUCCESS(status = BCryptHashData(
hHash,
(PBYTE)rgbMsg,
sizeof(rgbMsg),
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptHashData\n", status);
goto Cleanup;
}
//close the hash
if(!NT_SUCCESS(status = BCryptFinishHash(
hHash,
pbHash,
cbHash,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptFinishHash\n", status);
goto Cleanup;
}
//open handle to KSP
if(FAILED(secStatus = NCryptOpenStorageProvider(
&hProv,
MS_KEY_STORAGE_PROVIDER,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptOpenStorageProvider\n", secStatus);
goto Cleanup;
}
//create a persisted key
if(FAILED(secStatus = NCryptCreatePersistedKey(
hProv,
&hKey,
NCRYPT_ECDSA_P256_ALGORITHM,
L"my ecc key",
0,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptCreatePersistedKey\n", secStatus);
goto Cleanup;
}
//create key on disk
if(FAILED(secStatus = NCryptFinalizeKey(hKey, 0)))
{
wprintf(L"**** Error 0x%x returned by NCryptFinalizeKey\n", secStatus);
goto Cleanup;
}
//sign the hash
if(FAILED(secStatus = NCryptSignHash(
hKey,
NULL,
pbHash,
cbHash,
NULL,
0,
&cbSignature,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptSignHash\n", secStatus);
goto Cleanup;
}
//allocate the signature buffer
pbSignature = (PBYTE)HeapAlloc (GetProcessHeap (), 0, cbSignature);
if(NULL == pbSignature)
{
wprintf(L"**** memory allocation failed\n");
goto Cleanup;
}
if(FAILED(secStatus = NCryptSignHash(
hKey,
NULL,
pbHash,
cbHash,
pbSignature,
cbSignature,
&cbSignature,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptSignHash\n", secStatus);
goto Cleanup;
}
if(FAILED(secStatus = NCryptExportKey(
hKey,
NULL,
BCRYPT_ECCPUBLIC_BLOB,
NULL,
NULL,
0,
&cbBlob,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptExportKey\n", secStatus);
goto Cleanup;
}
pbBlob = (PBYTE)HeapAlloc (GetProcessHeap (), 0, cbBlob);
if(NULL == pbBlob)
{
wprintf(L"**** memory allocation failed\n");
goto Cleanup;
}
if(FAILED(secStatus = NCryptExportKey(
hKey,
NULL,
BCRYPT_ECCPUBLIC_BLOB,
NULL,
pbBlob,
cbBlob,
&cbBlob,
0)))
{
wprintf(L"**** Error 0x%x returned by NCryptExportKey\n", secStatus);
goto Cleanup;
}
if(!NT_SUCCESS(status = BCryptImportKeyPair(
hSignAlg,
NULL,
BCRYPT_ECCPUBLIC_BLOB,
&hTmpKey,
pbBlob,
cbBlob,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptImportKeyPair\n", status);
goto Cleanup;
}
if(!NT_SUCCESS(status = BCryptVerifySignature(
hTmpKey,
NULL,
pbHash,
cbHash,
pbSignature,
cbSignature,
0)))
{
wprintf(L"**** Error 0x%x returned by BCryptVerifySignature\n", status);
goto Cleanup;
}
wprintf(L"Success!\n");
Cleanup:
if(hHashAlg)
{
BCryptCloseAlgorithmProvider(hHashAlg,0);
}
if(hSignAlg)
{
BCryptCloseAlgorithmProvider(hSignAlg,0);
}
if (hHash)
{
BCryptDestroyHash(hHash);
}
if(pbHashObject)
{
HeapFree(GetProcessHeap(), 0, pbHashObject);
}
if(pbHash)
{
HeapFree(GetProcessHeap(), 0, pbHash);
}
if(pbSignature)
{
HeapFree(GetProcessHeap(), 0, pbSignature);
}
if(pbBlob)
{
HeapFree(GetProcessHeap(), 0, pbBlob);
}
if (hTmpKey)
{
BCryptDestroyKey(hTmpKey);
}
if (hKey)
{
NCryptDeleteKey(hKey, 0);
}
if (hProv)
{
NCryptFreeObject(hProv);
}
}