{"id":28416843,"url":"https://github.com/withsecurelabs/hl7magic","last_synced_at":"2025-06-25T05:31:21.097Z","repository":{"id":229874602,"uuid":"774389410","full_name":"WithSecureLabs/hl7magic","owner":"WithSecureLabs","description":"A Burp extension to allow for easy modification of HL7 messages sent to and from medical devices.","archived":false,"fork":false,"pushed_at":"2024-03-25T10:50:37.000Z","size":335,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-04T07:28:08.472Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/WithSecureLabs.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2024-03-19T13:18:12.000Z","updated_at":"2025-02-07T22:22:55.000Z","dependencies_parsed_at":"2024-03-26T18:42:49.900Z","dependency_job_id":null,"html_url":"https://github.com/WithSecureLabs/hl7magic","commit_stats":null,"previous_names":["withsecurelabs/hl7magic"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/WithSecureLabs/hl7magic","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WithSecureLabs%2Fhl7magic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WithSecureLabs%2Fhl7magic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WithSecureLabs%2Fhl7magic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WithSecureLabs%2Fhl7magic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/WithSecureLabs","download_url":"https://codeload.github.com/WithSecureLabs/hl7magic/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/WithSecureLabs%2Fhl7magic/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261812905,"owners_count":23213572,"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":[],"created_at":"2025-06-04T00:44:13.313Z","updated_at":"2025-06-25T05:31:21.079Z","avatar_url":"https://github.com/WithSecureLabs.png","language":"Python","readme":"\n# HL7Magic v0.1\n\nA Burp extension to convert HL7 messages to JSON readable format, to allow for modification when relayed from MitM_Relay.\n\n# Blog post:\n\nhttps://labs.withsecure.com/publications/hl7magic--a-tool-for-testing-medical-devices-using-the-hl7-proto\n\n\n# Set-up\nSet-up is a little fiddly, but so long as these requirements are in place, you should be good to go.\n\n### Jython\nThe extension requires Burp Suite to be configured to use Jython. For installation please see:\nhttps://portswigger.net/burp/help/extender.html#options_pythonenv\n\n### Mitm_relay\nAs HL7 is a non-http protocol, it is expected that a TCP relay tool such as MitM_Relay.py is to be used alongside this extension:\nhttps://github.com/jrmdev/mitm_relay\n\n### HL7apy\nThe HL7apy Python library is required for this extension, download from here https://github.com/crs4/hl7apy, and run 'python setup.py install'. Make sure the package is located at the system libs: /usr/lib/python2.7/dist-packages. Make sure to point Burp at this package location in the Extender settings.\n\nYou will also need to manually compile the .py files within each HL7 version package, so that it works nicely with Jython. For example, running 'python2.7 -m py_compile messages.py' in the /usr/lib/python2.7/dist-packages/hl7apy/v2_5 location if the HL7 message is version 2.5. Each .py module will need to be compiled to .pyc before running the extension. \n\n### Burp Libraries\nDon't forget to install the Burp Extender python libraries: 'pip install burp'.\n\n\n\n# Installation\n\nCan be manually installed by cloning this repository and then from within Burp Suite:\n1. selecting the Extender tab\n2. clicking the Add button\n3. changing the Extension type to Python\n4. selecting hl7magic.py as the extension file.\n\n\n\n![hl7magic](images/hl7magic-screenshot.png)\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwithsecurelabs%2Fhl7magic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwithsecurelabs%2Fhl7magic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwithsecurelabs%2Fhl7magic/lists"}