Configurazione: Impostazioni del server

Informazioni

Per personalizzare le tue impostazioni, fai clic sull'icona del server situata in alto a destra dell'interfaccia di Agent DVR e seleziona "Impostazioni" dal menu Configurazione. Si prega di notare che, se l'icona del server è evidenziata con uno sfondo colorato, ciò indica che stai operando su un server Agent DVR di un altro utente tramite permessi, il che potrebbe limitare l'accesso ad alcune funzionalità.

Generale

Opzioni generali per il server Agent DVR, inclusi il nome, la lingua predefinita, il canale di aggiornamento e il modo in cui gestisce il carico CPU.

  • Name: Assegna un nome univoco alla tua istanza di Agent DVR. Questo è particolarmente utile se gestisci più server nel tuo account. Nota: la modifica del nome del server potrebbe influire sui permessi che hai assegnato ad altri utenti.
  • Beta Track: Verifica gli aggiornamenti dal canale beta invece del canale di rilascio.
  • Default Language: Imposta la lingua predefinita per il tuo server
  • Default Voice: La voce predefinita utilizzata per la sintesi vocale.
  • Max CPU: Specifica l'utilizzo massimo di CPU per il tuo server. Gli avvisi verranno inviati se questo limite viene raggiunto e Agent DVR regolerà il framerate delle telecamere per gestire il carico.
  • Tuning: Ottimizza Agent DVR per il tuo hardware: Performance (FPS elevati, meno telecamere), Balance o Capacity (più telecamere o hardware meno potente).
  • Check for Updates: Abilita il controllo delle nuove versioni di Agent DVR.
  • Talk Device: Il dispositivo di uscita audio utilizzato per la riproduzione talk.
  • ONVIF Discovery: Abilita o disabilita il rilevamento periodico dei dispositivi ONVIF sulla tua rete.
  • Experimental Features: Attiva questa opzione per testare le nuove funzioni in Agent. Queste funzioni sono in genere in fase di sviluppo e dovrebbero essere utilizzate principalmente a scopo di test.
  • Software Encoders (FFmpeg GPL): Agent DVR utilizza una build LGPL di FFmpeg per impostazione predefinita. Abilita questa opzione per scaricare la build FFmpeg con licenza GPL facoltativa, che aggiunge i software encoder x264 e x265 per una codifica H.264/H.265 di qualità superiore su sistemi senza accelerazione GPU. Quando modifichi questa impostazione, Agent DVR scarica la build selezionata in background e quindi si riavvia automaticamente per applicarla. I sistemi con una GPU supportata non necessitano di questa opzione. Entrambe le build di FFmpeg sono open source - gli script di build e il codice sorgente sono disponibili su github.com/ispysoftware/agentdvr-ffmpeg-build, e ogni download include i relativi testi di licenza nella cartella licenses.
  • Default Camera Login: Un nome utente e una password precompilati utilizzati quando si aggiungono nuovi dispositivi telecamera (utile se le tue telecamere condividono un unico login).
  • Min Framerate: Il framerate minimo al quale le telecamere verranno ridotte quando Agent DVR sta riducendo il carico CPU.
  • CPU Priority: Imposta la priorità del processo Agent DVR sul tuo sistema. Si consiglia Above Normal.
  • Apply Schedule at Start: Abilita questa opzione per applicare le impostazioni di pianificazione all'avvio, assicurando che i tuoi dispositivi siano nello stato corretto in base alla tua pianificazione. Se deselezionata, Agent DVR si avvierà con i dispositivi nel loro ultimo stato noto.
  • Notify on Disconnect: Attiva questa opzione per ricevere notifiche se il server si disconnette inaspettatamente dai servizi web.
  • VLC Directory: Specifica la directory di installazione di VLC (v3+). Questa viene solitamente rilevata automaticamente dal sistema.
  • Push to Talk: Abilita la modalità push to talk, in cui la comunicazione è possibile solo quando il pulsante talk viene premuto.
  • SignalR Method: Seleziona il metodo SignalR (utilizzato da Agent DVR per configurare le connessioni remote). Questo è principalmente per la risoluzione dei problemi di accesso remoto.
  • Wait for SignalR: Abilita questa opzione per attendere una risposta SignalR all'avvio, che può aiutare a risolvere i problemi di connessione su macOS.

Server AI

Connetti Agent DVR ai server AI per aggiungere funzionalità intelligenti come il riconoscimento degli oggetti alle tue telecamere.

Vedi Impostazioni AI

Cloud

Connetti Agent DVR ai tuoi account di cloud storage qui in modo che le tue telecamere possano caricare automaticamente registrazioni e foto al di fuori del sito.

Provider Cloud Supportati

  • Box
  • Drive
  • DropBox
  • NextCloud / WebDav
  • OneDrive
  • OneDrive Business
  • OpenDrive
  • S3

Fai clic sul pulsante appropriato per autorizzare Agent DVR a connettersi al tuo host cloud. Se riscontri problemi, considera di disabilitare temporaneamente l'autenticazione a 2 fattori sul tuo account host cloud. Una volta che Agent DVR ha accesso, puoi gestire i caricamenti cloud regolando le tue impostazioni cloud della telecamera.

Cloud Storage S3

Per le opzioni di archiviazione S3, oauth non viene utilizzato. Invece, dovrai fornire un ID client e una chiave segreta per i caricamenti. Agent DVR è compatibile con Amazon S3 e altri provider S3 come Google Cloud.

Impostazioni Amazon S3

Configura il tuo account di archiviazione su AWS e inserisci i parametri S3 richiesti. Il campo URL deve essere lasciato vuoto per Amazon S3, poiché è configurato automaticamente.

Impostazioni Google Cloud S3

Per l'archiviazione Google Cloud S3, inizia creando un nuovo bucket nell'interfaccia di Google Cloud. Quindi, genera una Chiave di accesso, che fornirà una chiave e un segreto per la configurazione di Agent DVR. Imposta l'URL su https://storage.googleapis.com. Nota: il nome della regione non è richiesto per questa configurazione.

Server FTP

Configura e gestisci comodamente i tuoi server FTP qui. Una volta che un server è stato aggiunto, puoi facilmente selezionarlo per qualsiasi telecamera tramite le opzioni di modifica. Per ulteriori dettagli sulle impostazioni FTP della telecamera, consulta FTP della telecamera.

  • Nome: Assegna un nome locale al tuo server per una facile identificazione all'interno di Agent.
  • Nome utente: Inserisci il nome utente del tuo server FTP.
  • Password: Inserisci la password del tuo server FTP.
  • Server: Specifica l'URL del tuo server FTP, iniziando con ftp:// o sftp:// (ad esempio, ftp://192.168.12.1).
  • Porta: Il numero di porta utilizzato dal tuo server FTP, tipicamente 21 per ftp:// e 22 per sftp://.
  • Usa SFTP: Abilita questa opzione se il tuo server utilizza SFTP.
  • Usa Passivo: Opta per la modalità FTP passiva selezionando questa opzione.
  • Rinomina: Attivando questa opzione, Agent caricherà i file con un nome temporaneo e li rinominerà dopo il caricamento. Questo è particolarmente utile per ridurre al minimo lo sfarfallio durante lo streaming video tramite FTP e javascript. Ulteriori informazioni.
  • Coda massima: Imposta un limite per la dimensione della coda di caricamento. Se questo limite viene raggiunto, Agent smetterà di accettare nuovi file per il caricamento. Nota che la dimensione della coda è gestita su base per telecamera.

Layouts

I layout controllano come le tue telecamere sono disposte nella vista dal vivo. Utilizzando questa scheda puoi aggiungere, modificare ed eliminare layout

LDAP

Utilizza il tuo server LDAP (openLDAP, Active Directory ecc) per gestire gli accessi. Questa funzione utilizza la feature di accessi locali e richiede una licenza. Puoi trovare queste impostazioni nella scheda LDAP della finestra Utenti in Impostazioni server.

Con LDAP i tuoi utenti possono accedere al client web locale utilizzando i loro accessi LDAP. Questo li autenticherà rispetto al tuo server LDAP e creerà automaticamente un account locale per loro.

  • Abilitato: Attiva o disattiva gli accessi con LDAP.
  • Indirizzo server: Immetti l'indirizzo del tuo server LDAP, ad es. ldap.example.com
  • Porta: Porta del server LDAP. Di solito 389 o 636 per LDAP su SSL. Se stai utilizzando Active Directory e riscontri errori di Referral, prova la porta 3268 (Global Catalog).
  • È Active Directory: Spunta questa opzione se stai utilizzando AD (modifica alcuni campi passati a LDAP).
  • Usa SSL: Spunta se stai utilizzando una connessione sicura
  • Convalida certificato: Convalida il certificato SSL del server. Lascia disattivato per certificati autofirmati.
  • Usa autenticazione di base: Utilizza l'autenticazione di base quando ti colleghi al server LDAP.
  • Base di ricerca LDAP: Basi di ricerca del dominio. ad es. DC=myorg,DC=com
  • Versione protocollo: Il valore predefinito è 3
  • Nome comune: L'attributo utilizzato per abbinare i nomi utente, ad es. sAMAccountName per Active Directory o uid per openLDAP.
  • Accesso servizio: Nome utente e password opzionali per un account di servizio utilizzato per cercare i dettagli dell'utente e l'appartenenza al gruppo. Obbligatorio se il tuo server non consente il binding anonimo.

Autorizzazioni gruppo

Con le Autorizzazioni gruppo puoi aggiungere nomi di gruppi utenti LDAP e autorizzazioni da applicare a questi gruppi. Devi aggiungere almeno un gruppo LDAP per configurare gli accessi LDAP. Quando un utente accede, il sistema abbina la sua appartenenza al gruppo utenti LDAP rispetto a questi gruppi e applica le autorizzazioni trovate. Se un utente è membro di più gruppi, le autorizzazioni verranno combinate (tramite un'operazione OR).

Esempi di configurazione LDAP

Active Directory (Windows Server)

Configurazione di base

Indirizzo server
dc1.company.local
Porta
389 (LDAP) o 636 (LDAPS)
È Active Directory
Abilitato
Usa SSL
Abilitato (consigliato)
Usa autenticazione di base
Abilitato
Base di ricerca LDAP
DC=company,DC=local
Versione protocollo
3
Nome comune
sAMAccountName

Accesso al servizio (Facoltativo)

Nome utente
Password
[service account password]
Formati di accesso:
Gli utenti possono accedere con:

OpenLDAP Server

Configurazione di base

Indirizzo server
ldap.company.com
Porta
389 (LDAP) o 636 (LDAPS)
È Active Directory
Disabilitato
Usa SSL
Abilitato (consigliato)
Usa autenticazione di base
Abilitato
Base di ricerca LDAP
dc=company,dc=com
Versione protocollo
3
Nome comune
uid

Accesso al servizio (Obbligatorio)

Nome utente
cn=ldap-reader,ou=system,dc=company,dc=com
Password
[service account password]
Importante:
L'account di servizio è necessario per le ricerche di utenti poiché il binding anonimo è in genere disabilitato.
Accesso utente:
Gli utenti accedono con il loro uid:
john.doe

ForumSys Public Test Server

Configurazione Base

Indirizzo Server
ldap.forumsys.com
Porta
389
È Active Directory
Disabilitato
Usa SSL
Disabilitato (solo test)
Usa Autenticazione Base
Abilitato
Base di Ricerca LDAP
dc=example,dc=com
Versione Protocollo
3
Nome Comune
uid

Login Servizio (Non Richiesto)

Nome Utente
(lasciare vuoto)
Password
(lasciare vuoto)
Utenti di Test Disponibili:
einstein / password
newton / password
galieleo / password
tesla / password

Google Secure LDAP

Configurazione di Base

Indirizzo Server
ldap.google.com
Porta
636
È Active Directory
Disabilitato
Usa SSL
Abilitato
Usa Autenticazione di Base
Abilitato
Base di Ricerca LDAP
dc=company,dc=com
Versione Protocollo
3
Nome Comune
uid

Accesso al Servizio (Obbligatorio)

Nome Utente
[service account email]
Password
[service account password]
Obbligatorio:
L'account di servizio deve essere configurato in Google Admin Console con le autorizzazioni LDAP appropriate.

Note di Configurazione e Risoluzione dei Problemi

Raccomandazioni SSL/TLS

  • Produzione: Usa sempre SSL (porta 636) o StartTLS (porta 389 con SSL abilitato)
  • Test: Connessioni non-SSL accettabili solo per ambienti di test

Active Directory vs OpenLDAP

  • Active Directory: Usa sAMAccountName per Common Name
  • OpenLDAP/Others: Di solito usa uid per Common Name

Selezione della Porta

  • 389: LDAP standard (può usare StartTLS)
  • 636: LDAP over SSL (LDAPS)
  • 3268: AD Global Catalog (non crittografato)
  • 3269: AD Global Catalog over SSL

Account di Servizio

  • Active Directory: Può usare formato UPN ([email protected])
  • OpenLDAP: Richiede formato DN completo (cn=service,ou=users,dc=domain,dc=com)
  • Facoltativo: Se non specificato, le credenziali utente verranno usate per le ricerche di gruppo

Problemi Comuni

Assicurati che i certificati SSL siano validi o configura correttamente la convalida dei certificati.

Assicurati che le porte LDAP siano accessibili dal tuo server e che le regole del firewall consentano il traffico.

L'account di servizio deve avere permessi di lettura su oggetti utente e gruppo.

La base di ricerca deve essere abbastanza ampia da includere tutti gli utenti e i gruppi nella tua directory.

OAUTH

Utilizza un fornitore di identità di terze parti (come Okta, Microsoft Entra ID, Google, ecc.) per gestire gli accessi tramite gli standard OAuth 2.0 e OpenID Connect. Questa funzione utilizza la funzionalità di accesso locale e richiede una licenza.

Con OAuth2, i tuoi utenti possono accedere al client web locale utilizzando le credenziali aziendali esistenti. Questo li autentica presso il tuo fornitore e, se ha successo, crea o aggiorna automaticamente un account locale per loro.

  • Abilitato: Attiva o disattiva gli accessi con OAuth2.
  • Nome del fornitore: Un nome descrittivo per il fornitore che appare sul pulsante di accesso, ad esempio "Accedi con Google".
  • ID client: L'identificatore pubblico univoco della tua applicazione, fornito dal tuo fornitore di identità.
  • Segreto client: Il segreto client della tua applicazione. Mantienilo riservato.
  • Emittente: L'URL radice del server di autorizzazione del tuo fornitore. Questo è l'URL di base da cui vengono individuati tutti gli altri endpoint.
  • Endpoint di autorizzazione: L'URL verso cui viene inviato l'utente per accedere.
  • Endpoint token: L'URL che la tua applicazione utilizza per scambiare il codice di autorizzazione con un token ID.
  • Redirect URI: L'URL esatta a cui il provider reindirizzerà l'utente dopo un accesso riuscito. Questo deve essere nella whitelist del provider. Per le app LAN, è tipicamente un indirizzo localhost (ad es., http://localhost:8090/).
  • Scope: Un elenco di autorizzazioni separate da spazi che l'app sta richiedendo. Come minimo, deve includere openid profile email e uno scope per i gruppi, ad es., groups
  • Username Claim: Il nome della claim nel token ID da utilizzare come nome utente univoco dell'utente. La pratica standard è utilizzare preferred_username o email
  • Group Claim: Il nome della claim nel token ID che contiene le appartenenze ai gruppi dell'utente. È spesso groups

Autorizzazioni gruppo

Utilizzando Autorizzazioni di gruppo, puoi mappare i nomi dei gruppi dal tuo fornitore di identità a un insieme di autorizzazioni in questa applicazione. Devi aggiungere almeno un mapping di gruppo per configurare gli accessi OAuth2. Quando un utente accede, il sistema controlla le attestazioni di gruppo nel suo token, le confronta con queste regole e applica le autorizzazioni che trova. Se un utente è membro di più gruppi mappati, le autorizzazioni verranno combinate (tramite un'operazione OR), concedendogli l'accesso più permissivo.

Esempi di configurazione OAuth2

Okta

Configurazione del provider

Issuer
https://your-tenant.okta.com
Authorization Endpoint
https://your-tenant.okta.com/oauth2/v1/authorize
Token Endpoint
https://your-tenant.okta.com/oauth2/v1/token
Client ID
Disponibile nelle impostazioni dell'applicazione Okta
Redirect URI
http://localhost:8090/
Scope
openid profile email groups
Username Claim
preferred_username
Group Claim
groups

Note sulla configurazione di Okta

Configurazione importante:
Nelle Impostazioni generali dell'applicazione Okta, devi aggiungere alla whitelist gli URL:
  • Sign-in redirect URIs: Aggiungi il tuo Redirect URI completo (ad es., http://localhost:8090/).
  • Sign-out redirect URIs: Aggiungi l'URL a cui gli utenti devono essere inviati dopo il logout (ad es., http://localhost:8090/).
Ottenere le Group Claims:
Per includere i gruppi nel token, vai alla scheda Sign On dell'applicazione Okta, modifica la sezione "OpenID Connect ID Token" e configura un filtro Groups claim.
Errori Firewall / 403:
Se ricevi errori di connessione, potrebbe essere necessario aggiungere il tuo Redirect URI alla lista attendibile in Security > API > Trusted Origins.

Risoluzione dei problemi

Questo quasi sempre significa che l'URI di reindirizzamento all'accesso o l'URI di reindirizzamento alla disconnessione non è configurato e inserito nella whitelist correttamente nelle impostazioni dell'applicazione del provider. L'URL deve corrispondere esattamente a quello che l'applicazione sta inviando.

Il provider di identità sta bloccando la richiesta dal tuo server. Di solito è un firewall o una policy di sicurezza. In Okta, devi aggiungere l'URL base della tua applicazione (ad es. http://localhost:8090) all'elenco attendibile in Security > API > Trusted Origins. Altri provider potrebbero avere impostazioni simili per "CORS" o "Web Origins".

Questo può avere diverse cause:
  • L'ambito nella tua configurazione non include l'ambito richiesto per i gruppi, ad es. groups
  • L'utente che stai testando non è membro di alcun gruppo nel provider di identità.
  • Il provider non è configurato per inviare il claim dei gruppi. In Okta, devi configurare esplicitamente un filtro del claim dei gruppi nelle impostazioni "Sign On" dell'applicazione per aggiungere i gruppi all'ID Token.
  • Il nome del Group Claim nella tua configurazione non corrisponde al nome del claim nel token, ad es. la tua configurazione dice groups ma il token contiene roles

Licenza

Usa questa scheda per concedere in licenza Agent DVR per uso aziendale/abilitare l'inoltro di porta per l'accesso remoto.

Hai una licenza per Agent DVR e vuoi trasferirla a un nuovo computer? Vedi Trasferimento Licenza. Puoi semplicemente eliminare la vecchia licenza e ti permetterà di aggiungere una nuova licenza per il nuovo computer.

Puoi anche acquistare licenze in volume tramite Fattura. Vedi Licenze in Volume.

Licenza via riga di comando

Se non hai accesso ad Agent tramite la rete locale (ad esempio stai utilizzando ProxMox o un altro ambiente virtuale) puoi concedere in licenza Agent DVR utilizzando i seguenti comandi. Accedi al computer tramite il terminale e vai alla cartella contenente l'eseguibile di Agent. Assicurati che Agent non sia in esecuzione:

Questi comandi dovrebbero funzionare su v5.9.3.0+

  • sudo systemctl stop AgentDVR.service
  • Agent show-id
    Questo visualizzerà l'ID Univoco di cui hai bisogno per concedere in licenza agent o trasferire la tua licenza.
  • Agent license "LICENSE-GOES-HERE"
    Chiama questo con la tua licenza e riavvia Agent per applicare.
  • sudo systemctl start AgentDVR.service
    per riavviare il servizio Agent DVR.

Per versioni precedenti:

  • sudo systemctl stop AgentDVR.service
  • Ottieni il tuo ID Univoco modificando Agent/Media/XML/config.xml e cerca UniqueID. Agent avrà dovuto essere eseguito almeno una volta per generare questo file.
  • Concedi in licenza Agent e quindi copia il testo della licenza in un campo nuovo (o esistente) nello stesso file: <License>LICENSE-GOES-HERE</License>.
  • sudo systemctl start AgentDVR.service
    per riavviare il servizio Agent DVR.

Etichettatura bianca

Una volta che Agent DVR è Licenziato puoi applicare la white label per la tua azienda o i tuoi clienti utilizzando le opzioni nella scheda Opzioni White Label (richiede una licenza white-label):

Le opzioni di white labelling si applicano alla tua interfaccia utente del server, non alla nostra piattaforma web remota
  • Nome Prodotto Imposta un nome prodotto alternativo da visualizzare nella parte superiore dell'interfaccia utente (max 6 caratteri)
  • Mostra Logo Carica un logo utilizzando l'opzione File Upload del Menu Server e questo verrà visualizzato dai clienti mentre l'app web si carica.
  • Mostra Link Guida Attiva o disattiva i link della guida nell'app che portano l'utente al nostro sito web.
  • Mostra Remoto Mostra o nascondi i link ai nostri servizi remoti e integrazioni.
  • Mostra Licenza Mostra o nascondi questa scheda di licenza. Nota che se questa scheda è nascosta l'unico modo per visualizzarla di nuovo è interrompere il servizio Agent DVR, modificare Media/XML/config.xml nella directory Agent DVR e impostare ShowLicensing su "true" e quindi riavviarlo.
  • Testo Informazioni Imposta il testo che viene visualizzato quando fai clic sull'icona Informazioni nell'interfaccia utente.

Server Locale

Queste impostazioni controllano il server web integrato che ospita l'interfaccia utente di Agent DVR. Modificale per cambiare la porta del server web, abilitare HTTPS o limitare chi può connettersi.

  • Porta: La porta locale utilizzata da Agent. Il valore predefinito è 8090.
  • Porta WAN: Se hai effettuato il port forward di Agent DVR, specifica qui la porta esterna (utilizzata per le connessioni dell'applicazione mobile).
  • Porta SSL: La porta per le connessioni SSL al tuo server. Impostala a 0 per disabilitare. Prima di impostarla, leggi le linee guida.
  • Solo SSL: Accetta solo richieste SSL. Verifica prima che SSL funzioni correttamente!
  • Certificato SSL: Il file del certificato per le connessioni SSL.
  • Password SSL: La password per il tuo certificato SSL.
  • Proxy affidabili: Indirizzi IP dei proxy inversi autorizzati a segnalare l'IP client reale. Lascia vuoto a meno che non esegui un proxy (ad es. nginx, Caddy, Cloudflare Tunnel) davanti a Agent.
  • Associa all'interfaccia: Per impostazione predefinita, Agent DVR monitora tutte le interfacce. Puoi specificare un'interfaccia di rete particolare per il monitoraggio qui. Se questa impostazione interrompe l'accesso, puoi ripristinare il valore predefinito impostando BindInterface su '*' in Agent/Media/XML/config.xml.
  • Proteggi API: Abilita l'autenticazione di base per gli endpoint API. Nota che questo potrebbe influire su alcune integrazioni.
  • Timeout di accesso: Imposta un limite di tempo per l'accesso al server tramite permessi (in minuti). 0 per accesso illimitato.
  • Sessioni massime: Limita il numero di connessioni simultanee del browser web. Le connessioni in eccesso verranno disconnesse. Impostala a 0 per illimitato.
  • Abilita ZeroConf: Abilita il servizio di rilevamento automatico della rete, che consente ad Agent DVR di essere scoperto da altre applicazioni, incluse le app mobile e l'app della barra di sistema Windows.
  • Blocca accesso esterno: Seleziona questa opzione per bloccare completamente l'accesso dal portale web remoto.

Server TURN

Il server TURN è fondamentale per abilitare l'accesso remoto al server Agent DVR e ai dispositivi. Aiuta a facilitare le connessioni quando le connessioni peer-to-peer dirette non sono possibili, ad esempio quando i dispositivi sono dietro NAT o firewall.

Agent DVR include un server TURN integrato e lo configura e mantiene in esecuzione automaticamente. Puoi anche utilizzare il tuo server TURN se disponi di una licenza per l'accesso remoto.

  • Server STUN: Elenco di server STUN pubblicamente disponibili da utilizzare durante la configurazione delle connessioni.
  • Server TURN: Specifica se utilizzare il server TURN integrato o un server TURN personalizzato. La disabilitazione del server TURN potrebbe interrompere l'accesso.
  • Indirizzo TURN: L'indirizzo IP da utilizzare per il server TURN. Lascia vuoto per automatico.
  • Porta TURN: La porta del server STUN/TURN (predefinita 3478).
  • Porta minima server TURN: Limite inferiore dell'intervallo di porte per le allocazioni di relay TURN. L'impostazione predefinita è 50000. L'inoltro di questo intervallo è consigliato ma solitamente non richiesto, poiché il traffico di relay normalmente viaggia attraverso la porta TURN.
  • Porta massima server TURN: Limite superiore dell'intervallo di porte per le allocazioni di relay TURN. L'impostazione predefinita è 50100. L'inoltro di questo intervallo è consigliato ma solitamente non richiesto.

Utilizza le impostazioni del server TURN personalizzato se desideri utilizzare un server TURN ospitato esternamente per le connessioni remote dirette ad Agent DVR. Se configuri queste opzioni, dovrai impostare la modalità del server TURN qui sopra su Personalizzato. Dovrai ottenere questi dettagli dal tuo provider. È richiesta una licenza per l'accesso remoto ad Agent DVR.

Interfaccia utente

Queste opzioni personalizzano l'interfaccia di Agent DVR, dai timestamp predefiniti sui video ai formati di data e ora fino alle sezioni dell'interfaccia disponibili.

Limiti

  • Max Alerts: Il numero massimo di avvisi da archiviare. Quando questo limite viene raggiunto, Agent eliminerà gli avvisi precedenti.
  • Views: Il numero di visualizzazioni disponibili sulla schermata live.
  • Plans: Il numero di piani disponibili sulla schermata delle planimetrie.

Impostazioni Predefinite Timestamp

Lo stile di timestamp predefinito per le telecamere che utilizzano le impostazioni di timestamp globali.

  • Formatter: Il testo timestamp. Esempio: {FPS},{RES},{0:G},{0:T},{NAME},{REC},{0:dd MMM yy}
  • Position: Dove appare il timestamp sul video, o Nessuno per nasconderlo.
  • Text Color / Back Color: I colori del testo e dello sfondo del timestamp.
  • Show Background: Disegna uno sfondo dietro il testo del timestamp.
  • Opacity: L'opacità dello sfondo del timestamp.
  • Auto Font Size: Ridimensiona automaticamente il carattere del timestamp in base alla risoluzione video, o deseleziona per impostare una Font Size fissa.
  • Outline Color / Outline Size: Aggiungi un contorno al testo del timestamp.

Formati Ora

  • Culture Code: Imposta il codice cultura per la formattazione della data nei timestamp (ad es., en-US per l'inglese americano, fr-CA per il francese canadese). Vedi questo elenco per altre opzioni.
  • Time Format: Scegli il formato per la visualizzazione di data e ora nell'interfaccia di Agent DVR. Il formato predefinito è a 12 ore ("MMM DD YYYY h:mm:ss A"). Per il formato 24 ore, utilizza "YYYY-MM-DD H:mm:ss".
  • Time Format (small): Scegli il formato per la visualizzazione di data di piccole dimensioni nell'interfaccia di Agent DVR. Il formato predefinito è a 12 ore ("MMM DD h:mm A").
  • Date Format: Scegli il formato della data
  • YYYY: anno a 4 cifre '2019'
  • YY: anno a 2 cifre '19'
  • MMMM: mese per esteso 'June'
  • MMM: mese a 3 caratteri 'Jun'
  • MM: mese dell'anno, con padding zero '06'
  • M: mese dell'anno '6'
  • DD: giorno del mese, con padding zero '01'
  • D: giorno del mese '1'
  • Do: giorno del mese con contrazione ordinale numerica '1st'
  • HH: ora del giorno da 0-24, con padding zero, '14'
  • H: ora del giorno da 0-24, '14'
  • hh: ora del giorno in formato 12 ore, con padding zero, '02'
  • h: ora del giorno in formato 12 ore, '2'
  • mm: minuto, con padding zero, '04'
  • m: minuto, '4'
  • ss: secondo, con padding zero
  • s: secondo
  • A: 'AM' o 'PM'
  • a: 'am' o 'pm'

Impostazioni Predefinite Player

  • Skip to Motion: Durante la riproduzione delle registrazioni, salta alla prima istanza di movimento.

Tag

  • File Tags: L'insieme di tag disponibili per l'etichettatura delle registrazioni. Viene compilato automaticamente mentre etichetti le registrazioni oppure puoi modificarlo qui.
  • Image Tags: L'insieme di tag disponibili per l'etichettatura delle immagini. Viene compilato automaticamente mentre etichetti le immagini oppure puoi modificarlo qui.

Sezioni

Seleziona i viewer disponibili da visualizzare nell'interfaccia. Deseleziona le sezioni che desideri nascondere. Seleziona il pulsante "Admin has all" per abilitare tutte le sezioni per gli amministratori.

Registrazione

Controlla il livello di dettaglio che Agent DVR scrive nei suoi log. Aumenta il livello di log o le opzioni dei componenti qui sotto per risolvere un problema, quindi riducili di nuovo per mantenere i file di log gestibili.

  • Max Log Size: Determina il numero massimo di voci che possono essere conservate nella coda di log.
  • Log Level: Scegli il livello di dettaglio da registrare, da None fino a Debug.
  • WebRTC: Abilita la registrazione delle connessioni WebRTC, utile per il debug dei problemi di visualizzazione dal vivo.
  • ONVIF: Abilita la registrazione del debug per i dispositivi ONVIF.
  • FFMPEG Log Level: Regola il livello di output del debug per ffmpeg. Attenzione: l'impostazione Trace può riempire rapidamente i tuoi log e deve essere utilizzata solo brevemente per scopi di debug specifici.
  • SignalR Logging: Abilita la registrazione delle comunicazioni con il server SignalR, utile per il debug dettagliato.

Registrazione Syslog

Agent DVR può trasmettere i suoi log a un server syslog (v6.2.6.0+). Questo può essere utile per il monitoraggio e il debug. Puoi configurare il server per l'invio dei log in Logging.

  • Enabled: Attiva o disattiva Syslog Logging.
  • Server: Specifica l'indirizzo del server, ad es: logs1.papertrailapp.com
  • Port: La porta da utilizzare
  • Category: Seleziona la categoria Syslog (o Facility).

MQTT

MQTT, un protocollo di messaggistica IoT fondamentale, facilita l'integrazione senza interruzioni di dispositivi e servizi sulla tua rete. Configura le impostazioni MQTT qui per abilitare MQTT Events sui tuoi dispositivi, o utilizza Actions per inviare messaggi personalizzati al server MQTT. Inoltre, Agent DVR può essere configurato per reagire ai comandi MQTT. Per maggiori dettagli, vedi MQTT.

  • Enabled: Attiva o disattiva MQTT.
  • Server: Inserisci l'indirizzo IP del tuo server MQTT.
  • Port: Specifica la porta utilizzata dal tuo server MQTT (il valore predefinito è 1883).
  • Home Assistant Discovery: Pubblicizza i dispositivi che hanno MQTT Events abilitato su Home Assistant, in modo che compaiano lì automaticamente con sensori e interruttori. Vedi Home Assistant per i dettagli.
  • Check Interval: Imposta l'intervallo in secondi per Agent DVR per inviare messaggi keep-alive, garantendo una connessione stabile.
  • Protocol: Scegli il protocollo di connessione, None o TLS.
  • LWT delay: Invia un messaggio offline al topic di stato dopo un ritardo (in secondi, 0 per disabilitare).
  • Validate Certificate: Convalida il certificato TLS del server. Lascia disabilitato per certificati auto-firmati.
  • Protocol Version: La versione del protocollo MQTT da utilizzare. Lascia Default a meno che il tuo server non richieda una versione specifica.
  • QoS: Livello di Quality of Service. Consulta la documentazione del tuo server MQTT per i dettagli.
  • Client ID: Il tuo ID client MQTT. Lascia vuoto per generarlo automaticamente.
  • Username: Il tuo nome utente del server MQTT.
  • Password: La tua password del server MQTT.
  • Discovery Prefix: Il prefisso del topic utilizzato per i messaggi di discovery di Home Assistant (il valore predefinito è homeassistant). Cambia questo solo se hai modificato il prefisso di discovery nell'integrazione MQTT di Home Assistant.
  • Send Stats: Abilita questo per consentire a Agent DVR di inviare statistiche a MQTT, come l'utilizzo di CPU, utilizzo della memoria e utilizzo del disco.

NDI

NDI (Network Device Interface) semplifica il processo di accesso alle fonti video IP, offrendo funzionalità di scoperta integrate. Molte telecamere e sistemi di videosorveglianza sono già pronti per NDI, facilitando l'integrazione con Agent DVR. Per ulteriori informazioni sulla tecnologia NDI e sui dispositivi compatibili, visita ndi.tv. Agent DVR supporta le fonti NDI con capacità video e audio, nonché il controllo PTZ tramite NDI.

  • Gruppi: Qui puoi aggiungere gruppi NDI, se applicabile. Inserisci ogni gruppo su una nuova riga.
  • IP aggiuntivi: Aggiungi indirizzi IP NDI specifici per la scansione del dispositivo. Ogni IP dovrebbe essere su una nuova riga.
  • Mostra dispositivi locali: Attiva questa opzione per decidere se i dispositivi NDI sul computer locale (che sta eseguendo Agent DVR) devono essere visualizzati nell'elenco.

ONVIF

Agent DVR utilizza parole chiave nei pacchetti XML degli eventi ONVIF per identificare eventi di movimento. Poiché questi pacchetti possono variare tra modelli di telecamere diversi, forniamo un'opzione per aggiungere eventi XML personalizzati dalla tua telecamera per attivare eventi ONVIF. Questa funzione è particolarmente utile se riscontri problemi con la rilevazione degli eventi ONVIF standard.

  • Rileva XML: Inserisci qui il pacchetto evento ONVIF XML specifico dalla tua telecamera.
  • Registrazione eventi: Abilita questa opzione per registrare tutti gli XML in ingresso dalla telecamera, utile per scopi di debug. Accedi a questi registri su /logs.html sul tuo server locale.

Ad esempio, se noti voci nei registri su /logs.html come:


Evento ONVIF ignorato: <tt:Source xmlns:tt="http://www.onvif.org/ver10/schema"><tt:SimpleItem Name="VideoSource" Value="V_SRC_000" /><tt:SimpleItem Name="Rule" Value="MyMotionDetectorRule" /></tt:Source><tt:Data xmlns:tt="http://www.onvif.org/ver10/schema"><tt:SimpleItem Name="State" Value="true" /></tt:Data>

E Agent non lo riconosce come un evento di movimento, puoi aggiungere quanto segue nel campo Rileva XML:


<tt:SimpleItem Name="Rule" Value="MyMotionDetectorRule" /></tt:Source><tt:Data xmlns:tt="http://www.onvif.org/ver10/schema"><tt:SimpleItem Name="State" Value="true" /></tt:Data>

Agent interpreterà quindi gli eventi contenenti questo testo specifico come eventi di movimento.

Riproduzione

Queste impostazioni controllano come Agent DVR renderizza e fornisce il video al browser web e tramite l'API.

  • Max Stream Size: Imposta la risoluzione massima per lo streaming al client web. Risoluzioni più elevate possono aumentare significativamente l'utilizzo della CPU.
  • High DPI: Trasmette il video alla risoluzione completa dei display ad alta densità (monitor 4K, Mac, telefoni) per un'immagine più nitida, al costo di un maggiore carico di codifica. I limiti di dimensione dello stream rimangono validi.

    • Disabilitato: Risoluzione standard (impostazione predefinita).
    • GPU: Risoluzione completa solo per i visualizzatori che utilizzano la codifica GPU, dove il carico aggiuntivo è trascurabile.
    • Abilitato: Risoluzione completa per tutti i visualizzatori. Aumenta l'utilizzo della CPU con la codifica software.

  • Default Font: Il font predefinito utilizzato per il rendering di testo come i timestamp sul video.
  • Video FPS: Il massimo numero di fotogrammi al secondo (frequenza fotogrammi) per il video inviato al browser web.
  • Fill Mode: Scegli se l'immagine della telecamera riempie lo spazio disponibile (Fill) o mantiene il suo rapporto di aspetto originale (Center).
  • Use GPU: Abilita l'utilizzo della GPU per la decodifica dei file video salvati.
  • Use GPU for web client: Utilizza la GPU per codificare il video trasmesso ai client web. Richiede Force H264.
  • JPEG Quality: L'impostazione di qualità predefinita per la codifica delle immagini jpeg. Valori più elevati possono utilizzare più CPU e spazio di archiviazione.
  • Max MJPEG Size: La dimensione massima dello stream MJPEG che Agent DVR genererà tramite l'API.
  • Default MJPEG Size: La dimensione predefinita dello stream MJPEG che Agent DVR genererà tramite l'API, utilizzata quando nessun parametro di dimensione è specificato.
  • Force H264: Utilizza H264 per lo streaming del video ai client. Deseleziona questa opzione se la visualizzazione dal vivo smette di funzionare.
  • Default GPU Device: Scegli il dispositivo GPU predefinito da utilizzare quando hai più di uno.
  • Default GPU Decoder *: Scegli il decoder hardware preferito. Agent DVR proverà altre opzioni se quella preferita non funziona.
  • Default Record Codec *: Scegli l'encoder hardware preferito. Agent DVR utilizzerà opzioni alternative se necessario.
  • AI Shard Size: Il numero massimo di dispositivi per sessione di inferenza nel sistema AI interno. Valori più bassi migliorano la stabilità con alta concorrenza al costo di memoria GPU aggiuntiva. Le modifiche si applicano dopo il riavvio.
  • High Performance Resizing: Utilizza un algoritmo di ridimensionamento di base per ridurre l'utilizzo della CPU. È veloce ma può risultare in linee frastagliate nelle immagini.
  • Resize files for playback: Ridimensiona i file registrati durante la riproduzione per ridurre il carico. Deseleziona questa opzione per il supporto completo della risoluzione delle foto durante la riproduzione.

* Nota che la codifica e la decodifica GPU dipendono dalla compatibilità hardware del tuo computer, dai driver e dal supporto della libreria FFmpeg. Per verificare se Agent DVR sta utilizzando i tuoi dispositivi hardware, avvia una registrazione e visualizza i log in /logs.html nel client locale. Agent DVR dovrebbe tornare alla codifica basata su CPU se la codifica GPU non riesce.

Server RTMP

Agent DVR offre la possibilità di trasmettere video a endpoint RTMP come Twitch e YouTube, consentendoti di trasmettere o incorporare il flusso sul tuo sito web. Per ulteriori informazioni su come incorporare questi flussi, consulta Impostazioni RTMP.

Lo streaming RTMP può essere attivato dal menu Server o pianificato per avviarsi e arrestarsi automaticamente utilizzando un scheduler dei dispositivi.

  • URL: L'endpoint RTMP a cui pubblicare il video, in genere nel formato rtmp://a.rtmp.youtube.com/live2.
  • Stream Key: Consulta la guida di incorporamento collegata sopra per le istruzioni su come ottenere la chiave di flusso.
  • Size: Seleziona una risoluzione per la trasmissione. Ricorda che risoluzioni più elevate consumano più larghezza di banda e risorse CPU.
  • Quality: Regola l'impostazione di qualità di base. L'impostazione predefinita è 8. Valori più bassi significano qualità ridotta ma anche minore utilizzo della larghezza di banda.
  • Frame Rate: Imposta la frequenza fotogrammi desiderata per il video. L'impostazione predefinita è 15 fotogrammi al secondo.
  • Codec: Scegli l'encoder utilizzato per il flusso. Gli encoder GPU riducono l'utilizzo della CPU.
  • Include Audio: Includi l'audio nel flusso. Se disabilitato, Agent DVR creerà una traccia audio silenzioso fittizia.
  • Max Duration: Imposta la durata massima dello streaming in secondi. Agent DVR interromperà lo streaming dopo questo periodo. Inserisci 0 per lo streaming continuo.
  • Stream at startup: Inizia lo streaming verso questo server all'avvio di Agent DVR, utilizzando l'ultimo dispositivo a cui è stato trasmesso.

Sicurezza

Queste impostazioni sono progettate per gestire come Agent DVR gestisce l'attivazione e la disattivazione del sistema, tramite l'icona di blocco nell'interfaccia utente o tramite integrazioni/API.

  • Ritardo di attivazione: Il ritardo di tempo in secondi da quando fai clic sull'icona Attiva (l'icona del lucchetto in alto a sinistra in Agent) a quando Agent DVR attiva effettivamente gli avvisi.
  • Codice di disattivazione: Questo codice viene utilizzato per disattivare Agent DVR, applicabile in strumenti come Alexa. Il codice predefinito è 1234.
  • Profilo di attivazione: Scegli un profilo da applicare automaticamente quando il sistema è attivato (usando l'icona del lucchetto nell'angolo in alto a sinistra dell'interfaccia utente).
  • Profilo di disattivazione: Scegli un profilo da applicare automaticamente quando il sistema è disattivato (usando l'icona di sblocco nell'angolo in alto a sinistra dell'interfaccia utente).

SMTP

Utilizza queste impostazioni per inviare avvisi email da Agent DVR tramite il tuo server di posta. Hai la possibilità di utilizzare un abbonamento ispyconnect.com per gli avvisi email o configurare il tuo server SMTP. Ricorda, per inviare email, devi configurare un'azione per l'invio di email. Per aiuto con eventuali problemi, consulta Risoluzione dei problemi SMTP.

  • Usa SMTP: Abilita questa opzione per utilizzare il tuo server SMTP per la messaggistica.
  • Nome utente: Il nome utente del tuo server SMTP.
  • Password: La password del tuo server SMTP.
  • Indirizzo mittente: L'indirizzo email da cui inviare, ad esempio, [email protected].
  • Server: L'indirizzo IP o web del tuo server SMTP.
  • Porta: La porta utilizzata dal tuo server SMTP. Il valore predefinito è 25.
  • Usa SSL: Abilita questa opzione per la comunicazione SMTP su SSL.
  • Modello di avviso: Imposta l'oggetto e il messaggio predefiniti per gli email di avviso.
  • Convalida certificato: Convalida il certificato SSL del server. Lascia disattivato per certificati autofirmati.
  • Invia immagini a dimensione intera: Seleziona questa opzione per inviare immagini in risoluzione completa anziché versioni ridimensionate e più piccole.
  • Incorpora immagini: Mostra le immagini nel corpo del messaggio. Questo potrebbe causare immagini duplicate in alcuni client di posta.

Memoria

Queste opzioni aiutano nella gestione del disco per le tue registrazioni: ricevi un avviso email prima che una posizione di archiviazione si riempia e proteggi i video importanti dall'eliminazione automatica.

  • Configura: Vedi Impostazioni di archiviazione
  • Indirizzo email archiviazione: Fornisci un indirizzo email per ricevere avvisi quando i limiti di archiviazione vengono raggiunti. Questo richiede impostazioni SMTP o un abbonamento.
  • Trigger notifica: Imposta la percentuale di spazio utilizzato nella posizione di archiviazione per attivare una notifica email. Nota che questo si riferisce allo spazio massimo allocato, non allo spazio libero sul disco.
  • Intervallo email: Determina la frequenza degli avvisi di archiviazione, misurata in ore.
  • Intervallo archiviazione: Regola la frequenza delle operazioni di Gestione archiviazione da parte di Agent DVR.
  • Auto Lock Tags Blocca automaticamente le registrazioni con i tag specificati per prevenire l'eliminazione accidentale o la rimozione da parte della gestione dell'archiviazione. Per eliminare queste registrazioni, dovrai sbloccarle nell'interfaccia utente.

Utenti

Per informazioni sui permessi degli utenti remoti, fare riferimento a Permessi remoti.
Nota: la versione gratuita di Agent DVR consente l'aggiunta di un utente amministratore.

Con una licenza appropriata, è possibile aggiungere più utenti con autorizzazioni diverse al server locale di Agent DVR, ad esempio per fornire ai membri della famiglia o a un team di sicurezza i propri accessi con accesso limitato.

Per aggiungere utenti, accedere alle Impostazioni server e accedere alla scheda Utenti.

  • Nome utente: Si tratta del nome utente per l'accesso al server locale (è diverso dal nome utente ispyconnect.com).
  • Password: Creare una password per l'account locale.
  • Gruppi: Assegnare o creare gruppi per l'utente. I gruppi funzionano in modo simile ai permessi degli utenti remoti, ma non è necessario includere il nome del server. Per limitare l'accesso:
    • Assegnare un nome gruppo nelle impostazioni del dispositivo nella scheda Generale (ad esempio, "outside").
    • Nei permessi dell'utente, aggiungere il gruppo "outside" per limitare l'accesso ai dispositivi etichettati come tali.
    • Assegnare un nome gruppo a tutti gli altri dispositivi - se un dispositivo non è assegnato a un gruppo sarà visibile a tutti.
  • È amministratore: Concede accesso completo a tutte le funzioni e impostazioni. Se l'utente è un amministratore, l'impostazione "Solo lettura" di seguito viene ignorata.
  • PTZ: Consente l'accesso al controllo PTZ (Pan-Tilt-Zoom).
  • Impostazioni personali: L'utente può salvare le proprie viste, filtri, planimetrie e mappature dei tasti. Se questo non è selezionato utilizzeranno la configurazione dell'account amministratore.
  • Solo lettura: Impedisce all'utente di modificare le impostazioni del dispositivo.
  • Download: Consente all'utente di scaricare registrazioni.
  • Audio: Consente all'utente di ascoltare audio dal vivo e registrato.
  • Comunicazione: Consente all'utente di utilizzare le funzioni di comunicazione bidirezionale.
  • Controlli: Consente all'utente di utilizzare i controlli del dispositivo come registrazione e foto. Si applica solo se la casella Solo lettura è selezionata.
  • Contenuti: Consente l'accesso a registrazioni e foto.

Hai dimenticato l'accesso amministratore?

Se dimentichi l'accesso amministratore e sei bloccato da Agent DVR, puoi reimpostarlo seguendo questi passaggi:

  • Arrestare il servizio Agent DVR, se è in esecuzione.
  • Aprire una finestra console: fare clic su Start, digitare "cmd", fare clic con il pulsante destro su "Prompt dei comandi" e selezionare "Esegui come amministratore".
  • Navigare nella directory di Agent DVR, in genere "cd C:\Program Files\Agent".
  • Reimpostare la password locale digitando "Agent.exe reset-local-login" su Windows o "dotnet Agent.dll reset-local-login" su macOS e Linux.
  • Riavviare il servizio Agent DVR utilizzando lo stesso metodo usato per arrestarlo.

È possibile automatizzare l'aggiunta di nuovi utenti utilizzando LDAP o OAuth2.

Gestione della sessione

Dal menu Server, fare clic su Session Management per accedere a questi controlli. Questo è visibile solo agli amministratori.

Viene visualizzato l'elenco dei nomi utente e degli indirizzi IP degli accessi recenti al server. È possibile forzare la disconnessione di sessioni specifiche da qui.

Il registro delle sessioni

A partire dalla versione 6.2.8.0, Agent DVR mantiene anche un registro di audit in testo semplice dell'attività delle sessioni in sessionlog.txt, situato nella cartella Media (su Windows è generalmente C:\Program Files\Agent\Media). Questo copre sia gli account utente locali che gli utenti remoti che si collegano attraverso il sito web - ogni voce registra se la sessione era locale o remota.

Il registro delle sessioni registra:

  • Connessioni e disconnessioni degli utenti, con il nome utente, l'indirizzo IP e l'ID della sessione.
  • Riproduzione delle registrazioni, inclusa la riproduzione della timeline.
  • Download e streaming di file registrati.

Quando il file di registro raggiunge 10MB viene rinominato con un timestamp e viene avviato un nuovo file di registro, in modo che la cronologia recente sia sempre disponibile senza che il file cresca indefinitamente.