Trunk SIP

Un trunk SIP collega il tuo sistema telefonico a Bird. Fornisce al tuo PBX un indirizzo per le chiamate in uscita, definisce come Bird le autentica e può anche ricevere le chiamate in arrivo sui numeri che possiedi. Configura i trunk in Voice > SIP Trunks.

Configurare un trunk SIP illustra in ordine una configurazione completa, dalla creazione del trunk a una chiamata di prova in ciascuna direzione.

La maggior parte delle configurazioni richiede un solo trunk. Crea trunk separati quando sedi o sistemi necessitano di liste di IP consentiti, chiavi API, impostazioni delle credenziali di sessione o algoritmi Digest diversi.

Creare un trunk

Seleziona Create trunk e inserisci un nome. Puoi modificare questa etichetta della dashboard in seguito; non viene inviata con le chiamate.

Bird assegna un dominio SIP fisso al trunk. Inserisci questo dominio nel tuo sistema telefonico in modo che Bird possa associare le chiamate al trunk.

Un nuovo trunk rifiuta ogni chiamata finché non indichi chi può effettuarle: un intervallo IP, una chiave API, credenziali di sessione o una combinazione.

Direzione delle chiamate

Un trunk gestisce ciascuna direzione separatamente, e un nuovo trunk non ne gestisce nessuna. La pagina del trunk ha una sezione per direzione, e una direzione disattivata mostra solo il controllo per attivarla.

Outbound calling indica che il tuo PBX effettua chiamate tramite Bird. Seleziona Enable outbound. Finché non è attivato, il trunk rifiuta ogni tentativo in uscita indipendentemente dalle credenziali. I dettagli di connessione del trunk, le liste di IP consentiti, le chiavi, le credenziali di sessione e l'offerta Digest si trovano tutti in questa sezione, perché regolano chi può connettersi.

Inbound calling indica che Bird consegna le chiamate al tuo PBX, per i numeri a cui risponde questo trunk. Seleziona Enable inbound, poi configura l'Inbound routing del trunk: aggiungi almeno un gateway, inseriscilo in un gruppo e fai puntare la Default route a quel gruppo. Un trunk senza gateway rifiuta ogni chiamata in arrivo ai suoi numeri, e lo stesso fa una route predefinita salvata impostata su rifiuto. La lista Inbound numbers della sezione mostra quali dei tuoi numeri inviano le chiamate qui.

Un gateway di consegna è l'indirizzo del tuo sistema telefonico. Rimuovere l'ultimo gateway lascia attivata l'impostazione inbound del trunk, ma non offre alle chiamate in arrivo alcuna destinazione di consegna. Aggiungi un gateway funzionante prima di instradare il traffico verso il trunk. Il tuo gateway deve accettare la chiamata consegnata senza chiedere a Bird di rispondere a una challenge Digest SIP. Consegnare le chiamate a un trunk SIP spiega i gruppi, le regole e la route predefinita.

Associa un numero al trunk dalla pagina del numero. Consulta Ricezione delle chiamate per le istruzioni e per una spiegazione dei formati numerici dei gateway.

Attenzione: disattivare le chiamate in entrata riporta ogni numero associato a questo trunk sulla route predefinita dello spazio di lavoro e reimposta a rifiuto una route predefinita che indica questo trunk. Riattivare le chiamate in entrata non ripristina nessuna delle due. Eliminare il trunk produce lo stesso effetto.

Dettagli di connessione

Apri un trunk per vedere cosa inserire nel tuo PBX:

Nota: con la sola lista di IP consentiti, ti bastano il dominio SIP e una porta: username e password servono per l'autenticazione con chiave API. Un client che dispone di una credenziale di sessione usa invece la password di quella credenziale.

Invia le chiamate al dominio SIP su una di queste porte:

Audio encryption controlla la cifratura SRTP tra i tuoi apparati e Bird, con chiavi SDES inviate su TLS. I nuovi trunk usano Preferred. Le chiamate effettuate dai tuoi apparati sono cifrate quando questi offrono SDES su TLS. Le chiamate consegnate a un gateway TLS (sips: o ;transport=tls) usano la cifratura quando è disponibile, anche tramite una regione di uscita. Le chiamate su un trunk con media_bypass usano audio non cifrato. Un gateway TLS che non supporta SRTP risponde alle offerte cifrate con 488. Per quel gateway imposta Off oppure usa un URI sip:. Required rifiuta le chiamate non cifrate e richiede TLS per ogni gateway. Gli operatori possono inoltrare le chiamate senza cifratura.

Controllare chi può inviare chiamate

Un trunk può autenticare gli apparati in base all'indirizzo IP di origine, alla chiave API o a una credenziale di sessione a breve scadenza. Attiva i metodi necessari ai tuoi client.

Configurali in IP allow list, Allowed API keys e Session credentials. Le modifiche salvate si applicano alle nuove chiamate.

Lista di IP consentiti

Aggiungi gli indirizzi pubblici da cui i tuoi apparati inviano SIP, come indirizzi singoli o intervalli CIDR, ciascuno con una descrizione opzionale. Quando la lista contiene almeno una voce, le chiamate che usano l'ammissione IP o le chiavi API consentite devono provenire da un intervallo in lista. Le credenziali di sessione attivate offrono un percorso di ammissione separato e possono essere usate da altri indirizzi.

Aggiungi l'indirizzo pubblico di origine che raggiunge Bird. Per apparati dietro NAT, usa l'indirizzo pubblico del router invece dell'indirizzo privato del sistema telefonico. Per l'ammissione IP e le chiavi API consentite, Bird rifiuta le chiamate da indirizzi non in lista al livello SIP, quindi di solito non compaiono nel registro chiamate. Consulta la risoluzione dei problemi voce per le chiamate mancanti.

Autenticazione con chiave API

Bird può invece (o anche) richiedere una password per ogni chiamata. Lo scambio è l'autenticazione Digest SIP: Bird invia una challenge, il tuo sistema telefonico risponde con un hash della password anziché la password stessa, e Bird la verifica rispetto a una chiave Bird API.

1. Assegna a una chiave API il permesso voice a livello write, che è il livello su cui un trunk autentica. Aggiungilo a una chiave che hai già, oppure creane una nuova. In entrambi i casi il secret della chiave resta invariato: una chiave già distribuita mantiene il secret con cui i tuoi sistemi sono configurati, e una chiave nuova mostra il secret una sola volta, alla creazione, quindi salvalo in quel momento. Vedi Chiavi API.
2. Nella pagina del trunk, sotto Allowed API keys, aggiungi quella chiave.
3. Nel tuo PBX, imposta lo username su bird e la password sul secret della chiave.

Quando la lista contiene almeno una chiave, l'autenticazione con chiave API richiede una delle chiavi elencate. Le credenziali di sessione restano un metodo separato quando sono attivate.

Rimuovere il permesso voice da una chiave ne blocca l'autenticazione immediatamente, ma il trunk la mantiene nella lista delle chiavi consentite. Riaggiungi il permesso e il trunk funziona di nuovo con lo stesso secret, senza modifiche al trunk o al tuo PBX. Mentre il permesso manca, la pagina del trunk contrassegna la chiave come non disponibile.

Revocare o eliminare una chiave API ne rimuove immediatamente la capacità di autenticazione, su ogni trunk che la consentiva, e questa azione è permanente. Per ruotare, aggiungi prima la nuova chiave al trunk, sposta i tuoi apparati, poi revoca quella vecchia.

Credenziali di sessione

Una credenziale di sessione è uno username e una password SIP a breve scadenza. Risponde alla stessa challenge Digest di una chiave API senza esporre un secret di lunga durata.

Attivale sotto Session credentials nella pagina del trunk; su un nuovo trunk sono disattivate. Cosa ammettono:

• Il telefono nella dashboard, che ne genera una per chiamata automaticamente.
• Un client SIP gestito dalla CLI: bird voice tools test-call ne genera una per la chiamata che effettua, e bird voice session-credentials create ne genera una da incollare in qualsiasi altro client. Entrambi richiedono accesso voice a livello write.

Una credenziale appartiene allo spazio di lavoro e non a un singolo trunk, quindi un client può usarla su tutti i trunk idonei. Il client deve presentare la credenziale e il trunk deve avere le credenziali di sessione attivate. Bird restituisce la password solo al momento della generazione.

Considera la scadenza restituita come il momento più tardi in cui la credenziale può ammettere una nuova chiamata. Il soggetto che l'ha creata deve restare attivo: gli utenti umani necessitano di un ruolo nello spazio di lavoro o dell'accesso come proprietario dell'organizzazione; le chiavi API devono restare corrispondenti al tenant, non revocate e non scadute; gli account di servizio devono restare attivi nello stesso tenant. Il permesso di chiamata viene verificato al momento della creazione della credenziale. I controlli successivi sul soggetto non ricalcolano quel permesso né terminano una chiamata già ammessa.

Attivarle non cambia il modo in cui si connettono gli apparati nella lista di IP consentiti: una chiamata da un indirizzo in lista, su un trunk senza chiavi API consentite, viene comunque ammessa senza richiesta di password.

Algoritmo Digest

Per impostazione predefinita Bird offre prima SHA-256 e poi MD5. Il tuo PBX risponde con il primo algoritmo che supporta.

Modifica l'offerta in Digest algorithm quando il tuo apparato lo richiede. Per un PBX che gestisce male una challenge che inizia con SHA-256, seleziona MD5 only. Un trunk accetta solo gli algoritmi che offre. Le chiavi API funzionano con entrambi gli algoritmi e non devono essere riemesse.

Mantieni MD5 nell'offerta su qualsiasi trunk da cui chiami con il telefono: un browser risponde con MD5 e nient'altro, quindi un trunk che offre solo SHA-256 rifiuta ogni chiamata dal browser.

Eliminare un trunk

L'eliminazione di un trunk ha effetto immediato: il suo dominio SIP smette di accettare nuove chiamate e ogni numero associato al trunk torna alla route predefinita dello spazio di lavoro. Le chiamate già in corso proseguono e i record delle chiamate effettuate tramite il trunk restano nel tuo Registro chiamate.

Passi successivi