Asterisk pjsip parameters
提供: VoIP-Info.jp
目次
全般的な注意
省略時のデフォルトが明確でない部分もあるので注意してください。安全のためには明示指定すべきです。
例えば、いくつかのセクションで transport= が指定できますが、これが省略された場合には「最初のtype=transportで指定された」トランスポートが使用されます。明示指定せずとも動作しますが、別なトランスポートを定義し、それが以前のものよりも前に来るように書いてしまうと挙動が変わってしまうということになります。
次の例をみてください
[transport-udp] type = transport protocol = udp bind = 0.0.0.0:5070 [hikari-hgw] type = registration transport = transport-udp outbound_auth = hikari-hgw server_uri = sip:XXX.XXX.XXX.XXX client_uri = sip:3@XXX.XXX.XXX.XXX retry_interval = 60 [hikari-hgw] type = endpoint context = from-hikari-hgw dtmf_mode = inband disallow = all allow = ulaw direct_media = no send_pai = yes inband_progress = yes from_user = 3 from_domain = XXX.XXX.XXX.XXX language = ja outbound_auth = hikari-hgw aors = hikari-hgw
Registerのセクションにはtransport-udpが指定されていますが、endpointのセクションにはtransportが指定されていません。
ですがtransportセクションとしてtransport-udpが定義されているので、省略時にはこれが用いられます。
res_pjsip
GLOBAL
[grobal]
グローバル設定
type=global
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
max_forwards | SIPのMAXFORWARDERS値 | uint | 70 | - |
user_agent | SIPのUA名 | 文字列 | Asterisk PBX {Version} | - |
default_outbound_endpoint | デフォルトで使用するエンドポイント(発信) | 文字列 | - | - |
keep_alive_interval | コネクション型で使用されるキープアライブ | 数値(秒) | 90 | - |
contact_expiration_check_interval | 期限切れコンタクトを無効にするまでの時間 | 数値(秒) | 30 | - |
disable_multi_domain | マルチドメインのサポートを無効化する | yes/no | no | - |
endpoint_identifier_order | エンドポイントの判定順序 | カンマ区切り文字列 | ip,username,anonymous,header,auth_username | - |
debug | デバッグ設定(nまたはIPアドレス) | 文字列 | n | - |
max_initial_qualify_time | 起動から初期Qualify(全AOR)までの秒数 | 数値(秒) | 4 | - |
regcontext | レジストしてくるエンドポイントにPriority 1のNoOpをエンドポイント名で作成するcontextを指定 | 文字列 | なし | - |
default_voicemail_extension | AORで指定されていない場合にNOTIFYで使用されるボイスメールのexten | 文字列 | なし | - |
unidentified_request_count | あるIPアドレスからの未識別のリクエストを何回まで許容するか | 数値(回数) | 5 | - |
unidentified_request_period | 未識別のリクエストを許容する間隔 | 数値(秒数) | 5 | - |
unidentified_request_prune_interval | 未識別のリクエストを隔離する間隔 | 数値 | - | - |
default_from_use | デフォルトのFromユーザ名 | 文字列 | asterisk | - |
default_realm | デフォルトのrealm | 文字列 | asterisk | - |
mwi_tps_queue_high | - | 数値 | - | - |
mwi_tps_queue_low | - | 数値 | -1 | - |
mwi_disable_initial_unsolicited | - | yes/no | - | - |
ignore_uri_user_options | SIP URIのuser=を無視するかどうか | yes/no | - | - |
send_contact_status_on_update_registration | デバイスがレジストを更新した際にAMIイベントを送出するかどうか | yes/no | no | - |
taskprocessor_overload_trigge | タスクプロセッサの過負荷検出要因 | global,pjsip_only,none | global | - |
norefersub | norefersubを送出するかどうか | yes/no | yes | - |
all_codecs_on_empty_reinvite | - | yes/no | no | - |
allow_sending_180_after_183 | 183の後に180を送るかどうか | yes/no | no | - |
SYSTEM
type=system
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
timer_t1 | T1タイマ値(ミリ秒) | uint | 500 | - |
timer_b | タイマB値(ミリ秒 | uint | 32000 | - |
compact_headers | コンパクトヘッダを使用するかどうか | Bool | n | - |
threadpool_initial_size | PjSIPスレッド・プールの初期数 | uint | 0 | - |
threadpool_auto_increment | 必要になった際にスレッドを増加させる数 | uint | 5 | - |
threadpool_idle_timeout | 使用されなくなったスレッドを破棄するまでの時間(秒) | uint | 60 | - |
threadpool_max_size | PjSIPが使用するスレッドの最大数(0は無制限) | uint | 0 | - |
disable_tcp_switch | UDPからTCPへの自動切り替えを禁止するかどうか | Bool | n | - |
follow_early_media_fork | - | Bool | yes | - |
accept_multiple_sdp_answers | - | Bool | no | - |
disable_rport | rportを無効にするかどうか | yes/no | no | - |
ACL(res_pjsip_acl)
type=acl
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
acl | acl.conf内の名前付ACL名 | Custom | - | - |
contact_acl | acl.conf内のContact名前付ACL | Custom | - | - |
contact_deny | 拒否するSIPヘッダ内のContact | Custom | - | - |
contact_permit | 許可するSIPヘッダ内のContact | Custom | - | - |
deny | 拒否するIPアドレス | Custom | - | deny=192.168.1.0/24 deny=0.0.0.0/0.0.0.0 |
permit | 許可するIPアドレス | Custom | - | permit=192.168.2.0/24 permit=192.168.2.1,192.168.2.2 |
AOR
type=aor
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
authenticate_qualify | Qualifyに認証を使用するかどうか | Bool | no | - |
contact | このAORのコンタクト | Custom | - | - |
default_expiration | このAORを使用する動的コンタクトのexpire時間(秒) | uint | 3600 | - |
mailboxes | 指定されたメールボックスへのSubscribeを許可 | 文字列 | - | - |
max_contacts | このAORに接続可能なコンタクト数 | uint | 0 | - |
maximum_expiration | AORで保持される最大時間(秒) | uint | 7200 | - |
minimum_expiration | AORの最小キープアライブ時間(秒) | uint | 60 | - |
outbound_proxy | OPTIONSを送出する際に使用するプロキシ | 文字列 | - | - |
qualify_frequency | Qualify間隔(秒) | uint | 0 | - |
qualify_timeout | Qualifyのタイムアウト(秒) | double | 3.0 | - |
remove_existing | 既存のコンタクトを新しいもので上書きするかどうか | Bool | no | - |
remove_unavailable | - | yes/no | no | - |
support_path | REGISTERリクエストのPathサポートを有効にするかどうか | Bool | no | - |
voicemail_extension | NOTIFYに含めるメールボックスexten | Custom | - | - |
AUTH
type=auth
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
auth_type | 認証方式 | Custom | userpass | auth_type=userpass |
md5_cred | 認証に使用するMD5ハッシュ | 文字列 | - | - |
nonce_lifetime | 認証のnonce寿命時間 | uint | 32 | - |
password | パスワード | 文字列 | - | password=mypassword |
realm | エンドポイントのSIPレルム | 文字列 | - | - |
username | ユーザ名 | 文字列 | - | username=myusername |
CONTACT
DOMAIN_ALIAS
type=domain_alias
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
domain | ドメインのエイリアス | 文字列 | - | - |
ENDPOINT
type=endpoint
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
100rel | RFC3252タグを許可 | Custom | yes | - |
accept_multiple_sdp_answers | 非100relレスポンスで複数のSDP応答を許 | Bool | no | - |
acl | acl.confのセクション名 | Custom | - | - |
aggregate_mwi | MWの通知をひとつのNOTIFYにまとめる | Bool | yes | - |
allow | 許可するCODEC | Codec | - | allow=ulaw allow=ulaw,gsm |
deny | 許可しないCODEC | Codec | - | deny=all deny=alaw |
allow_overlap | RFC3578オーバラップダイヤルを許可 | Bool | yes | - |
allow_subscribe | エンドポイントからAsteriskへのサブスクライブ許可 | Bool | yes | - |
allow_transfer | エンドポイントのSIP REFERによる転送を許可 | Bool | yes | - |
aors | このエンドポイントのAOR | 文字列 | - | - |
asymmetric_rtp_codec | 送受信で異なるCODECの使用を許可 | Bool | no | - |
auth | このエンドポイントのauth | 文字列 | - | - |
bind_rtp_to_media_address | RTPインスタンスをmedia_addressにする | Bool | no | - |
call_group | コールグループ(数値) | Custom | - | - |
callerid | このエンドポイントのCID | Custom | - | - |
callerid_privacy | デフォルトのプライバシーレベル | Custom | allowed_not_screened | - |
callerid_tag | エンドポイントの内部id_tag | Custom | - | - |
connected_line_method | コネクテッドラインのメソッド | Custom | invite | - |
contact_acl | acl.conf内のセクション名(コンタクトACL) | Custom | - | - |
contact_user | Custom | - | - | |
context | ダイヤルプランのcontext | 文字列 | default | - |
cos_audio | 音声のCOS値 | uint | 0 | - |
cos_video | ビデオのCOS値 | uint | 0 | - |
device_state_busy_at | 使用中のチャネル数がこの値に達した際にBUSY応答する | uint | 0 | - |
direct_media | エンドポイント間でのダイレクトメディアを許可 | Bool | yes | - |
direct_media_glare_mitigation | - | Custom | - | - |
direct_media_method | ダイレクトメディアのメソッド | Custom | invite | - |
disable_direct_media_on_nat | NAT環境下で使用する場合にはダイレクトメディアを無効化 | Bool | no | - |
dtls_ca_file | 認証証書(CA)ファイル名へのパス | Custom | - | - |
dtls_ca_path | 認証証書(CA)ファイルのあるディレクトリへのパス | Custom | - | - |
dtls_cert_file | 現在のピアの認証証書 | Custom | - | - |
dtls_cipher | DTLSネゴシエーションで使用する暗号化 | Custom | - | - |
dtls_fingerprint | SDPで使用するDTLSフィンガープリントのハッシュ | Custom | - | - |
dtls_private_key | 認証証書のプライベートキー | Custom | - | - |
dtls_rekey | TLSセッションとSRTPセッションのrekeyまでの間隔 | Custom | 0 | - |
dtls_setup | 接続の方向 | Custom | - | - |
dtls_verify | ピアの認証証書を検証するかどうか | Custom | no | - |
dtmf_mode | DTMFモード | Custom | RFC4733 | - |
fax_detect | CNGトーン検出 | Bool | no | - |
fax_detect_timeout | CNGトーン検出タイムアウト | uint | 0 | - |
follow_early_media_fork | Toタグが異なっていてもSDPに追従する | bool | no | - |
force_avp | このエンドポイントでAVPを使用するかどうか | Bool | no | - |
force_rport | このエンドポイントでAVP使用を強制するかどうか | Bool | no | - |
from_domain | SIPのfromdomain | 文字列 | - | - |
from_user | SIPのfromuser | 文字列 | - | - |
g726_non_standard | G726オーディオ時にAAL2使用を強制 | Bool | no | - |
ice_support | NATトラバースにICEを使用 | Bool | no | - |
identify_by | エンドポイントの識別方法 | Custom | username,ip | - |
inband_progress | Ringingをインバンドで使用するかどうか | Bool | no | - |
incoming_mwi_mailbox | MWI NOTIFYが来た場合に使用するメールボックス | 文字列 | - | - |
language | このエンドポイントの言語 | 文字列 | - | language=ja |
mailboxes | 指定されたメールボックスに変更があった場合エンドポイントにNOTIFY | 文字列 | - | - |
media_address | SDPのメディアハンドリングで使用するIPアドレス | 文字列 | - | - |
media_encryption | このエンドポイントでメディア暗号化を使用するかどうか/その方式 | Custom | - | - |
media_encryption_optimistic | 暗号化に成功しない場合でもセッションを切断しない | Bool | no | - |
media_use_received_transport | ||||
message_context | ||||
moh_suggest | ||||
mwi_from_user | ||||
mwi_subscribe_replaces_unsolicited | ||||
named_call_group | ||||
named_pickup_group | ||||
notify_early_inuse_ringing | ||||
one_touch_recording | ||||
outbound_auth | ||||
outbound_proxy | ||||
pickup_group | ||||
record_off_feature | ||||
record_on_feature | ||||
refer_blind_progress | ||||
rewrite_contact | ||||
rpid_immediate | ||||
rtcp_mux | ||||
rtp_engine | ||||
rtp_ipv6 | ||||
rtp_keepalive | ||||
rtp_symmetric | ||||
rtp_timeout | ||||
rtp_timeout_hold | ||||
sdp_owner | ||||
sdp_session | ||||
send_diversion | ||||
send_pai | ||||
send_rpid | ||||
set_var | ||||
srtp_tag_32 | ||||
sub_min_expiry | ||||
subscribe_context | ||||
suppress_q850_reason_headers | ||||
t38_udptl | ||||
t38_udptl_ec | ||||
t38_udptl_ipv6 | ||||
t38_udptl_maxdatagram | ||||
t38_udptl_nat | ||||
timers | ||||
timers_min_se | ||||
timers_sess_expires | ||||
tone_zone | ||||
tos_audio | ||||
tos_video | ||||
transport | ||||
trust_id_inbound | ||||
trust_id_outbound | ||||
use_avpf | ||||
use_ptime | ||||
user_eq_phone | ||||
voicemail_extension |
IDENTIFY(res_pjsip_endpoint_identifier_ip)
type=identify
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
endpoint | 識別するエンドポイント名 | 文字列 | - | |
match | 一致させるIPアドレスまたはネットワーク | Custom | - | match = 192.168.100.1 |
match_header | 一致させるヘッダ/値のペア | 文字列 | - | match_header = SIPHeader: 値 |
srv_lookups | ホスト名解決にSRV参照を使用するかどうか | Bool | yes |
REGISTRATION(res_pjsip_outbound_registration)
type=registration
項目名 | 内容 | 種類 | デフォルト | 記述例 |
---|---|---|---|---|
auth_rejection_permanent | 認証失敗時に恒久的失敗として扱う | Bool | yes | |
client_uri | アウトバウンドレジスト時に使用するクライアントのSIP URI | 文字列 | - | |
contact_user | リクエスト内のコンタクトユーザ | 文字列 | - | |
endpoint | 着信時に使用するエンドポイント | 文字列 | - | line=yes時にしか使えないので注意 |
expiration | レジスタのExpire時間 | uint | 3600 | expiration=3600 |
fatal_retry_interval | Fatalレスポンスの場合のリトライ間隔(秒) | uint | 0 | |
forbidden_retry_interval | 403エラーの場合のリトライ間隔(秒) | uint | 0 | |
line | 着信時のcontactにlineを付加するかどうか | Bool | no | |
max_retries | レジスタ試行回数 | uint | 10 | |
server_uri | レジスタ先のサーバURI | 文字列 | - | |
outbound_auth | このレジスタの認証情報 | 文字列 | - | outbound_auth=セクション名 |
outbound_proxy | レジスタ先のアウトバウンドproxyのFull SIP URI | 文字列 | - | |
retry_interval | レジスタ失敗時の再試行間隔(秒) | uint | 60 | |
support_path | レジスタ時のPATHサポートの有効無効 | Bool | no | |
transport | このReg.が使用するトランスポート | 文字列 | - | trabsport=セクション名 |
TRANSPORT
type=transport
注意:transportの設定変更は通常、res_pjsip.soモジュールのリロードでは反映されません。Asteriskを再起動する必要があります。res_pjsipのリロードでtransportもリロードするにはallow_reload = yesを設定する必要があります。
項目名 | 内容 | 種類 | デフォルト | 記述例 | |
---|---|---|---|---|---|
allow_reload | res_pjsipをリロードした際にtransportもリロードするかどうか | Bool | no | - | |
async_operations | 非同期動作の同時実行数 | uint | 1 | - | |
bind | このトランスポートがbindするアドレスとポート | Custom | - | bind=0.0.0.0:5070 | |
ca_list_file | 読み込む認証証書のリストが入っているファイル(TLSのみWSSは非対象) | 文字列 | - | - | |
ca_list_path | 読み込む認証証書のリストが入っているファイルへのパス(TLSのみWSSは非対象) | 文字列 | - | - | |
cert_file | エンドポイントの認証証書(TLSのみWSSは非対象) | 文字列 | - | - | |
cipher | 優先する暗号化方式(TLSのみWSSは非対象) | 文字列 | - | - | |
cos | COS値 | uint | 0 | - | |
domain | "入り"方向のドメイン | 文字列 | - | - | |
external_media_address | RTPを扱う際の外部IPアドレス | 文字列 | - | - | |
external_signaling_address | SIPを扱う際の外部IPアドレス | 文字列 | - | - | |
external_signaling_port | SIPの外部ポート番号 | uint | 0 | - | |
local_net | NATを使用する場合にローカルとして扱うアドレス | Custom | - | - | |
method | SSLトランスポートのメソッド | Custom | - | - | |
password | トランスポートに必要とされるパスワード | 文字列 | - | - | |
priv_key_file | プライベートキーファイル(TLSのみWSSは非対象) | Custom | - | - | |
protocol | このトランスポートが使用するプロトコル(TLSのみWSSは非対象) | Custom | udp | protocol=udp | |
require_client_cert | クライアント認証証書が必要(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接続のタイムアウト(ミリ秒) | 100 | - | - |
res_pjsip_config_wizard
ファイル: pjsip_wizard.conf