, 11 October 2013 | Imprime |  Disponible también en Español

What is YARA?

When speaking about malware detection, there are mainly three ways of determining if a file is malicious: signatures, heuristics and string signatures.

The most widespread in the antivirus detection systems is the signature based detection, i.e. based in the HASH of a file, check it against a signature database and see if this file has previously been detected as malware. This kind of signature is useless for the detection of unknown malware, and to evade this system you just need to recompile the code in a different system or change a single bit.

In order to try to stop these evasion methods, the heuristic method is usually the chosen one. This method relies on the behaviour of the executable file and, according to the actions that it performs inside the system, it decides if it’s dealing with a malicious file. The main issue of this method is that, as many legit programs perform suspicious actions, it can generate a big amount of false positives.

Last but not least, there is the method which this article refers to: string signatures. This method is based in another kind of signatures, different from the aforementioned kind. Instead of using HASH signatures, it uses text or binary strings that uniquely identify a malware sample. That way, even if the file has been tampered with, if it still contains those string signatures, the analysts will be able to detect and classify the malware sample.

YARA is a tool that was designed by Víctor Manuel Álvarez mainly for string signature based detection and classification of malware. And I say “mainly” because it can be used in different ways – man shall not live by malware alone.

Using relatively simple rules, YARA goes over the files that it receives and looks for the strings defined in the rule and, if they match certain conditions, it tells you what rules match each file. This can also be applied to running processes.

It is very easy to use and, in order to install it, you just need to download the packet for your system from the project’s website and follow the install instructions if you are Linux (the link is for Ubuntu, but I’m sure you can adapt it to your favourite distro); and for Windows it’s even easier: you just have to unzip the YARA executable and, for the YARA library: double click, next, next, finish.

One of the things I like the most about YARA: it has a Python library that allows you integrate it very easily with your projects!

YARA rules (Yeah! It rulez!)

To learn about YARA rules, let’s start with a simple example:

rule HelloWorld
		$a = "Hello world"


Dissecting the rule:

rule HelloWorld	//rule -> Keyword all rules start with
		//HelloWorld -> Rule name
	strings:	//Strings section -> In this section the strings
			//that will be used afterwards to check the
			//the conditions are defined.
		$a = "Hello world"	//variable $a, it contains “Hello world”

	condition:	//Condition section -> Conditions are defined.
		$a	//If it matches $a, true

We create three text files to test the rule:


Hello world

Hello World

Analysing YARA’s output. The file rules.yar contains the rule and the option –s will show the string that matches the rule:

# yara –s rules.yar test1.txt
# yara –s rules.yar test2.txt
HelloWorld test2.txt
0x0:$a: Hello world
# yara –s rules.yar test3.txt

We can see a match in the file test2.txt:

HelloWorld test2.txt	-> Matched rule
0x0:$a: Hello world 	-> Offset:variable: String matched

Even if the documentation is very good, the are some undocumented things, like the ones presented by Julia Wolf (@foxgrrl) in the BerlinSides talk entitled Classifying malware with YARA. Unfortunately, I didn’t manage to find it published, so I guess you will only be able to find those problems while fighting against the (YARA) rules.

YARA with binaries

In order to test YARA with binary files, I will set up a scenario. Let’s say we work for an evil corp called The Corp. Inside The Corp, people handle very sensitive patents and in the past it has been the target of some… APTs! We, as part of the The Corporation’s CSIRT, have to be ready for defending our beloved evil corp from possible attacks. The previous attacks analyses reveal that the entry point of all the attacks has been email, and in all of them we have found administrative accounts somewhere in the middle of the code.
As any “good” organization, in The Corporation, a strict naming scheme is followed, and all administrative accounts follow one of the following schemes: either admin.<user> or corp.<user>. Furthermore, in the area we want to defend, we only have Linux systems.

In order to defend The Corporation, we set up a sniffer that captures all the email traffic, extracts the attachments and sends them to YARA.

We prepare the following rule to defend The Corporation:

rule APT_adm_corp : apt 	//apt is just a tag, it doesn’t
					//affect the rule.
        meta:			//Metadata, they don’t affect the rule
                author = "xgusix"

                $adm = "adm."
                $corp = "corp."
                $elf = { 7f 45 4c 46 } //ELF file’s magic numbers

                $elf in (0..4) and ($adm or $corp)
		//If $elf in the first 4 bytes and it matches $adm or $corp

Some fields that did not appear before are explained in the comments. In order to test the rule, we launch it against a malware simulation, which is no less than the following code after being compiled:


int main ()
	char *user = "adm.user";
	return 0;

We run it against our rule with the options: –s to watch the strings; -g to watch the tags; and –m to watch the metadata:

# yara -s -m -g rules.yar testbin
APT_adm_corp [apt] [author="xgusix"] testbin
0x0:$elf: 7F 45 4C 46
0x4c0:$adm: adm.

The rule has been executed successfully and it has caught our “malware”.

There are many ways you can use YARA and what I have just described is simply an example of what can be achieved with this tool. I encourage you all to give it a try and find out what you can do with YARA.

(You can follow us in Twitter: @SecurityArtWork)
No me gusta esta entradaMe gusta esta entrada (Sin votos todavía)
Loading ... Loading ...

4 comentarios a “YARA 101”

(Please note that Spanish and English comments are merged so you may need to use an online translator to understand other users' comments)

Buena entrada,

La verdad que Yara va muy bien para clasificar las distintas familias de malware. Hace nada Mila Parkour actualizo su excel con las reglas de Yara de reconocimiento de familias. Ahora bien, los atacantes solo tiene que tener acceso a las reglas de Yara para modificar el binario en función a la regla de Yara, por eso muchas personas no quieren subir sus reglas.

Un saludo

Ximo [web], 11 de October de 2013, 1:37 pm

Pues se trata de una interesante aplicación. El tema que dice Ximo si es un problema, no poder compartir las reglas…

Alejandro [web], 18 de October de 2013, 11:24 am

[...] ¿Qué es YARA? Cuando se habla de detección de malware existen principalmente tres maneras de determinar si un fichero es dañino o no: firmas, heurística y string signatures. La más extendida en los…  [...]

YARA 101 | Sec Business | Scoop.it [web], 26 de October de 2013, 6:08 pm

Have you ever thought about publishing an ebook or guest
autoring on other sites? I have a blog bassed uponn on the same information you discuss and would really
like to have you share some stories/information. I know my
readers would value your work. If you’re even remotely interested, feel free
to send me an e mail.

Executive Coaching [web], 5 de April de 2015, 1:13 pm

Leave a comment

(Los datos que nos proporciones serán incorporados al fichero LECTORES DEL BLOG cuyo responsable es S2 Grupo, cuya única finalidad es la gestión de las acciones e interacciones que se desarrollen con los usuarios de los blogs de S2 Grupo, entre los que se encuentra Security Art Work. Los datos recogidos no serán en ningún caso cedidos a terceras partes ni tratados para una finalidad distinta a la indicada. Puedes ejercer tus derechos de Acceso, Rectificación, Cancelación y Oposición enviando un correo a admin@securityartwork.es, en el que deberás proporcionarnos la información necesaria para verificar tu identidad. Para cualquier otra consulta o duda relativa a cómo gestionamos tus datos personales, puedes utilizar el mismo correo electrónico.)