ss7MAPer – A SS7 pen testing toolkit

While running some SS7 pentests last year, I developed a small tool automating some of the well-known SS7 attack cases. Today I’m releasing the first version of ss7MAPer, a SS7 MAP (pen-)testing toolkit.

The toolkit is build upon the Osmocom SS7 stack and implements some basic MAP messages. At its current state tests against the HLR are ready for use, in future versions tests against VLR, MSC and SMSC will follow.

The source code of the tool is published on github, feel free to use and extend.

The tool is written in Erlang; to get it running you will need the Erlang runtime environment. It is developed for version 17.5.

As example, the screen shot below shows the output of the tool against a HLR, testing which MAP messages are accepted and the results given back.


As you can see in the picture, the demonstrated test cases for the HLR respond to most of the MAP messages regardless the fact that we are not registered as valid provider. The tool is not configured as a serving MSC nor a roaming contractor. Some of the information gathered can be seen as critical, as the MSISD -> IMSI resolution, the over-the-air crypto keys or the ability to create supplementary services e.g. call forwarding.

The code (and its dependencies) are not that easy to compile but I tried to give a complete step by step instructions in the README file.

The messages and test cases are gathered from public SS7 research of the last years (see 1, 2) and check for known weaknesses in the SS7 domain.
The tool itself was developed under a cooperation with the Belgium provider Proximus and aims to test the secure configuration of the internal and external SS7 network access. Thanks a lot for giving us the opportunity here, we are convinced that the tool gives the research community but also telecommunication providers a new, important and (especially) open-source-based possibility for SS7 testing.

More about the tool and SS7 testing on Troopers TelcoSecDay, Telco Network Security & Network Protocol Fuzzing Workshop.

That’s it, get the code, try the tool.
Best wishes from Heidelberg.



  1. thanks alot for this contribution, i need to know if there any simulation tools to simulate the nodes (HLR,MSC,..etc) as we need to simulate the attacks, and dont want to test the toolkit first on live nodes.
    also when will the messages/attack scenarios for VLR/MSC, and the rest of the nodes be updated?

  2. Hi,

    I have not found any software so emulate the target devices (HLR, MSC, etc.). It might be done with jSS7 ( but I’ve not tested this. There is an open source implementation of a SGW ( that can be used to test the M3UA part of the application.
    To implement further attacks I would need access to an SS7 network with the components reachable. I will likely get access to a real SS7 environment again later this year.



  3. Dear Daniel,

    thanks for your reply, i would like to know if am testing against live nodes, do i have to get an interconnect or you can connect through ss7 thrid party access providers, and do you recommend any?

  4. Hello
    I want to know how you could get access to ss7 network.
    Did you do that by Osmocom SS7 stack and connected to Real operator BTS’s ?

  5. Hello Daniel,

    Assuming we have the permission from a telecom operator, what do we need as hardware/OS/packages to setup a server for connection to SS7 network and how to verify the connection setup is working? Can you provide information on this?


Leave a Reply

Your email address will not be published. Required fields are marked *