Questo repository è stato archiviato e non è più mantenuto. Fare riferimento a alurity per i futuri sviluppi sul footprinting e fingerprinting dei robot.

aztarna

Questo repository contiene aztarna di Alias Robotics, uno strumento di footprinting per robot.

Alias Robotics supporta i produttori originali di robot nella valutazione della loro sicurezza e nel miglioramento della qualità del software. In nessun caso incoraggiamo o promuoviamo la manomissione non autorizzata di sistemi robotici in funzione. Ciò può causare gravi danni umani e materiali.

Edizione di lettura HTML: Aztarna, uno strumento di footprinting per robot

Per ROS

• Un elenco dei nodi ROS presenti nel sistema (Publisher e Subscriber)
• Per ogni nodo, i topic pubblicati e sottoscritti, incluso il tipo di topic
• Per ogni nodo, i servizi ROS offerti da ciascun nodo
• Un elenco di tutti i parametri ROS presenti nel Parameter Server
• Un elenco delle comunicazioni attive in esecuzione nel sistema. Una singola comunicazione include i nodi publisher/subscriber coinvolti e i topic

Per SROS

• Determinare se il sistema è un master SROS.
• Rilevare se è in uso la configurazione demo.
• Un elenco dei nodi trovati nel sistema. (Modalità estesa)
• Un elenco delle politiche allow/deny per ogni nodo.
  • Topic pubblicabili.
  • Topic sottoscrivibili.
  • Servizi eseguibili.
  • Parametri leggibili.

Per ROS2 (Finanziato nell'ambito del progetto ROSIN)

• Un elenco dei nodi ROS2 presenti in ciascun dominio di comunicazione.
• Un elenco dei topic scoperti in ciascun dominio di comunicazione.
• Un elenco dei servizi scoperti in ciascun dominio di comunicazione.
• Per ogni nodo, la relazione dei topic pubblicati e sottoscritti.
• Per ogni nodo, i servizi forniti da quel nodo.

Per router industriali

• Rilevamento di router industriali eWON, Moxa, Sierra Wireless e Westermo.
• Verifica delle credenziali predefinite per i router trovati.

Per pacchetti ROS Industrial (Finanziato nell'ambito del progetto ROSIN)

• Rilevamento di host ROS Industrial.
• Produttori:
  • ABB
  • Fanuc
  • Kuka

Installazione

Per la produzione

Direttamente da PyPi

pip3 install aztarna

o dal repository:

pip3 install .

Per lo sviluppo

pip3 install -e .

oppure

python3 setup.py develop

Python 3.6 e il pacchetto setuptools sono richiesti per l'installazione. Si consiglia Python 3.7.

Modulo ROS2

Per l'utilizzo del modulo di footprinting ROS2 è necessaria un'installazione di ROS2. Esegui il source dello script setup.bash prima di avviare.

Installazione con Docker

docker build -t aztarna_docker .

Utilizzo del codice:

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

Esegui il codice (esempio con file di input):

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

Esegui il codice con Docker (esempio con file di input):

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

Esegui il codice (esempio con indirizzo IP singolo):

aztarna -t ROS -p 11311 -a 115.129.241.241

Esegui il codice (esempio con subnet):

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

Esegui il codice (esempio con indirizzo IP singolo e intervallo di porte):

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

Esegui il codice (esempio con indirizzo IP singolo e elenco di porte):

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

Esegui il codice con ROS 2 (esempio esplorando tutti gli intervalli, 0-231):

aztarna -t ROS2

Esegui il codice con ROS 2 con ROS_DOMAIN_ID=15:

aztarna -t ROS2 -d 15

Esegui il codice con ROS 2 usando il demone rclpy ros2cli e con ROS_DOMAIN_ID=0 mostrando i nodi nascosti:

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

Esegui il codice con ROS 2 in modalità passiva per cercare gli host. Se imposti 'any' come argomento, verrà eseguita la ricerca su tutte le interfacce del sistema:

aztarna -t ros2 --passive any

Esegui il codice (esempio di pipe diretta da zmap):

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

Esegui il codice (esempio di ricerca di router industriali su shodan):

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

Esegui il codice (esempio di ricerca di router industriali su shodan, pipe in file):

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

Cita il nostro lavoro

Se utilizzi il nostro lavoro per la tua ricerca, citaci come:

@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}
}

Supportato da ROSIN - ROS-Industrial Quality-Assured Robot Software Components. Maggiori informazioni: rosin-project.eu

Questo repository è stato in parte finanziato da ROSIN RedROS2-I FTP, che ha ricevuto finanziamenti dal programma di ricerca e innovazione Horizon 2020 dell'Unione Europea nell'ambito del progetto ROSIN con l'accordo di sovvenzione n. 732287.