Decrypting the LockCrypt Ransomware

Share and earn Cybytes
Facebook Twitter LinkedIn Email


LockCrypt, also known as EncryptServer2018 is a ransomware family that has been in the wild since mid 2017 and is still active today. The malware was reversed and analyzed thoroughly by Malwarebytes Labs in April, correctly concluded that the unsophisticated home-made encryption used in this malware seems to be breakable.

However, the Malwarebytes researchers did not publish any decryptor for this malware, and we couldn’t find any other public decryption method online either. The only other clue was a news post which referred victims to Michael Gillespie (@demonslay335) for help with its decryption.

We contacted Michael, who did some really nice work together with @hasherezade and @FraMauronz, but whose recovery method was incomplete – it required a large known plaintext file (1MB), could not recover all filenames, and in some cases could not decrypt 1-2 bytes in the end of the file.

In this blog post we will describe our analysis of the home-made encryption that the malware used, how we broke it, and how the encryption key can be recovered in case you have at least 25KB of known plaintext. This scenario is very realistic, since LockCrypt encrypts all of the files it can find, including application files like DLLs which can be easily recovered by installing the same software version on a different computer. Scripts and instructions for recovering files are included in the final section of the report.

Note that a new variant of this malware with better encryption has recently been spotted. We have not analyzed this new version, but it appears to use much stronger encryption.


Initial analysis

Disassembling the malware encryption, we found that the malware authors chose to encrypt the files using some custom-made encryption which looked pretty weak. It really surprised us that in 2018 you could still encounter a ransomware with a custom encryption models, when you can easily use Windows APIs to encrypt data in a way that will take billions of years to crack using current and foreseeable hardware (for example for 128-bit AES with a key that was generated using cryptographically safe methods).

The disassembly of the encryption functions is equivalent to the following Python code (equivalent C code for the encrypt() function can be seen in Malwarebyte’s analysis and might be easier to understand because of the pointer operations):

def grouper(iterable, n, fillvalue=None):
    """returns a generator which iterates iterable in groups of size n.
    in case the last group is incomplete, it is padded with fillvalue"""

    args = [iter(iterable)] * n
    return itertools.izip_longest(fillvalue=fillvalue, *args)

def rol(val, n, width):
	"""equivalent to the x86 rol opcode"""
    return (val << n) & ((1<<width)-1) | 
           ((val & ((1<<width)-1)) >> (width-n))

def encrypt(key, plain):
    size = len(plain)-2
    enc = io.BytesIO(plain)

    # phase 1
    key_cyclic = grouper(itertools.cycle(key), 4)
    for _ in xrange(0, size&(~0x3), 2): # align the size of the data to a multiple of 4 bytes
        # get the next key dword
        k = "".join(
        k = struct.unpack("<I", k)[0]

        # get the next data dword
        d =
        d = struct.unpack("<I", d)[0]

        # XOR them and put it back to the data
        e = k^d
        e = struct.pack("<I", e), os.SEEK_CUR)

        # go back 2 bytes in the data stream (so that loop iterations overlap), os.SEEK_CUR)

    # phase 2, os.SEEK_SET)
    key_cyclic = grouper(itertools.cycle(key), 4)
    for i in xrange(0, size&(~0x3), 4):
        # get the next key dword
        k = "".join(
        k = struct.unpack("<I", k)[0]

        # get the next data dword
        d =
        d = struct.unpack("<I", d)[0]

        # rotate the data dword
        e = rol(d, 5, 32)
        # XOR it with the key dword
        e = e^k
        # swap the byte order
        e = struct.pack(">I", e)
        # put the data dword back, os.SEEK_CUR)

    return enc.getvalue()

def encrypt_file(key, file):
    # len(key) == 25000

    # leave the first 4 bytes as-is, os.SEEK_SET)

    # encrypt the rest of the first 1MB of the file
    plain_data = - 4)
    enc_data = encrypt(key, plain_data), os.SEEK_SET)

    # leave the rest of the file as is

The following conclusions are  apparent:

  1. The transformation defined by phase 1 is cyclic with a cycle length of 12500 bytes
  2. The transformation defined by phase 2 is cyclic with a cycle length of 25000 bytes
  3. Excluding edge cases (we’ll discuss those later on), each plain bit is XOR-ed to 3 key bits (two during phase 1 and another one during phase 2)
  4. If we “undo” the bit shifts done in Phase 2 (swapping back the byte order and ROR back 5 bits), both phases together can be described as a stream cipher with a cyclic key of length 25000 (which is a function of the original key)

We will explain the last two conclusions using the following diagrams which visualize the transformation of on data bytes 4:8 while going through the different steps of the encryption function. The ⊕ symbol between the rows indicates the bits have been XOR-ed with eachother.

Before any sort of transformation, the bits of bytes 4:8 look like:




After the 2nd iteration of the phase 1 loop:



After the 3rd iteration of the phase 1 loop:



After the 4th iteration of the phase 1 loop (and the same after the entire phase 1 loop):


During the 2nd iteration of the phase 2 loop, after the ROL operation:lockcrypt_5


During the 2nd iteration of the phase 2 loop, after the XOR operation:


The order of the bytes is then swapped, and this concludes these bytes’ encryption.


Recovering the “stream key”

If we take the encrypted bytes 4:8 from the last diagram, unswap their order, and ROR them back 5 bits, we get:


This operation (unswapping the byte order and ROR-ing back 5 bits) has basically “normalized” the encryption to a typical stream cipher. If we then XOR these bytes with known plain bytes, we’ll be left with the function of the key bits that we mentioned in conclusion 4 above:


We call this stream (whose each bit is actually three XOR-ed key bits) the “stream key”. Since it is cyclic with a cycle length of 25000 bytes, it seems enough to have 25000 bytes of both plain and encrypted bytes in order to recover it and then decrypt the file!

The following python function can be used to recover the stream key using some given plaintext and encrypted data pairs. The index parameter specifies the index of the 25000 known plaintext bytes in the given string (minus 4, since the first 4 bytes are never encrypted), i.e. only bytes idx+4:idx+4+25000 in the plain string will be used, and if we have a known plaintext file of length 50000 bytes we can use 0 <= idx < 24998.


key_len = 25000

def ror(val, n, width):
    return ((val & ((1<<width)-1)) >> n) | 
           (val << (width-n) & ((1<<width)-1))

def recover_stream_key(plain, enc, idx):
    assert len(plain) == len(enc)
    assert len(plain) - 2 >= idx + key_len

    plain = io.BytesIO(plain)
    enc = io.BytesIO(enc)

    assert == & (~3), os.SEEK_CUR) & (~3), os.SEEK_CUR)

    stream_key = io.BytesIO()
    for i in xrange(0, key_len + (idx % 4), 4):
        # read the next plain dword
        p =
        p = struct.unpack("<I", p)[0]

        # read the next encrypted dword and undo the bit shifts on it
        e =
            # unswap the byte order
        e = struct.unpack(">I", e)[0]
            # ROR back 5 bits
        e = ror(e, 5, 32)

        # XOR the plain and normalized encrypted dwords
        k = p^e
        k = struct.pack("<I", k)

        # write the stream key dword to the recovered stream key stream
        if i == 0:
            stream_key.write(k[idx % 4:])
        elif i < key_len:
        else: # i == key_len
            stream_key.write(k[:-idx % 4])
    stream_key = stream_key.getvalue()

    assert len(stream_key) == key_len

    return stream_key

We should now (not really) be able to decrypt files with the following function:

def decrypt(stream_key, enc):
    size = len(enc)-2

    plain = io.BytesIO(enc)

    stream_key_cyclic = grouper(itertools.cycle(stream_key), 4)
    for i in xrange(0, size&(~3), 4):
        # read the next stream key dword
        sk = "".join(
        sk = struct.unpack("<I", sk)[0]

        # read the next encrypted dword and undo the bit shifts on it
        e =
            # unswap the byte order
        e = struct.unpack(">I", e)[0]
            # ROR back 5 bits
        e = ror(e, 5, 32)

        # XOR the normalized encrypted dword with the stream key dword to recover
        # the plain dword
        p = e^sk
        p = struct.pack("<I", p), os.SEEK_CUR)

    return plain.getvalue()

def decrypt_file(stream_key, file):
    assert len(stream_key) == key_len

    # leave the first 4 bytes as-is, os.SEEK_SET)

    # decrypt the rest of the first 1MB of the file
    enc_data = - 4)
    plain_data = decrypt(stream_key, enc_data), os.SEEK_SET)

    # leave the rest of the file as is

Unfortunately, the above solution excludes the handling a few edge cases:

  1. The first 2 encrypted bytes (bytes 4:6 of the original file) are only XOR-ed with 2 key bits, and therefore:
    1. In order to decrypt the rest of the bytes we must use a stream key of idx >= 2
    2. In order to decrypt the first two bytes we must use the stream key of idx == 0
  2. If the length of the original file != 2 (mod 4), we will have len(plain) != 0 (mod 4) in encrypt(), and therefore we will have 1-2 bytes in the end of the file encrypted only by the last iteration of phase 1. Each plain bit of those bytes will be XOR-ed with only 1 key bit (which we don’t have) and so we cannot decrypt them.

Moreover, as indicated by Malwarebytes the filenames are encrypted by XOR-ing directly with a subset of the original key, and we won’t be able to decrypt them as well. A filename of length m can be decrypted if we have a known filename of length n >= m, as @demonslay335 uses in their decryptor.

To conclude, in order to recover any arbitrary length file and filename, it look like we actually have to recover the original encryption key and not just the stream key we described.


Recovering the original key

The analysis we showed above in fact gave us linear equation system (over GF(2), in which XOR is the addition operation) which tie the stream key with the original key. If we try to generalize the analysis, the following python function can give us the original key bit indices which XOR-ed together result in each stream key bit (indexed by i):


key_bitlen = 25000*8

def k_for_i(i):
    i_dword = i >> 5 # the index of the dword for bit i
    i_offset = i % 32 # the index of bit i in its dword

    i = i + key_bitlen

    k = []

    k.append((i_dword << 6) + i_offset)

    if i_offset < 16:
        k.append(k[0] - 16)
        k.append(k[0] + 16)

    k.append((i_dword << 5) + ((i_offset + 5) % 32))

    return [x % key_bitlen for x in k if x >= 0]

That is, stream_key[i] == reduce(xor, (key[k] for k in k_for_i(i)))

With this function, we can generate a very sparse 200000×200000 matrix over GF(2) which will describe the transformation between the original key and the stream key:

def gen_equations(idx):
    A_i_j_s = []
    for i in xrange(idx << 3, (idx << 3) + key_bitlen):
    return A_i_j_s

That is, row i of the matrix A is all 0s except for the columns in A_i_j_s[i] (which are 1).

This is a VERY sparse matrix (each row contains only 3 values) and so it is feasible to solve it on a regular PC using linear algebra methods. For example, using the mathematics software SageMath, we can do the following:


import itertools
import struct

def grouper(iterable, n, fillvalue=None):
    args = [iter(iterable)] * n
    return itertools.izip_longest(fillvalue=fillvalue, *args)

def str2bits(s):
    bits = []

    for dword in grouper(s, 4):
        dword = "".join(dword)
        dword = struct.unpack("<I", dword)[0]

        bits += [(dword >> i) & 1 for i in xrange(32)]

    return bits

def bits2str(bits):
    s = []

    for dword_bits in grouper(bits, 32):
        dword = 0

        for i, bit in enumerate(dword_bits):
            dword = dword | (bit << i)

        s.append(struct.pack("<I", dword))

    return "".join(s)

stream_key_idx = 2
with open("key-stream-idx-2.bin") as f:
    stream_key =
assert len(stream_key) == 25000

stream_key_bits = str2bits(stream_key)
Y = vector(GF(2), 200000, stream_key_bits)

# create a matrix with the equations for the stream key bit
A_i_j_s = gen_equations(stream_key_idx)

A = matrix(GF(2), 200000, sparse=True)
for i, A_i_j in enumerate(A_i_j_s):
    for j in A_i_j:
        A[i,j] = 1

# recover the original key bits
X = A.solve_right(Y)

key_bits = [int(x) for x in X.list()]
key = bits2str(key_bits)

with open('key.bin', 'wb') as f:


Decrypting your files

To summarize, the steps to recover the encryption key used by the malware:

  1. Recover a plaintext (unencrypted) version of a file which was encrypted by the ransomware and is at least 25006 bytes of size
    1. We recommend doing that by installing the same software version of some software that was encrypted by the ransomware on a different computer, and try to match an encrypted DLL file to its original using their file sizes
  2. Install Python 2.7 if not already installed
  3. Use the py script to recover the stream key for a certain idx from a given pair of encrypted and plaintext files.
    1. As stated above, we recommend using idx = 25000 if you have a large enough known plaintext file
  4. Install SageMath
  5. Use the code snippet above with SageMath to recover the original encryption key (make sure to fix the filenames of the stream key and output key)
  6. Use the attached py script to decrypt the encrypted files

We truly hope that any victims of this ransomware will find this analysis and scripts useful in recovering their lost files.

The post Decrypting the LockCrypt Ransomware appeared first on Palo Alto Networks Blog.

Share this post and earn Cybytes
Facebook Twitter LinkedIn Email
About Palo Alto Networks
Palo Alto Networks is the next-generation security company maintaining trust in the digital age by helping tens of thousands of organizations worldwide prevent cyber breaches. With our deep cybersecurity expertise, commitment to innovation, and game-changing Next-Generation Security Platform, customers can confidently pursue a digital-first strategy and embark on new technology initiatives, such as cloud and mobility. This kind of thinking and know-how helps customer organizations grow their business and empower employees all while maintaining complete visibility and the control needed to protect their critical control systems and most valued data assets. Our platform was built from the ground up for breach prevention, with threat information shared across security functions system-wide, and designed to operate in increasingly mobile, modern networks. By combining network, cloud and endpoint security with advanced threat intelligence in a natively integrated security platform, we safely enable all applications and deliver highly automated, preventive protection against cyberthreats at all stages in the attack lifecycle without compromising performance. Customers benefit from superior security to what legacy or point products provide and realize a better total cost of ownership.
Promoted Content
Unit 42 Report - Ransomware: Unlocking the Lucrative Criminal Business Model
Ransomware, specifically cryptographic ransomware, has quickly become one of the greatest cyber threats facing organizations around the world. This criminal business model has proven to be highly effective in generating revenue for cyber criminals in addition to causing significant operational impact to affected organizations. It is largely victim agnostic, spanning across the globe and affecting all major industry verticals. Small organizations, large enterprises, individual home users – everyone is a potential target. Ransomware has existed in various forms for decades, but in the last several years criminals have perfected the key components of these attacks. This has led to an explosion of new malware families and has drawn new actors into participating in these lucrative schemes.

Our Revolution

We believe Cyber Security training should be free, for everyone, FOREVER. Everyone, everywhere, deserves the OPPORTUNITY to learn, begin and grow a career in this fascinating field. Therefore, Cybrary is a free community where people, companies and training come together to give everyone the ability to collaborate in an open source way that is revolutionizing the cyber security educational experience.

Cybrary On The Go

Get the Cybrary app for Android for online and offline viewing of our lessons.

Get it on Google Play

Support Cybrary

Donate Here to Get This Month's Donor Badge

Skip to toolbar

We recommend always using caution when following any link

Are you sure you want to continue?