/** * Steamless - Copyright (c) 2015 - 2017 atom0s [atom0s@live.com] * * This work is licensed under the Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License. * To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/4.0/ or send a letter to * Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. * * By using Steamless, you agree to the above license and its terms. * * Attribution - You must give appropriate credit, provide a link to the license and indicate if changes were * made. You must do so in any reasonable manner, but not in any way that suggests the licensor * endorses you or your use. * * Non-Commercial - You may not use the material (Steamless) for commercial purposes. * * No-Derivatives - If you remix, transform, or build upon the material (Steamless), you may not distribute the * modified material. You are, however, allowed to submit the modified works back to the original * Steamless project in attempt to have it added to the original project. * * You may not apply legal terms or technological measures that legally restrict others * from doing anything the license permits. * * No warranties are given. */ namespace Steamless.Unpacker.Variant31.x86 { using API; using API.Crypto; using API.Events; using API.Extensions; using API.Model; using API.PE32; using API.Services; using Classes; using System; using System.Collections.Generic; using System.IO; using System.Security.Cryptography; [SteamlessApiVersion(1, 0)] public class Main : SteamlessPlugin { /// /// Internal logging service instance. /// private LoggingService m_LoggingService; /// /// Gets the author of this plugin. /// public override string Author => "atom0s"; /// /// Gets the name of this plugin. /// public override string Name => "SteamStub Variant 3.1 Unpacker (x86)"; /// /// Gets the description of this plugin. /// public override string Description => "Unpacker for the 32bit SteamStub variant 3.1."; /// /// Gets the version of this plugin. /// public override Version Version => new Version(1, 0, 0, 1); /// /// Internal wrapper to log a message. /// /// /// private void Log(string msg, LogMessageType type) { this.m_LoggingService.OnAddLogMessage(this, new LogMessageEventArgs(msg, type)); } /// /// Initialize function called when this plugin is first loaded. /// /// /// public override bool Initialize(LoggingService logService) { this.m_LoggingService = logService; return true; } /// /// Processing function called when a file is being unpacked. Allows plugins to check the file /// and see if it can handle the file for its intended purpose. /// /// /// public override bool CanProcessFile(string file) { try { // Load the file.. var f = new Pe32File(file); if (!f.Parse() || f.IsFile64Bit() || !f.HasSection(".bind")) return false; // Obtain the bind section data.. var bind = f.GetSectionData(".bind"); // Attempt to locate the known v3.x signature.. var varient = Pe32Helpers.FindPattern(bind, "E8 00 00 00 00 50 53 51 52 56 57 55 8B 44 24 1C 2D 05 00 00 00 8B CC 83 E4 F0 51 51 51 50"); if (varient == 0) return false; // Version patterns.. var varientPatterns = new List> { new KeyValuePair("55 8B EC 81 EC ?? ?? ?? ?? 53 ?? ?? ?? ?? ?? 68", 0x10), // v3.1 [Original version?] new KeyValuePair("55 8B EC 81 EC ?? ?? ?? ?? 53 ?? ?? ?? ?? ?? 8D 83", 0x16), // v3.1.1 [Newer, 3.1.1? (Seen 2015?)] new KeyValuePair("55 8B EC 81 EC ?? ?? ?? ?? 56 ?? ?? ?? ?? ?? ?? ?? ?? ?? ?? 8D", 0x10) // v3.1.2 [Newer, 3.1.2? (Seen late 2017.)] }; var headerSize = 0; uint offset = 0; foreach (var p in varientPatterns) { offset = Pe32Helpers.FindPattern(bind, p.Key); if (offset <= 0) continue; headerSize = BitConverter.ToInt32(bind, (int)offset + p.Value); break; } // Ensure valid data was found.. if (offset == 0 || headerSize == 0) return false; return headerSize == 0xF0; } catch { return false; } } /// /// Processing function called to allow the plugin to process the file. /// /// /// /// public override bool ProcessFile(string file, SteamlessOptions options) { // Initialize the class members.. this.TlsAsOep = false; this.TlsOepRva = 0; this.Options = options; this.CodeSectionData = null; this.CodeSectionIndex = -1; this.XorKey = 0; // Parse the file.. this.File = new Pe32File(file); if (!this.File.Parse()) return false; // Announce we are being unpacked with this packer.. this.Log("File is packed with SteamStub Variant 3.1!", LogMessageType.Information); this.Log("Step 1 - Read, decode and validate the SteamStub DRM header.", LogMessageType.Information); if (!this.Step1()) return false; this.Log("Step 2 - Read, decode and process the payload data.", LogMessageType.Information); if (!this.Step2()) return false; this.Log("Step 3 - Read, decode and dump the SteamDRMP.dll file.", LogMessageType.Information); if (!this.Step3()) return false; this.Log("Step 4 - Handle .bind section. Find code section.", LogMessageType.Information); if (!this.Step4()) return false; this.Log("Step 5 - Read, decrypt and process code section.", LogMessageType.Information); if (!this.Step5()) return false; this.Log("Step 6 - Rebuild and save the unpacked file.", LogMessageType.Information); if (!this.Step6()) return false; return true; } /// /// Step #1 /// /// Read, decode and validate the SteamStub DRM header. /// /// private bool Step1() { // Obtain the DRM header data.. var fileOffset = this.File.GetFileOffsetFromRva(this.File.NtHeaders.OptionalHeader.AddressOfEntryPoint); var headerData = new byte[0xF0]; Array.Copy(this.File.FileData, (int)(fileOffset - 0xF0), headerData, 0, 0xF0); // Xor decode the header data.. this.XorKey = SteamStubHelpers.SteamXor(ref headerData, 0xF0); this.StubHeader = Pe32Helpers.GetStructure(headerData); // Validate the header signature.. if (this.StubHeader.Signature == 0xC0DEC0DF) return true; // Try again using the Tls callback (if any) as the OEP instead.. if (this.File.TlsCallbacks.Count == 0) return false; // Obtain the DRM header data.. fileOffset = this.File.GetRvaFromVa(this.File.TlsCallbacks[0]); fileOffset = this.File.GetFileOffsetFromRva(fileOffset); headerData = new byte[0xF0]; Array.Copy(this.File.FileData, (int)(fileOffset - 0xF0), headerData, 0, 0xF0); // Xor decode the header data.. this.XorKey = SteamStubHelpers.SteamXor(ref headerData, 0xF0); this.StubHeader = Pe32Helpers.GetStructure(headerData); // Validate the header signature.. if (this.StubHeader.Signature != 0xC0DEC0DF) return false; // Tls was valid for the real oep.. this.TlsAsOep = true; this.TlsOepRva = fileOffset; return true; } /// /// Step #2 /// /// Read, decode and process the payload data. /// /// private bool Step2() { // Obtain the payload address and size.. var payloadAddr = this.File.GetFileOffsetFromRva(this.TlsAsOep ? this.TlsOepRva : this.File.NtHeaders.OptionalHeader.AddressOfEntryPoint - this.StubHeader.BindSectionOffset); var payloadSize = (this.StubHeader.PayloadSize + 0x0F) & 0xFFFFFFF0; // Do nothing if there is no payload.. if (payloadSize == 0) return true; this.Log(" --> File has payload data!", LogMessageType.Debug); // Obtain and decode the payload.. var payload = new byte[payloadSize]; Array.Copy(this.File.FileData, payloadAddr, payload, 0, payloadSize); this.XorKey = SteamStubHelpers.SteamXor(ref payload, payloadSize, this.XorKey); try { if (this.Options.DumpPayloadToDisk) { System.IO.File.WriteAllBytes(this.File.FilePath + ".payload", payload); this.Log(" --> Saved payload to disk!", LogMessageType.Debug); } } catch { // Do nothing here since it doesn't matter if this fails.. } return true; } /// /// Step #3 /// /// Read, decode and dump the SteamDRMP.dll file. /// /// private bool Step3() { // Ensure there is a dll to process.. if (this.StubHeader.DRMPDllSize == 0) { this.Log(" --> File does not contain a SteamDRMP.dll file.", LogMessageType.Debug); return true; } this.Log(" --> File has SteamDRMP.dll file!", LogMessageType.Debug); try { // Obtain the SteamDRMP.dll file address and data.. var drmpAddr = this.File.GetFileOffsetFromRva(this.TlsAsOep ? this.TlsOepRva : this.File.NtHeaders.OptionalHeader.AddressOfEntryPoint - this.StubHeader.BindSectionOffset + this.StubHeader.DRMPDllOffset); var drmpData = new byte[this.StubHeader.DRMPDllSize]; Array.Copy(this.File.FileData, drmpAddr, drmpData, 0, drmpData.Length); // Decrypt the data (xtea decryption).. SteamStubHelpers.SteamDrmpDecryptPass1(ref drmpData, this.StubHeader.DRMPDllSize, this.StubHeader.EncryptionKeys); try { if (this.Options.DumpSteamDrmpToDisk) { var basePath = Path.GetDirectoryName(this.File.FilePath) ?? string.Empty; System.IO.File.WriteAllBytes(Path.Combine(basePath, "SteamDRMP.dll"), drmpData); this.Log(" --> Saved SteamDRMP.dll to disk!", LogMessageType.Debug); } } catch { // Do nothing here since it doesn't matter if this fails.. } return true; } catch { this.Log(" --> Error trying to decrypt the files SteamDRMP.dll data!", LogMessageType.Error); return false; } } /// /// Step #4 /// /// Remove the bind section if requested. /// Find the code section. /// /// private bool Step4() { // Remove the bind section if its not requested to be saved.. if (!this.Options.KeepBindSection) { // Obtain the .bind section.. var bindSection = this.File.GetSection(".bind"); if (!bindSection.IsValid) return false; // Remove the section.. this.File.RemoveSection(bindSection); // Decrease the header section count.. var ntHeaders = this.File.NtHeaders; ntHeaders.FileHeader.NumberOfSections--; this.File.NtHeaders = ntHeaders; this.Log(" --> .bind section was removed from the file.", LogMessageType.Debug); } else this.Log(" --> .bind section was kept in the file.", LogMessageType.Debug); // Skip finding the code section if the file is not encrypted.. if ((this.StubHeader.Flags & (uint)SteamStubDrmFlags.NoEncryption) == (uint)SteamStubDrmFlags.NoEncryption) return true; // Find the code section.. var codeSection = this.File.GetOwnerSection(this.StubHeader.CodeSectionVirtualAddress); if (codeSection.PointerToRawData == 0 || codeSection.SizeOfRawData == 0) return false; // Store the code sections index.. this.CodeSectionIndex = this.File.GetSectionIndex(codeSection); return true; } /// /// Step #5 /// /// Read, decrypt and process the code section. /// /// private bool Step5() { // Skip decryption if the code section is not encrypted.. if ((this.StubHeader.Flags & (uint)SteamStubDrmFlags.NoEncryption) == (uint)SteamStubDrmFlags.NoEncryption) { this.Log(" --> Code section is not encrypted.", LogMessageType.Debug); return true; } try { // Obtain the code section.. var codeSection = this.File.Sections[this.CodeSectionIndex]; this.Log($" --> {codeSection.SectionName} linked as main code section.", LogMessageType.Debug); this.Log($" --> {codeSection.SectionName} section is encrypted.", LogMessageType.Debug); // Obtain the code section data.. var codeSectionData = new byte[codeSection.SizeOfRawData + this.StubHeader.CodeSectionStolenData.Length]; Array.Copy(this.StubHeader.CodeSectionStolenData, 0, codeSectionData, 0, this.StubHeader.CodeSectionStolenData.Length); Array.Copy(this.File.FileData, this.File.GetFileOffsetFromRva(codeSection.VirtualAddress), codeSectionData, this.StubHeader.CodeSectionStolenData.Length, codeSection.SizeOfRawData); // Create the AES decryption helper.. var aes = new AesHelper(this.StubHeader.AES_Key, this.StubHeader.AES_IV); aes.RebuildIv(this.StubHeader.AES_IV); // Decrypt the code section data.. var data = aes.Decrypt(codeSectionData, CipherMode.CBC, PaddingMode.None); if (data == null) return false; // Set the code section override data.. this.CodeSectionData = data; return true; } catch { this.Log(" --> Error trying to decrypt the files code section data!", LogMessageType.Error); return false; } } /// /// Step #6 /// /// Rebuild and save the unpacked file. /// /// private bool Step6() { FileStream fStream = null; try { // Rebuild the file sections.. this.File.RebuildSections(); // Open the unpacked file for writing.. var unpackedPath = this.File.FilePath + ".unpacked.exe"; fStream = new FileStream(unpackedPath, FileMode.Create, FileAccess.ReadWrite); // Write the DOS header to the file.. fStream.WriteBytes(Pe32Helpers.GetStructureBytes(this.File.DosHeader)); // Write the DOS stub to the file.. if (this.File.DosStubSize > 0) fStream.WriteBytes(this.File.DosStubData); // Update the entry point of the file.. var ntHeaders = this.File.NtHeaders; ntHeaders.OptionalHeader.AddressOfEntryPoint = (uint)this.StubHeader.OriginalEntryPoint; this.File.NtHeaders = ntHeaders; // Write the NT headers to the file.. fStream.WriteBytes(Pe32Helpers.GetStructureBytes(ntHeaders)); // Write the sections to the file.. for (var x = 0; x < this.File.Sections.Count; x++) { var section = this.File.Sections[x]; var sectionData = this.File.SectionData[x]; // Write the section header to the file.. fStream.WriteBytes(Pe32Helpers.GetStructureBytes(section)); // Set the file pointer to the sections raw data.. var sectionOffset = fStream.Position; fStream.Position = section.PointerToRawData; // Write the sections raw data.. var sectionIndex = this.File.Sections.IndexOf(section); if (sectionIndex == this.CodeSectionIndex) fStream.WriteBytes(this.CodeSectionData ?? sectionData); else fStream.WriteBytes(sectionData); // Reset the file offset.. fStream.Position = sectionOffset; } // Set the stream to the end of the file.. fStream.Position = fStream.Length; // Write the overlay data if it exists.. if (this.File.OverlayData != null) fStream.WriteBytes(this.File.OverlayData); this.Log(" --> Unpacked file saved to disk!", LogMessageType.Success); this.Log($" --> File Saved As: {unpackedPath}", LogMessageType.Success); return true; } catch { this.Log(" --> Error trying to save unpacked file!", LogMessageType.Error); return false; } finally { fStream?.Dispose(); } } /// /// Gets or sets if the Tls callback is being used as the Oep. /// private bool TlsAsOep { get; set; } /// /// Gets or sets the Tls Oep Rva if it is being used as the Oep. /// private uint TlsOepRva { get; set; } /// /// Gets or sets the Steamless options this file was requested to process with. /// private SteamlessOptions Options { get; set; } /// /// Gets or sets the file being processed. /// private Pe32File File { get; set; } /// /// Gets or sets the current xor key being used against the file data. /// private uint XorKey { get; set; } /// /// Gets or sets the DRM stub header. /// private SteamStub32Var31Header StubHeader { get; set; } /// /// Gets or sets the index of the code section. /// private int CodeSectionIndex { get; set; } /// /// Gets or sets the decrypted code section data. /// private byte[] CodeSectionData { get; set; } } }