Ce dépôt a été archivé et n'est plus maintenu. Reportez-vous à alurity pour les progrès futurs sur l'empreinte et l'identification des robots.

aztarna

Ce dépôt contient aztarna d'Alias Robotics, un outil d'empreinte pour robots.

Alias Robotics soutient les fabricants de robots originaux dans l'évaluation de leur sécurité et l'amélioration de la qualité de leurs logiciels. Nous n'encourageons ni ne promouvons en aucun cas l'altération non autorisée de systèmes robotiques en fonctionnement. Cela peut causer des blessures graves et des dommages matériels.

Édition de lecture HTML : Aztarna, a footprinting tool for robots

Pour ROS

• Une liste des nœuds ROS présents dans le système (Publishers et Subscribers)
• Pour chaque nœud, les topics publiés et souscrits, y compris le type de topic
• Pour chaque nœud, les services ROS que chaque nœud propose
• Une liste de tous les paramètres ROS présents dans le Parameter Server
• Une liste des communications actives en cours dans le système. Une seule communication inclut les nœuds publisher/subscriber concernés et les topics

Pour SROS

• Déterminer si le système est un maître SROS.
• Détection si la configuration de démonstration est utilisée.
• Une liste des nœuds trouvés dans le système (mode étendu)
• Une liste des politiques d'autorisation/refus pour chaque nœud.
  • Topics publiable.
  • Topics souscriptable.
  • Services exécutables.
  • Paramètres lisibles.

Pour ROS2 (Financé par le projet ROSIN)

• Une liste des nœuds ROS2 présents dans chaque domaine de communication.
• Une liste des topics découverts sur chaque domaine de communication.
• Une liste des services découverts sur chaque domaine de communication.
• Pour chaque nœud, la relation des topics publiés et souscrits.
• Pour chaque nœud, les services fournis par ce nœud.

Pour les routeurs industriels

• Détection des routeurs industriels eWON, Moxa, Sierra Wireless et Westermo.
• Vérification des identifiants par défaut pour les routeurs trouvés.

Pour les packages ROS Industrial (Financé par le projet ROSIN)

• Détection des hôtes ROS Industrial.
• Fabricants :
  • ABB
  • Fanuc
  • Kuka

Installation

Pour la production

Directement depuis PyPi

pip3 install aztarna

ou depuis le dépôt :

pip3 install .

Pour le développement

pip3 install -e .

ou

python3 setup.py develop

Python 3.6 et le package setuptools sont requis pour l'installation. Python 3.7 est recommandé.

Module ROS2

Pour l'utilisation du module d'empreinte ROS2, une installation de ROS2 est requise. Sourcez le script setup.bash avant de lancer.

Installer avec Docker

docker build -t aztarna_docker .

Utilisation du code :

usage: aztarna [-h] -t TYPE [-a ADDRESS] [-p PORTS] [-i INPUT_FILE]
               [-o OUT_FILE] [-e] [-r RATE] [-d DOMAIN] [--daemon] [--hidden]
               [--shodan] [--api-key API_KEY] [--passive PASSIVE]

Aztarna

optional arguments:
  -h, --help            show this help message and exit
  -t TYPE, --type TYPE  <ROS/ros/SROS/sros/ROS2/ros2/IROUTERS/irouters> Scan
                        ROS, SROS, ROS2 hosts or Industrial routers
  -a ADDRESS, --address ADDRESS
                        Single address or network range to scan.
  -p PORTS, --ports PORTS
                        Ports to scan (format: 13311 or 11111-11155 or
                        1,2,3,4)
  -i INPUT_FILE, --input_file INPUT_FILE
                        Input file of addresses to use for scanning
  -o OUT_FILE, --out_file OUT_FILE
                        Output file for the results
  -e, --extended        Extended scan of the hosts
  -r RATE, --rate RATE  Maximum simultaneous network connections
  -d DOMAIN, --domain DOMAIN
                        ROS 2 DOMAIN ID (ROS_DOMAIN_ID environmental
                        variable). Only applies to ROS 2.
  --daemon              Use rclpy daemon (coming from ros2cli).
  --hidden              Show hidden ROS 2 nodes. By default filtering
                        _ros2cli*
  --shodan              Use shodan for the scan types that support it.
  --api-key API_KEY     Shodan API Key
  --passive PASSIVE     Passive search for ROS2

Exécuter le code (exemple de fichier d'entrée) :

aztarna -t ROS -p 11311 -i ros_scan_s20.csv

Exécuter le code avec Docker (exemple de fichier d'entrée) :

docker run -v <host_path>:/root -it aztarna_docker -t ROS -p 11311 -i <input_file>

Exécuter le code (exemple d'adresse IP unique) :

aztarna -t ROS -p 11311 -a 115.129.241.241

Exécuter le code (exemple de sous-réseau) :

aztarna -t ROS -p 11311 -a 115.129.241.0/24

Exécuter le code (exemple d'adresse IP unique, plage de ports) :

aztarna -t ROS -p 11311-11500 -a 115.129.241.241

Exécuter le code (exemple d'adresse IP unique, liste de ports) :

aztarna -t ROS -p 11311,11312,11313 -a 115.129.241.241

Exécuter le code avec ROS 2 (exemple explorant toutes les plages, 0-231)

aztarna -t ROS2

Exécuter le code avec ROS 2 avec ROS_DOMAIN_ID=15

aztarna -t ROS2 -d 15

Exécuter le code avec ROS 2 en utilisant le démon rclpy ros2cli et avec ROS_DOMAIN_ID=0 tout en affichant les nœuds cachés

aztarna -t ros2 -d 0 --daemon --hidden

Exécuter le code avec ROS 2 en mode passif pour rechercher les hôtes. Si vous définissez 'any' comme argument, il recherchera sur toutes les interfaces de votre système :

aztarna -t ros2 --passive any

Exécuter le code (exemple de piping direct depuis zmap) :

zmap -p 11311 0.0.0.0/0 -q | aztarna -t SROS -p 11311

Exécuter le code (exemple de recherche de routeurs industriels dans shodan)

aztarna -t IROUTERS --shodan --api-key <yourshodanapikey>

Exécuter le code (exemple de recherche de routeurs industriels dans shodan, piping vers un fichier)

aztarna -t IROUTERS --shodan --api-key <yourshodanapikey> -o routers.csv

Citer notre travail

Si vous utilisez notre travail pour vos recherches, veuillez nous citer comme suit :

@ARTICLE{2018arXiv181209490V,
  author = {{Vilches}, V{\'\i}ctor Mayoral and {Mendia}, Gorka Olalde and
  {Baskaran}, Xabier Perez and {Cordero}, Alejandro Hern{\'a}ndez
  and {Juan}, Lander Usategui San and {Gil-Uriarte}, Endika and
  {de Urabain}, Odei Olalde Saez and {Kirschgens}, Laura Alzola},
  title = "{Aztarna, a footprinting tool for robots}",
  journal = {arXiv e-prints},
  keywords = {Computer Science - Cryptography and Security, Computer Science - Robotics},
  year = 2018,
  month = Dec,
  eid = {arXiv:1812.09490},
  pages = {arXiv:1812.09490},
  archivePrefix = {arXiv},
  eprint = {1812.09490},
  primaryClass = {cs.CR},
  adsurl = {https://ui.adsabs.harvard.edu/\#abs/2018arXiv181209490V},
  adsnote = {Provided by the SAO/NASA Astrophysics Data System}
}

Supported by ROSIN - ROS-Industrial Quality-Assured Robot Software Components. More information: rosin-project.eu

Ce dépôt a été partiellement financé par ROSIN RedROS2-I FTP qui a reçu des fonds du programme de recherche et d'innovation Horizon 2020 de l'Union européenne dans le cadre du projet ROSIN avec la convention de subvention n° 732287.