{"id":15056396,"url":"https://github.com/ernw/ss7maper","last_synced_at":"2025-10-04T16:30:53.845Z","repository":{"id":54823316,"uuid":"48054176","full_name":"ernw/ss7MAPer","owner":"ernw","description":"SS7 MAP (pen-)testing toolkit. DISCONTINUED REPO, please use: https://github.com/0xc0decafe/ss7MAPer/","archived":true,"fork":false,"pushed_at":"2018-04-20T08:39:03.000Z","size":52818,"stargazers_count":451,"open_issues_count":5,"forks_count":181,"subscribers_count":67,"default_branch":"master","last_synced_at":"2024-09-30T03:42:02.009Z","etag":null,"topics":["erlang","hlr","m3ua","map","msc","pentest","smsc","ss7"],"latest_commit_sha":null,"homepage":"https://c0decafe.de/git/ss7MAPer.git/","language":"Erlang","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ernw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-12-15T16:07:53.000Z","updated_at":"2024-09-26T19:39:58.000Z","dependencies_parsed_at":"2022-08-14T04:00:16.155Z","dependency_job_id":null,"html_url":"https://github.com/ernw/ss7MAPer","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ernw%2Fss7MAPer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ernw%2Fss7MAPer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ernw%2Fss7MAPer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ernw%2Fss7MAPer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ernw","download_url":"https://codeload.github.com/ernw/ss7MAPer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235274287,"owners_count":18963889,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["erlang","hlr","m3ua","map","msc","pentest","smsc","ss7"],"created_at":"2024-09-24T21:50:46.963Z","updated_at":"2025-10-04T16:30:50.734Z","avatar_url":"https://github.com/ernw.png","language":"Erlang","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ss7MAPer\n\nSS7 MAP (pen-)testing toolkit\n\n## Binary releases\n\nAs a lot of people run into problems building the tool, there are binary releases which can be found here: https://github.com/ernw/ss7MAPer/tree/master/releases\n\nAs people also run into problems using the binary release, there is a [docker image](https://hub.docker.com/r/ernw/ss7maper/) with ss7MAPer running on ubuntu 16.04\n\nIf you use the binary version, skip right over the next chapter.\n\n## Get it running\n\nYou will need:\n\n * Erlang. Get it from your repo or from http://www.erlang.org.\n\n * Rebar. Get it from your repo or from https://github.com/rebar/rebar\n\n * The code (;   \n \n        git clone https://github.com/ernw/ss7MAPer   \n        \n * The dependencies   \n \n        cd ss7MAPer   \n        rebar get-deps   \n        \n * Patch the dependencies   \n \n        cd deps/osmo_map   \n        patch -p1 \u003c ../../patches/osmo_map.patch   \n        cd ../osmo_sccp   \n        patch -p1 \u003c ../../patches/osmo_sccp.patch   \n        cd ../osmo_ss7   \n        patch -p1 \u003c ../../patches/osmo_ss7.patch   \n        \n * Get the deps to build (; This is not as easy as it might sound, I needed to:   \n    Patch the epacp/rebar.config and replace   \n        \n        {port_envs, [   \n          {\"DRV_CFLAGS\", \"-g -Wall $ERL_CFLAGS\"},   \n          {\"DRV_LDFLAGS\", \"-lpcap $ERL_LDFLAGS\"}   \n        ]}.   \n           \n    with   \n        \n        {port_envs, [   \n          {\"CFLAGS\", \"-g -Wall $ERL_CFLAGS\"},   \n          {\"LDFLAGS\", \"-lpcap $ERL_LDFLAGS\"}   \n        ]}.   \n           \n    Another dependency is not covered by rebar, so you need to fetch it manually:   \n        \n        cd deps   \n        git clone http://cgit.osmocom.org/erlang/signerl/   \n           \n    Build the ASN.1 source files:   \n        \n        cd deps/signerl/TCAP/asn_src/ITU   \n        make   \n           \n    Copy the ASN.1 files to osmo_sccp:   \n        \n        cp deps/signerl/TCAP/asn_src/ITU/*rl deps/osmo_sccp/src/   \n           \n    Also the osmo libs have dependencies on each other and some other deps are shared, so I created some symlinks:   \n        \n        mkdir deps/epcap/deps\n        ln -sd ../../pkt deps/epcap/deps/pkt\n        mkdir deps/osmo_sccp/deps   \n        ln -sd ../../osmo_ss7 deps/osmo_sccp/deps/osmo_ss7   \n        ln -sd ../../epcap deps/osmo_sccp/deps/epcap   \n        ln -sd ../../pkt deps/osmo_sccp/deps/pkt   \n        ln -sd ../../signerl/MAP deps/osmo_sccp/deps/MAP    \n        ln -sd ../../signerl/SCCP deps/osmo_sccp/deps/SCCP   \n        ln -sd ../../signerl/TCAP deps/osmo_sccp/deps/TCAP   \n        mkdir deps/osmo_map/deps   \n        ln -sd ../../osmo_ss7 deps/osmo_map/deps/osmo_ss7   \n        ln -sd ../../epcap deps/osmo_map/deps/epcap   \n        ln -sd ../../pkt deps/osmo_map/deps/pkt   \n           \n    And copy some files in place:   \n        \n        cp deps/signerl/SCCP/itu/include/sccp.hrl deps/osmo_sccp/src/   \n        cp deps/signerl/TCAP/include/tcap.hrl deps/osmo_map/src/   \n           \n * Build the code   \n        \n        rebar co   \n           \nIf all the steps above are too much to do by hand (as for me testing ;) you can use the build script here: https://github.com/ernw/ss7MAPer/blob/master/prepare_n_build.sh\n\n## The config file\n\nThe config file is split in 4 section, sctp, m3ua, sccp and target.\n\nIn the *sctp* section source and destination ip as well as source and destination port of the SCTP connection are configured.\n\nIn the *m3ua* section all the M3UA parameters, like local and remote point code are configured.\n\nIn the *sccp* section currently only the local (or source) global title needs to be configured.\n\nLast but not least in the *target* section information about the tested environment need to be configured, like the global title of the HLR, or the MSISDN of the tested phone.\n\nBe sure to modify it to your needs.\n\n## Running the tool\n\n### Running a source build\n\nTo run the tool one needs to start a rebar shell:\n\n    cd ss7MAPer   \n    rebar shell   \n\nStart the application and its dependencies with:\n\n    application:start(sasl).\n    application:start(ss7MAPer).\n\nIf everything is set up correctly the m3ua connection comes up.\n\n### Running the binary release\n\nRun the application by starting it from the root directory:\n\n    cd ss7MAPer\n    ./bin/ss7MAPer console\n\nIf everything is set up correctly the m3ua connection comes up.\n\n### Using the tool\n\nOnce the application is started, there are some commands that can be executed from the erlang command line:\n\n - ss7MAPer:test\\_hlr()\n - ss7MAPer:test\\_msc()\n - ss7MAPer:test\\_smsc()\n\nand each of them does exactly as its called, running MAP tests against the targets defined in the config file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fernw%2Fss7maper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fernw%2Fss7maper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fernw%2Fss7maper/lists"}