Penyiapan klien SIP
Klien SIP apa pun yang dapat melakukan panggilan melalui proxy dapat menggunakan trunk Bird. Ini mencakup PBX, softphone desktop, dan alat baris perintah. Halaman ini memetakan detail koneksi trunk ke kolom klien umum dan pengaturan autentikasi.
Yang dibutuhkan klien
Empat nilai, semuanya dari halaman trunk:
| Kolom klien | Yang harus diisi |
|---|---|
| Server, domain, host, atau proxy SIP | Domain SIP trunk |
| Port dan transport | Salah satu port yang didukung trunk |
| Authentication user, auth user, atau login | bird |
| Password atau secret | Secret dari kunci API yang diizinkan pada trunk |
Trunk yang hanya menggunakan daftar IP yang diizinkan hanya memerlukan dua yang pertama. Kredensial adalah yang ditambahkan oleh autentikasi kunci API.
Contoh-contoh menggunakan YOUR_TRUNK_DOMAIN, YOUR_CALLER_ID, dan YOUR_API_KEY_SECRET. Salin domain lengkap dari halaman trunk. Bird menolak panggilan ke domain lain sebelum panggilan tersebut masuk ke call log Anda. Saat masuk dengan Bird CLI, jalankan bird voice tools test-call --dry-run untuk mencetak nilai-nilai ini sebagai baris akun baresip.
Kosongkan realm atau authentication domain agar klien menggunakan realm dari challenge Bird. Jika klien memerlukan nilai, gunakan workspace ID tanpa prefiks wsp_, diikuti oleh .sip.bird.com. Realm workspace berbeda dari domain SIP trunk.
Melakukan panggilan tanpa registrasi
Bird mengautentikasi setiap INVITE berdasarkan daftar IP yang diizinkan pada trunk atau melalui challenge password. Klien tidak perlu registrasi ke trunk.
Periksa registrasi sebelum melakukan panggilan:
- Di PBX, konfigurasikan Bird sebagai trunk dan matikan registrasi. Di Asterisk, artinya tidak ada bagian type=registration; di FreeSWITCH artinya register=false pada gateway; FreePBX dan 3CX memiliki mode registrasi yang diatur ke none.
- Di softphone, matikan registrasi di pengaturan lanjutan akun jika tersedia. Jika tidak tersedia, percobaan registrasi yang gagal hanya bersifat kosmetik dan panggilan tetap berfungsi, karena kami bertindak berdasarkan INVITE bukan berdasarkan registrasi.
Dua identitas, dua kolom
Klien Anda harus mengirim dua identitas berbeda:
- Caller ID ditempatkan di header From, dan harus berupa nomor yang telah Anda verifikasi, dalam format E.164: diawali + diikuti kode negara dan nomor nasional. Di sebagian besar klien, ini adalah kolom user atau caller-ID akun.
- Digest username selalu bird. Di sebagian besar klien, ini adalah kolom authentication user atau login.
Gunakan format E.164 juga saat menelepon, karena itulah yang digunakan Bird untuk merutekan dan menentukan harga.
Softphone
Softphone adalah cara tercepat untuk membuktikan trunk baru berfungsi sebelum Anda mengarahkan traffic produksi ke sana.
baresip
Tambahkan satu baris ke ~/.baresip/accounts, dengan caller ID Anda sebagai user akun dan bird sebagai auth user:
Contoh kode
<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 adalah yang mencegah baresip melakukan registrasi. Jalankan baresip dan telepon dengan /dial +31612345678.
Zoiper
Tambahkan akun SIP secara manual. Atur Domain ke domain SIP trunk, Username ke caller ID terverifikasi Anda, dan Password ke secret kunci API. Di pengaturan lanjutan, atur Auth username ke bird, nonaktifkan registrasi saat startup, dan pilih transport.
Linphone
Tambahkan akun dengan bird sebagai auth user identitas SIP dan caller ID Anda sebagai username-nya, lalu nonaktifkan registrasi pada akun tersebut. Di linphonerc akun yang sama adalah bagian [proxy_N] dengan reg_sendregister=0.
MicroSIP
Di bagian Account: Server SIP adalah domain SIP trunk, Username caller ID terverifikasi Anda, Login bird, Password secret kunci API. Biarkan Domain sama dengan server SIP.
PBX
Asterisk
Di pjsip.conf, sebuah endpoint dengan outbound auth dan tanpa bagian registrasi:
Contoh kode
[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 adalah caller ID yang diperiksa Bird, jadi harus berupa nomor terverifikasi. Telepon dengan Dial(PJSIP/+31612345678@bird).
FreePBX
Di Connectivity > Trunks, tambahkan trunk SIP (chan_pjsip). Di pjsip Settings, atur Username ke bird, Secret ke secret kunci API, Server SIP ke domain SIP trunk, Authentication ke outbound, dan Registration ke none. Atur caller ID keluar trunk ke nomor terverifikasi.
FreeSWITCH
Sebuah gateway di conf/sip_profiles/external/bird.xml:
Contoh kode
<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>Dengan caller-id-in-from diatur, caller ID pada leg menjadi nomor From, jadi atur ke nomor terverifikasi saat Anda melakukan originate.
3CX
Tambahkan trunk SIP generik dan nonaktifkan registrasi. Atur host ke domain SIP trunk, authentication ID ke bird, dan password ke secret kunci API. Atur caller ID keluar ke nomor terverifikasi.
Langkah selanjutnya
| Halaman | Yang dibahas |
|---|---|
| Pemecahan masalah voice | Mendiagnosis panggilan yang tidak berhasil, berdasarkan gejalanya |
| Trunk SIP | Detail koneksi, daftar yang diizinkan, dan penawaran Digest |
| Melakukan panggilan | Yang diharapkan Bird pada INVITE, dan cara penentuan harga panggilan |
| Caller ID | Mendaftarkan nomor dan membuktikan kepemilikan dengan panggilan verifikasi |
| Call log | Memastikan panggilan berhasil keluar, dan berapa biayanya |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.