doc.rustdesk.com/content/self-host/rustdesk-server-pro/console/_index.it.md

title, weight, description, keywords

title	weight	description	keywords
Console Web	10	Documentazione RustDesk su Console Web. Consulta le guide per installazione, configurazione, distribuzione e risoluzione dei problemi.	rustdesk web console rustdesk server pro console rustdesk port 21114 rustdesk device management rustdesk admin console

Risposta rapida

La console web di RustDesk Server Pro è il punto centrale per gestire utenti, dispositivi, gruppi, licenze, configurazioni, relay, log e token API. I nuovi amministratori dovrebbero iniziare da accesso, licenza, email e impostazioni di accesso prima di distribuire modifiche più ampie.

Punti chiave

• Verifica prima login e licenza
• Poi rivedi utenti, dispositivi, gruppi e strategie
• Configura email, relay e token API solo quando l’accesso di base funziona

La console web è integrata in RustDesk Server Pro, servita dalla porta 21114.

Caratteristiche:

• Sfogliare i dispositivi
• Aggiungere/modificare utenti e gruppi di utenti
• Modificare i permessi di accesso ai dispositivi
• Sfogliare i log di connessione dei dispositivi e altri log
• Aggiornare le impostazioni
• Gestire le strategie di sincronizzazione delle impostazioni del client
• Gestire le rubriche condivise
• Generare build personalizzate del client

Accedere

La porta predefinita della console web è 21114. Inserisci http://<ip del server>:21114 nel browser per accedere alla pagina della console, come mostrato nella figura seguente. Il nome utente/password predefinito dell'amministratore è admin/test1234:

Se hai bisogno del supporto HTTPS, installa un server web come Nginx o usa IIS per Windows.

Dopo aver effettuato l'accesso, assicurati di cambiare la password, seleziona Impostazioni nel menu dell'account nell'angolo in alto a destra per accedere alla pagina di modifica della password, come mostrato nella figura seguente. Puoi anche creare un altro account amministratore e eliminare questo. È meglio abilitare la verifica dell'accesso via email.

Anche gli utenti non amministratori possono accedere per sfogliare i loro dispositivi e log, modificare le loro impostazioni utente.

Configurazioni Automatiche

Cliccando su Windows EXE sarai in grado di ottenere le configurazioni per il tuo RustDesk Server Pro, questo aiuterà a configurare i tuoi client.

Per i client Windows, puoi omettere la configurazione personalizzata del server e mettere le informazioni di configurazione nel nome del file rustdesk.exe invece. Come mostrato sopra, vai alla pagina di benvenuto della console e clicca su Windows EXE. Client ≥ 1.1.9 richiesto.

Puoi usare questo insieme alla configurazione del client e agli script di distribuzione per configurare i tuoi client.

Creare un nuovo utente diverso dall'utente predefinito admin

{{% notice note %}} Il piano Individual non ha questa caratteristica. {{% /notice %}}

1. Clicca su Utenti nel menu a sinistra.
2. Crea un altro account con amministratore abilitato.
3. Accedi con il nuovo account amministrativo.
4. Elimina l'admin nella pagina Utenti.

Creare un nuovo utente

1. Clicca su Utenti nel menu a sinistra.
2. Crea un nuovo utente.
3. Seleziona in quale gruppo dovrebbero essere (se devi aggiungere nuovi gruppi continua a leggere).

Aggiungere un nuovo Gruppo

1. Clicca su Gruppi nel menu a sinistra.
2. Crea un nuovo gruppo.
3. Una volta creato puoi permettere ai gruppi di accedere l'uno all'altro, clicca Modifica.
4. Seleziona i gruppi rilevanti a cui vuoi accesso (li aggiunge automaticamente nel gruppo corrispondente).

Configurare più server relay

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su Relay nel sottomenu.
3. Clicca + accanto a Server Relay.
4. Inserisci l'indirizzo DNS o l'indirizzo IP del server relay nella casella che ora appare e premi Invio.
5. Se hai più di un server relay puoi continuare a cliccare + e adattare le impostazioni geografiche se necessario (ricorda e copia la tua chiave agli altri server).

Impostare o cambiare la licenza

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su Licenza nel sottomenu.
3. Clicca Modifica e incolla il tuo codice licenza.
4. Clicca OK.

Visualizzare i Log

Sul lato sinistro clicca su Log.

Configurare le Email

Gmail in questo esempio

1. Vai su Impostazioni nel menu a sinistra.
2. Clicca su SMTP nel sottomenu.
3. Inserisci l'indirizzo SMTP smtp.gmail.com.
4. Inserisci la Porta 587 in Porta SMTP.
5. Inserisci l'account Gmail cioè myrustdeskserver@gmail.com in Account Mail.
6. Inserisci la tua password (potresti aver bisogno di una password dell'app).
7. Inserisci il tuo account Gmail cioè myrustdeskserver@gmail.com in Da.
8. Clicca Controlla per salvare.

Assegnazione di Utenti/Strategie/Gruppi di Dispositivi ai Dispositivi tramite Console Web

L’Utente è l’utente RustDesk connesso al dispositivo o assegnato al dispositivo cliccando su Modifica accanto al dispositivo, cliccando nella casella Utente e selezionando il proprio utente dal menu a discesa.
È anche possibile assegnare dispositivi in blocco a un utente cliccando su Altro → Assegna Dispositivi nella Lista Utenti.

Per aggiungere un dispositivo a un gruppo di dispositivi, è possibile cliccare su Modifica accanto al dispositivo nella Lista Dispositivi e cambiare il Gruppo, oppure andare nella lista dei Gruppi di Dispositivi, cliccare sul nome di un gruppo e regolare i dispositivi in quel gruppo.

Per assegnare una strategia a un dispositivo, passare il mouse sul lato destro della lista Strategia e cliccare su Modifica Dispositivi, Modifica Utenti o Modifica Gruppi di Dispositivi nel menu per aggiungere i dispositivi corrispondenti, i dispositivi degli utenti o i dispositivi del gruppo alla strategia selezionata.

---

Token API

È necessario prima andare su Impostazioni → Token → Crea e creare un token con le autorizzazioni richieste: Dispositivo, Registro Audit, Utente, Gruppo, Strategia, Rubrica, Ruolo Amministratore, Ruolo di Controllo.

Una volta creato, è possibile utilizzare questi token tramite linea di comando o Python CLI per eseguire azioni con le autorizzazioni corrispondenti.

Assegnazione tramite Token dalla Linea di Comando

È anche possibile eseguire assegnazioni utilizzando l’eseguibile RustDesk con il parametro --assign.
Questo permette di assegnare utenti, strategie, rubriche o gruppi di dispositivi a un dispositivo direttamente dalla linea di comando.

Esempio:

"C:\Program Files\RustDesk\rustdesk.exe" --assign --token <generatedtoken> --user_name <username>

Parametri supportati

Parametro	Descrizione	RustDesk Server Pro	RustDesk Client
--user_name <username>	Assegna un utente al dispositivo
--strategy_name <strategyname>	Assegna una strategia al dispositivo
--address_book_name <addressbookname>	Assegna il dispositivo a una rubrica
--address_book_tag <addressbooktag>	Assegna con tag della rubrica
--address_book_alias <alias>	Assegna con alias della rubrica	1.5.8	1.4.1
--address_book_password <password>	Imposta la password per la voce	1.6.6	1.4.3
--address_book_note <note>	Imposta una nota per la voce	1.6.6	1.4.3
--device_group_name <devicegroupname>	Assegna il dispositivo a un gruppo
--note <note>	Aggiunge una nota al dispositivo	1.6.6	1.4.3
--device_username <device_username>	Imposta il nome utente del dispositivo	1.6.6	1.4.3
--device_name <device_name>	Imposta il nome del dispositivo	1.6.6	1.4.3
--deploy	Registra un nuovo dispositivo quando Richiedi distribuzione per i nuovi dispositivi è abilitato. Richiede un token API con l'autorizzazione Dispositivi impostata su Lettura e scrittura.	1.8.3	1.4.7

La linea di comando su Windows non produce output per default. Per ottenere output, eseguire:

"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | more
"C:\Program Files\RustDesk\rustdesk.exe" <arg1> <arg2> ... | Out-String

vedi qui.

Strumenti di Gestione Python CLI

Gestione Utenti (users.py)

Mostra aiuto:
./users.py -h

Visualizza utenti:
./users.py --url <url> --token <token> view [--name <username>] [--group_name <group_name>]

Filtri:

• --name: nome utente (ricerca fuzzy)
• --group_name: gruppo utenti (corrispondenza esatta)

Esempio:
./users.py --url https://example.com --token <token> view --group_name Default

Operazioni di base:

• Disabilitare utente:
  ./users.py --url <url> --token <token> disable --name testuser

• Abilitare utente:
  ./users.py --url <url> --token <token> enable --name testuser

• Eliminare utente:
  ./users.py --url <url> --token <token> delete --name testuser

Creazione e invito utenti:

• Creare nuovo utente:
  ./users.py --url <url> --token <token> new --name username --password 'password123' --group_name Default [--email user@example.com] [--note "nota"]

  Richiesto: --name, --password, --group_name
  Opzionale: --email, --note

• Invitare utente via email:
  ./users.py --url <url> --token <token> invite --email user@example.com --name username --group_name Default [--note "nota"]

  Richiesto: --email, --name, --group_name
  Opzionale: --note

Operazioni 2FA e sicurezza:

• Abilitare imposizione 2FA:
  ./users.py --url <url> --token <token> enable-2fa-enforce --name username --web-console-url <console_url>

  Richiesto: --web-console-url

• Disabilitare imposizione 2FA:
  ./users.py --url <url> --token <token> disable-2fa-enforce --name username [--web-console-url <console_url>]

  Opzionale: --web-console-url

• Reimpostare 2FA:
  ./users.py --url <url> --token <token> reset-2fa --name username

• Disabilitare verifica email:
  ./users.py --url <url> --token <token> disable-email-verification --name username

• Disconnessione forzata:
  ./users.py --url <url> --token <token> force-logout --name username

Note:

• Quando si opera su più utenti (corrispondenti ai filtri), verrà richiesta conferma
• Se non ci sono utenti corrispondenti, verrà mostrato "Found 0 users"

---

Gestione Gruppi Utenti (user_group.py)

Mostra aiuto:
./user_group.py -h

Visualizza gruppi utenti:
./user_group.py --url <url> --token <token> view [--name <group_name>]

Esempio:
./user_group.py --url https://example.com --token <token> view --name "Team Vendite"

Operazioni sui gruppi:

• Creare gruppo utenti:
  ./user_group.py --url <url> --token <token> add --name "NomeGruppo" [--note "descrizione"] [--accessed-from '<json>'] [--access-to '<json>']

  Esempio con controllo accesso:
  ./user_group.py --url <url> --token <token> add --name "Ingegneria" --accessed-from '[{"type":0,"name":"Manager"}]' --access-to '[{"type":1,"name":"Server Dev"}]'

• Aggiornare gruppo utenti:
  ./user_group.py --url <url> --token <token> update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from '<json>'] [--access-to '<json>']

• Eliminare gruppo utenti:
  ./user_group.py --url <url> --token <token> delete --name "NomeGruppo"

  Supporta nomi separati da virgola: --name "Gruppo1,Gruppo2,Gruppo3"

Gestione utenti nei gruppi:

• Visualizzare utenti nel gruppo:
  ./user_group.py --url <url> --token <token> view-users [--name <group_name>] [--user-name <username>]

  Filtri:

  • --name: nome del gruppo (corrispondenza esatta, opzionale)
  • --user-name: nome utente (ricerca fuzzy, opzionale)

  Esempio:
  ./user_group.py --url <url> --token <token> view-users --name Default --user-name john

• Aggiungere utenti al gruppo:
  ./user_group.py --url <url> --token <token> add-users --name "NomeGruppo" --users "user1,user2,user3"

Parametri controllo accesso:

• --accessed-from: array JSON che definisce chi può accedere a questo gruppo utenti

  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Admins"}])
  • Type 2 = Utente (es. [{"type":2,"name":"john"}])

• --access-to: array JSON che definisce a cosa può accedere questo gruppo utenti

  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Supporto"}])
  • Type 1 = Gruppo dispositivi (es. [{"type":1,"name":"Server"}])

Nota: Utilizzare virgolette singole attorno agli array JSON per evitare problemi di parsing della shell.

Requisiti di permessi:

• I comandi view/add/update/delete/add-users richiedono Permesso Gruppo Utenti
• Il comando view-users richiede Permesso Utente

---

Gestione dei ruoli amministratore (admin-roles.py)

Il token deve appartenere a un amministratore completo e disporre del permesso Ruolo Amministratore in lettura o lettura/scrittura. I comandi che risolvono i nomi utente o elencano i membri del ruolo richiedono anche il permesso Utente in lettura.

Visualizza i ruoli:

# Elenca i ruoli, filtrandoli facoltativamente per nome esatto o tipo
./admin-roles.py --url <url> --token <token> view [--name <role_name>] [--type global|individual|group]

# Visualizza un ruolo tramite GUID
./admin-roles.py --url <url> --token <token> view --guid <role_guid>

Crea un ruolo:

# Ruolo globale
./admin-roles.py --url <url> --token <token> add \
  --name "Support Admin" --type global \
  --permissions "users.view,devices.view,audits.view" --note "Read-only support"

# Ruolo con ambito di gruppo
./admin-roles.py --url <url> --token <token> add \
  --name "Support Scope" --type group \
  --permissions "users.view,devices.view,devices.enable_disable" \
  --user-groups "Support" --device-groups "Servers" --unassigned

Il tipo di ruolo non può essere modificato dopo la creazione. --permissions accetta nomi di permessi, ID decimali o ID con prefisso 0x, separati da virgole; i formati possono essere combinati. Ad esempio, users.view,513,0x0203 equivale a 257,513,515. Il server rifiuta i permessi non validi per il tipo di ruolo selezionato.

Il comando view riconverte gli ID dei permessi conosciuti nei nomi riportati di seguito. Un ID sconosciuto allo script viene mantenuto come numero, affinché i permessi aggiunti da una versione più recente del server non vengano nascosti.

Area	Permessi	Tipi di ruolo validi
Utenti	users.view (257); users.create (259); users.invite (260); users.delete (261); users.enable_disable (262); users.edit_email (263); users.edit_password (264); users.edit_note (265); users.manage_2fa (266); users.force_logout (267); users.change_strategy (269); users.change_control_role (270); users.edit_display_name (271)	global, group
Utenti	users.change_group (268)	global
Dispositivi	devices.view (513)	global, group
Dispositivi	devices.enable_disable (515); devices.delete (516); devices.edit_info (517); devices.change_strategy (520)	global, individual, group
Dispositivi	devices.assign_to_user (518); devices.change_group (519)	global
Gruppi di utenti	user_groups.view (769); user_groups.edit (770)	global
Gruppi di dispositivi	device_groups.view (1025); device_groups.edit (1026); device_groups.change_strategy (1027)	global
Audit	audits.view (1281); audits.edit (1282)	global, individual
Strategie	strategies.view (1537); strategies.edit (1538)	global
Client personalizzati	custom_clients.view (1793); custom_clients.edit (1794)	global
Ruoli di controllo	control_roles.view (2049); control_roles.edit (2050)	global

Aggiorna o elimina un ruolo:

./admin-roles.py --url <url> --token <token> update --name "Support Admin" \
  [--new-name "Helpdesk Admin"] [--note "new note"] [--permissions "users.view,devices.view"] \
  [--user-groups "Support"] [--device-groups "Servers"] [--unassigned|--no-unassigned]

./admin-roles.py --url <url> --token <token> delete --name "Support Admin"

Passare un valore vuoto per cancellare --note, --permissions, --user-groups o --device-groups, ad esempio --permissions "".

Gestisci i membri del ruolo:

./admin-roles.py --url <url> --token <token> view-users --name "Support Admin"
./admin-roles.py --url <url> --token <token> add-users --name "Support Admin" --users "user1,user2"
./admin-roles.py --url <url> --token <token> remove-users --name "Support Admin" --users "user1,user2"

I ruoli e gli utenti di destinazione possono essere indicati anche tramite GUID. In --users è possibile combinare nomi utente e GUID.

---

Gestione dei ruoli di controllo (control-roles.py)

Il token deve disporre del permesso Ruolo di Controllo in lettura o lettura/scrittura. I comandi che risolvono i nomi utente o elencano i membri del ruolo richiedono anche il permesso Utente in lettura.

Visualizza i ruoli:

./control-roles.py --url <url> --token <token> view [--name <role_name>] [--status enabled|disabled]
./control-roles.py --url <url> --token <token> view --guid <role_guid>

Crea, aggiorna, elimina, abilita o disabilita un ruolo:

./control-roles.py --url <url> --token <token> add --name "Contractors" [--note "Restricted access"]
./control-roles.py --url <url> --token <token> update --name "Contractors" [--new-name "Vendors"] [--note "new note"]
./control-roles.py --url <url> --token <token> delete --name "Contractors"
./control-roles.py --url <url> --token <token> enable --name "Contractors"
./control-roles.py --url <url> --token <token> disable --name "Contractors"

I nuovi ruoli creati da questo script non includono permessi di controllo. Configurarli nella console web prima di assegnare gli utenti. Questo script non gestisce né visualizza le definizioni dei permessi di controllo.

Gestisci i membri del ruolo:

./control-roles.py --url <url> --token <token> view-users --name "Contractors"
./control-roles.py --url <url> --token <token> assign-users --name "Contractors" --users "user1,user2"
./control-roles.py --url <url> --token <token> remove-users --users "user1,user2"

I ruoli e gli utenti di destinazione possono essere indicati anche tramite GUID. remove-users cancella il ruolo di controllo corrente di ogni utente, quindi non accetta --name o --guid. Per il ruolo riservato Default, view-users elenca solo le assegnazioni esplicite; anche gli utenti senza un ruolo di controllo assegnato ereditano Default. Il ruolo riservato Not Logged non può essere assegnato agli utenti e i ruoli riservati non possono essere rinominati, dotati di una nota o eliminati.

---

Gestione Gruppi Dispositivi (device_group.py)

Mostra aiuto:
./device_group.py -h

Visualizza gruppi dispositivi:
./device_group.py --url <url> --token <token> view [--name <group_name>]

Esempio:
./device_group.py --url https://example.com --token <token> view

Operazioni sui gruppi:

• Creare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> add --name "NomeGruppo" [--note "descrizione"] [--accessed-from '<json>']

  Esempio:
  ./device_group.py --url <url> --token <token> add --name "Produzione" --accessed-from '[{"type":0,"name":"Admins"}]'

• Aggiornare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> update --name "NomeGruppo" [--new-name "Nuovo Nome"] [--note "nuova nota"] [--accessed-from '<json>']

• Eliminare gruppo dispositivi:
  ./device_group.py --url <url> --token <token> delete --name "NomeGruppo"

  Supporta nomi separati da virgola: --name "Gruppo1,Gruppo2,Gruppo3"

Gestione dispositivi nei gruppi:

• Visualizzare dispositivi nel gruppo:
  ./device_group.py --url <url> --token <token> view-devices [filtri]

  Filtri disponibili:

  • --name: nome del gruppo dispositivi (corrispondenza esatta)
  • --id: ID dispositivo (ricerca fuzzy)
  • --device-name: nome dispositivo (ricerca fuzzy)
  • --user-name: nome utente/proprietario (ricerca fuzzy)
  • --device-username: nome utente connesso al dispositivo (ricerca fuzzy)

  Esempi:

  # Visualizzare tutti i dispositivi in un gruppo
  ./device_group.py --url <url> --token <token> view-devices --name Produzione
  
  # Cercare per nome dispositivo
  ./device_group.py --url <url> --token <token> view-devices --device-name server
  
  # Combinare filtri
  ./device_group.py --url <url> --token <token> view-devices --name Produzione --user-name john
  

• Visualizzare gruppi dispositivi accessibili:
  ./device_group.py --url <url> --token <token> accessible

  Mostra tutti i gruppi dispositivi accessibili all'utente corrente.

• Aggiungere dispositivi al gruppo:
  ./device_group.py --url <url> --token <token> add-devices --name "NomeGruppo" --ids "deviceid1,deviceid2"

• Rimuovere dispositivi dal gruppo:
  ./device_group.py --url <url> --token <token> remove-devices --name "NomeGruppo" --ids "deviceid1,deviceid2"

Parametro controllo accesso:

• --accessed-from: array JSON che definisce chi può accedere a questo gruppo dispositivi
  • Type 0 = Gruppo utenti (es. [{"type":0,"name":"Ingegneri"}])
  • Type 2 = Utente (es. [{"type":2,"name":"admin"}])

Requisiti permessi:

• I comandi view/add/update/delete/add-devices/remove-devices richiedono Permesso Gruppo Dispositivi
• Il comando view-devices richiede Permesso Dispositivo

---

Gestione Dispositivi (devices.py)

Mostra aiuto:

./devices.py -h

Visualizza dispositivi:

./devices.py --url <url> --token <token> view [--id <device_id>] [--device_name <device_name>] [--user_name <user_name>] [--group_name <group_name>] [--device_group_name <device_group_name>] [--offline_days <days>]

Filtri:

--id : ID dispositivo
--device_name : nome dispositivo
--user_name : utente assegnato
--group_name : gruppo utenti
--device_group_name : gruppo dispositivi
--offline_days : giorni offline

Esempio:

./devices.py --url https://example.com --token <token> view --user_name mike

Operazioni:

view può essere sostituito con enable, disable, delete, o assign.

Esempio (assegnare dispositivo):

./devices.py --url https://example.com --token <token> assign --device_name PC01 --assign_to user_name=mike

---

Gestione Rubrica (ab.py)

Mostra aiuto:

./ab.py -h

Visualizza rubriche condivise:

./ab.py --url <url> --token <token> view-ab [--ab-name <address_book_name>]

Ottieni GUID rubrica personale:

./ab.py --url <url> --token <token> get-personal-ab

Aggiungi rubrica condivisa:

./ab.py --url <url> --token <token> add-ab --ab-name <name> [--note <note>] [--password <password>]

Aggiorna o elimina rubrica condivisa:

./ab.py --url <url> --token <token> update-ab --ab-guid <guid> [--ab-update-name <new_name>] [--note <note>]
./ab.py --url <url> --token <token> delete-ab --ab-guid <guid>

Visualizza peer in una rubrica:

./ab.py --url <url> --token <token> view-peer --ab-guid <guid> [--peer-id <peer_id>] [--alias <alias>]

Aggiungi, aggiorna o elimina un peer:

./ab.py --url <url> --token <token> add-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> update-peer --ab-guid <guid> --peer-id <peer_id> [--alias <alias>] [--note <note>] [--tags tag1,tag2]
./ab.py --url <url> --token <token> delete-peer --ab-guid <guid> --peer-id <peer_id>

Gestione tag:

./ab.py --url <url> --token <token> view-tag --ab-guid <guid>
./ab.py --url <url> --token <token> add-tag --ab-guid <guid> --tag-name <name> [--tag-color 0xFF00FF00]
./ab.py --url <url> --token <token> update-tag --ab-guid <guid> --tag-name <name> --tag-color 0xFFFF0000
./ab.py --url <url> --token <token> delete-tag --ab-guid <guid> --tag-name <name>

Gestione regole di accesso:

./ab.py --url <url> --token <token> view-rule --ab-guid <guid>
./ab.py --url <url> --token <token> add-rule --ab-guid <guid> [--rule-type user|group|everyone] [--rule-user <user>] [--rule-group <group>] --rule-permission ro|rw|full
./ab.py --url <url> --token <token> update-rule --rule-guid <rule_guid> --rule-permission rw
./ab.py --url <url> --token <token> delete-rule --rule-guid <rule_guid>

Esempio (aggiungi regola sola lettura per l’utente "mike"):

./ab.py --url https://example.com --token <token> add-rule --ab-guid <guid> --rule-user mike --rule-permission ro

---

Gestione delle Strategie (strategies.py)

Mostra aiuto:
./strategies.py -h

Elenca tutte le strategie:
./strategies.py --url <url> --token <token> list

Visualizza una strategia specifica:

# Per nome
./strategies.py --url <url> --token <token> view --name "Default"

# Per GUID
./strategies.py --url <url> --token <token> view --guid "01983006-fcca-7c12-9a91-b1df483c6073"

Abilita o disabilita una strategia:

./strategies.py --url <url> --token <token> enable --name "NomeStrategia"
./strategies.py --url <url> --token <token> disable --name "NomeStrategia"

Assegna strategia a dispositivi, utenti o gruppi dispositivi:

# Assegna a dispositivi (per ID dispositivo)
./strategies.py --url <url> --token <token> assign --name "Default" --peers "1849118658,1337348840"

# Assegna a utenti (per nome utente)
./strategies.py --url <url> --token <token> assign --name "Default" --users "admin,user1"

# Assegna a gruppi dispositivi (per nome gruppo)
./strategies.py --url <url> --token <token> assign --name "Default" --device-groups "device_group1,Production"

# Assegnazione mista
./strategies.py --url <url> --token <token> assign \
  --name "Default" \
  --peers "1849118658" \
  --users "admin" \
  --device-groups "device_group1"

Rimuovi assegnazione strategia:

# Rimuovi da dispositivi
./strategies.py --url <url> --token <token> unassign --peers "1849118658,1337348840"

# Rimuovi da utenti
./strategies.py --url <url> --token <token> unassign --users "admin"

# Rimuovi da gruppi dispositivi
./strategies.py --url <url> --token <token> unassign --device-groups "device_group1"

Note:

• Lo script supporta sia nomi che GUID per utenti e gruppi dispositivi
• Gli ID dispositivi vengono automaticamente convertiti in GUID
• Tutte le operazioni assign/unassign possono gestire più target contemporaneamente

Requisiti di permessi:

• I comandi list/view/enable/disable/assign/unassign richiedono Permesso Strategia
• --peers richiede Permesso Dispositivo:r (per ricerca da ID a GUID)
• --users richiede Permesso Utente:r (per ricerca da nome utente a GUID)
• --device-groups richiede Permesso Gruppo Dispositivi:r (per ricerca da nome gruppo a GUID)

---

Audit (audits.py)

Mostra aiuto:

./audits.py -h

Visualizza audit di connessione:

./audits.py --url <url> --token <token> view-conn [--remote <peer_id>] [--conn-type <type>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit file:

./audits.py --url <url> --token <token> view-file [--remote <peer_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit allarmi:

./audits.py --url <url> --token <token> view-alarm [--device <device_id>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Visualizza audit console:

./audits.py --url <url> --token <token> view-console [--operator <username>] [--page-size <n>] [--current <n>] [--created-at <"YYYY-MM-DD HH:MM:SS">] [--days-ago <n>]

Filtri:

--remote : ID peer (per audit di connessione o file)
--conn-type : 0=Desktop Remoto, 1=Trasferimento File, 2=Trasferimento Porte, 3=Visualizza Telecamera, 4=Terminale
--device : ID dispositivo (per audit allarmi)
--operator : nome operatore (per audit console)
--created-at : filtro orario locale, es. "2025-09-16 14:15:57"
--days-ago : filtra record più recenti di n giorni
--page-size / --current : paginazione

Esempio:

./audits.py --url https://example.com --token <token> view-conn --remote 123456789 --days-ago 7

Cercare un dispositivo

1. Vai su Dispositivi.
2. Nel Campo di Ricerca Nome Dispositivo digita il nome e clicca Query o premi Invio.
3. Per usare un carattere jolly aggiungi % all'inizio, alla fine o a entrambi del termine di ricerca.