#include "integrity.h" #include "common.h" #include "driver.h" #include "modules.h" #include typedef struct _INTEGRITY_CHECK_HEADER { INT executable_section_count; LONG total_packet_size; }INTEGRITY_CHECK_HEADER, *PINTEGRITY_CHECK_HEADER; /* * note: this can be put into its own function wihtout an IRP as argument then it can be used * in both the get driver image ioctl handler and the CopyDriverExecvutableRegions func */ NTSTATUS GetDriverImageSize( _In_ PIRP Irp ) { NTSTATUS status; SYSTEM_MODULES modules = { 0 }; PRTL_MODULE_EXTENDED_INFO driver_info; status = GetSystemModuleInformation( &modules ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "GetSystemModuleInformation failed with status %x", status ); return status; } driver_info = FindSystemModuleByName( "driver.sys", &modules ); Irp->IoStatus.Information = sizeof( ULONG ); RtlCopyMemory( Irp->AssociatedIrp.SystemBuffer, &driver_info->ImageSize, sizeof( ULONG ) ); if (modules.address ) ExFreePoolWithTag( modules.address, SYSTEM_MODULES_POOL ); return status; } NTSTATUS GetModuleInformationByName( _In_ PRTL_MODULE_EXTENDED_INFO ModuleInfo, _In_ LPCSTR ModuleName ) { NTSTATUS status = STATUS_SUCCESS; SYSTEM_MODULES modules = { 0 }; PRTL_MODULE_EXTENDED_INFO driver_info; status = GetSystemModuleInformation( &modules ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "GetSystemModuleInformation failed with status %x", status ); TerminateProtectedProcessOnViolation(); return status; } driver_info = FindSystemModuleByName( "driver.sys", &modules ); ModuleInfo->FileNameOffset = driver_info->FileNameOffset; ModuleInfo->ImageBase = driver_info->ImageBase; ModuleInfo->ImageSize = driver_info->ImageSize; RtlCopyMemory( ModuleInfo->FullPathName, driver_info->FullPathName, sizeof( ModuleInfo->FullPathName ) ); if ( modules.address ) ExFreePoolWithTag( modules.address, SYSTEM_MODULES_POOL ); return status; } NTSTATUS StoreModuleExecutableRegionsInBuffer( _In_ PVOID* Buffer, _In_ PVOID ModuleBase, _In_ SIZE_T ModuleSize, _In_ PSIZE_T BytesWritten ) { NTSTATUS status = STATUS_SUCCESS; PIMAGE_DOS_HEADER dos_header; PLOCAL_NT_HEADER nt_header; PIMAGE_SECTION_HEADER section; ULONG total_packet_size = 0; ULONG num_sections = 0; ULONG num_executable_sections = 0; UINT64 buffer_base; ULONG bytes_returned; MM_COPY_ADDRESS address; if ( !ModuleBase || !ModuleSize ) return STATUS_INVALID_PARAMETER; DEBUG_LOG( "Module base: %llx, size: %llx", (UINT64)ModuleBase, ModuleSize ); /* * The reason we allocate a buffer to temporarily hold the section data is that * we don't know the total size until after we iterate over the sections meaning * we cant set Irp->IoStatus.Information to the size of our reponse until we * enumerate and count all executable sections for the file. */ *Buffer = ExAllocatePool2( POOL_FLAG_NON_PAGED, ModuleSize + sizeof( INTEGRITY_CHECK_HEADER ), POOL_TAG_INTEGRITY ); if ( !*Buffer ) return STATUS_ABANDONED; /* * Note: Verifier doesn't like it when we map the module so rather then mapping it to our address * space we will simply use MmCopyMemory on the module to avoid upsettings verifier :) */ dos_header = ( PIMAGE_DOS_HEADER )ModuleBase; /* * The IMAGE_DOS_HEADER.e_lfanew stores the offset of the IMAGE_NT_HEADER from the base * of the image. */ nt_header = ( struct _IMAGE_NT_HEADERS64* )( ( UINT64 )ModuleBase + dos_header->e_lfanew ); num_sections = nt_header->FileHeader.NumberOfSections; /* * The IMAGE_FIRST_SECTION macro takes in an IMAGE_NT_HEADER and returns the address of * the first section of the PE file. */ section = IMAGE_FIRST_SECTION( nt_header ); buffer_base = ( UINT64 )*Buffer + sizeof( INTEGRITY_CHECK_HEADER ); for ( ULONG index = 0; index < num_sections; index++ ) { DEBUG_LOG( "section name: %s, size: %lx", section->Name, section->SizeOfRawData ); if ( section->Characteristics & IMAGE_SCN_MEM_EXECUTE ) { /* * Note: MmCopyMemory will fail on discardable sections. */ address.VirtualAddress = section; status = MmCopyMemory( ( UINT64 )buffer_base + total_packet_size, address, sizeof( IMAGE_SECTION_HEADER ), MM_COPY_MEMORY_VIRTUAL, &bytes_returned ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "MmCopyMemory failed with status %x", status ); ExFreePoolWithTag( *Buffer, POOL_TAG_INTEGRITY ); TerminateProtectedProcessOnViolation(); return status; } address.VirtualAddress = ( UINT64 )ModuleBase + section->PointerToRawData; status = MmCopyMemory( ( UINT64 )buffer_base + total_packet_size + sizeof( IMAGE_SECTION_HEADER ), address, section->SizeOfRawData, MM_COPY_MEMORY_VIRTUAL, &bytes_returned ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "MmCopyMemory failed with status %x", status ); ExFreePoolWithTag( *Buffer, POOL_TAG_INTEGRITY ); TerminateProtectedProcessOnViolation(); return status; } total_packet_size += section->SizeOfRawData + sizeof( IMAGE_SECTION_HEADER ); num_executable_sections += 1; } section++; } INTEGRITY_CHECK_HEADER header = { 0 }; header.executable_section_count = num_executable_sections; header.total_packet_size = total_packet_size + sizeof( INTEGRITY_CHECK_HEADER ); RtlCopyMemory( *Buffer, &header, sizeof( INTEGRITY_CHECK_HEADER ) ); *BytesWritten = total_packet_size + sizeof( INTEGRITY_CHECK_HEADER ); return status; } NTSTATUS MapDiskImageIntoVirtualAddressSpace( _In_ PHANDLE SectionHandle, _In_ PVOID* Section, _In_ PUNICODE_STRING Path, _In_ PSIZE_T Size ) { NTSTATUS status; HANDLE file_handle; OBJECT_ATTRIBUTES object_attributes; PIO_STATUS_BLOCK pio_block; UNICODE_STRING path; RtlInitUnicodeString( &path, L"\\SystemRoot\\System32\\Drivers\\driver.sys" ); InitializeObjectAttributes( &object_attributes, &path, OBJ_KERNEL_HANDLE | OBJ_CASE_INSENSITIVE, NULL, NULL ); status = ZwOpenFile( &file_handle, FILE_GENERIC_READ | SYNCHRONIZE, &object_attributes, &pio_block, FILE_GENERIC_READ, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "ZwOpenFile failed with statsu %x", status ); TerminateProtectedProcessOnViolation(); return status; } object_attributes.ObjectName = NULL; if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "NTSetInformationProcess failed with status %x", status ); ZwClose( file_handle ); TerminateProtectedProcessOnViolation(); return status; } /* * Its important that we set the SEC_IMAGE flag with the PAGE_READONLY * flag as we are mapping an executable image. */ status = ZwCreateSection( SectionHandle, SECTION_ALL_ACCESS, &object_attributes, NULL, PAGE_READONLY, SEC_IMAGE, file_handle ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "ZwCreateSection failed with status %x", status ); ZwClose( file_handle ); TerminateProtectedProcessOnViolation(); return status; } /* * Mapping a section with the flag SEC_IMAGE (see function above) tells the os we * are mapping an executable image. This then allows the OS to take care of parsing * the PE header and dealing with all relocations for us, meaning the mapped image * will be identical to the in memory image. */ status = ZwMapViewOfSection( *SectionHandle, ZwCurrentProcess(), Section, NULL, NULL, NULL, Size, ViewUnmap, MEM_TOP_DOWN, PAGE_READONLY ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "ZwMapViewOfSection failed with status %x", status ); ZwClose( file_handle ); ZwClose( *SectionHandle ); TerminateProtectedProcessOnViolation(); return status; } ZwClose( file_handle ); return status; } NTSTATUS ComputeHashOfBuffer( _In_ PVOID Buffer, _In_ ULONG BufferSize, _In_ PVOID* HashResult, _In_ PULONG HashResultSize ) { /* * Since the windows documentation for the BCrypt functions contain the worst variable naming scheme * in existence, I will try to explain what they do. (for my sake and any readers who also aren't smart * enough to understand their otherworldy naming convention) * * algo_handle: handle to our BCrypt algorithm * hash_handle: handle to our BCrypt hash * bytes_copied: number of bytes that were copied to the output buffer when using BCryptGetProperty * resulting_hash_size: this is the size of the final buffer hash, it should be equal to 32 (sizeof SHA256 hash) * hash_object_size: the size of the buffer that will temporarily store our hash object * hash_object: pointer to the buffer storing our hash object which is used to hash our buffer * resulting_hash: pointer to the buffer that stores the resulting hash of our buffer, this is what we care about */ NTSTATUS status; BCRYPT_ALG_HANDLE algo_handle = NULL; BCRYPT_HASH_HANDLE hash_handle = NULL; ULONG bytes_copied = 0; ULONG resulting_hash_size = 0; ULONG hash_object_size = 0; PCHAR hash_object = NULL; PCHAR resulting_hash = NULL; status = BCryptOpenAlgorithmProvider( &algo_handle, BCRYPT_SHA256_ALGORITHM, NULL, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptOpenAlogrithmProvider failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } /* * Request the size of the hash object buffer, this is different then the buffer that * will store the resulting hash, instead this will be used to store the hash object * used to create the hash. */ status = BCryptGetProperty( algo_handle, BCRYPT_OBJECT_LENGTH, ( PCHAR )&hash_object_size, sizeof( ULONG ), &bytes_copied, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptGetProperty failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } hash_object = ExAllocatePool2( POOL_FLAG_NON_PAGED, hash_object_size, POOL_TAG_INTEGRITY ); /* * This call gets the size of the resulting hash, which we will use to allocate the * resulting hash buffer. */ status = BCryptGetProperty( algo_handle, BCRYPT_HASH_LENGTH, ( PCHAR )&resulting_hash_size, sizeof( ULONG ), &bytes_copied, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptGetProperty failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } resulting_hash = ExAllocatePool2( POOL_FLAG_NON_PAGED, resulting_hash_size, POOL_TAG_INTEGRITY ); if ( !resulting_hash ) goto end; /* * Here we create our hash object and store it in the hash_object buffer. */ status = BCryptCreateHash( algo_handle, &hash_handle, hash_object, hash_object_size, NULL, NULL, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptCreateHash failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } /* * This function hashes the buffer, but does NOT store it in our resulting buffer yet, * we need to call BCryptFinishHash to retrieve the final hash. */ status = BCryptHashData( hash_handle, Buffer, BufferSize, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptHashData failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } /* * As said in the previous comment, this is where we retrieve the final hash and store * it in our output buffer. */ status = BCryptFinishHash( hash_handle, resulting_hash, resulting_hash_size, NULL ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "BCryptFinishHash failed with status %x", status ); TerminateProtectedProcessOnViolation(); return status; } *HashResult = resulting_hash; *HashResultSize = resulting_hash_size; end: if ( algo_handle ) BCryptCloseAlgorithmProvider( algo_handle, 0 ); if ( hash_handle ) BCryptDestroyHash( hash_handle ); if ( hash_object ) ExFreePoolWithTag( hash_object, POOL_TAG_INTEGRITY ); return status; } /* * 1. map driver to memory * 2. store executable sections in buffer * 3. do the same with the in-memory module * 4. hash both buffers * 5. compare */ NTSTATUS VerifyInMemoryImageVsDiskImage( //_In_ PIRP Irp ) { NTSTATUS status; UNICODE_STRING path; HANDLE section_handle = NULL; PVOID section = NULL; SIZE_T section_size = NULL; SIZE_T bytes_written = NULL; PVOID disk_buffer = NULL; PVOID in_memory_buffer = NULL; RTL_MODULE_EXTENDED_INFO module_info = { 0 }; UINT64 disk_base = NULL; UINT64 memory_base = NULL; PIMAGE_SECTION_HEADER disk_text_header = NULL; PIMAGE_SECTION_HEADER memory_text_header = NULL; PVOID disk_text_hash = NULL; PVOID memory_text_hash = NULL; ULONG disk_text_hash_size = NULL; ULONG memory_text_hash_size = NULL; SIZE_T result = NULL; /* TODO: ad this into global config */ RtlInitUnicodeString( &path, L"\\SystemRoot\\System32\\Drivers\\driver.sys" ); status = MapDiskImageIntoVirtualAddressSpace( §ion_handle, §ion, &path, §ion_size ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "MapDiskImageIntoVirtualAddressSpace failed with status %x", status ); TerminateProtectedProcessOnViolation(); return status; } status = StoreModuleExecutableRegionsInBuffer( &disk_buffer, section, section_size, &bytes_written ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "StoreModuleExecutableRegionsInBuffer failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } /* * Parse the in-memory module */ status = GetModuleInformationByName( &module_info, "driver.sys" ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "GetModuleInformationByName failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } status = StoreModuleExecutableRegionsInBuffer( &in_memory_buffer, module_info.ImageBase, module_info.ImageSize, &bytes_written ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "StoreModuleExecutableRegionsInBuffe failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } disk_base = ( UINT64 )( ( UINT64 )disk_buffer + sizeof( INTEGRITY_CHECK_HEADER ) + sizeof( IMAGE_SECTION_HEADER ) ); memory_base = ( UINT64 )( ( UINT64 )in_memory_buffer + sizeof( INTEGRITY_CHECK_HEADER ) + sizeof( IMAGE_SECTION_HEADER ) ); disk_text_header = ( PIMAGE_SECTION_HEADER )( ( UINT64 )disk_buffer + sizeof( INTEGRITY_CHECK_HEADER ) ); memory_text_header = ( PIMAGE_SECTION_HEADER )( ( UINT64 )in_memory_buffer + sizeof( INTEGRITY_CHECK_HEADER ) ); if ( !disk_base || !memory_base || !disk_buffer || !in_memory_buffer ) { DEBUG_ERROR( "buffers are null lmao" ); TerminateProtectedProcessOnViolation(); goto end; } if ( disk_text_header->SizeOfRawData != memory_text_header->SizeOfRawData ) { /* report or bug check etc. */ DEBUG_LOG( "Executable section size differs, LOL" ); TerminateProtectedProcessOnViolation(); goto end; } status = ComputeHashOfBuffer( disk_base, disk_text_header->SizeOfRawData, &disk_text_hash, &disk_text_hash_size ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "ComputeHashOfBuffer failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } status = ComputeHashOfBuffer( memory_base, memory_text_header->SizeOfRawData, &memory_text_hash, &memory_text_hash_size ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "ComputeHashOfBuffer failed with status %x", status ); TerminateProtectedProcessOnViolation(); goto end; } if ( memory_text_hash_size != disk_text_hash_size ) { DEBUG_ERROR( "Error with the hash algorithm, hash sizes are different." ); TerminateProtectedProcessOnViolation(); goto end; } result = RtlCompareMemory( memory_text_hash, disk_text_hash, memory_text_hash_size ); if (result != memory_text_hash_size) { /* report etc. bug check etc. */ DEBUG_ERROR( "Text sections are different from each other!!"); TerminateProtectedProcessOnViolation(); goto end; } DEBUG_LOG( "Text sections are fine, integrity check complete." ); end: if ( section_handle != NULL ) ZwClose( section_handle ); ZwUnmapViewOfSection( ZwCurrentProcess(), section ); if ( disk_buffer ) ExFreePoolWithTag( disk_buffer, POOL_TAG_INTEGRITY ); if ( in_memory_buffer ) ExFreePoolWithTag( in_memory_buffer, POOL_TAG_INTEGRITY ); if ( memory_text_hash ) ExFreePoolWithTag( memory_text_hash, POOL_TAG_INTEGRITY ); if ( disk_text_hash ) ExFreePoolWithTag( disk_text_hash, POOL_TAG_INTEGRITY ); return status; } NTSTATUS RetrieveInMemoryModuleExecutableSections( _In_ PIRP Irp ) { NTSTATUS status; SIZE_T bytes_written = NULL; PVOID buffer = NULL; RTL_MODULE_EXTENDED_INFO module_info = { 0 }; status = GetModuleInformationByName( &module_info, "driver.sys" ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "GetModuleInformationByName failed with status %x", status ); return status; } status = StoreModuleExecutableRegionsInBuffer( &buffer, module_info.ImageBase, module_info.ImageSize, &bytes_written ); if ( !NT_SUCCESS( status ) ) { DEBUG_ERROR( "StoreModuleExecutableRegionsInBuffe failed with status %x", status ); return status; } Irp->IoStatus.Information = bytes_written; RtlCopyMemory( Irp->AssociatedIrp.SystemBuffer, buffer, bytes_written ); if ( buffer ) ExFreePoolWithTag( buffer, POOL_TAG_INTEGRITY ); return status; }