Konfiguracja klienta SIP
Każdy klient SIP, który potrafi zestawić połączenie przez proxy, może korzystać z trunku Bird. Dotyczy to central PBX, softphone'ów desktopowych i narzędzi wiersza poleceń. Ta strona odwzorowuje szczegóły połączenia trunku na typowe pola klienta i ustawienia uwierzytelniania.
Czego potrzebuje klient
Cztery wartości, wszystkie ze strony trunku:
| Pole klienta | Co wpisać |
|---|---|
| Serwer SIP, domena, host lub proxy | Domena SIP trunku |
| Port i transport | Jeden z obsługiwanych portów trunku |
| Użytkownik uwierzytelniania, auth user lub login | bird |
| Hasło lub sekret | Sekret klucza API dopuszczonego na trunku |
Trunk korzystający wyłącznie z listy dozwolonych adresów IP wymaga tylko dwóch pierwszych wartości. Dane uwierzytelniające to to, co dodaje uwierzytelnianie kluczem API.
Przykłady używają YOUR_TRUNK_DOMAIN, YOUR_CALLER_ID i YOUR_API_KEY_SECRET. Skopiuj pełną domenę ze strony trunku. Bird odrzuca połączenia kierowane do innej domeny, zanim trafią do dziennika połączeń. Po zalogowaniu się za pomocą Bird CLI uruchom bird voice tools test-call --dry-run, aby wyświetlić te wartości jako linię konta baresip.
Pozostaw pole realm lub authentication domain puste, aby klient użył realm z wyzwania Bird. Jeśli klient wymaga wartości, użyj identyfikatora obszaru roboczego bez prefiksu wsp_, a po nim .sip.bird.com. Realm obszaru roboczego różni się od domeny SIP trunku.
Wykonuj połączenia bez rejestracji
Bird uwierzytelnia każde INVITE na podstawie listy dozwolonych adresów IP trunku lub przez wyzwanie hasłem. Klienty nie rejestrują się na trunku.
Sprawdź rejestrację przed wykonaniem połączenia:
- W centrali PBX skonfiguruj Bird jako trunk i zostaw rejestrację wyłączoną. W Asterisku oznacza to brak sekcji type=registration; we FreeSWITCH oznacza register=false na bramce; FreePBX i 3CX mają tryb rejestracji do ustawienia na none.
- W softphonie wyłącz rejestrację w zaawansowanych ustawieniach konta, jeśli jest taka opcja. Jeśli jej nie ma, nieudana próba rejestracji jest kosmetyczna i wybieranie numeru nadal działa, ponieważ działamy na podstawie INVITE, a nie rejestracji.
Dwie tożsamości, dwa pola
Klient musi wysłać dwie różne tożsamości:
- Identyfikator dzwoniącego trafia do nagłówka From i musi być numerem, który zweryfikowałeś, w formacie E.164: wiodący +, po nim kod kraju i numer krajowy. W większości klientów jest to pole użytkownika konta lub caller-ID.
- Nazwa użytkownika digest to zawsze bird. W większości klientów jest to pole użytkownika uwierzytelniania lub loginu.
Wybieraj numery też w formacie E.164, ponieważ na tym Bird opiera routing i naliczanie opłat.
Softphony
Softphone to najszybszy sposób, żeby sprawdzić, czy nowy trunk działa, zanim skierujesz na niego ruch produkcyjny.
baresip
Dodaj jedną linię do ~/.baresip/accounts, wpisując swój identyfikator dzwoniącego jako użytkownika konta i bird jako użytkownika uwierzytelniania:
Przykład kodu
<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 powstrzymuje baresip przed rejestracją. Uruchom go i wybieraj numery za pomocą /dial +31612345678.
Zoiper
Dodaj konto SIP ręcznie. Ustaw Domain na domenę SIP trunku, Username na zweryfikowany identyfikator dzwoniącego, a Password na sekret klucza API. W ustawieniach zaawansowanych ustaw Auth username na bird, wyłącz rejestrację przy starcie i wybierz transport.
Linphone
Dodaj konto z bird jako użytkownikiem uwierzytelniania tożsamości SIP i swoim identyfikatorem dzwoniącego jako nazwą użytkownika, a następnie wyłącz rejestrację na koncie. W linphonerc to samo konto to sekcja [proxy_N] z reg_sendregister=0.
MicroSIP
W sekcji Account: SIP server to domena SIP trunku, Username to zweryfikowany identyfikator dzwoniącego, Login to bird, Password to sekret klucza API. Pozostaw Domain takie samo jak serwer SIP.
Centrale PBX
Asterisk
W pjsip.conf endpoint z uwierzytelnianiem wychodzącym i bez sekcji rejestracji:
Przykład kodu
[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_DOMAINfrom_user to identyfikator dzwoniącego, który sprawdza Bird, więc musi to być zweryfikowany numer. Wybieraj numery za pomocą Dial(PJSIP/+31612345678@bird).
FreePBX
W Connectivity > Trunks dodaj trunk SIP (chan_pjsip). W jego pjsip Settings ustaw Username na bird, Secret na sekret klucza API, SIP Server na domenę SIP trunku, Authentication na outbound, a Registration na none. Ustaw wychodzący identyfikator dzwoniącego trunku na zweryfikowany numer.
FreeSWITCH
Bramka w conf/sip_profiles/external/bird.xml:
Przykład kodu
<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>Po ustawieniu caller-id-in-from identyfikator dzwoniącego na danym odcinku przyjmuje numer From, więc przy inicjowaniu połączenia ustaw go na zweryfikowany numer.
3CX
Dodaj ogólny trunk SIP i wyłącz rejestrację. Ustaw jego host na domenę SIP trunku, authentication ID na bird, a hasło na sekret klucza API. Ustaw wychodzący identyfikator dzwoniącego na zweryfikowany numer.
Następne kroki
| Strona | Co obejmuje |
|---|---|
| Rozwiązywanie problemów z głosem | Diagnozowanie połączenia, które nie dochodzi, na podstawie objawu |
| Trunki SIP | Szczegóły połączenia, listy dozwolonych i oferta Digest |
| Wykonywanie połączeń | Czego Bird oczekuje w INVITE i jak połączenie jest wyceniane |
| Identyfikatory dzwoniącego | Rejestrowanie numeru i potwierdzenie jego własności połączeniem weryfikacyjnym |
| Dziennik połączeń | Potwierdzenie, że połączenie zostało wykonane, i ile kosztowało |
Powiązane zasoby
Kontynuuj z dokumentacją, przewodnikami i przykładami dotyczącymi tego tematu. Zasoby są w języku angielskim.