Configurazione del client SIP

Qualsiasi client SIP in grado di effettuare una chiamata attraverso un proxy può usare un trunk Bird. Questo include PBX, softphone desktop e strumenti da riga di comando. Questa pagina associa i dettagli di connessione del trunk ai campi più comuni dei client e alle impostazioni di autenticazione.

Cosa serve a un client

Quattro valori, tutti dalla pagina del trunk:

Un trunk che usa solo la propria lista di IP consentiti ha bisogno solo dei primi due. Le credenziali sono ciò che aggiunge l'autenticazione con chiave API.

Gli esempi usano YOUR_TRUNK_DOMAIN, YOUR_CALLER_ID e YOUR_API_KEY_SECRET. Copia il dominio completo dalla pagina del trunk. Bird rifiuta le chiamate verso un altro dominio prima che raggiungano il tuo registro chiamate. Dopo aver effettuato l'accesso con il Bird CLI, esegui bird voice tools test-call --dry-run per stampare questi valori come riga account di baresip.

Lascia realm o authentication domain vuoto, così il client usa il realm nella challenge di Bird. Se un client richiede un valore, usa l'ID dello spazio di lavoro senza il prefisso ws_, seguito da .sip.bird.com. Il realm dello spazio di lavoro è diverso dal dominio SIP del trunk.

Effettuare chiamate senza registrazione

Bird autentica ogni INVITE rispetto alla lista di IP consentiti del trunk o tramite una challenge con password. I client non si registrano sul trunk.

Verifica la registrazione prima di effettuare una chiamata:

• In un PBX, configura Bird come trunk e lascia la registrazione disattivata. In Asterisk significa nessuna sezione type=registration; in FreeSWITCH significa register=false sul gateway; FreePBX e 3CX hanno una modalità di registrazione da impostare su none.
• In un softphone, disattiva la registrazione nelle impostazioni avanzate dell'account, se disponibile. Dove non lo è, il tentativo di registrazione fallito è puramente estetico e la composizione funziona comunque, perché l'azione avviene sull'INVITE anziché sulla registrazione.

Due identità, due campi

Il client deve inviare due identità diverse:

• Il caller ID va nell'header From. Usa un numero Bird attualmente assegnato a questo spazio di lavoro e abilitato per le chiamate in uscita, oppure un numero esterno che hai verificato. Usa il formato E.164: un + iniziale seguito dal prefisso internazionale e dal numero nazionale. Nella maggior parte dei client è il campo user o caller-ID dell'account.
• Il digest username è sempre bird. Nella maggior parte dei client è il campo authentication user o login.

Componi anche in E.164, dato che è il formato su cui Bird instrada e tarifica.

Softphone

Un softphone è il modo più rapido per verificare che un nuovo trunk funzioni prima di indirizzarvi il traffico di produzione.

baresip

Aggiungi una riga a ~/.baresip/accounts, con il tuo caller ID come account user e bird come auth user:

<sip:YOUR_CALLER_ID@YOUR_TRUNK_DOMAIN>;auth_user=bird;auth_pass=YOUR_API_KEY_SECRET;regint=0;outbound="sip:YOUR_TRUNK_DOMAIN;transport=udp"

regint=0 è ciò che impedisce a baresip di registrarsi. Avvialo e componi con /dial +31612345678.

Zoiper

Aggiungi un account SIP manualmente. Imposta Domain sul dominio SIP del trunk, Username sul tuo caller ID abilitato e Password sul secret della chiave API. Nelle impostazioni avanzate, imposta Auth username su bird, disattiva la registrazione all'avvio e scegli il trasporto.

Linphone

Aggiungi un account con bird come auth user dell'identità SIP e il tuo caller ID come username, quindi disattiva la registrazione sull'account. In linphonerc lo stesso account è una sezione [proxy_N] con reg_sendregister=0.

MicroSIP

In Account: SIP server è il dominio SIP del trunk, Username il tuo caller ID abilitato, Login bird, Password il secret della chiave API. Lascia Domain uguale al server SIP.

PBX

Asterisk

In pjsip.conf, un endpoint con autenticazione outbound e nessuna sezione di registrazione:

[bird-auth]
type=auth
auth_type=userpass
username=bird
password=YOUR_API_KEY_SECRET

[bird-aor]
type=aor
contact=sip:YOUR_TRUNK_DOMAIN:5060

[bird]
type=endpoint
context=from-internal
outbound_auth=bird-auth
aors=bird-aor
from_user=YOUR_CALLER_ID
from_domain=YOUR_TRUNK_DOMAIN

from_user è il caller ID che Bird controlla, quindi usa un caller ID abilitato. Componi con Dial(PJSIP/+31612345678@bird).

FreePBX

In Connectivity > Trunks, aggiungi un trunk SIP (chan_pjsip). Nelle pjsip Settings, imposta Username su bird, Secret sul secret della chiave API, SIP Server sul dominio SIP del trunk, Authentication su outbound e Registration su none. Imposta il caller ID in uscita del trunk su un numero abilitato.

FreeSWITCH

Un gateway in conf/sip_profiles/external/bird.xml:

<include>
  <gateway name="bird">
    <param name="proxy" value="YOUR_TRUNK_DOMAIN"/>
    <param name="register" value="false"/>
    <param name="username" value="bird"/>
    <param name="password" value="YOUR_API_KEY_SECRET"/>
    <param name="from-domain" value="YOUR_TRUNK_DOMAIN"/>
    <param name="caller-id-in-from" value="true"/>
  </gateway>
</include>

Con caller-id-in-from impostato, il caller ID sulla tratta diventa il numero From, quindi impostalo su un numero abilitato quando origini la chiamata.

3CX

Aggiungi un trunk SIP generico e disattiva la registrazione. Imposta l'host sul dominio SIP del trunk, l'authentication ID su bird e la password sul secret della chiave API. Imposta il caller ID in uscita su un numero abilitato.

Passi successivi