CanLabs
=======
Ce projet permet de créer et gérer une interface CAN simplement.
Tester avec
-----------
- `Korlan USB2CAN <https://www.8devices.com/products/usb2can_korlan>`__
- `Kernel USB2CAN Module <https://github.com/8devices/usb2can>`__
Installation
------------
Install CanLabs with pypi:
.. code:: bash
pip install CanLabs
Install from source:
.. code:: bash
git clone https://github.com/alexandre-meline/CanLabs.git
cd CanLabs
sudo python test.py
Gestion de l’Interface CAN avec la Classe CANInterfaceManager
-------------------------------------------------------------
La classe ``CANInterfaceManager`` permet de gérer l’interface CAN en
utilisant Usb2Can.
Elle offre des fonctionnalités pour supprimer le pilote USB2CAN, le
télécharger, le construire, charger les modules du pilote USB2CAN, et
créer l’interface CAN avec des paramètres personnalisables.
Prérequis Usb2Can
-----------------
Avant d’utiliser la classe ``CANInterfaceManager``, assurez-vous d’avoir
les éléments suivants :
La classe utilise la classe ``Usb2Can``, pour en savoir plus
`ici <https://github.com/alexandre-meline/CanLabs/blob/master/canlabs/devices/README.md>`__.
- Assurez vous d’utiliser le modèle suivant: `Korlan
USB2CAN <https://www.8devices.com/products/usb2can_korlan>`__
- Accès en tant qu’utilisateur ``root`` pour effectuer certaines
opérations système.
- Un adaptateur CAN USB2CAN connecté en USB.
Utilisation de la classe ``CANInterfaceManager`` avec USB2CAN
-------------------------------------------------------------
1. Importez la classe ``CANInterfaceManager`` depuis le module où vous
souhaitez l’utiliser.
2. Créez une instance de la classe en spécifiant les paramètres de
l’interface CAN, tels que le nom de l’interface, le débit binaire
(bitrate), et le point d’échantillonnage (sample point).
3. Utilisez les méthodes de la classe pour gérer l’interface CAN en
fonction de vos besoins.
Voici un exemple d’utilisation de la classe ``CANInterfaceManager`` :
.. code:: python
from canlabs.can_interface_manager import CANInterfaceManager
# Initialze CANInterfaceManager
can_interface_manager = CANInterfaceManager(can_interface_name="can0")
# Create CAN interface
can_interface_manager.create_usb2can_interface()
Fonctionnalités à venir
~~~~~~~~~~~~~~~~~~~~~~~
- Récuperer tous les défaults DTC
- Surveillance en temps réel
- Analyse des trames CAN
- Journalisation des données
- Filtrage des messages
- Support pour différents adaptateurs CAN
- Intégration système de persistance de donnée (GoogleSheet, BDD, etc)
- Notification d’événements
- Support multiplateforme
Fonctionnalités pentest à venir
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- Attaques par injection de trames
- Détection d’anomalies
- Attaques par déni de service
- Attaques par rejeu
- Attaques par usurpation d’identité
- Tests d’authentification
- Tests de chiffrement
- Tests de conformité aux normes
- Tests de sécurité des mises à jour
- Tests de sécurité des DTC
Contribuer
----------
Pour contribuer au développement de ce projet, veuillez consulter notre
guide de contribution `ici <CONTRIBUTING.md>`__.
License
-------
Ce script est fourni sous la licence MIT. Consultez le fichier
`MIT <LICENSE>`__ pour plus d’informations.
Authors
-------
- [@alexandre-meline](https://github.com/alexandre-meline)
Raw data
{
"_id": null,
"home_page": "https://github.com/alexandre-meline/CanLabs",
"name": "CanLabs",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Alexandre Meline",
"author_email": "alexandre.meline.dev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b4/03/04052c149dddd4d557c59c3efd683b526d5e4997211eab18e39f03c2debb/CanLabs-0.1.2.36.tar.gz",
"platform": null,
"description": "CanLabs\n=======\n\nCe projet permet de cr\u00e9er et g\u00e9rer une interface CAN simplement.\n\nTester avec\n-----------\n\n- `Korlan USB2CAN <https://www.8devices.com/products/usb2can_korlan>`__\n- `Kernel USB2CAN Module <https://github.com/8devices/usb2can>`__\n\nInstallation\n------------\n\nInstall CanLabs with pypi:\n\n.. code:: bash\n\n pip install CanLabs\n\nInstall from source:\n\n.. code:: bash\n\n git clone https://github.com/alexandre-meline/CanLabs.git\n cd CanLabs\n sudo python test.py \n\nGestion de l\u2019Interface CAN avec la Classe CANInterfaceManager\n-------------------------------------------------------------\n\nLa classe ``CANInterfaceManager`` permet de g\u00e9rer l\u2019interface CAN en\nutilisant Usb2Can.\n\nElle offre des fonctionnalit\u00e9s pour supprimer le pilote USB2CAN, le\nt\u00e9l\u00e9charger, le construire, charger les modules du pilote USB2CAN, et\ncr\u00e9er l\u2019interface CAN avec des param\u00e8tres personnalisables.\n\nPr\u00e9requis Usb2Can\n-----------------\n\nAvant d\u2019utiliser la classe ``CANInterfaceManager``, assurez-vous d\u2019avoir\nles \u00e9l\u00e9ments suivants :\n\nLa classe utilise la classe ``Usb2Can``, pour en savoir plus\n`ici <https://github.com/alexandre-meline/CanLabs/blob/master/canlabs/devices/README.md>`__.\n\n- Assurez vous d\u2019utiliser le mod\u00e8le suivant: `Korlan\n USB2CAN <https://www.8devices.com/products/usb2can_korlan>`__\n- Acc\u00e8s en tant qu\u2019utilisateur ``root`` pour effectuer certaines\n op\u00e9rations syst\u00e8me.\n- Un adaptateur CAN USB2CAN connect\u00e9 en USB.\n\nUtilisation de la classe ``CANInterfaceManager`` avec USB2CAN\n-------------------------------------------------------------\n\n1. Importez la classe ``CANInterfaceManager`` depuis le module o\u00f9 vous\n souhaitez l\u2019utiliser.\n2. Cr\u00e9ez une instance de la classe en sp\u00e9cifiant les param\u00e8tres de\n l\u2019interface CAN, tels que le nom de l\u2019interface, le d\u00e9bit binaire\n (bitrate), et le point d\u2019\u00e9chantillonnage (sample point).\n3. Utilisez les m\u00e9thodes de la classe pour g\u00e9rer l\u2019interface CAN en\n fonction de vos besoins.\n\nVoici un exemple d\u2019utilisation de la classe ``CANInterfaceManager`` :\n\n.. code:: python\n\n from canlabs.can_interface_manager import CANInterfaceManager\n\n # Initialze CANInterfaceManager\n can_interface_manager = CANInterfaceManager(can_interface_name=\"can0\")\n # Create CAN interface\n can_interface_manager.create_usb2can_interface()\n\nFonctionnalit\u00e9s \u00e0 venir\n~~~~~~~~~~~~~~~~~~~~~~~\n\n- R\u00e9cuperer tous les d\u00e9faults DTC\n- Surveillance en temps r\u00e9el\n- Analyse des trames CAN\n- Journalisation des donn\u00e9es\n- Filtrage des messages\n- Support pour diff\u00e9rents adaptateurs CAN\n- Int\u00e9gration syst\u00e8me de persistance de donn\u00e9e (GoogleSheet, BDD, etc)\n- Notification d\u2019\u00e9v\u00e9nements\n- Support multiplateforme\n\nFonctionnalit\u00e9s pentest \u00e0 venir\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n- Attaques par injection de trames\n- D\u00e9tection d\u2019anomalies\n- Attaques par d\u00e9ni de service\n- Attaques par rejeu\n- Attaques par usurpation d\u2019identit\u00e9\n- Tests d\u2019authentification\n- Tests de chiffrement\n- Tests de conformit\u00e9 aux normes\n- Tests de s\u00e9curit\u00e9 des mises \u00e0 jour\n- Tests de s\u00e9curit\u00e9 des DTC\n\nContribuer\n----------\n\nPour contribuer au d\u00e9veloppement de ce projet, veuillez consulter notre\nguide de contribution `ici <CONTRIBUTING.md>`__.\n\nLicense\n-------\n\nCe script est fourni sous la licence MIT. Consultez le fichier\n`MIT <LICENSE>`__ pour plus d\u2019informations.\n\nAuthors\n-------\n\n- [@alexandre-meline](https://github.com/alexandre-meline)\n\n\n",
"bugtrack_url": null,
"license": "",
"summary": "Gestion de l'interface CAN avec Python",
"version": "0.1.2.36",
"project_urls": {
"Homepage": "https://github.com/alexandre-meline/CanLabs"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "904bbc903a72a357d00a9ab5b890c8bc504dfe2dcf050386ce71c9710552e2bf",
"md5": "218866c30d6076e847a344e5d38a0065",
"sha256": "1dc1e7e84caa266d19bb573339b9180189fb8ed93b8d9637c248d0743562eac7"
},
"downloads": -1,
"filename": "CanLabs-0.1.2.36-py3-none-any.whl",
"has_sig": false,
"md5_digest": "218866c30d6076e847a344e5d38a0065",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 10697,
"upload_time": "2023-09-25T15:13:52",
"upload_time_iso_8601": "2023-09-25T15:13:52.744255Z",
"url": "https://files.pythonhosted.org/packages/90/4b/bc903a72a357d00a9ab5b890c8bc504dfe2dcf050386ce71c9710552e2bf/CanLabs-0.1.2.36-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b40304052c149dddd4d557c59c3efd683b526d5e4997211eab18e39f03c2debb",
"md5": "257886e6e71bd097d96d3327c4d1e411",
"sha256": "273e2976169fea1922f8b8f440c58d5879c4d82abc7e86713cbf642f36eddf1f"
},
"downloads": -1,
"filename": "CanLabs-0.1.2.36.tar.gz",
"has_sig": false,
"md5_digest": "257886e6e71bd097d96d3327c4d1e411",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7883,
"upload_time": "2023-09-25T15:13:54",
"upload_time_iso_8601": "2023-09-25T15:13:54.654299Z",
"url": "https://files.pythonhosted.org/packages/b4/03/04052c149dddd4d557c59c3efd683b526d5e4997211eab18e39f03c2debb/CanLabs-0.1.2.36.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-09-25 15:13:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alexandre-meline",
"github_project": "CanLabs",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "canlabs"
}