SentryPeer v4.0.5

Proteggi i tuoi server SIP da attori malintenzionati

Un ringraziamento speciale a Deutsche Telekom Security GmbH per averci sponsorizzato nel 2024.

Perché non lasciarci una stella e seguirci su Twitter!

Indice

• Introduzione
• Panoramica
• Funzionalità
• Talk
• Adozione
• Design
• Docker
  • Variabili d'ambiente
• Installazione
  • Homebrew (macOS o Linux)
  • Alpine Linux
  • Pacchetto Ubuntu
  • Compilazione dal sorgente
• Esecuzione di SentryPeer
• WebHook
• API RESTful
  • Endpoint /health-check
  • Endpoint /ip-addresses
  • Endpoint /ip-addressss/{ip-address}
  • Endpoint /numbers
  • Endpoint /numbers/{phone-number}
• Syslog e Fail2ban
• Formato dei log JSON
• Opzioni della riga di comando
• Indirizzo multicast IPv6
• Licenza
• Contribuire
• Sito web del progetto
• Marchio
• Domande, segnalazioni di bug, richieste di funzionalità
• Ringraziamenti speciali
• Sponsorizzazione

Introduzione

SentryPeer^® è uno strumento di rilevamento delle frodi. Consente agli attori malintenzionati di provare a effettuare chiamate telefoniche e salva l'indirizzo IP da cui provengono e il numero che hanno tentato di chiamare. Questi dettagli possono poi essere utilizzati per generare notifiche sulla rete dei fornitori di servizi e la prossima volta che un utente/cliente tenta di chiamare un numero raccolto, puoi agire come ritieni opportuno.

Ad esempio:

Supponiamo che tu stia gestendo il tuo PBX VoIP in sede. Ciò che SentryPeer ti consentirà di fare in questo contesto, è attingere all'elenco dei numeri di telefono (utilizzando l'API RESTful) quando i tuoi utenti effettuano chiamate in uscita. Se ottieni una corrispondenza, riceverai un avviso che potenzialmente un dispositivo all'interno della tua rete sta tentando di chiamare numeri di telefono noti per il probing che sono stati:

1. Numeri raccolti dai nodi SentryPeer che stai eseguendo tu stesso
2. Numeri visti da altri nodi SentryPeer che sono stati replicati sul tuo nodo tramite la rete peer to peer

Questo ti permetterebbe di generare una notifica dai tuoi sistemi di monitoraggio prima di accumulare chiamate costose o che accada qualcosa di peggio.

Cosa potrebbe portare a questo scenario?

1. Potenziale frode tramite segreteria telefonica. Questo può accadere se consenti a una chiamata verso un numero in entrata (il tuo DID/DDI) di raggiungere il tuo sistema di segreteria telefonica, che poi richiede un PIN. Questo PIN è debole e il sistema di segreteria telefonica ti permette di premere '*' per richiamare il Caller ID che ha lasciato un messaggio. L'attaccante ha lasciato un messaggio, poi indovina il tuo PIN e richiama. Il CLI è un numero noto che SentryPeer ha visto. Puoi generare un avviso su di esso.
2. Un dispositivo è stato compromesso e/o un softphone o simile sta usando le credenziali rubate dalla GUI del telefono e sta tentando di registrarsi al tuo sistema e effettuare chiamate verso un numero visto da SentryPeer.
3. Un utente innocente sta chiamando un numero di phishing o un numero noto costoso ecc. che SentryPeer ha già visto in precedenza.

Tradizionalmente, questi dati vengono inviati a un luogo centralizzato, quindi non possiedi i dati che hai raccolto. Questo progetto riguarda interamente la condivisione Peer to Peer di quei dati. L'utente che possiede i dati e i vari feed di dati relativi a Service Provider / Network Provider sono la parte fondamentale per me. Sono stanco di tutti quei servizi là fuori che li conservano e li vendono. Se li hai raccolti, dovresti avere la scelta di conservarli e/o di aderire alla condivisione con altri membri della community SentryPeer tramite metodi p2p.

Panoramica

Nodo SentryPeer

Qui utilizziamo i diagrammi di sequenza Mermaid per mostrare il flusso di dati da un nodo SentryPeer a SentryPeerHQ.

sequenceDiagram
    actor A as Attacker
    participant S as SentryPeer Node
    participant DS as Data Store
    participant W as WebHook <br/>Endpoint
    Note over DS: sqlite/json log/syslog <br/>(if enabled)
    Note over W: if enabled
    A->>S: SIP probe OPTIONS/REGISTER/etc
    S->>DS: Save event
    S->>W: Send event
    W->>S: 200 OK
    S->>A: 200 OK
    A->>S: INVITE sip:00046500729221@

Nodo SentryPeer verso SentryPeerHQ

sequenceDiagram
    actor A as Attacker
    participant S as SentryPeer Node
    participant DS as Data Store
    participant HQ as SentryPeerHQ
    Note over DS: sqlite/json log/syslog (if enabled)
    Note over HQ: OAuth2 creds required.<br/> if using https://sentrypeer.com
    A->>S: SIP probe OPTIONS/REGISTER/etc
    S->>DS: Save event
    S->>HQ: Send event
    HQ->>S: 201 Created
    S->>A: 200 OK
    A->>S: INVITE sip:00046500729221@

Utilizzo del nodo SentryPeer e dell'API SentryPeerHQ

sequenceDiagram
    Actor U as User
    participant S as SentryPeer Node/HQ API
    Note over S: if enabled
    U->>S: GET /numbers
    S->>U: 200 OK Return all Phone numbers seen in database

Integrazione con i tuoi sistemi