<!--
SPDX-FileCopyrightText: AISEC Pentesting Team
SPDX-License-Identifier: CC0-1.0
-->
# Gallia
[](https://fraunhofer-aisec.github.io/gallia)
[](https://gallia.readthedocs.io/en/latest)
[](https://pypi.python.org/pypi/gallia/)
[](https://www.apache.org/licenses/LICENSE-2.0.html)
[](https://pypi.python.org/pypi/gallia/)
[](https://zenodo.org/doi/10.5281/zenodo.10696368)
[](https://repology.org/project/gallia/versions)
Gallia is an extendable pentesting framework with the focus on the automotive domain.
The scope of the toolchain is conducting penetration tests from a single ECU up to whole cars.
Currently, the main focus lies on the [UDS](https://www.iso.org/standard/72439.html) interface.
Acting as a generic interface, the logging functionality implements reproducible tests and enables post-processing tasks.
The [rendered documentation](https://fraunhofer-aisec.github.io/gallia) is available via Github Pages.
Alternatively, the documentation is hosted on [readthedocs](https://gallia.readthedocs.io/en/latest) as well.
The documentation for the current [stable](https://gallia.readthedocs.io/en/stable) realease is available on readthedocs.
Keep in mind that this project is intended for research and development usage only!
Inappropriate usage might cause irreversible damage to the device under test.
We do not take any responsibility for damage caused by the usage of this tool.
## Quickstart
See the [setup instructions](https://fraunhofer-aisec.github.io/gallia/setup.html).
First create a config template with `--template`, store it to a file called [`gallia.toml`](https://fraunhofer-aisec.github.io/gallia/config.html), and adjust it to your needs.
`gallia` reads this file to set the defaults of the command line flags.
All options correspond to a command line flag; the only required option for scans is `gallia.scanner.target`, for instance `isotp://can0?src_addr=0x123&dst_addr=0x312&tx_padding=0xaa&rx_padding=0xaa`.
```
$ gallia --template > gallia.toml
```
You are all set to start your first scan, for instance read the diagnostic trouble codes:
```
$ gallia primitive uds dtc read
```
The target can also be specified by the `--target` option on the command line.
For the format of the `--target` argument see the [transports documentation](https://fraunhofer-aisec.github.io/gallia/transports.html).
## Acknowledgments
This work was partly funded by the German Federal Ministry of Education and Research (BMBF) as part of the [SecForCARs](https://www.secforcars.de/) project (grant no. 16KIS0790).
A short presentation and demo video is available at this [page](https://www.secforcars.de/demos/10-automotive-scanning-framework.html).
Raw data
{
"_id": null,
"home_page": "https://github.com/Fraunhofer-AISEC/gallia",
"name": "gallia",
"maintainer": "Stefan Tatschner",
"docs_url": null,
"requires_python": "<3.13,>=3.11",
"maintainer_email": "stefan.tatschner@aisec.fraunhofer.de",
"keywords": "pentesting, automotive, uds",
"author": "AISEC Pentesting Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/c4/a4/9ba8489956adaa6dcf333b9f3e93f24bcbcf1119ababb640414639e6b7ff/gallia-1.7.0.tar.gz",
"platform": null,
"description": "<!--\nSPDX-FileCopyrightText: AISEC Pentesting Team\n\nSPDX-License-Identifier: CC0-1.0\n-->\n\n# Gallia\n\n[](https://fraunhofer-aisec.github.io/gallia)\n[](https://gallia.readthedocs.io/en/latest)\n[](https://pypi.python.org/pypi/gallia/)\n[](https://www.apache.org/licenses/LICENSE-2.0.html)\n[](https://pypi.python.org/pypi/gallia/)\n[](https://zenodo.org/doi/10.5281/zenodo.10696368)\n\n[](https://repology.org/project/gallia/versions)\n\nGallia is an extendable pentesting framework with the focus on the automotive domain.\nThe scope of the toolchain is conducting penetration tests from a single ECU up to whole cars.\nCurrently, the main focus lies on the [UDS](https://www.iso.org/standard/72439.html) interface.\nActing as a generic interface, the logging functionality implements reproducible tests and enables post-processing tasks.\nThe [rendered documentation](https://fraunhofer-aisec.github.io/gallia) is available via Github Pages.\nAlternatively, the documentation is hosted on [readthedocs](https://gallia.readthedocs.io/en/latest) as well.\nThe documentation for the current [stable](https://gallia.readthedocs.io/en/stable) realease is available on readthedocs.\n\nKeep in mind that this project is intended for research and development usage only!\nInappropriate usage might cause irreversible damage to the device under test.\nWe do not take any responsibility for damage caused by the usage of this tool.\n\n## Quickstart\n\nSee the [setup instructions](https://fraunhofer-aisec.github.io/gallia/setup.html).\n\nFirst create a config template with `--template`, store it to a file called [`gallia.toml`](https://fraunhofer-aisec.github.io/gallia/config.html), and adjust it to your needs.\n`gallia` reads this file to set the defaults of the command line flags.\nAll options correspond to a command line flag; the only required option for scans is `gallia.scanner.target`, for instance `isotp://can0?src_addr=0x123&dst_addr=0x312&tx_padding=0xaa&rx_padding=0xaa`.\n\n```\n$ gallia --template > gallia.toml\n```\n\nYou are all set to start your first scan, for instance read the diagnostic trouble codes:\n\n```\n$ gallia primitive uds dtc read\n```\n\nThe target can also be specified by the `--target` option on the command line.\nFor the format of the `--target` argument see the [transports documentation](https://fraunhofer-aisec.github.io/gallia/transports.html).\n\n## Acknowledgments\n\nThis work was partly funded by the German Federal Ministry of Education and Research (BMBF) as part of the [SecForCARs](https://www.secforcars.de/) project (grant no. 16KIS0790).\nA short presentation and demo video is available at this [page](https://www.secforcars.de/demos/10-automotive-scanning-framework.html).\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Extendable Pentesting Framework",
"version": "1.7.0",
"project_urls": {
"Documentation": "https://fraunhofer-aisec.github.io/gallia",
"Homepage": "https://github.com/Fraunhofer-AISEC/gallia",
"Repository": "https://github.com/Fraunhofer-AISEC/gallia"
},
"split_keywords": [
"pentesting",
" automotive",
" uds"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8fa8d80d6f7c20f64421561a77a4db588bc00543eb9b1b2abd2c40a1e722803e",
"md5": "5fc0161980aabd2940fbe11a06aaf490",
"sha256": "aafea26b8ab29f988ea3d305af8cf7a22e7b54ee018e3fa0b5c1c5509246b3f9"
},
"downloads": -1,
"filename": "gallia-1.7.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "5fc0161980aabd2940fbe11a06aaf490",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.11",
"size": 189661,
"upload_time": "2024-04-10T14:28:00",
"upload_time_iso_8601": "2024-04-10T14:28:00.995658Z",
"url": "https://files.pythonhosted.org/packages/8f/a8/d80d6f7c20f64421561a77a4db588bc00543eb9b1b2abd2c40a1e722803e/gallia-1.7.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c4a49ba8489956adaa6dcf333b9f3e93f24bcbcf1119ababb640414639e6b7ff",
"md5": "5c92739914ada463b266b31ae696d22a",
"sha256": "f88b2d3fc92a7ec12a040cd6495637eea18e9b13dd3746e88d7fb76c1265ad09"
},
"downloads": -1,
"filename": "gallia-1.7.0.tar.gz",
"has_sig": false,
"md5_digest": "5c92739914ada463b266b31ae696d22a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.11",
"size": 145846,
"upload_time": "2024-04-10T14:28:02",
"upload_time_iso_8601": "2024-04-10T14:28:02.767460Z",
"url": "https://files.pythonhosted.org/packages/c4/a4/9ba8489956adaa6dcf333b9f3e93f24bcbcf1119ababb640414639e6b7ff/gallia-1.7.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-10 14:28:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Fraunhofer-AISEC",
"github_project": "gallia",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gallia"
}
JSON
