https://www.voip-info.jp/api.php?action=feedcontributions&user=Takahashi&feedformat=atom
VoIP-Info.jp - 利用者の投稿記録 [ja]
2024-03-28T18:18:04Z
利用者の投稿記録
MediaWiki 1.29.1
https://www.voip-info.jp/index.php?title=Asterisk_pjsip&diff=11613
Asterisk pjsip
2023-12-21T08:38:55Z
<p>Takahashi: /* Wizard */</p>
<hr />
<div>[[カテゴリ:Asterisk]]<br />
[[カテゴリ:pjsip]]<br />
<br />
AsiteriskでチャネルにPjSIPを使用する際の設定方法など<br />
==コンパイル==<br />
Asterisk 13まではpjprojectを別個インストールするか、configureに--with-pjproject-bundledを付けて実行する必要がありましたが、Asterisk 16からはデフォルトでbundledインストールされるようになりました。<BR><br />
各バージョン毎のインストール方法についてはAsteriskのそれぞれのページを参照してください。<BR><br />
[[Asterisk 13]]<BR><br />
[[Asterisk 16]]<BR><br />
<br />
==変換ツール==<br />
Asterisk 13以降であれば ソースディレクトリ/contrib/scripts/sip_to_pjsip の下にPythonのスクリプトがあります(複数)。sip.confのあるディレクトリでこれを実行するとpjsip.confに変換してくれます。#includeしている場合にはそれらも変換してくれますが、完璧ではないです。<br />
==Asterisk 16以降における注意点==<br />
PjSIPはres_statsd.soに依存します。このためres_statsdがloadされていないと、res_pjsipがloadされない問題が発生します。<BR><br />
(Asterisk 16ではモジュールの依存関係チェックが厳密化されています)<BR><br />
res_statsdモジュールはstatsd.confファイルが無いとloadされないため、statsd.confファイルが無いだけで、PjSIPが使えないという困った状態になります。ソースファイルに含まれる statsd.conf.sample を /etc/asterisk/statsd.conf にコピーしておいてください。もっとも、このファイルはコメントされた行だけなので要するに空なのですが。<br />
<br />
==パラメータ一覧==<br />
[[Asterisk pjsip parameters]]<br />
<br />
==基本設定==<br />
*間違いやすいところ<br />
:sip.confでは1wordだったのがアンダーバーが入る<br />
:dtmfmode → dtmf_mode<br />
:fromdomain → from_domain<br />
===グローバル設定===<br />
設定は基本としてはpjsip.confに書きます。<BR><br />
*[[Asterisk_pjsip_parameters#GLOBAL]]<BR><br />
グローバル設定を使用する場合にはtype=globalのセクションを書きます。<BR><br />
<nowiki>[global]<br />
type=global<br />
max_forwards = 50</nowiki><br />
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。<BR><br />
*[[Asterisk_pjsip_parameters#SYSTEM]]<BR><br />
<br />
===インクルード===<br />
Asteriskの他の設定ファイル同様に#includeが使えます。なので、電話機と回線は別ファイルにした方が見通しは良いかもしれません。例えば<BR><br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
#include pjsip_phones.conf<br />
#include pjsip_trunk_hikari.conf<br />
のようにファイルを分割し、includeすると管理が楽になります。<br />
<br />
基本で必要なものは以下です。<br />
<br />
===トランスポート===<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。<BR><br />
<br />
===ACL===<br />
ACLの例は次の通りです。<br />
[acl]<br />
type=acl<br />
deny=0.0.0.0/0.0.0.0<br />
permit=192.168.0.0/16<br />
※deny,permitはこの順でないとpermitしてdenyしてしまう模様で、逆に書くと誰も使えなくなります。<BR><br />
<BR><br />
pjsip.confに複数のACL(type=acl)を書くとそのセクション名にかかわらず後ろにあるACLの方が勝つ模様。<BR><br />
[acl]<br />
type=acl<br />
deny=0.0.0.0/0.0.0.0<br />
permit=192.168.0.0/16<br />
<br />
[acl-my]<br />
type=acl<br />
deny=0.0.0.0/0.0.0.0<br />
permit=10.10.0.0/16<br />
と、書くとacl-myが勝つので要注意です。複数を許可したい場合には1セクションで<br />
[acl]<br />
type=acl<br />
deny=0.0.0.0/0.0.0.0<br />
permit=192.168.0.0/16<br />
permit=10.10.0.0/16<br />
のように書きます。<BR><br />
*[[Asterisk_pjsip_parameters#ACL.28res_pjsip_acl.29]]<br />
→[[Asterisk pjsip ACL]]<br />
<br />
===認証情報(Auth)===<br />
sip_confではピア(エンドポイント)の認証がわかりにくかったのですが、PjSIPでは別なセクションで(type=auth)認証情報を定義するようになりました。このため、認証情報がピア名(sip.confの[ ])に紐付かなくなりました。<BR><br />
慣れないとわかりにくい感じがしますが、管理がより柔軟になります。例えば<br />
[some-phone]<br />
type = endpoint<br />
.<br />
.<br />
.<br />
auth = phone-auth<br />
outbound_auth = phone-out-auth<br />
のようなendpointが定義されている場合には、2つのauthセクションが必要です。<br />
[phone-auth]<br />
type = auth<br />
username = phone123<br />
password = phonepassword<br />
このAuthは'[some-phone]'エンドポイントに接続、つまり外からの"入り"の際の認証情報です。<BR><br />
[phone-out-auth]<br />
略<br />
このAuthはoutbound_authで設定されているので、このエンドポイントからの"出"の際の認証情報です。<BR><br />
<br />
==電話機==<br />
電話機の接続は [[Asterisk pjsip 電話機]] のページへ<br />
==トランク==<br />
回線接続側は [[Asterisk pjsip trunks]]のページへ<br />
<br />
==Wizard==<br />
Asteriskにはpjsip_wizardが組み込まれており、PjSIPの設定を簡素化することができます。使う場合の条件は以下の通りです。<br />
*基本の設定はpjsip.confに書く<br />
:transportなどの情報はpjsip.confに書く必要があります<br />
*Wizard用のファイル名はpjsip_wizard.conf<br />
*共通化したテンプレート内で各セクションを指定するにはスラッシュ(/)で区切る<br />
*Wizardは電話機でもトランクでも使用できる<br />
:registration/を書くとregistrationセクションがつくられる<br />
記述例:<br />
:endpoint/context=mycontext<br />
:endpoint/dtmf_mode<br />
:aor/max_contacts = 1<br />
pjsip_wizard.confの記述例<br />
;電話機用テンプレート(共通設定)<br />
[phone-defaults](!)<br />
type=wizard<br />
transport = transport-udp<br />
accepts_registrations = yes<br />
sends_registrations = no<br />
accepts_auth = yes<br />
sends_auth = no<br />
endpoint/context = default<br />
endpoint/dtmf_mode = rfc4733<br />
endpoint/call_group = 1<br />
endpoint/pickup_group = 1<br />
endpoint/language = ja<br />
endpoint/disallow = all<br />
endpoint/allow = ulaw<br />
endpoint/rtp_symmetric = yes<br />
endpoint/force_rport = yes<br />
endpoint/direct_media = no<br />
endpoint/send_pai = yes<br />
endpoint/send_rpid = yes<br />
endpoint/rewrite_contact = yes<br />
endpoint/inband_progress = yes<br />
endpoint/allow_subscribe = yes<br />
endpoint/transport = transport-udp<br />
aor/max_contacts = 1<br />
aor/qualify_frequency = 30<br />
aor/authenticate_qualify = no<br />
<br />
;各電話機個別設定<br />
[phone1](phone-defaults)<br />
inbound_auth/username = phone1<br />
inbound_auth/password = mypasswordishere<br />
<br />
==CLIコマンド==<br />
*sip show peersに対応するのはpjsip show endpoints<br />
*sip show peer phone1などピア情報を表示するのはpjsip show endpoint phone1<br />
*AORを表示するのは一覧ならpjsip show aorsでピアの情報を表示するのはpjsip show aor phone1のようにする<br />
*それぞれの設定項目で何が設定されているかを確認するには pjsip show endpoint phone1 のようにすると phone1 の endpoint パラメータ一覧が表示される。aorを見たければ pjsip show aor phone1。これはトランクの場合も同様で pjsip show registration hikari-hgw のようにするとregister関係のパラメータがみえる。<br />
===デバッグ===<br />
chan_sipのsip debug代わりに使えるのは、pjsip debug history。SIPメッセージの確認はこちらの方が簡単かも。<br />
<br />
ヒストリをクリア<br />
*CLI> pjsip set history clear<br />
PJSIP History cleared<br />
<br />
ヒストリをONに設定<br />
*CLI> pjsip set history on<br />
PJSIP History enable<br />
<br />
なんかやる<br />
<br />
ヒストリをOFFに設定<br />
*CLI> pjsip set history off<br />
PJSIP History disabled<br />
<br />
ヒストリをみる<br />
*CLI> pjsip show history<br />
No. Timestamp (Dir) Address SIP Message<br />
===== ========== ============================== ===================================<br />
00047 1620781794 * <== 192.168.254.10:5060 INVITE sip:201@192.168.254.234:5070 SIP/2.0<br />
00048 1620781794 * ==> 192.168.254.10:5060 SIP/2.0 401 Unauthorized<br />
00049 1620781794 * <== 192.168.254.10:5060 ACK sip:201@192.168.254.234:5070 SIP/2.0<br />
00050 1620781794 * <== 192.168.254.10:5060 INVITE sip:201@192.168.254.234:5070 SIP/2.0<br />
00051 1620781794 * ==> 192.168.254.10:5060 SIP/2.0 100 Trying<br />
00052 1620781794 * ==> 192.168.254.3:5060 INVITE sip:phone1@192.168.254.3:5060 SIP/2.0<br />
00053 1620781794 * <== 192.168.254.3:5060 SIP/2.0 100 Trying<br />
00054 1620781795 * ==> 192.168.254.4:5060 OPTIONS sip:phone6@192.168.254.4:5060 SIP/2.0<br />
00055 1620781795 * <== 192.168.254.4:5060 SIP/2.0 200 OK<br />
00056 1620781796 * <== 192.168.254.3:5060 SIP/2.0 180 Ringing<br />
00057 1620781796 * ==> 192.168.254.10:5060 SIP/2.0 183 Session Progress<br />
00058 1620781797 * <== 192.168.254.3:5060 SIP/2.0 200 OK<br />
00059 1620781797 * ==> 192.168.254.3:5060 ACK sip:phone1@192.168.254.3:5060 SIP/2.0<br />
00060 1620781797 * ==> 192.168.254.10:5060 SIP/2.0 200 OK<br />
00061 1620781797 * <== 192.168.254.10:5060 ACK sip:192.168.254.234:5070 SIP/2.0<br />
00062 1620781799 * <== 192.168.254.3:5060 BYE sip:asterisk@192.168.254.234:5070 SIP/2.0<br />
00063 1620781799 * ==> 192.168.254.3:5060 SIP/2.0 200 OK<br />
00064 1620781799 * ==> 192.168.254.10:5060 BYE sip:phone3@192.168.254.10:5060 SIP/2.0<br />
00065 1620781799 * <== 192.168.254.10:5060 SIP/2.0 200 OK<br />
<br />
特定のメッセージを確認する<br />
*CLI> pjsip show history entry 56<br />
<--- History Entry 56 Received from 192.168.254.3:5060 at 1620781796 ---><br />
SIP/2.0 180 Ringing<br />
Via: SIP/2.0/UDP 192.168.254.234:5070;rport=5070;received=192.168.254.234;branch=z<br />
Call-ID: fd5b758b-06e4-48cf-97e9-c815623ba9af<br />
From: "203" <sip:203@192.168.254.234>;tag=bedf1400-19fc-4c8d-80c2-f7a280ca9978<br />
To: <sip:phone1@192.168.254.3>;tag=1946423440<br />
CSeq: 4197 INVITE<br />
Allow: INVITE, ACK, CANCEL, BYE, INFO, UPDATE, OPTIONS, MESSAGE, NOTIFY, REFER<br />
Contact: <sip:phone1@192.168.254.3:5060><br />
Server: Panasonic-KX-HDV330N/02.504 (bcc3423c1e0c)<br />
Content-Length: 0<br />
Content-Length: 0<br />
<br />
chan_sipのようにダラダラ出したい場合は<br />
*CLI> pjsip set logger on<br />
<br />
==挙動上の注意点==<br />
===挙動そのもの===<br />
chan_sipより制限が少し"きつい"です。SIPメッセージの中に少しおかしなものがあってもchan_sipでは制限が緩かったので、通っていたものがPjSIPでは通らないことがあります。CLI等で'syntax error'のようなメッセージが出る場合にはSIPメッセージにおかしなところがあるかもしれないので調べてください。<br />
===AddHeader===<br />
chan_sipの場合にはSIPAddHeaderでSIPヘッダを追加できましたが、PjSIPではファンクションPJSIP_HEDER()を使用します。ただしこのファンクションはextenの途中で使用しても効果がありません。Dial時にサブルーチンコールしてやる必要があります。<BR><br />
例えばAlert-Info: hogeを追加するにはまず以下のよなルーチンを定義します。<br />
[add-alert]<br />
exten => s,1,Set(PJSIP_HEADER(add,Alert-Info)=hoge)<br />
exten => s,n,Return<br />
Dial時に以下のようにしてコールします<br />
exten => 201,1,Dial(PJSIP/201,,b(add-alert,s,1))<br />
<br />
==設定変更の反映==<br />
*モジュール数が多すぎて一発リロードする方法がよくわからない<br />
*module reload res_pjsip.soを実行すれば"だいたい"はいけそう<br />
:wizardのaor/を変更しても反映されない場合がある<br />
==PjSIPで拡張される機能==<br />
[[pjsip_機能拡張]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk%E3%82%B3%E3%83%B3%E3%82%B5%E3%83%AB%E3%82%BF%E3%83%B3%E3%83%88&diff=11612
Asteriskコンサルタント
2023-11-22T06:40:24Z
<p>Takahashi: /* スターシステムズ株式会社 */</p>
<hr />
<div>[[Category:Asterisk]]<br />
Asteriskを使ったサービスや開発等を行っている組織/個人の一覧です。各種依頼等の連絡にお使いください。<br />
<br />
自社&自分を宣伝したい方はページを更新してください。<br />
<br />
なお、無料サポート・質問等の窓口ではありません。ビジネスとしての問い合わせ以外はユーザグループ等をご利用ください。<br />
<br><br />
'''編集権限のあるメンバーはリンク切れを発見した場合にはエントリの削除を行ってください。'''<br />
<br />
==メーリングリスト==<br />
Asteriskユーザ会としてGoogle Groupで運用しています。<br><br />
流量があまり無いためビジネス系もこちらで行っていただいてかまいません。<br><br />
http://groups.google.com/group/asterisk-ug<br />
<br />
==会社等==<br />
===コンピュータ利用促進協同組合(略称 CCP) / 株式会社アースワークス===<br />
:住所:〒400-0857 山梨県甲府市幸町 13-21 共栄ビル<br />
:電話:055-244-7663<br />
:担当:小西<br />
:ウェブ:http://ews.jp/<br />
:ウェブ:http://www.iweave.jp/<br />
:ウェブ:http://www.ccp.or.jp/<br />
:取扱製品:ひかり電話ゲートウェイ、開発、サポート、技術支援<br />
<br />
===デンフォン株式会社===<br />
:住所:〒106-0032 東京都港区六本木2-4-9 アソルティ六本木1丁目ビル4F<br />
:電話:03-4550-1405<br />
:担当:鶸田(ひわだ)<br />
:ウェブ:https://www.denphone.com<br />
:取り扱い製品:IP電話機(Polycom, snom, Cisco, Grandstream, Linksysなど)、Digium製品、sangoma製品、Dialogic製品など<br />
<br />
===株式会社コミュニケーションビジネスアヴェニュー===<br />
:住所:〒239-0847 神奈川県横須賀市光の丘3番4号 YRP(横須賀リサーチパーク)センター1番館 508号室<br />
:電話:046-821-3362<br />
:ウェブ:http://www.cba-japan.com<br />
:ショップ:http://cba.shop-pro.jp/<br />
:取り扱い製品:trixbox Pro(ビジネス向けasterisk), Sangoma製品、Polycom、ダイアロジックボードなど<br />
<br />
===有限会社クラフト===<br />
:住所:〒701-1221 岡山県岡山市北区芳賀5303 岡山リサーチパークインキュベーションセンター内<br />
:電話:086-239-6031<br />
:担当:田口<br />
:ウェブ:http://www.craft-inc.net/<br />
:メール:craft-webmaster@craft-inc.net<br />
<br />
===株式会社あすか===<br />
:住所:〒530-0027 大阪市北区堂山町2-1 三共梅田ビル3F<br />
:電話:06-6131-1267<br />
:ウェブ:https://www.aska-ltd.jp/jp/service/81<br />
:お問い合わせ:inquiry@aska-ltd.jp<br />
:担当:宗近<br />
:担当範囲:Asteriskの導入コンサル等<br />
<br />
===有限会社IP-S===<br />
:住所:〒562-0004 大阪府箕面市牧落1-1-3<br />
:電話:072-736-9300<br />
:お問い合わせ:ttaniguchi@ip-s.biz<br />
:担当:谷口<br />
:取り扱い製品:アイコムIP電話、フュージョンコミュニケーションズIP電話、フュージョンモバイルIP電話、沖電気BVシリーズ、古河電工、富士通、アライドテレシス、アレクソン、VMware他。<br />
:取り扱い業務:各種導入コンサルティング、保守・運用サポート、海外設置<br />
<br />
===株式会社テクノアント===<br />
:住所:〒650-0024 神戸市中央海岸通3丁目1-1KCCビル<br />
:電話:078-907-6101<br />
:お問い合わせ:info@technoant.com<br />
:担当:山崎<br />
:担当範囲:通信環境およびAsterisk導入コンサルティング<br />
<br />
===株式会社RELATION===<br />
:住所:〒708-0814 岡山県津山市東一宮 21-1<br />
:電話:0868-27-7744<br />
:URL:http://www.rel-ltd.com/<br />
:お問い合わせ:takatori@rel-ltd.com<br />
:担当:鷹取<br />
:担当範囲:Asterisk導入コンサルティング ネットワーク設計<br />
<br />
===株式会社iSERVE===<br />
:住所:〒108-0073 東京都港区三田4丁目7-19 ハタビル5階<br />
:電話:03-6420-3234<br />
:URL:http://www.iserve.jp/<br />
:お問い合わせ:sales@iserve.jp<br />
:担当:松原/橋本<br />
:担当範囲:基盤情報システムの設計、構築、運用およびコンサルティング(アセスメント、調達支援など)<br />
:取り扱い製品:サーバ、ストレージ、ネットワーク、セキュリティおよびVoIP(IP-PBX, IP Phoneなど)関連製品、基盤情報関連ソフトウェア<br />
:その他:フュージョンコミュニケーションズ社販売代理店、VMware社VAC/VIP、EMC社販売代理店、NetApp社CDP、Nexenta社販売代理店<br />
<br />
===株式会社and One===<br />
:住所:〒150-0002 東京都渋谷区渋谷1-17-8 松岡渋谷ビル<br />
:電話:03-5774-1660<br />
:URL:http://www.andone.co.jp<br />
:お問い合わせ:and1-contact@andone.co.jp(http://www.andone.co.jp/contact/)<br />
:担当:and Oneインフォメーションセンター<br />
:取り扱い製品:Asteriskベースの『Primus』は、機能性・操作性・柔軟性・コストパフォーマンスに優れたIP-PBXソフトウェアです。<br />
:NTT東西が提供する、フレッツ光ネクストによる電話サービス「ひかり電話」、NTTCom Arcstar IP Voice、FUSION IP-Phone、KVH VoiceLINE IPの直収が可能です。<br />
:また、Asteriskのコンサルティングから、組み込み開発まで承りますので、ご相談ください。<br />
:導入事例:http://www.andone.co.jp/primus/example/<br />
<br />
===株式会社ソフツー===<br />
:住所:〒103-0004 東京都中央区東日本橋1-1-7 野村不動産東日本橋ビル5F<br />
:電話:03-4455-7300<br />
:URL:http://www.softsu.co.jp<br />
:お問い合わせ:https://www.softsu.co.jp/contact.php<br />
:担当:お問合せ窓口よりご連絡ください。<br />
:取り扱い業務: Asteriskベースのクラウドコールセンターシステム「[http://bluebean.softsu.com BlueBean]」の開発及び提供をしています。<br />
:プレディクティブコール利用可能なアウトバウンド/インバウンドのオールインワン型クラウドコールセンターシステムです。<br />
:Webから契約でき、安価で簡単に始められます。<br />
<br />
===メディアリンク株式会社===<br />
:住所:〒108-0014 東京都港区芝5-31-17 PMO田町5F<br />
:電話:03-3455-2700<br />
:URL:https://www.medialink-ml.co.jp<br />
:お問い合わせ:https://www.medialink-ml.co.jp/form/<br />
:担当:前田<br />
:取扱製品: Asteriskベースのオフィス向けIP-PBX『MediaOffice』/コールセンター向けIP-PBX『MediaCalls』/IVR『MediaVoice』、IP電話機、各種NW機器<br />
:取扱業務: コンタクトセンターシステム(CTIソリューション)をはじめ、さまざまなシステムのコンサルティングから設計・製造・運用支援・保守サービス<br />
:主な導入実績: <br />
: 大手通信事業者様 MediaVoice 400ライセンス(80万コール/月の稼働実績)<br />
: 大手人材派遣業者様 MediaVoice 40ライセンス(1万コール/月の稼働実績)<br />
: 大手広告代理店様 MediaVoice 40ライセンス<br />
: 大手決済代行会社様 MediaOffice 400ライセンス<br />
: 大手テレビ局様 MediaOffice 100ライセンス<br />
: 通信事業者様 MediaOffice 1,000ライセンス<br />
: ほか多数(導入実績10,000席以上)<br />
<br />
===株式会社ワイドテック===<br />
:住所:〒101-0032 千代田区岩本町2-11-2 イトーピア岩本町二丁目ビル4F<br />
:電話:03-5829-4886<br />
:取扱製品:クラウド型電話転送サービス「転送録」は、Asterisk/NTT/FUSIONを使用した下記のサービスをご提供しております<br />
: ・転送先増設 ボイスワープなどの[転送先を増設]<br />
: ・順次転送 転送先を[順番に呼び出し]<br />
: ・一斉呼出転送 転送先を[一斉に呼び出し]<br />
: ・自動分配転送 転送先を[均等に呼び出し]<br />
: ・自動音声受付 音声ガイダンスで[自動で受付]<br />
: ・チェックコール 自動ダイヤル・応答確認<br />
: 医療系緊急コールやクリニックの診療時間外の連絡対応、大手メーカのサービス部門の時間外コール対応など、幅広い分野でご採用いただいております。<br />
:URL:https://www.10so6.com/<br />
:お問い合わせ:10so6.support@widetec.com<br />
:担当:「転送録」お客様相談センター<br />
<br />
===株式会社オプトエスピー===<br />
:住所:〒161-0033 東京都新宿区下落合1-6-1 宮村ビル2階<br />
:電話:03-3360-3688<br />
:ウェブ:http://www.optsp.co.jp/<br />
:お問い合わせ:cti-solution@optsp.co.jp<br />
:取扱製品:AsteriskベースのIP-PBX「FlexPhone」、Asteriskと親和性のある録音システム「OrekaTR」<br />
<br />
===株式会社 シーボーン===<br />
:住所:東京都中央区京橋2-1-1<br />
:ウェブ:http://www.c-borne.com/<br />
:メール:info@c-borne.com<br />
:電話:050-5810-3085<br />
:担当:田代<br />
:取扱製品:Asteriskベース、IP-PBX「Re-Vox」<br />
:取扱サービス:基盤情報システムの設計、ネットワーク設計、セキュリティ、構築、運用およびコンサルティング<br />
<br />
===株式会社メディアシステム===<br />
:住所:〒812-0011 福岡市博多区博多駅前2丁目12番3号 HAKATAエフビル 7階<br />
:電話:092-477-5600(担当:原田、廣石)<br />
:住所:〒105-0003 東京都港区西新橋1丁目18番6号 クロスオフィス内幸町12階<br />
:電話:03-6433-2525(担当:山口、石橋)<br />
:住所:〒904-1103 沖縄県うるま市石川赤崎2丁目20-1 うるま市IT事業支援センター 2号館1F インキュベーション室4<br />
:電話:098-917-4027<br />
:ウェブ:http://www.media-system.co.jp/<br />
:メール:info@media-system.co.jp<br />
:取り扱い製品:<br><br />
Asteriskベースの「コールセンターシステム/自動音声応答システム/FAXシステム」の開発を行っております。<br><br />
長年の開発実績を活かし、小規模~大規模、クラウド/オンプレミス問わず、幅広くご対応が可能です。<br><br />
テレワークに対応したシステム構築もご相談ください。<br><br />
柔軟且つスピードを持って対応させて頂きますので、お気軽にお問い合わせ下さい。<br />
:その他:<br><br />
楽天コミュニケーションズ社販売代理店、各種IP電話機取扱い(Panasonic・SAXA・GrandStream・Yealink他)<br />
<br />
===株式会社ギークフィード===<br />
:住所:〒111-0056 東京都台東区小島2-20-7 扶桑御徒町ビル2F<br />
:電話:03-3863-6754<br />
:ウェブ:http://www.geekfeed.co.jp<br />
:お問い合わせ:sales@geekfeed.co.jp<br />
:担当範囲:Asteriskのカスタマイズ受託開発、導入コンサルティング、勉強会、セミナー、構築<br />
:取扱製品:AudioCodesの一次代理店として、VoIPGateway、IP電話、SBC等を取り扱っております。<br />
:イタリアXenialabの日本総代理店として、asteriskベースのオムニチャンネルコールセンターシステムxcallyのライセンス販売、SaaS提供を行っております。<br />
:CounterPathのリセラーとして、ソフトフォンのBriaやプロビジョニングサーバーStrettoを取り扱っております。<br />
:自社製品として、通話録音システムYouWireを開発、販売しております。<br />
:取扱製品:IPPhone,VoIPGateway,SBCメーカーであるAudioCodesの一次代理店です。<br />
<br />
===ディブソル株式会社===<br />
:住所:〒144-0052 東京都大田区蒲田4-32-11<br />
:ウェブ:https://www.divssol.com<br />
:お問い合わせ:info@divssol.com<br />
:業務範囲:<br><br />
・インバウンド、アウトバウンドのコールセンターシステム開発(CRM,プリディクティブ対応)<br><br />
・Asterisk,Freeswitch,Opensips,Kamailio,Kazoo等のカスタマイズ開発<br><br />
・WebRTCクライアント、iOS、Android VoIPアプリのOEM開発<br><br />
・SIPクライアント/ライブラリ開発、pjsip/vialer、linphone 、sip.js/jssip等<br><br />
・Carrier GladeのAsterisk/Freeswitch/IMS構築支援<br><br />
・組込み向けAsterisk開発支援(Yocto Linux)<br><br />
・クラウド開発支援(AWS, Azure, GCP, OpenStack, Salesforce, MS Dynamics)<br><br />
・各社回線適合調査、IP電話コンサルティング<br><br />
・多言語開発対応(英語、ドイツ語、タイ語等) Multilingal development (English,German, Thai etc)<br />
:開発実績:大手通信会社様、通販業者様等、大小問わず様々な実績がございます。お気軽にお問合せ下さい。<br />
<br />
===株式会社Ringing===<br />
:住所:〒231-0005 神奈川県横浜市中区本町三丁目24番地1 本町中央ビル 701B<br />
:ウェブ:https://www.ringing.co.jp/<br />
:電話:050-5526-4164<br />
:お問い合わせ:ウェブの"お問い合わせフォーム"、またはお電話にてお問い合わせお願いします。<br />
:業務範囲:<br><br />
・Asterisk,FreeSwitch等を利用したシステム開発・運用保守を承っております。<br><br />
・クラウドPBXの開発/運用、オートコールシステムの開発、FAXアプリの開発/運用、SIPトランク・ゲートウェイの開発/運用など実績があります。<br><br />
・ちょっとした改修作業、運用保守も低料金にて承っております。お気軽にお問い合わせください。<br><br />
<br />
===株式会社Network Revolution===<br />
:住所:〒911-0031 福井県勝山市長山町2丁目3番25号<br />
:ウェブ:https://www.nwre.co.jp/<br />
:お問い合わせ:ウェブの"お問い合わせフォーム"にてお問い合わせお願いします。<br />
:業務範囲:<br><br />
・北陸地方で唯一のIP電話工事業者です。<br><br />
・ネットワーク構築、OpenVPN、WireGuard over IPv6を用いたNTT網内折返し高速VPNなどを構築しています。<br><br />
・Asterisk,freePBX等を利用したIP電話システム構築、工事、運用をおこなっています。<br><br />
・どこでもイエデン®シリーズ(PBX,NTTひかり電話転送GW、CTI、VPN)の販売、設定サポート、工事、保守、運用を行っています。<br><br />
・どこでもイエデン®シリーズは販売代理店を募集中です。<br><br />
・どこでもイエデン®シリーズはカスタマイズも承ります。<br><br />
<br />
==個人等== <br />
===高橋隆雄=== <br />
:aka たかはし<br />
:ウェブ:ここ<br />
:メール:webmaster'at'voip-info'dot'jp<br />
:担当製品:人寄せパンダ(Asterisk関連の執筆・講演等行います)</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_20&diff=11611
Asterisk 20
2023-11-13T02:09:39Z
<p>Takahashi: /* 新機能 */</p>
<hr />
<div>[[カテゴリ:Asterisk]]<br />
[[カテゴリ:pjsip]]<br />
<br />
Asterisk 20.0.0が2022年10月19日(現地時間)リリースされました。<br><br />
:メンテナンス終了は2026年10月19日<br />
:セキュリティフィックス提供終了は2027年10月<br />
==概要==<br />
Asterisk 20は最新のAsteriskのメジャーリリースで、Asterisk 18同様にLTS(Long Term Support:通常4年)になります。<br />
:https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions<br />
===Asterisk 18からの変更点で重要なもの===<br />
*chan_sipは廃止予定(Deprecated扱いで標準ではコンパイルされない)<br />
:chan_sipは18でもそうでしたが、ほぼメンテナンスされていないようなので使わないことをお勧めします。<br />
*chan_alsa,chan_mgcp,chan_skinnyも廃止予定(deprecated)で標準コンパイルされない<br />
*app_macroは廃止予定(Deprecated扱いで標準ではコンパイルされない)<br />
上記はmenuselectで明示指定すればコンパイルはされる<br />
*res_config_sqliteは廃止<br />
<br />
===新機能===<br />
*function EXPORT<br />
*function 文字列操作<br />
:TRIM,LTRIM,RTRIMが追加<br />
その他はCHANGESを参照のこと。<br />
==メモ==<br />
今のところテストしている環境ではAsterisk 18がコンパイル/インストールできる環境でならば20も問題なさそう。</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_20&diff=11610
Asterisk 20
2023-11-13T02:08:23Z
<p>Takahashi: /* Asterisk 18からの変更点で重要なもの */</p>
<hr />
<div>[[カテゴリ:Asterisk]]<br />
[[カテゴリ:pjsip]]<br />
<br />
Asterisk 20.0.0が2022年10月19日(現地時間)リリースされました。<br><br />
:メンテナンス終了は2026年10月19日<br />
:セキュリティフィックス提供終了は2027年10月<br />
==概要==<br />
Asterisk 20は最新のAsteriskのメジャーリリースで、Asterisk 18同様にLTS(Long Term Support:通常4年)になります。<br />
:https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions<br />
===Asterisk 18からの変更点で重要なもの===<br />
*chan_sipは廃止予定(Deprecated扱いで標準ではコンパイルされない)<br />
:chan_sipは18でもそうでしたが、ほぼメンテナンスされていないようなので使わないことをお勧めします。<br />
*chan_alsa,chan_mgcp,chan_skinnyも廃止予定(deprecated)で標準コンパイルされない<br />
*app_macroは廃止予定(Deprecated扱いで標準ではコンパイルされない)<br />
上記はmenuselectで明示指定すればコンパイルはされる<br />
*res_config_sqliteは廃止<br />
<br />
===新機能===<br />
*function EXPORT<br />
*function 文字列操作<br />
:TRIM,LTRIM,RTRIMが追加<br />
その他はCHANGESを参照のこと。</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11609
Asterisk pjsip parameters
2023-11-13T01:33:54Z
<p>Takahashi: /* TRANSPORT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
==res_pjproject==<br />
PjSIPの基本となるモジュール。それ自体の設定ファイルはpjproject.conf。チャネルドライバ(chan_pjsip)等の機能もres_pjprojectで提供されているが、SIPのエンドポイント設定等はpjsip.confファイルで行う。<br />
===pjproject.conf===<br />
pjprojectの共通設定ファイル。<br><br />
このファイルが存在しなくともchan_pjsip等は動作する。デフォルト値で通常動作は問題ないため。設定項目を変更したい、例えばAsteriskのログに出したいpjprojectのログレベルを変更したような場合にはこのファイルを使用する。<br />
====[startup]====<br />
type=startupの記述はあるがセクション名も"[startup]"とする必要がある。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|cache_pools||pjprojectのメモリプールをキャッシュする||Bool||yes||-<br />
|-<br />
|log_level||内部のログレベル(0-6,default)||-||2||-<br />
|-<br />
|}<br />
====[log_mappings]====<br />
type=log_mappingsもセクション名を"[log_mappings]"とする必要がある。<br><br />
ログのレベルは次の通り<br><br />
- 0: 致命的なエラー<br><br />
- 1: エラー<br><br />
- 2: 警告<br><br />
- 3: 情報<br><br />
- 4: デバッグ<br><br />
- 5: トレース<br><br />
- 6: より詳細なトレース<br><br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|asterisk_error||Asterisk errorにマップするpjprojectのerror(カンマ区切り)||0~6||0,1||-<br />
|-<br />
|asterisk_warning||Asterisk warningにマップするpjprojectのerror(カンマ区切り)||0~6||2||-<br />
|-<br />
|asterisk_notice||Asterisk noticeにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_verbose||Asterisk verboseにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_debug||Asterisk debugにマップするpjprojectのerror(カンマ区切り)||0~6||3,4||-<br />
|-<br />
|asterisk_trace||Asterisk traceにマップするpjprojectのerror(カンマ区切り)||0~6||5,6||-<br />
|-<br />
|}<br />
<br />
=各セクションのパラメータ(pjsip.conf)=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||int||100||-<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11608
Asterisk pjsip parameters
2023-11-13T01:28:00Z
<p>Takahashi: /* 各セクションのパラメータ */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
==res_pjproject==<br />
PjSIPの基本となるモジュール。それ自体の設定ファイルはpjproject.conf。チャネルドライバ(chan_pjsip)等の機能もres_pjprojectで提供されているが、SIPのエンドポイント設定等はpjsip.confファイルで行う。<br />
===pjproject.conf===<br />
pjprojectの共通設定ファイル。<br><br />
このファイルが存在しなくともchan_pjsip等は動作する。デフォルト値で通常動作は問題ないため。設定項目を変更したい、例えばAsteriskのログに出したいpjprojectのログレベルを変更したような場合にはこのファイルを使用する。<br />
====[startup]====<br />
type=startupの記述はあるがセクション名も"[startup]"とする必要がある。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|cache_pools||pjprojectのメモリプールをキャッシュする||Bool||yes||-<br />
|-<br />
|log_level||内部のログレベル(0-6,default)||-||2||-<br />
|-<br />
|}<br />
====[log_mappings]====<br />
type=log_mappingsもセクション名を"[log_mappings]"とする必要がある。<br><br />
ログのレベルは次の通り<br><br />
- 0: 致命的なエラー<br><br />
- 1: エラー<br><br />
- 2: 警告<br><br />
- 3: 情報<br><br />
- 4: デバッグ<br><br />
- 5: トレース<br><br />
- 6: より詳細なトレース<br><br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|asterisk_error||Asterisk errorにマップするpjprojectのerror(カンマ区切り)||0~6||0,1||-<br />
|-<br />
|asterisk_warning||Asterisk warningにマップするpjprojectのerror(カンマ区切り)||0~6||2||-<br />
|-<br />
|asterisk_notice||Asterisk noticeにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_verbose||Asterisk verboseにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_debug||Asterisk debugにマップするpjprojectのerror(カンマ区切り)||0~6||3,4||-<br />
|-<br />
|asterisk_trace||Asterisk traceにマップするpjprojectのerror(カンマ区切り)||0~6||5,6||-<br />
|-<br />
|}<br />
<br />
=各セクションのパラメータ(pjsip.conf)=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11607
Asterisk pjsip parameters
2023-11-13T01:26:11Z
<p>Takahashi: /* res_pjproject */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
==res_pjproject==<br />
PjSIPの基本となるモジュール。それ自体の設定ファイルはpjproject.conf。チャネルドライバ(chan_pjsip)等の機能もres_pjprojectで提供されているが、SIPのエンドポイント設定等はpjsip.confファイルで行う。<br />
===pjproject.conf===<br />
pjprojectの共通設定ファイル。<br><br />
このファイルが存在しなくともchan_pjsip等は動作する。デフォルト値で通常動作は問題ないため。設定項目を変更したい、例えばAsteriskのログに出したいpjprojectのログレベルを変更したような場合にはこのファイルを使用する。<br />
====[startup]====<br />
type=startupの記述はあるがセクション名も"[startup]"とする必要がある。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|cache_pools||pjprojectのメモリプールをキャッシュする||Bool||yes||-<br />
|-<br />
|log_level||内部のログレベル(0-6,default)||-||2||-<br />
|-<br />
|}<br />
====[log_mappings]====<br />
type=log_mappingsもセクション名を"[log_mappings]"とする必要がある。<br><br />
ログのレベルは次の通り<br><br />
- 0: 致命的なエラー<br><br />
- 1: エラー<br><br />
- 2: 警告<br><br />
- 3: 情報<br><br />
- 4: デバッグ<br><br />
- 5: トレース<br><br />
- 6: より詳細なトレース<br><br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|asterisk_error||Asterisk errorにマップするpjprojectのerror(カンマ区切り)||0~6||0,1||-<br />
|-<br />
|asterisk_warning||Asterisk warningにマップするpjprojectのerror(カンマ区切り)||0~6||2||-<br />
|-<br />
|asterisk_notice||Asterisk noticeにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_verbose||Asterisk verboseにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_debug||Asterisk debugにマップするpjprojectのerror(カンマ区切り)||0~6||3,4||-<br />
|-<br />
|asterisk_trace||Asterisk traceにマップするpjprojectのerror(カンマ区切り)||0~6||5,6||-<br />
|-<br />
|}<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11606
Asterisk pjsip parameters
2023-11-13T01:23:26Z
<p>Takahashi: /* pjproject.conf */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
==res_pjproject==<br />
===pjproject.conf===<br />
pjprojectの共通設定ファイル。<br><br />
このファイルが存在しなくともchan_pjsip等は動作する。デフォルト値で通常動作は問題ないため。設定項目を変更したい、例えばAsteriskのログに出したいpjprojectのログレベルを変更したような場合にはこのファイルを使用する。<br />
====[startup]====<br />
type=startupの記述はあるがセクション名も"[startup]"とする必要がある。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|cache_pools||pjprojectのメモリプールをキャッシュする||Bool||yes||-<br />
|-<br />
|log_level||内部のログレベル(0-6,default)||-||2||-<br />
|-<br />
|}<br />
====[log_mappings]====<br />
type=log_mappingsもセクション名を"[log_mappings]"とする必要がある。<br><br />
ログのレベルは次の通り<br><br />
- 0: 致命的なエラー<br><br />
- 1: エラー<br><br />
- 2: 警告<br><br />
- 3: 情報<br><br />
- 4: デバッグ<br><br />
- 5: トレース<br><br />
- 6: より詳細なトレース<br><br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|asterisk_error||Asterisk errorにマップするpjprojectのerror(カンマ区切り)||0~6||0,1||-<br />
|-<br />
|asterisk_warning||Asterisk warningにマップするpjprojectのerror(カンマ区切り)||0~6||2||-<br />
|-<br />
|asterisk_notice||Asterisk noticeにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_verbose||Asterisk verboseにマップするpjprojectのerror(カンマ区切り)||0~6||-||-<br />
|-<br />
|asterisk_debug||Asterisk debugにマップするpjprojectのerror(カンマ区切り)||0~6||3,4||-<br />
|-<br />
|asterisk_trace||Asterisk traceにマップするpjprojectのerror(カンマ区切り)||0~6||5,6||-<br />
|-<br />
|}<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11605
Asterisk pjsip parameters
2023-11-13T01:05:23Z
<p>Takahashi: /* 全般的な注意 */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
==res_pjproject==<br />
===pjproject.conf===<br />
pjprojectの共通設定ファイル(このファイルは無くてもchan_pjsip等は動く)<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk&diff=11604
Asterisk
2023-11-11T17:03:53Z
<p>Takahashi: /* 各バージョンの情報 */</p>
<hr />
<div>[[Category:Asterisk]]<br />
[[Category:VoIP]]<br />
==Asterisk: Open Source Communication Framework== <br />
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。<br><br />
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。<br><br />
日本でAsteriskが広く知られるようになったのは2005年頃からです。<br><br />
===対応するプロトコル===<br />
*IP系<br />
:SIP<br />
:H.323<br />
:UNISTIM<br />
:IAX(Inter Asterisk eXchange)<br />
:MGCP<br />
:Skinny(Cisco)<br />
*レガシー系<br />
:BRI/PRI(ISDNボード必要)<br />
:アナログ(アナログボード必要)<br />
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます<br />
===[[導入事例]]===<br />
[[導入事例]]のページにサマリーをまとめてあります。<br />
<br />
==バージョン==<br />
Asterisk 1.8まで<br />
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン<br />
:奇数番号は開発バージョンで一般には公開されない<br />
Asterisk 10以降<br />
:11,13,16,18<br />
::LTS(Long Term Support:長期サポートバージョン)<br />
:10,12,14,15,17<br />
::STD(Standard:標準サポートバージョン)<br />
<br />
==Asteriskの入手とインストール==<br />
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。<br><br />
<br><br />
===どのバージョンをインストールすれば?===<br />
現在(2023年11月)時点で安定していると思われるのはAsterisk 18です。<br><br />
EOLまでの時間を気にする場合にはAsterisk 20を検討してください。<br><br />
<br />
===オプションのパッケージ===<br />
*[[DAHDI]](旧Zaptel)<br><br />
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。<br><br />
:アナログ、BRI/PRIのボードを使用しない場合には不要です。<br />
*libpri<br><br />
:PRIを使用しなければ必要ありません。<br><br />
*OS/ディストリ依存情報<br><br />
:[[Asteriskインストールメモ]]<br><br />
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが) <br />
:[[Asterisk サンプル設定ファイル]]を使ってみてください。<br> <br />
:[[extension道場]]も参考になります。<br><br />
===各バージョンの情報===<br />
*旧バージョンの情報<br />
:[[Asterisk 旧バージョン]]<br />
*Asterisk 13<br />
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])<br />
*Asterisk 14<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 15<br />
:2017年リリース(Standard)<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 16<br />
:2018年10月リリース。LTS。(Security Onlyは2022/10、EOLは2023/10)<br />
*Asterisk 17<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 18<br />
:2020年10月リリース。LTS。(Security Onlyは2024/10、EOLは2025/10)<br />
*Asterisk 20<br />
:2022年10月リリース。LTS。<br />
<br />
===DAHDIへの移行===<br />
:[[DAHDIインストール]]<br />
===Asterisk+DB===<br />
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''<br />
:[[Asterisk+MySQL]]<br />
:[[Asterisk+PostgreSQL]]<br />
:[[Asterisk CDR SQLite]]<br />
:[[Asterisk 11 ODBC]]<br />
<br />
===使用する上でのヒント===<br />
*[[Asterisk Tips]]<br />
===注意点などの追加情報===<br />
*[[Asterisk 追加情報]]<br />
===セキュリティ===<br />
*[[利用者:MR G]]の[[パケットフィルタリング]]<br />
*'''[[Asterisk SIP セキュリティ]]'''<br />
*'''[[SIP-Fail2ban]]'''<br />
*[[Asteriskが使用するポート一覧]]<br />
<br />
===参考になるページ===<br />
MR Gさんのページ [[利用者:MR G]]<br><br />
[[Asterisk NAT]]<br><br />
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]]<br><br />
===参考になるかどうかよくわからないページ===<br />
[[バカstarisk]]<br><br />
[[あすりん(仮)]]<br />
<br />
==派生ディストリビューション==<br />
[[Asteriskの派生ディストリビューション]]<br />
==アンインストール==<br />
[[アンインストール情報]]のページへ<br />
<br />
==Asteriskの動作する環境==<br />
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル以降ならば問題はありません。<br />
===OS===<br />
[[Asterisk動作確認済みOS]]<br />
===関連情報===<br />
[[Asterisk Timer]]<br> <br />
[[Zaptel udev]]<br><br />
[[Asterisk MacOSXでの動作]]<br><br />
[[Asterisk FreeBSDでの動作]]<br><br />
<br />
===特殊なプラットフォーム===<br />
*小型アプライアンス類<br />
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照<br><br />
*OpenWRT<br><br />
:ルータ用代替ファームウェア。Asteriskのインストールも可能。<br><br />
<br />
==Asteriskと回線や電話機等の接続==<br />
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。<br />
===IP===<br />
*[[IP電話機]]<br />
*[[ITSP接続]]<br />
*[[ENUM]]<br />
===アナログ===<br />
*[[アナログ回線の接続]]<br />
*[[アナログ電話機の接続]]<br />
===ISDN===<br />
*[[ISDN接続]]<br />
===ひかり電話===<br />
*[[ひかり電話対応]]<br />
===回線交換機(アナログ式PBX)===<br />
*[[OD接続(E&M)]]<br />
*[[FXS接続]]<br />
*[[FXO接続]]<br />
<br />
=== 携帯電話 ===<br />
<br />
*[[Bluetooth接続(chan_mobile)]]<br />
*chan_dongle<br />
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)/USSDに対応。開発は活発ではないけど使える模様。<br />
<br />
===Skype===<br />
*[[Skype for Asterisk]]<br />
:Digiumのプロダクト。ディスコン。<br />
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]<br />
:Skype公式のSIP接続サービス。US$6.95/ch/月<br />
<br />
===FAX===<br />
*[[Fax for Asterisk]]<br />
:Digiumのプロダクト<br />
*spandsp + res_fax_spandsp<br />
:Asterisk13以降。なおapp_faxは非推奨<br />
*IAXModem + Hylafax<br />
<br />
==Asteriskの管理==<br />
*コマンドライン<br />
:[[Asterisk_CLI]]<br />
*[[Asterisk Manager Interface]]<br />
:Asterisk管理インタフェース<br />
*GUI<br />
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。<br><br />
:[[Asterisk-GUI]](純正)<br><br />
:[[Asterisk GUI]]<br><br />
:ADM<br><br />
<br />
==外部プログラムとの連携==<br />
*[[自動発信|コール用ファイル]](call file)<br />
*AGI: Asterisk Gateway Interface<br />
*AMI: Asterisk Manager Interface<br />
*ARI: Asterisk REST Interface<br />
*ダイヤルプランから<br />
:Application_Exec, Function_SHELL, Function_FILE<br />
:Application_ReadFileは非推奨。<br />
<br />
<br />
==IP電話関連機器はどこで買えますか?==<br />
日本国内での入手性も序々に良くなってきました。<br><br />
[[購入情報]] のページを参照してください。<br><br />
<br />
==日本国内対応==<br />
Asteriskを日本国内に対応させる情報は下記を参照してください。<br><br />
===ローカライズ===<br />
*<s>[[Asterisk パッチ]]</s>(現在のバージョンでは必要ありません)<br />
*[[Asterisk 日本語音声]]<br />
*[[音声合成]]<br />
<br />
===接続および使い方===<br />
*[[ひかり電話対応]]<br />
*[[ラインキー問題]]<br />
<br />
<br />
<br />
==書籍==<br />
===日本語===<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)<br />
:1.0ベースのため1.2系は当Wikiでフォローしています。<br><br />
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)<br />
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など<br />
:Asteriskに特化した内容となっています。<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)<br />
:AsteriskNOWによるAsteriskの入門書です。<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]<br />
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド]<br><br />
:1.2ベースの本のようです。1.2のソースCD付。<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド]<br><br />
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。<br><br />
*[https://www.amazon.co.jp/dp/B00B0NJ6I8/takahashitaka-22/ref=nosim Ubuntu 12.04 と EC2で作る Asterisk電話サーバ](kindle)<br />
<br />
===洋書=== <br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony]<br><br />
:こちらも1.0ベースの本。<br><br />
:Asterisk : The Future of Telephony (Asterisk Documentation Project)<br><br />
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。<br><br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)]<br><br />
:2ndエディションで1.4対応だそうです。<br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)]<br><br />
:発売日:2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。<br />
*[http://www.amazon.co.jp/dp/B00HQ0RA8M/takahashitaka-22/ref=nosim Asterisk: The Definitive Guide 4th edition]<br />
:Asterisk 11に対応。pjprojectの記述はまだありません。<br />
<br />
==問い合わせ先など==<br />
*[[Asteriskコンサルタント]]<br />
*セミナー/イベントなど<br />
:[[イベント情報]]のページで告知しています。<br />
<br />
==外部リンク==<br />
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。<br />
:Digium http://www.digium.com<br><br />
:Asterisk http://www.asterisk.org<br></div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk&diff=11603
Asterisk
2023-11-11T17:03:07Z
<p>Takahashi: /* どのバージョンをインストールすれば? */</p>
<hr />
<div>[[Category:Asterisk]]<br />
[[Category:VoIP]]<br />
==Asterisk: Open Source Communication Framework== <br />
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。<br><br />
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。<br><br />
日本でAsteriskが広く知られるようになったのは2005年頃からです。<br><br />
===対応するプロトコル===<br />
*IP系<br />
:SIP<br />
:H.323<br />
:UNISTIM<br />
:IAX(Inter Asterisk eXchange)<br />
:MGCP<br />
:Skinny(Cisco)<br />
*レガシー系<br />
:BRI/PRI(ISDNボード必要)<br />
:アナログ(アナログボード必要)<br />
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます<br />
===[[導入事例]]===<br />
[[導入事例]]のページにサマリーをまとめてあります。<br />
<br />
==バージョン==<br />
Asterisk 1.8まで<br />
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン<br />
:奇数番号は開発バージョンで一般には公開されない<br />
Asterisk 10以降<br />
:11,13,16,18<br />
::LTS(Long Term Support:長期サポートバージョン)<br />
:10,12,14,15,17<br />
::STD(Standard:標準サポートバージョン)<br />
<br />
==Asteriskの入手とインストール==<br />
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。<br><br />
<br><br />
===どのバージョンをインストールすれば?===<br />
現在(2023年11月)時点で安定していると思われるのはAsterisk 18です。<br><br />
EOLまでの時間を気にする場合にはAsterisk 20を検討してください。<br><br />
<br />
===オプションのパッケージ===<br />
*[[DAHDI]](旧Zaptel)<br><br />
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。<br><br />
:アナログ、BRI/PRIのボードを使用しない場合には不要です。<br />
*libpri<br><br />
:PRIを使用しなければ必要ありません。<br><br />
*OS/ディストリ依存情報<br><br />
:[[Asteriskインストールメモ]]<br><br />
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが) <br />
:[[Asterisk サンプル設定ファイル]]を使ってみてください。<br> <br />
:[[extension道場]]も参考になります。<br><br />
===各バージョンの情報===<br />
*旧バージョンの情報<br />
:[[Asterisk 旧バージョン]]<br />
*Asterisk 13<br />
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])<br />
*Asterisk 14<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 15<br />
:2017年リリース(Standard)<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 16<br />
:2018年10月リリース。LTS。(Security Onlyは2022/10、EOLは2023/10)<br />
*Asterisk 17<br />
:STDリリースのため使用は推奨しません。<br><br />
*Asterisk 18<br />
:2020年10月リリース。LTS。(Security Onlyは2024/10、EOLは2025/10)<br />
<br />
===DAHDIへの移行===<br />
:[[DAHDIインストール]]<br />
===Asterisk+DB===<br />
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''<br />
:[[Asterisk+MySQL]]<br />
:[[Asterisk+PostgreSQL]]<br />
:[[Asterisk CDR SQLite]]<br />
:[[Asterisk 11 ODBC]]<br />
<br />
===使用する上でのヒント===<br />
*[[Asterisk Tips]]<br />
===注意点などの追加情報===<br />
*[[Asterisk 追加情報]]<br />
===セキュリティ===<br />
*[[利用者:MR G]]の[[パケットフィルタリング]]<br />
*'''[[Asterisk SIP セキュリティ]]'''<br />
*'''[[SIP-Fail2ban]]'''<br />
*[[Asteriskが使用するポート一覧]]<br />
<br />
===参考になるページ===<br />
MR Gさんのページ [[利用者:MR G]]<br><br />
[[Asterisk NAT]]<br><br />
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]]<br><br />
===参考になるかどうかよくわからないページ===<br />
[[バカstarisk]]<br><br />
[[あすりん(仮)]]<br />
<br />
==派生ディストリビューション==<br />
[[Asteriskの派生ディストリビューション]]<br />
==アンインストール==<br />
[[アンインストール情報]]のページへ<br />
<br />
==Asteriskの動作する環境==<br />
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル以降ならば問題はありません。<br />
===OS===<br />
[[Asterisk動作確認済みOS]]<br />
===関連情報===<br />
[[Asterisk Timer]]<br> <br />
[[Zaptel udev]]<br><br />
[[Asterisk MacOSXでの動作]]<br><br />
[[Asterisk FreeBSDでの動作]]<br><br />
<br />
===特殊なプラットフォーム===<br />
*小型アプライアンス類<br />
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照<br><br />
*OpenWRT<br><br />
:ルータ用代替ファームウェア。Asteriskのインストールも可能。<br><br />
<br />
==Asteriskと回線や電話機等の接続==<br />
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。<br />
===IP===<br />
*[[IP電話機]]<br />
*[[ITSP接続]]<br />
*[[ENUM]]<br />
===アナログ===<br />
*[[アナログ回線の接続]]<br />
*[[アナログ電話機の接続]]<br />
===ISDN===<br />
*[[ISDN接続]]<br />
===ひかり電話===<br />
*[[ひかり電話対応]]<br />
===回線交換機(アナログ式PBX)===<br />
*[[OD接続(E&M)]]<br />
*[[FXS接続]]<br />
*[[FXO接続]]<br />
<br />
=== 携帯電話 ===<br />
<br />
*[[Bluetooth接続(chan_mobile)]]<br />
*chan_dongle<br />
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)/USSDに対応。開発は活発ではないけど使える模様。<br />
<br />
===Skype===<br />
*[[Skype for Asterisk]]<br />
:Digiumのプロダクト。ディスコン。<br />
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]<br />
:Skype公式のSIP接続サービス。US$6.95/ch/月<br />
<br />
===FAX===<br />
*[[Fax for Asterisk]]<br />
:Digiumのプロダクト<br />
*spandsp + res_fax_spandsp<br />
:Asterisk13以降。なおapp_faxは非推奨<br />
*IAXModem + Hylafax<br />
<br />
==Asteriskの管理==<br />
*コマンドライン<br />
:[[Asterisk_CLI]]<br />
*[[Asterisk Manager Interface]]<br />
:Asterisk管理インタフェース<br />
*GUI<br />
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。<br><br />
:[[Asterisk-GUI]](純正)<br><br />
:[[Asterisk GUI]]<br><br />
:ADM<br><br />
<br />
==外部プログラムとの連携==<br />
*[[自動発信|コール用ファイル]](call file)<br />
*AGI: Asterisk Gateway Interface<br />
*AMI: Asterisk Manager Interface<br />
*ARI: Asterisk REST Interface<br />
*ダイヤルプランから<br />
:Application_Exec, Function_SHELL, Function_FILE<br />
:Application_ReadFileは非推奨。<br />
<br />
<br />
==IP電話関連機器はどこで買えますか?==<br />
日本国内での入手性も序々に良くなってきました。<br><br />
[[購入情報]] のページを参照してください。<br><br />
<br />
==日本国内対応==<br />
Asteriskを日本国内に対応させる情報は下記を参照してください。<br><br />
===ローカライズ===<br />
*<s>[[Asterisk パッチ]]</s>(現在のバージョンでは必要ありません)<br />
*[[Asterisk 日本語音声]]<br />
*[[音声合成]]<br />
<br />
===接続および使い方===<br />
*[[ひかり電話対応]]<br />
*[[ラインキー問題]]<br />
<br />
<br />
<br />
==書籍==<br />
===日本語===<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)<br />
:1.0ベースのため1.2系は当Wikiでフォローしています。<br><br />
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)<br />
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など<br />
:Asteriskに特化した内容となっています。<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)<br />
:AsteriskNOWによるAsteriskの入門書です。<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]<br />
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]<br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド]<br><br />
:1.2ベースの本のようです。1.2のソースCD付。<br><br />
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド]<br><br />
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。<br><br />
*[https://www.amazon.co.jp/dp/B00B0NJ6I8/takahashitaka-22/ref=nosim Ubuntu 12.04 と EC2で作る Asterisk電話サーバ](kindle)<br />
<br />
===洋書=== <br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony]<br><br />
:こちらも1.0ベースの本。<br><br />
:Asterisk : The Future of Telephony (Asterisk Documentation Project)<br><br />
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。<br><br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)]<br><br />
:2ndエディションで1.4対応だそうです。<br />
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)]<br><br />
:発売日:2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。<br />
*[http://www.amazon.co.jp/dp/B00HQ0RA8M/takahashitaka-22/ref=nosim Asterisk: The Definitive Guide 4th edition]<br />
:Asterisk 11に対応。pjprojectの記述はまだありません。<br />
<br />
==問い合わせ先など==<br />
*[[Asteriskコンサルタント]]<br />
*セミナー/イベントなど<br />
:[[イベント情報]]のページで告知しています。<br />
<br />
==外部リンク==<br />
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。<br />
:Digium http://www.digium.com<br><br />
:Asterisk http://www.asterisk.org<br></div>
Takahashi
https://www.voip-info.jp/index.php?title=%E3%83%A1%E3%82%A4%E3%83%B3%E3%83%9A%E3%83%BC%E3%82%B8&diff=11602
メインページ
2023-11-11T16:56:53Z
<p>Takahashi: /* イベント・セミナー情報 */</p>
<hr />
<div>== '''VoIP-Info.jp Wiki''' ==<br />
このページでは[[Asterisk]]の話題を中心にVoIP関連の情報交換を行なっています。<br><br />
なおこのページは http://www.voip-info.jp http://voip-info.jp のいずれでもアクセスできます。<br><br />
Asterisk PBX、VoIP、IP電話に興味をお持ちの皆様ご参加下さい。<br><br />
<br><br />
Asteriskをビジネスとして扱われている方は[[Asteriskコンサルタント]]のページへ。仕事を依頼したい、仕事として受けたいなど、ビジネスマッチングにお使い下さい。<br><br />
<br><br />
'''SPAM投稿が多いため、ポリシーを変更します。ユーザ登録を行わないと書き込み/編集はできません。'''<br><br />
書き込みを行われる方は、[http://www.voip-info.jp/index.php/%E7%89%B9%E5%88%A5:%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3 ログインまたはアカウント作成]のページから、ユーザ登録を行ってください。<br><br />
(アクセスログ等は取得しています。迷惑行為等に対しては関係各所へ通報いたします。)<br><br />
<br><br />
'''警告''':以前のWikiからもそうでしたが、広告宣伝に情報が埋もれることだけは避けたいので、特定企業への誘導リンク等は適切なページへ貼ってください。[[購入情報]]や[[Asteriskコンサルタント]]のページがそれに相当します。<br><br />
広告出稿をご希望の場合はwebmaster'at'voip-info.jpへメールでお問合せください [[広告]]。<br />
<br><br />
各種ユーザ会関連情報は[[コミュニティ]]のページへ。<br><br />
<br />
=='''Asteriskバージョン'''==<br />
いまだ古いバージョンのAsteriskを使い続けているケースが多く見受けられますが、今後サポートされなくなりますので注意してください。特にSIPチャネルはchan_sipからchan_pjsipへ移行が行われますので注意が必要です。<br />
*Asterisk '''16'''のサポートは終了しました。<br />
*Asterisk '''18'''のサポートは2025/10/20までです。<br />
*Asterisk '''20'''がリリースされました。サポートは2027/10/19までです。chan_sipはDeprecatedになりました。<br />
:https://docs.asterisk.org/About-the-Project/Asterisk-Versions/<br />
<br />
=='''注意したい情報'''==<br />
===テレワーク関連に対する注意喚起===<br />
テレワーク関連で、SIPポートへのアタックが考えられますので注意喚起しておきます。<br />
====影響を受ける環境/状況====<br />
テレワーク環境(家庭等)でSIP対応の電話機、ソフトフォンなどを使用しておりクラウドサービスや、会社のIP-PBXに接続している場合。<br />
====考えられる攻撃====<br />
これまでインターネット上に広まっていたSIPポート(主に5060/udp)に対する攻撃を一般家庭でも受ける可能性があります。<br><br />
現象としては『謎の』着信がある、正体の不明の相手からの通話要求があるが電話に出られない、出ても何も聞こえないなどです。<br />
====攻撃の影響を受ける理由/場合:====<br />
SIP対応の電話機あるいはソフトフォンがローカル(電話機やソフトフォン自体が使用する)のSIPポートとして5060を使用している場合、SIPポートに対するアタックの対象となります。これはAsterisk等のサーバのSIPポートが5060であるかどうかに関係しません。<br><br />
[電話機 5060] <=====> [Asterisk 5060]<br />
一般的にSIPの電話機/ソフトフォン(SIPクライアント)はAsteriskやIP-PBXに対して、自分の「所在」を登録するためREGISTERを行い、通話を開始するためにはINVITEを行います。この際、SIPクライアントが「目がけて行く」先は、AsteriskやIP-PBXの IPアドレス:ポート番号です。ご承知の通り、このポート番号が5060番の場合、インターネット上から攻撃を受けることがよくあり、皆さんもポート番号をずらす、あるいはファイアウォールで防御する等の対策を取られていると思います。ところが昨今のテレワーク環境においては、このAsteriskやIP-PBXのポート番号ではなく、SIP電話機やソフトフォン側のポート番号で、一部の電話機/ソフトフォンでは『ローカルSIPポート』として5060を使うものがあることが知られています。ここで、問題とするのはこのローカルSIPポートです。<br />
====対策:====<br />
不用意な攻撃を受けないようにする方法はいくつかあります。<br />
:; 電話機/ソフトフォンのポート番号をずらす :電話機あるいはソフトフォンの設定で、ローカルSIPポートを5060以外のところにずらしてください。ここで、〇〇番が良い、などと書くとその情報が伝播して攻撃対象となることが考えられますので、『不都合のない適切な』値に設定してください。この対策においては、クライアント側だけ変更すればよく、Asterisk等のサーバ側ポート番号は現在使用しているものから変更する必要は通常ありません。<br />
:; 家庭側でもフィルタ/ファイアウォールを施す :クラウド上のIP-PBXや会社のサーバのIPアドレスが固定、あるいは、ある範囲にある場合ならば、家庭側のルータ等でSIPポート番号に対する『入り』(着信)をそのIPアドレスからのみ許可するようにしてください。<br />
急な対応により、不用意なSIP電話機やソフトフォンも増えているかと思いますので、皆様、お気をつけください。サーバ側の5060ポートに対しては慎重に行動されているかとは思いますが、家庭等に電話機を持っていった場合、5060が開いているかもしれないということを失念されていることがあります。今回、問題としているのは電話機ソフトフォン側のポート番号ですので、注意をお願いします。<br><br />
:当然ですがVPNで会社にトンネルを張ってる場合には関係ありませんので念のため。<br />
<br />
===安直にサーバを立てないでください===<br />
Asteriskの情報に辿り着き、クラウド上等にPBXを構築する場合、ネット上の一般的な情報だけを元に安直にAsteriskサーバを立てるのはやめましょう。インターネット上で開いているサーバには十分なセキュリティを施しておかないと、いわゆる『タダがけ』でやられます。特にSIPの5060ポートに対する攻撃は、あっという間に来ます。[[Asterisk SIP セキュリティ]] のページを参考にして注意して運用してください。<br />
===テレワークの参考情報===<br />
テレビ会議等で、音が『気持ち悪い』ような場合には、ヘッドフォンの片方を耳からはずして、片耳状態で使ってみてください。<br><br />
モノラル音源の場合、音像の定位が頭の中心にきてしまうため気持ち悪く感じるためです。私たちは頭の中心で誰かが喋ることに慣れていません。携帯電話など、電話での会話は片耳で聞くことに慣れているので、テレビ会議でも片耳で聞けば気持ち悪くなくなります。<br><br />
画面上の人物と音の来る方向が一致しないのも『気持ち悪い』原因となりますので、あまり人物を注視しない方が良いでしょう。<br><br />
<br />
===会社の電話(番号)をテレワークでも使いたい===<br />
これは我々の得意とする分野です。お困りの場合には [[コミュニティ]] のページからユーザ会にご参加いただき、案件を投げてもらえれば手を挙げてくれるベンダーさんもいるかと思います。[[Asteriskコンサルタント]] ページも参考にしてください。<br />
<br><br />
<br />
=='''注意喚起'''==<br />
===DNSへのアタックに注意===<br />
DNSへのアタックが多発しています。サーバを運用している方は特にご注意ください。普通のアクセスルータでも、まずいケースがありますのでアクセス回線でも速度がおかしい場合には注意した方がよいかもしれません。<br><br />
ヤマハルータによるこの対策方法をまとめておきました。→ [[DNSamp対策]]<br />
<br />
===SIPポートへの攻撃についてご注意下さい===<br />
SIPポートへの攻撃が流行っているようですので、ご注意下さい。<br><br />
現在多い攻撃は'''SIPのREGISTERを総当たりで試す'''というものです。<br><br />
対策方法等については : '''[[Asterisk SIP セキュリティ]]'''<br><br />
Fail2banによるiptablesでのブロック方法の設定をまとめました : '''[[SIP-Fail2ban]]'''<br><br />
<br />
=='''注目の情報'''==<br />
*[[ABS]] をリリースしました<br />
:軽量なAsteriskベースのPBXをお探しの場合にどうぞ<br />
:キーテレホン挙動もできるのでビジホン用途でも使えます [[ABS]]<br />
*新サンプル設定ファイル<br />
:サンプル設定ファイルの内容を一新し13対応としました。<br />
:[[Asterisk 13 サンプル設定ファイル]]<br />
<br />
*'''Sangoma「が」Digium「を」買収'''<br />
:特設ページ作りました [[Sangoma_Digium]]<br />
<br />
==お願い==<br />
最近、SPAMが増えつつあります。気付いた方は正常なページへの差し戻しまたは削除をお願いします。同一ページが複数回のSPAM書き込みを受けた場合にはページの保護をお願いします。<br />
<br />
==RSSフィードについて==<br />
メインのWikiのRSSフィードは[[%E7%89%B9%E5%88%A5:Recentchanges|最近更新したページ]]のツールボックス(左サイドバーの広告の下)にあります。<br><br />
フォーラム(Google Groups)のRSSフィードは下記です。<br><br />
:https://groups.google.com/forum/feed/asterisk-ug/msgs/rss.xml?num=50<br />
ご利用ください。<br />
<br />
==Wikiの管理者権限==<br />
管理者権限が欲しい人は[[たかはし]]まで、ご連絡ください。<br><br />
Wikiページの書き換えや更新は、ユーザ登録を行っていただければできます。まだ登録されていない方は[[特別:Userlogin|アカウント作成ページ]]からユーザ登録をお願いします。</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11601
Asterisk pjsip parameters
2023-11-11T16:52:48Z
<p>Takahashi: /* ENDPOINT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||Bool||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11600
Asterisk pjsip parameters
2023-11-11T16:49:08Z
<p>Takahashi: /* 各セクションのパラメータ */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11599
Asterisk pjsip parameters
2023-11-11T04:23:23Z
<p>Takahashi: /* ENDPOINT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11598
Asterisk pjsip parameters
2023-11-11T04:22:39Z
<p>Takahashi: /* ENDPOINT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11597
Asterisk pjsip parameters
2023-11-11T04:18:51Z
<p>Takahashi: /* SYSTEM */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
[system]<br><br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11596
Asterisk pjsip parameters
2023-11-10T18:20:42Z
<p>Takahashi: /* CONTACT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます(contact=)。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11595
Asterisk pjsip parameters
2023-11-10T18:19:48Z
<p>Takahashi: /* res_pjsip_config_wizard */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
==CONTACT(res_pjsip)==<br />
CONTACTオブジェクトはSIP URI等を含むもので内部で自動生成されます(pjsip show contacts)。<br><br />
入り側(Asteriskに対しての)REGISTERでAORの情報に基づき生成されますが、固定ピアの場合にはAORの生成時にCONTACTも生成されます。<br><br />
自動生成されるオブジェクトのため手動で設定するものはありません。<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11594
Asterisk pjsip parameters
2023-11-10T18:16:07Z
<p>Takahashi: /* TRANSPORT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT(res_pjsip)==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11593
Asterisk pjsip parameters
2023-11-10T18:15:17Z
<p>Takahashi: /* ENDPOINT(res_pjsip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11592
Asterisk pjsip parameters
2023-11-10T18:13:34Z
<p>Takahashi: /* ENDPOINT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT(res_pjsip)==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11591
Asterisk pjsip parameters
2023-11-10T18:10:15Z
<p>Takahashi: /* DOMAIN_ALIAS */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS(res_pjsip)==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11590
Asterisk pjsip parameters
2023-11-10T18:09:50Z
<p>Takahashi: /* AUTH */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH(res_pjsip)==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11589
Asterisk pjsip parameters
2023-11-10T18:09:22Z
<p>Takahashi: /* AOR */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR(res_pjsip)==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11588
Asterisk pjsip parameters
2023-11-10T18:01:44Z
<p>Takahashi: /* AOR */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||Bool||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11587
Asterisk pjsip parameters
2023-11-10T17:59:53Z
<p>Takahashi: /* GLOBAL */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11586
Asterisk pjsip parameters
2023-11-10T17:43:41Z
<p>Takahashi: /* GLOBAL */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom||global||注:指定できるのはglobal,pjsip_only,none<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11585
Asterisk pjsip parameters
2023-11-10T17:42:16Z
<p>Takahashi: /* GLOBAL */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom<br>(global,<br>pjsip_only,<br>none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11584
Asterisk pjsip parameters
2023-11-10T17:40:47Z
<p>Takahashi: /* 各セクションのパラメータ */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br><br />
参考にしている情報は<br><br />
:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/<br />
ですが、CustomとStringの使い分けがいまひとつわかりません。<br />
<br><br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11583
Asterisk pjsip parameters
2023-11-10T17:38:32Z
<p>Takahashi: /* TRANSPORT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||String||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||String||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||String||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11582
Asterisk pjsip parameters
2023-11-10T17:34:36Z
<p>Takahashi: /* 各セクションのパラメータ */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br><br />
また<br />
[Alice]<br />
type=registration<br />
は"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br />
<br><br />
<b>凡例</b><br><br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11581
Asterisk pjsip parameters
2023-11-10T17:31:38Z
<p>Takahashi: /* CONTACT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11580
Asterisk pjsip parameters
2023-11-10T17:26:46Z
<p>Takahashi: /* REGISTRATION(res_pjsip_outbound_registration) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||-<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-<br />
|-<br />
|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-<br />
|-<br />
|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能<br />
|-<br />
|server_uri||レジストするサーバのSIP URI||String||-||-<br />
|-<br />
|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11579
Asterisk pjsip parameters
2023-11-10T09:22:56Z
<p>Takahashi: /* REGISTRATION(res_pjsip_outbound_registration) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||Custom||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||String||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||String||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11578
Asterisk pjsip parameters
2023-11-10T09:21:54Z
<p>Takahashi: /* REGISTRATION(res_pjsip_outbound_registration) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||String||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||String||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||String||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11577
Asterisk pjsip parameters
2023-11-10T09:20:12Z
<p>Takahashi: /* IDENTIFY(res_pjsip_endpoint_identifier_ip) */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||String||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||String||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11576
Asterisk pjsip parameters
2023-11-10T09:16:00Z
<p>Takahashi: /* AUTH */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||String||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11575
Asterisk pjsip parameters
2023-11-10T09:15:35Z
<p>Takahashi: /* AUTH */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||String||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||String||-||-<br />
|-<br />
|username||ユーザ名||String||-||username=myusername<br />
|}<br />
<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11574
Asterisk pjsip parameters
2023-11-10T09:13:35Z
<p>Takahashi: /* AOR */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||String||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||String||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11573
Asterisk pjsip parameters
2023-11-10T09:12:02Z
<p>Takahashi: /* SYSTEM */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||Uint||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||Uint||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uint||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uint||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uint||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uint||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11572
Asterisk pjsip parameters
2023-11-10T09:10:28Z
<p>Takahashi: /* GLOBAL */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||String||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uint||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uint||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uint||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uint||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||Uint||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uint||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||String||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||Uint||-||-<br />
|-<br />
|mwi_tps_queue_low||-||Int||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||Bool||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||Bool||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(global,pjsip_only,none)||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||Bool||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||Bool||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||Bool||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11571
Asterisk pjsip parameters
2023-11-10T09:00:17Z
<p>Takahashi: /* ENDPOINT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||Custom||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Codec||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||String||-||-<br />
|-<br />
|acl||acl.conf内で定義されたACL名||Custom||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||String||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||Bool||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||Bool||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||Bool||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||Bool||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||Bool||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||Bool||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||String||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||Custom||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||Bool||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||String||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||Custom||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||String||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||Bool||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||Bool||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||Bool||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||Bool||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||Bool||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||uint||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||Bool||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||uint||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||String||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||Bool||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||Bool||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||Bool||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||Bool||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||Bool||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||Custom||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||Custom||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||Custom||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||Custom||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||uint||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||Bool||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||uint||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||Bool||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||uint||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||Bool||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||Bool||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||Bool||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||String||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||String||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||Uint||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||Uint||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||Uint||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||String||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||String||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||Bool||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||Custom||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||Bool||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||uint||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||Custom||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||Bool||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||Bool||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||Bool||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||Uint||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||Uint||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||Bool||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||Bool||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||Bool||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||Bool||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||Bool||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||Bool||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11570
Asterisk pjsip parameters
2023-11-10T08:51:37Z
<p>Takahashi: /* 凡例 */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11569
Asterisk pjsip parameters
2023-11-10T08:34:14Z
<p>Takahashi: /* 凡例 */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。<br><br />
String:任意の文字列が指定できるもの。<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11568
Asterisk pjsip parameters
2023-11-10T08:28:58Z
<p>Takahashi: /* 凡例 */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できないもの。<br><br />
String:任意の文字列<br><br />
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br><br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11567
Asterisk pjsip parameters
2023-11-10T08:21:55Z
<p>Takahashi: /* 凡例 */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードしか指定できないもの。<br><br />
文字列:任意の文字列<br><br />
数値,uint: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。以前のバージョンではuintやdoubleと書かれていた。<br><br />
yes/no: yesかnoで指定するもの。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの(yes/noなのかy/nなのか明確でない。以前のバージョンではBoolとなっていたため)<br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11566
Asterisk pjsip parameters
2023-11-10T08:21:08Z
<p>Takahashi: /* 各セクションのパラメータ */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
==凡例==<br />
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードしか指定できないもの。<br><br />
文字列:任意の文字列<br><br />
数値,uint: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。以前のバージョンではuintと書かれていた。<br><br />
yes/no: yesかnoで指定するもの。<br><br />
Bool:yes/no指定しかできないかy/n指定しかできないもの(yes/noなのかy/nなのか明確でない。以前のバージョンではBoolとなっていたため)<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11565
Asterisk pjsip parameters
2023-11-10T08:15:06Z
<p>Takahashi: /* ENDPOINT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3262を許可||yes/no||yes||-<br />
|-<br />
|aggregate_mwi||MWIの通知をひとつのNOTIFYにまとめる||yes/no||yes||-<br />
|-<br />
|allow||使用を許可するCODEC||Custom||-||allow=ulaw<br />
|-<br />
|allow_overlap||RFC3578オーバーラップダイヤルを有効化||yes/no||yes||-<br />
|-<br />
|aors||このエンドポイントで使用するAOR(s)||文字列||-||-<br />
|-<br />
|auth||このエンドポイントの認証情報のセクション名||文字列||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||文字列||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screend||-<br />
|-<br />
|callerid_tag||このエンドポイントの内部id_tag||文字列||-||-<br />
|-<br />
|context||着信時のダイヤルプランcontext名||文字列||default||-<br />
|-<br />
|direct_media_glare_mitigation||再INVITEグレア時のダイレクトメディア緩和||Custom||none||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|trust_connected_line||コネクテッドラインの更新を受け入れる||yes/no||yes||-<br />
|-<br />
|send_connected_line||コネクテッドラインの更新を送出する||yes/no||yes||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|direct_media||ダイレクトメディアを使用するか||yes/no||yes||-<br />
|-<br />
|disable_direct_media_on_nat||NAT時にダイレクトメディアを無効化するかどうか||yes/no||no||-<br />
|-<br />
|disallow||使用を禁止するCODEC||Custom||-||disallow=ulaw<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||rfc4733||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||Custom||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPセッションをmedia_addressで指定したアドレスで行うかどうか||yes/no||no||-<br />
|-<br />
|force_rport||リターンポートを強制使用する||yes/no||yes||-<br />
|-<br />
|ice_support||NAT時にICEを使用するかどうか||yes/no||no||-<br />
|-<br />
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙||Custom||"username,ip"||-<br />
|-<br />
|redirect_method||リダイレクト時のメソッド||Custom||user||-<br />
|-<br />
|mailboxes||指定されたメールボックスが更新されたらNOTIFYを送る||文字列||-||-<br />
|-<br />
|voicemail_extension||NOTIFY内で送るメールボックスの内線番号||文字列||-||-<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||要求されていないNOTIFYをMWIサブスクライブで置換||yes/no||no||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||yes/no||yes||-<br />
|-<br />
|outbound_auth||発信時に使用する認証情報||文字列||-||-<br />
|-<br />
|outbound_proxy||アウトバウンドプロキシの指定.フルURIで記述||文字列||-||-<br />
|-<br />
|rewrite_contact||ContactヘッダをソースIPアドレスとポートでリライトするかどうか||yes/no||no||-<br />
|-<br />
|rtp_symmetric||RTPを対称にするかどうか||yes/no||no||-<br />
|-<br />
|send_diversion||Diversionヘッダを送出するかどうか||yes/no||yes||-<br />
|-<br />
|send_pai||PAIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|send_rpid||RPIヘッダを送出するかどうか||yes/no||no||-<br />
|-<br />
|rpid_immediate||着信中(非応答)の呼にコネクテッドライン情報を送出するかどうか||yes/no||no||-<br />
|-<br />
|timers_min_se||セッションタイマーの寿命最小値||数値||90||-<br />
|-<br />
|timers||セッションタイマーを使用するかどうか||yes/no||yes||-<br />
|-<br />
|timers_sess_expires||セッションタイマーの寿命最大値||数値||1800||-<br />
|-<br />
|transport||このエンドポイントで使用するトランスポートの明示指定||文字列||-||-<br />
|-<br />
|trust_id_inbound||このエンドポイントで識別情報を受け取る||yes/no||no||-<br />
|-<br />
|trust_id_outbound||このエンドポイントの識別情報を送出する||yes/no||no||-<br />
|-<br />
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?||no||-<br />
|-<br />
|use_avpf||このエンドポイントでAVPFを使う||yes/no||no||-<br />
|-<br />
|media_encryption||メディアの暗号化を行う||yes/no||no||-<br />
|-<br />
|media_encryption_optimistic||このメディアの暗号化を行うが失敗しても失敗として扱わない||yes/no||no||-<br />
|-<br />
|g726_non_standard||標準ではないG.726を使う||yes/no||no||-<br />
|-<br />
|inband_progress||インバンドプログレス(リンギング)を使う||yes/no||no||-<br />
|-<br />
|call_group||ピックアップグループの番号||数値||-||-<br />
|-<br />
|pickup_group||ピックアップ可能なピックアップグループの番号||数値||-||-<br />
|-<br />
|named_call_group||ピックアップグループの名前||文字列||-||-<br />
|-<br />
|named_pickup_group||ピックアップ可能なピックアップグループの名前||文字列||-||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの数に達するとデバイスステータスでBUSYを返す||数値||0(無制限)||-<br />
|-<br />
|t38_udptl||T.38 UDPTLを使用するかどうか||yes/no||no||-<br />
|-<br />
|t38_udptl_ec||T.38 UDPTLのエラー修正方法||Custom||none||-<br />
|-<br />
|t38_udptl_maxdatagram||T.38 UDPTLの最大データグラムサイズ||数値||0||-<br />
|-<br />
|fax_detect||CNGトーン検出を行うか||yes/no||no||-<br />
|-<br />
|fax_detect_timeout||fax_detect実行の無効化までの時間(秒数)||数値(秒数)||0||-<br />
|-<br />
|t38_udptl_nat||UDPTLセッションでのNATの使用||yes/no||no||-<br />
|-<br />
|t38_bind_rtp_to_media_address||UDPTLセッションをこのメディアアドレスで使用する||Custom||no||-<br />
|-<br />
|tone_zone||チャンネルが使用するトーンゾーン(国)||Custom||-||-<br />
|-<br />
|language||このエンドポイントの言語||Custom||-||-<br />
|-<br />
|one_touch_recording||ワンタッチ録音を許可するかどうか||yes/no||no||-<br />
|-<br />
|record_on_feature||ワンタッチ録音開始時に使う機能||Custom||automixmon||-<br />
|-<br />
|record_off_feature||ワンタッチ録音終了時に使う機能||Custom||automixmon||-<br />
|-<br />
|rtp_engine||チャンネルで使用するRTPエンジン||Custom||asterisk||-<br />
|-<br />
|allow_transfer||SIP REFERでの転送を許可するかどうか||yes/no||yes||-<br />
|-<br />
|sdp_owner||SDPのusername部分を指定する文字列||文字列||"""-""(-の文字)"||-<br />
|-<br />
|sdp_session||SDPのセッションs行で使用する文字列||文字列||Asterisk||-<br />
|-<br />
|tos_audio||オーディオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|tos_video||ビデオストリームのDSCP TOSビット||数値||0||-<br />
|-<br />
|cos_audio||オーディオストリームの優先度||数値||0||-<br />
|-<br />
|cos_video||ビデオストリームの優先度||数値||0||-<br />
|-<br />
|allow_subscribe||エンドポイントのsubscribeを許可||yes/no||yes||-<br />
|-<br />
|sub_min_expiry||subscribeの最短寿命時間||数値||0||-<br />
|-<br />
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||文字列||-||-<br />
|-<br />
|mwi_from_user||MWIのNOTIFYで使われるFromのユーザ||文字列||-||-<br />
|-<br />
|from_domain||このエンドポイントに使用されるドメイン||文字列||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を確認するかどうか||yes/no||no||-<br />
|-<br />
|dtls_rekey||TLSセッションとrekeyの再ネゴシエーション間隔||数字||0||-<br />
|-<br />
|dtls_auto_generate_cert||一時的DTLS認証証書の生成を有効にするかどうか||yes/no||no||-<br />
|-<br />
|dtls_cert_file||認証証書のパス||パス文字列||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキーのパス||パス文字列||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化方式||Custom||-||-<br />
|-<br />
|dtls_ca_file||CA証書へのパス||パス文字列||-||-<br />
|-<br />
|dtls_ca_path||CAファイルを含むディレクトリへのパス||パス文字列||-||-<br />
|-<br />
|dtls_setup||DTLS接続の方向||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPに入れるフィンガープリントに使用するハッシュ||Cuatom||(SHA-256)||-<br />
|-<br />
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||yes/no||no||-<br />
|-<br />
|set_var||チャンネルが生成された際に設定するチャネル変数.複数のset_varを列挙することで複数の変数を設定できる||文字列||-||-<br />
|-<br />
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||数値(秒数)||0||-<br />
|-<br />
|rtp_timeout||RTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|rtp_timeout_hold||保留中にRTPが受信されない場合にハングアップするまでの秒数||数値(秒数)||0(無効)||-<br />
|-<br />
|contact_user||このエンドポイントから発信する際のContactヘッダを指定||文字列||-||-<br />
|-<br />
|incoming_call_offer_pref||SDPのCODECオファー順序(着)||Custom||local||-<br />
|-<br />
|outgoing_call_offer_pref||SDPのCODECオファー順序(発)||Custom||remote_merge||-<br />
|-<br />
|preferred_codec_only||優先CODECのみ使用||yes/no||no||-<br />
|-<br />
|asymmetric_rtp_codec||RTPのCODECを非対称で使用するかどうか||yes/no||no||-<br />
|-<br />
|refer_blind_progress||"ブラインド転送時に詳細な情報を送出(Mitel,Aastra,Snomではnoに設定)"||yes/no||yes||-<br />
|-<br />
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||yes/no||no||-<br />
|-<br />
|max_audio_streams||オーディオストリームの最大値||数値||1||-<br />
|-<br />
|max_video_streams||ビデオストリームの最大値||数値||1||-<br />
|-<br />
|webrtc||"yes'に設定すると以下の値を設定する.media_encryptions=dtls.dtls_verify=fingerprint,dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||yes/no||no||-<br />
|-<br />
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||文字列||-||-<br />
|-<br />
|follow_early_media_fork||-||yes/no||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||発信時にUASが前回とは異なるSDP属性で応答するのを許容するかどうか||yes/no||no||-<br />
|-<br />
|suppress_q850_reason_headers||Q.850ヘッダを抑止するかどうか||yes/no||no||-<br />
|-<br />
|ignore_183_without_sdp||SDPを含まない183を転送しない||yes/no||no||-<br />
|-<br />
|stir_shaken||STIR/SHAKENを行う||yes/no||no||-<br />
|-<br />
|stir_shaken_profile||stir_shaken.confで指定されたプロファイルを記述する||Custom||-||-<br />
|-<br />
|allow_unauthenticated_options||認証なしのOPTIONSを受け入れる||yes/no||no||-<br />
|-<br />
|geoloc_incoming_call_profile||着信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|geoloc_outgoing_call_profile||発信時のジオロケーションプロファイル||Custom||-||-<br />
|-<br />
|send_aoc||AOCを送出するかどうか||yes/no||no||-<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi
https://www.voip-info.jp/index.php?title=Asterisk_pjsip_parameters&diff=11564
Asterisk pjsip parameters
2023-11-10T00:33:46Z
<p>Takahashi: /* ENDPOINT */</p>
<hr />
<div>=全般的な注意=<br />
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。<BR><br />
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。<BR><br />
次の例をみてください<br />
[transport-udp]<br />
type = transport<br />
protocol = udp<br />
bind = 0.0.0.0:5070<br />
<br />
[hikari-hgw]<br />
type = registration<br />
transport = transport-udp<br />
outbound_auth = hikari-hgw<br />
server_uri = sip:XXX.XXX.XXX.XXX<br />
client_uri = sip:3@XXX.XXX.XXX.XXX<br />
retry_interval = 60<br />
<br />
[hikari-hgw]<br />
type = endpoint<br />
context = from-hikari-hgw<br />
dtmf_mode = inband<br />
disallow = all<br />
allow = ulaw<br />
direct_media = no<br />
send_pai = yes<br />
inband_progress = yes<br />
from_user = 3<br />
from_domain = XXX.XXX.XXX.XXX<br />
language = ja<br />
outbound_auth = hikari-hgw<br />
aors = hikari-hgw<br />
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR><br />
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。<br />
<br />
=各セクションのパラメータ=<br />
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br><br />
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは<br />
[Alice]<br />
type=endpoint<br />
"Alice"という名前のエンドポイントのセクションという意味になります。<br />
<br />
==GLOBAL==<br />
[grobal]<BR><br />
グローバル設定<BR><br />
type=global<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|max_forwards||SIPのMAXFORWARDERS値||uint||70||-<br />
|-<br />
|user_agent||SIPのUA名||文字列||Asterisk PBX {Version}||-<br />
|-<br />
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||文字列||-||-<br />
|-<br />
|keep_alive_interval||コネクション型で使用されるキープアライブ||数値(秒)||90||-<br />
|-<br />
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||数値(秒)||30||-<br />
|-<br />
|disable_multi_domain||マルチドメインのサポートを無効化する||yes/no||no||-<br />
|-<br />
|endpoint_identifier_order||エンドポイントの判定順序||カンマ区切り文字列||ip,username,anonymous,header,auth_username||-<br />
|-<br />
|debug||デバッグ設定(nまたはIPアドレス)||文字列||n||-<br />
|-<br />
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||数値(秒)||4||-<br />
|-<br />
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||文字列||なし||-<br />
|-<br />
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||文字列||なし||-<br />
|-<br />
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||数値(回数)||5||-<br />
|-<br />
|unidentified_request_period||未識別のリクエストを許容する間隔||数値(秒数)||5||-<br />
|-<br />
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||数値||-||-<br />
|-<br />
|default_from_user||デフォルトのFromユーザ名||文字列||asterisk||-<br />
|-<br />
|default_realm||デフォルトのrealm||文字列||asterisk||-<br />
|-<br />
|mwi_tps_queue_high||-||数値||-||-<br />
|-<br />
|mwi_tps_queue_low||-||数値||-1||-<br />
|-<br />
|mwi_disable_initial_unsolicited||-||yes/no||-||-<br />
|-<br />
|ignore_uri_user_options||SIP URIのuser=を無視するかどうか||yes/no||-||-<br />
|-<br />
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||yes/no||no||-<br />
|-<br />
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||global,pjsip_only,none||global||-<br />
|-<br />
|norefersub||norefersubを送出するかどうか||yes/no||yes||-<br />
|-<br />
|all_codecs_on_empty_reinvite||-||yes/no||no||-<br />
|-<br />
|allow_sending_180_after_183||183の後に180を送るかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==SYSTEM==<br />
type=system<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|timer_t1||T1タイマ値(ミリ秒)||数値(uint)||500||-<br />
|-<br />
|timer_b||タイマB値(ミリ秒||数値(uint)||32000||-<br />
|-<br />
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-<br />
|-<br />
|threadpool_initial_size||PjSIPスレッド・プールの初期数||数値(uint)||0||-<br />
|-<br />
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||数値(uint)||5||-<br />
|-<br />
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||数値(uint)||60||-<br />
|-<br />
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||数値(uint)||0||-<br />
|-<br />
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-<br />
|-<br />
|follow_early_media_fork||-||Bool||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||-||Bool||no||-<br />
|-<br />
|disable_rport||rportを無効にするかどうか||yes/no||no||-<br />
|-<br />
|}<br />
<br />
==ACL(res_pjsip_acl)==<br />
type=acl<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|acl||acl.conf内の名前付ACL名||Custom||-||-<br />
|-<br />
|contact_acl||acl.conf内のContact名前付ACL||Custom||-||-<br />
|-<br />
|contact_deny||拒否するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|contact_permit||許可するSIPヘッダ内のContact||Custom||-||-<br />
|-<br />
|deny||拒否するIPアドレス||Custom||-||deny=192.168.1.0/24<br>deny=0.0.0.0/0.0.0.0<br />
|-<br />
|permit||許可するIPアドレス||Custom||-||permit=192.168.2.0/24<br>permit=192.168.2.1,192.168.2.2<br />
|}<br />
<br />
==AOR==<br />
type=aor<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|authenticate_qualify||Qualifyに認証を使用するかどうか||Bool||no||-<br />
|-<br />
|contact||このAORのコンタクト||Custom||-||-<br />
|-<br />
|default_expiration||このAORを使用する動的コンタクトのexpire時間(秒)||uint||3600||-<br />
|-<br />
|mailboxes||指定されたメールボックスへのSubscribeを許可||文字列||-||-<br />
|-<br />
|max_contacts||このAORに接続可能なコンタクト数||uint||0||-<br />
|-<br />
|maximum_expiration||AORで保持される最大時間(秒)||uint||7200||-<br />
|-<br />
|minimum_expiration||AORの最小キープアライブ時間(秒)||uint||60||-<br />
|-<br />
|outbound_proxy||OPTIONSを送出する際に使用するプロキシ||文字列||-||-<br />
|-<br />
|qualify_frequency||Qualify間隔(秒)||uint||0||-<br />
|-<br />
|qualify_timeout||Qualifyのタイムアウト(秒)||double||3.0||-<br />
|-<br />
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-<br />
|-<br />
|remove_unavailable||-||yes/no||no||-<br />
|-<br />
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-<br />
|-<br />
|voicemail_extension||NOTIFYに含めるメールボックスexten||Custom||-||-<br />
|}<br />
<br />
==AUTH==<br />
type=auth<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_type||認証方式||Custom||userpass|| auth_type=userpass<br />
|-<br />
|md5_cred||認証に使用するMD5ハッシュ||文字列||-||-<br />
|-<br />
|nonce_lifetime||認証のnonce寿命時間||uint||32||-<br />
|-<br />
|password||パスワード||文字列||-||password=mypassword<br />
|-<br />
|realm||エンドポイントのSIPレルム||文字列||-||-<br />
|-<br />
|username||ユーザ名||文字列||-||username=myusername<br />
|}<br />
==CONTACT==<br />
==DOMAIN_ALIAS==<br />
type=domain_alias<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|domain||ドメインのエイリアス||文字列||-||-<br />
|}<br />
<br />
==ENDPOINT==<br />
type=endpoint<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|100rel||RFC3252タグを許可||Custom||yes||-<br />
|-<br />
|accept_multiple_sdp_answers||非100relレスポンスで複数のSDP応答を許||Bool||no||-<br />
|-<br />
|acl||acl.confのセクション名||Custom||-||-<br />
|-<br />
|aggregate_mwi||MWの通知をひとつのNOTIFYにまとめる||Bool||yes||-<br />
|-<br />
|allow||許可するCODEC||Codec||-||allow=ulaw<br>allow=ulaw,gsm<br />
|-<br />
|deny||許可しないCODEC||Codec||-||deny=all<br>deny=alaw<br />
|-<br />
|allow_overlap||RFC3578オーバラップダイヤルを許可||Bool||yes||-<br />
|-<br />
|allow_subscribe||エンドポイントからAsteriskへのサブスクライブ許可||Bool||yes||-<br />
|-<br />
|allow_transfer||エンドポイントのSIP REFERによる転送を許可||Bool||yes||-<br />
|-<br />
|aors||このエンドポイントのAOR||文字列||-||-<br />
|-<br />
|asymmetric_rtp_codec||送受信で異なるCODECの使用を許可||Bool||no||-<br />
|-<br />
|auth||このエンドポイントのauth||文字列||-||-<br />
|-<br />
|bind_rtp_to_media_address||RTPインスタンスをmedia_addressにする||Bool||no||-<br />
|-<br />
|call_group||コールグループ(数値)||Custom||-||-<br />
|-<br />
|callerid||このエンドポイントのCID||Custom||-||-<br />
|-<br />
|callerid_privacy||デフォルトのプライバシーレベル||Custom||allowed_not_screened||-<br />
|-<br />
|callerid_tag||エンドポイントの内部id_tag||Custom||-||-<br />
|-<br />
|connected_line_method||コネクテッドラインのメソッド||Custom||invite||-<br />
|-<br />
|contact_acl||acl.conf内のセクション名(コンタクトACL)||Custom||-||-<br />
|-<br />
|contact_user||||Custom||-||-<br />
|-<br />
|context||ダイヤルプランのcontext||文字列||default||-<br />
|-<br />
|cos_audio||音声のCOS値||uint||0||-<br />
|-<br />
|cos_video||ビデオのCOS値||uint||0||-<br />
|-<br />
|device_state_busy_at||使用中のチャネル数がこの値に達した際にBUSY応答する||uint||0||-<br />
|-<br />
|direct_media||エンドポイント間でのダイレクトメディアを許可||Bool||yes||-<br />
|-<br />
|direct_media_glare_mitigation||-||Custom||-||-<br />
|-<br />
|direct_media_method||ダイレクトメディアのメソッド||Custom||invite||-<br />
|-<br />
|disable_direct_media_on_nat||NAT環境下で使用する場合にはダイレクトメディアを無効化||Bool||no||-<br />
|-<br />
|dtls_ca_file||認証証書(CA)ファイル名へのパス||Custom||-||-<br />
|-<br />
|dtls_ca_path||認証証書(CA)ファイルのあるディレクトリへのパス||Custom||-||-<br />
|-<br />
|dtls_cert_file||現在のピアの認証証書||Custom||-||-<br />
|-<br />
|dtls_cipher||DTLSネゴシエーションで使用する暗号化||Custom||-||-<br />
|-<br />
|dtls_fingerprint||SDPで使用するDTLSフィンガープリントのハッシュ||Custom||-||-<br />
|-<br />
|dtls_private_key||認証証書のプライベートキー||Custom||-||-<br />
|-<br />
|dtls_rekey||TLSセッションとSRTPセッションのrekeyまでの間隔||Custom||0||-<br />
|-<br />
|dtls_setup||接続の方向||Custom||-||-<br />
|-<br />
|dtls_verify||ピアの認証証書を検証するかどうか||Custom||no||-<br />
|-<br />
|dtmf_mode||DTMFモード||Custom||RFC4733||-<br />
|-<br />
|fax_detect||CNGトーン検出||Bool||no||-<br />
|-<br />
|fax_detect_timeout||CNGトーン検出タイムアウト||uint||0||-<br />
|-<br />
|follow_early_media_fork||Toタグが異なっていてもSDPに追従する||bool||no||-<br />
|-<br />
|force_avp||このエンドポイントでAVPを使用するかどうか||Bool||no||-<br />
|-<br />
|force_rport||このエンドポイントでAVP使用を強制するかどうか||Bool||no||-<br />
|-<br />
|from_domain||SIPのfromdomain||文字列||-||-<br />
|-<br />
|from_user||SIPのfromuser||文字列||-||-<br />
|-<br />
|g726_non_standard||G726オーディオ時にAAL2使用を強制||Bool||no||-<br />
|-<br />
|ice_support||NATトラバースにICEを使用||Bool||no||-<br />
|-<br />
|identify_by||エンドポイントの識別方法||Custom||username,ip||-<br />
|-<br />
|inband_progress||Ringingをインバンドで使用するかどうか||Bool||no||-<br />
|-<br />
|incoming_mwi_mailbox||MWI NOTIFYが来た場合に使用するメールボックス||文字列||-||-<br />
|-<br />
|language||このエンドポイントの言語||文字列||-||language=ja<br />
|-<br />
|mailboxes||指定されたメールボックスに変更があった場合エンドポイントにNOTIFY||文字列||-||-<br />
|-<br />
|media_address||SDPのメディアハンドリングで使用するIPアドレス||文字列||-||-<br />
|-<br />
|media_encryption||このエンドポイントでメディア暗号化を使用するかどうか/その方式||Custom||-||-<br />
|-<br />
|media_encryption_optimistic||暗号化に成功しない場合でもセッションを切断しない||Bool||no||-<br />
|-<br />
|media_use_received_transport||廃止済(sip.confとの互換性維持?)||-||-||-<br />
|-<br />
|message_context||廃止済(sip.confとの互換性維持?)||-||-||-<br />
|-<br />
|moh_suggest||デフォルトのMOHクラス||文字列||default||-<br />
|-<br />
|moh_passthrough||-||Bool||yes||-<br />
|-<br />
|mwi_from_user||<br />
|-<br />
|mwi_subscribe_replaces_unsolicited||<br />
|-<br />
|named_call_group||<br />
|-<br />
|named_pickup_group||<br />
|-<br />
|notify_early_inuse_ringing||<br />
|-<br />
|one_touch_recording||<br />
|-<br />
|outbound_auth||<br />
|-<br />
|outbound_proxy||<br />
|-<br />
|pickup_group||<br />
|-<br />
|record_off_feature||<br />
|-<br />
|record_on_feature||<br />
|-<br />
|refer_blind_progress||<br />
|-<br />
|rewrite_contact||<br />
|-<br />
|rpid_immediate||<br />
|-<br />
|rtcp_mux||<br />
|-<br />
|rtp_engine||<br />
|-<br />
|rtp_ipv6||<br />
|-<br />
|rtp_keepalive||<br />
|-<br />
|rtp_symmetric||<br />
|-<br />
|rtp_timeout||<br />
|-<br />
|rtp_timeout_hold||<br />
|-<br />
|sdp_owner||<br />
|-<br />
|sdp_session||<br />
|-<br />
|send_diversion||<br />
|-<br />
|send_pai||<br />
|-<br />
|send_rpid||<br />
|-<br />
|set_var||<br />
|-<br />
|srtp_tag_32||<br />
|-<br />
|sub_min_expiry||<br />
|-<br />
|subscribe_context||<br />
|-<br />
|suppress_q850_reason_headers||<br />
|-<br />
|t38_udptl||<br />
|-<br />
|t38_udptl_ec||<br />
|-<br />
|t38_udptl_ipv6||<br />
|-<br />
|t38_udptl_maxdatagram||<br />
|-<br />
|t38_udptl_nat||<br />
|-<br />
|timers||<br />
|-<br />
|timers_min_se||<br />
|-<br />
|timers_sess_expires||<br />
|-<br />
|tone_zone||<br />
|-<br />
|tos_audio||<br />
|-<br />
|tos_video||<br />
|-<br />
|transport||<br />
|-<br />
|trust_id_inbound||<br />
|-<br />
|trust_id_outbound||<br />
|-<br />
|use_avpf||<br />
|-<br />
|use_ptime||<br />
|-<br />
|user_eq_phone||<br />
|-<br />
|voicemail_extension||<br />
|}<br />
<br />
==IDENTIFY(res_pjsip_endpoint_identifier_ip)==<br />
type=identify<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|endpoint||識別するエンドポイント名||文字列||-||<br />
|-<br />
|match||一致させるIPアドレスまたはネットワーク||Custom||-||match = 192.168.100.1<br />
|-<br />
|match_header||一致させるヘッダ/値のペア||文字列||-||match_header = SIPHeader: 値<br />
|-<br />
|srv_lookups||ホスト名解決にSRV参照を使用するかどうか||Bool||yes||<br />
|}<br />
<br />
==REGISTRATION(res_pjsip_outbound_registration)==<br />
type=registration<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|auth_rejection_permanent||認証失敗時に恒久的失敗として扱う||Bool||yes||<br />
|-<br />
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||文字列||-||<br />
|-<br />
|contact_user||リクエスト内のコンタクトユーザ||文字列||-||<br />
|-<br />
|endpoint||着信時に使用するエンドポイント||文字列||-||line=yes時にしか使えないので注意<br />
|-<br />
|expiration||レジスタのExpire時間||uint||3600||expiration=3600<br />
|-<br />
|fatal_retry_interval||Fatalレスポンスの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|forbidden_retry_interval||403エラーの場合のリトライ間隔(秒)||uint||0||<br />
|-<br />
|line||着信時のcontactにlineを付加するかどうか||Bool||no||<br />
|-<br />
|max_retries||レジスタ試行回数||uint||10||<br />
|-<br />
|server_uri||レジスタ先のサーバURI||文字列||-||<br />
|-<br />
|outbound_auth||このレジスタの認証情報||文字列||-||outbound_auth=セクション名<br />
|-<br />
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列||-||<br />
|-<br />
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||<br />
|-<br />
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||<br />
|-<br />
|transport||このReg.が使用するトランスポート||文字列||-||trabsport=セクション名<br />
<br />
|}<br />
<br />
==TRANSPORT==<br />
type=transport<BR><br />
'''注意:'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。<br />
{| border="1" cellspacing="0"<br />
!項目名!!内容!!種類!!デフォルト!!記述例<br />
|-<br />
|allow_reload||res_pjsipをリロードした際にtransportもリロードするかどうか||Bool||no||-<br />
|-<br />
|async_operations||非同期動作の同時実行数||uint||1||-<br />
|-<br />
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070<br />
|-<br />
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列||-||-<br />
|-<br />
|cos||COS値||uint||0||-<br />
|-<br />
|domain||"入り"方向のドメイン||文字列||-||-<br />
|-<br />
|external_media_address||RTPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列||-||-<br />
|-<br />
|external_signaling_port||SIPの外部ポート番号||uint||0||-<br />
|-<br />
|local_net||NATを使用する場合にローカルとして扱うアドレス||Custom||-||-<br />
|-<br />
|method||SSLトランスポートのメソッド||Custom||-||-<br />
|-<br />
|password||トランスポートに必要とされるパスワード||文字列||-||-<br />
|-<br />
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|protocol||このトランスポートが使用するプロトコル(TLSのみWSSは非対象)||Custom||udp||protocol=udp<br />
|-<br />
|require_client_cert||クライアント認証証書が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-<br />
|-<br />
|tos||TOS値||Custom||0||-||-<br />
|-<br />
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-<br />
|-<br />
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||100||-||-<br />
<br />
|}<br />
<br />
=res_pjsip_config_wizard=<br />
ファイル: pjsip_wizard.conf<br><br />
*[[Asterisk_pjsip#Wizard]]</div>
Takahashi