4,174
回編集
差分
→TRANSPORT(res_pjsip)
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。<BR>
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。
==res_pjproject==
PjSIPの基本となるモジュール。それ自体の設定ファイルはpjproject.conf。チャネルドライバ(chan_pjsip)等の機能もres_pjprojectで提供されているが、SIPのエンドポイント設定等はpjsip.confファイルで行う。
===pjproject.conf===
pjprojectの共通設定ファイル。<br>
このファイルが存在しなくともchan_pjsip等は動作する。デフォルト値で通常動作は問題ないため。設定項目を変更したい、例えばAsteriskのログに出したいpjprojectのログレベルを変更したような場合にはこのファイルを使用する。
====[startup]====
type=startupの記述はあるがセクション名も"[startup]"とする必要がある。
{| border="1" cellspacing="0"
!項目名!!内容!!種類!!デフォルト!!記述例
|-
|cache_pools||pjprojectのメモリプールをキャッシュする||Bool||yes||-
|-
|log_level||内部のログレベル(0-6,default)||-||2||-
|-
|}
====[log_mappings]====
type=log_mappingsもセクション名を"[log_mappings]"とする必要がある。<br>
ログのレベルは次の通り<br>
- 0: 致命的なエラー<br>
- 1: エラー<br>
- 2: 警告<br>
- 3: 情報<br>
- 4: デバッグ<br>
- 5: トレース<br>
- 6: より詳細なトレース<br>
{| border="1" cellspacing="0"
!項目名!!内容!!種類!!デフォルト!!記述例
|-
|asterisk_error||Asterisk errorにマップするpjprojectのerror(カンマ区切り)||0～6||0,1||-
|-
|asterisk_warning||Asterisk warningにマップするpjprojectのerror(カンマ区切り)||0～6||2||-
|-
|asterisk_notice||Asterisk noticeにマップするpjprojectのerror(カンマ区切り)||0～6||-||-
|-
|asterisk_verbose||Asterisk verboseにマップするpjprojectのerror(カンマ区切り)||0～6||-||-
|-
|asterisk_debug||Asterisk debugにマップするpjprojectのerror(カンマ区切り)||0～6||3,4||-
|-
|asterisk_trace||Asterisk traceにマップするpjprojectのerror(カンマ区切り)||0～6||5,6||-
|-
|}
=各セクションのパラメータ(pjsip.conf)=
各セクションはtype=で区別されます。例えば[global]はセクション名ですが、type=globalを指定する必要があります。globalやsystemの設定はそのままセクションにglobal,systemと書くのが良いでしょう。<br>
エンドポイントやAOR等はそれぞれの名前を使いますので例えば次のようなケースは
[Alice]
type=endpoint
"Alice"という名前のエンドポイントのセクションという意味になります。<br>また [Alice] type==registrationは"Alice"が外に対してREGISTERするための情報のセクションという意味になります。<br><br><b>凡例==</b><br>
Custom:指定に制限のある文字列。CODEC指定等でulaw,alawとか決まったワードやフレーズしか指定できない、あるいは設定ファイル内のセクションを指定するものなど。数字指定でもCustomになっているものもあり。<br>
String:任意の文字列が指定できるもの。<br>
uint,double: 数値を指定するもの。カッコ内で単位が書いてあるものはその単位。<br>
Bool:yes/no指定しかできないかy/n指定しかできないもの。<br>
<br>参考にしている情報は<br>:https://docs.asterisk.org/Configuration/Channel-Drivers/SIP/Configuring-res_pjsip/ですが、CustomとStringの使い分けがいまひとつわかりません。<br>
==GLOBAL==
[grobal]<BR>
|default_outbound_endpoint||デフォルトで使用するエンドポイント(発信)||String||-||-
|-
|keep_alive_interval||コネクション型で使用されるキープアライブ||Uintuint||90||-
|-
|contact_expiration_check_interval||期限切れコンタクトを無効にするまでの時間||Uintuint||30||-
|-
|disable_multi_domain||マルチドメインのサポートを無効化する||Bool||no||-
|-
|endpoint_identifier_order||エンドポイントの判定順序||String||ip,<br>username,<br>anonymous,<br>header,<br>auth_username<br>(の順)||-
|-
|debug||デバッグ設定(nまたはIPアドレス)||String||n||-
|-
|max_initial_qualify_time||起動から初期Qualify(全AOR)までの秒数||Uintuint||4||-
|-
|regcontext||レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定||String||なし||-
|default_voicemail_extension||AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten||String||なし||-
|-
|unidentified_request_count||あるIPアドレスからの未識別のリクエストを何回まで許容するか||Uintuint||5||-
|-
|unidentified_request_period||未識別のリクエストを許容する間隔||Uintuint||5||-
|-
|unidentified_request_prune_interval||未識別のリクエストを隔離する間隔||Uintuint||-||-
|-
|default_from_user||デフォルトのFromユーザ名||String||asterisk||-
|default_realm||デフォルトのrealm||String||asterisk||-
|-
|mwi_tps_queue_high||-||Uintuint||-||-
|-
|mwi_tps_queue_low||-||Int||-1||-
|send_contact_status_on_update_registration||デバイスがレジストを更新した際にAMIイベントを送出するかどうか||Bool||no||-
|-
|taskprocessor_overload_trigge||タスクプロセッサの過負荷検出要因||Custom(||global||注:指定できるのはglobal,pjsip_only,none)||global||-
|-
|norefersub||norefersubを送出するかどうか||Bool||yes||-
==SYSTEM==
[system]<br>
type=system
{| border="1" cellspacing="0"
!項目名!!内容!!種類!!デフォルト!!記述例
|-
|timer_t1||T1タイマ値(ミリ秒)||Uintuint||500||-
|-
|timer_b||タイマB値(ミリ秒||Uintuint||32000||-
|-
|compact_headers||コンパクトヘッダを使用するかどうか||Bool||n||-
|-
|threadpool_initial_size||PjSIPスレッド・プールの初期数||Uintuint||0||-
|-
|threadpool_auto_increment||必要になった際にスレッドを増加させる数||Uintuint||5||-
|-
|threadpool_idle_timeout||使用されなくなったスレッドを破棄するまでの時間(秒)||Uintuint||60||-
|-
|threadpool_max_size||PjSIPが使用するスレッドの最大数(0は無制限)||Uintuint||0||-
|-
|disable_tcp_switch||UDPからTCPへの自動切り替えを禁止するかどうか||Bool||n||-
|}
==AOR(res_pjsip)==
type=aor
{| border="1" cellspacing="0"
|remove_existing||既存のコンタクトを新しいもので上書きするかどうか||Bool||no||-
|-
|remove_unavailable||-||yes/noBool||no||-
|-
|support_path||REGISTERリクエストのPathサポートを有効にするかどうか||Bool||no||-
|}
==AUTH(res_pjsip)==
type=auth
{| border="1" cellspacing="0"
|}
type=domain_alias
{| border="1" cellspacing="0"
|}
==ENDPOINT(res_pjsip)==
type=endpoint
{| border="1" cellspacing="0"
|ice_support||NAT時にICEを使用するかどうか||Bool||no||-
|-
|identify_by||このエンドポイント識別に使用する情報をカンマ区切りれ列挙このエンドポイント識別に使用する情報をカンマ区切りで列挙||Custom||"username,ip"||-
|-
|redirect_method||リダイレクト時のメソッド||Custom||user||-
|trust_id_outbound||このエンドポイントの識別情報を送出する||Bool||no||-
|-
|use_ptime||エンドポイントのsリクエストのパケット化間隔||?Bool||no||-
|-
|use_avpf||このエンドポイントでAVPFを使う||Bool||no||-
|tos_video||ビデオストリームのDSCP TOSビット||Custom||0||-
|-
|cos_audio||オーディオストリームの優先度||Uintuint||0||-
|-
|cos_video||ビデオストリームの優先度||Uintuint||0||-
|-
|allow_subscribe||エンドポイントのsubscribeを許可||Bool||yes||-
|-
|sub_min_expiry||subscribeの最短寿命時間||Uintuint||0||-
|-
|from_user||このエンドポイントに使用されるFromヘッダのユーザ名||Custom||-||-
|srtp_tag_32||80バイトではなく32バイトタグを使うかどうか||Bool||no||-
|-
|set_var||チャンネルが生成された際に設定するチャネル変数.<br>複数のset_varを列挙することで複数の変数を設定できる||Custom||-||-
|-
|rtp_keepalive||RTPが流れていない場合にコンフォートノイズのRTPを流す間隔||uint||0||-
|notify_early_inuse_ringing||dialog-infoのearlyでINUSEとRINGINGを通知||Bool||no||-
|-
|max_audio_streams||オーディオストリームの最大値||Uintuint||1||-
|-
|max_video_streams||ビデオストリームの最大値||Uintuint||1||-
|-
|webrtc||"yes'に設定すると以下の値を設定する.<br>media_encryptions=dtls.dtls_verify=fingerprint,<br>dtls_setup=actpass.dtls_cert_fileとdtls_ca_fileは明示指定する必要あり."||Bool||no||-
|-
|incoming_mwi_mailbox||入りのMWI NOTIFYのメールボックス名||String||-||-
|-
|client_uri||アウトバウンドレジスト時に使用するクライアントのSIP URI||String||-||
|-
|contact_header_params||Contactヘッダに入れるパラメータ||String||-||-
|-
|contact_user||リクエスト内のコンタクトユーザ||String||-||
|-
|line||着信時のcontactにlineを付加するかどうか||Bool||no||
|-
|max_random_initial_delay||初期REGISTERでランダムに遅延させる最大の秒数||uint||10||-
|-
|max_retries||レジスタ試行回数||uint||10||
|server_uri||レジスタ先のサーバURI||String||-||
|-
|outbound_auth||このレジスタの認証情報||文字列Custom||-||outbound_auth=セクション名
|-
|outbound_proxy||レジスタ先のアウトバウンドproxyのFull SIP URI||文字列String||-||-
|-
|retry_interval||レジスタ失敗時の再試行間隔(秒)||uint||60||-|-|security_mechanisms||サポートされるセキュリティメカニズムのリスト||Custom||no||-|-|security_negotiation||セキュリティネゴシエーションで使用するメカニズム||Custom||no||注:現在のところmediasecのみ指定可能|-|server_uri||レジストするサーバのSIP URI||String||-||-|-|support_outbound||SIP Outbound Support(RFC5626)のアドバタイズを有効にするかどうか||Bool||no||-
|-
|support_path||レジスタ時のPATHサポートの有効無効||Bool||no||
|-
|transport||このReg.が使用するトランスポート||文字列String||-||trabsport=セクション名
|}
==TRANSPORT(res_pjsip)==
type=transport<BR>
'''注意：'''transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。
||bind||このトランスポートがbindするアドレスとポート||Custom||-||bind=0.0.0.0:5070
|-
||ca_list_file||読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象)||文字列Custom||-||-
|-
|ca_list_path||読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象)||文字列Custom||-||-
|-
|cert_file||エンドポイントの認証証書(TLSのみWSSは非対象)||文字列Custom||-||-
|-
|cipher||優先する暗号化方式(TLSのみWSSは非対象)||文字列Custom||-||-
|-
|cos||COS値||uint||0||-
|-
|domain||"入り"方向のドメイン||文字列String||-||-
|-
|external_media_address||RTPを扱う際の外部IPアドレス||文字列String||-||-
|-
|external_signaling_address||SIPを扱う際の外部IPアドレス||文字列String||-||-
|-
|external_signaling_port||SIPの外部ポート番号||uint||0||-
|method||SSLトランスポートのメソッド||Custom||-||-
|-
|password||トランスポートに必要とされるパスワード||文字列String||-||-
|-
|priv_key_file||プライベートキーファイル(TLSのみWSSは非対象)||Custom||-||-
|symmetric_transport||入出力双方で同じトランポートを使用するかどうか||Bool||no||-
|-
|tos||TOS値||Custom||0||-||-
|-
|verify_client||クライアント認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-
|verify_server||サーバ認証証書の確認が必要(TLSのみWSSは非対象)||Custom||-||-
|-
|websocket_write_timeout||WebSocket接続のタイムアウト(ミリ秒)||int||100||-||-}
=res_pjsip_config_wizard=
ファイル: pjsip_wizard.conf<br>
*[[Asterisk_pjsip#Wizard]]
