VoIP-Info.jp - 利用者の投稿記録 [ja]

利用者:ふじかわ/test

2018-10-27T21:11:07Z

ふじかわ:

CLIが0から始まるときに81をつける 
extensions.conf
same = n,Set(CALLERID(all)=${IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):1}:${CALLERID(num)})})
または
same = n,Set(CALLERID(num)=${IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):1}:${CALLERID(num)})})
same = n,Set(CALLERID(name)=${CALLERID(num)})

IPアドレスが決まっている2台のAsteriskをIAX2でシンプルに接続

host1 (IP: 10.10.10.1)のiax.conf

[general]
bindport=4569 ;デフォルトインターネット環境では変更すると攻撃を回避できるかも
;bindaddr=10.10.10.1 ;指定しないと全てのアドレスにバインド
iaxcompat=yes
language=en
bandwidth=medium
disallow=all
allow=ulaw
allow=gsm
jitterbuffer=no

[host2]
type=friend
secret=EKWfVd47p7n4 ;2台同じもの
host=10.10.10.2 ;host2のIPアドレス
context=from-incoming ;host2から着信したときにhost1が参照するhost1のextensions.confのcontext
qualify=yes

host2 (IP: 10.10.10.2)のiax.conf

[general]
bindport=4569
;bindaddr=10.10.10.2 ;指定しないと全てのアドレスにバインド
iaxcompat=yes
language=en
bandwidth=medium
disallow=all
allow=ulaw
allow=gsm
jitterbuffer=no

[host1]
type=friend
secret=EKWfVd47p7n4
host=10.10.10.1 ;host1のIPアドレス
context=from-incoming ;host1から着信したときにhost2が参照するhost2のextensions.confのcontext
qualify=yes

設定ファイルを保存して、両方のCLIから次のコマンドを実行

*CLI> module load chan_iax2.so
*CLI> iax2 reload (すでにiax2モジュールが起動しているとき)

利用者:ふじかわ/test

2018-10-27T21:05:35Z

ふじかわ: iax.confサンプル

CLIが0から始まるときに81をつける 
extensions.conf
same = n,Set(CALLERID(all)=${IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):1}:${CALLERID(num)})})
または
same = n,Set(CALLERID(num)=${IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):1}:${CALLERID(num)})})
same = n,Set(CALLERID(name)=${CALLERID(num)})

2台のAsteriskをIAX2でシンプルに接続

host1 (IP: 10.10.10.1)のiax.conf

[general]
bindport=4569
;bindaddr=10.10.10.1 ;指定しないと全てのアドレスにバインド
iaxcompat=yes
language=en
bandwidth=medium
disallow=all
allow=ulaw
allow=gsm
jitterbuffer=no

[host2]
type=friend
secret=EKWfVd47p7n4
host=10.10.10.2 ;host2のIPアドレス
context=from-incoming
;host2から着信したときにhost1が参照するhost1のextensions.confのcontext
qualify=yes

host2 (IP: 10.10.10.2)のiax.conf

[general]
bindport=4569
;bindaddr=10.10.10.2 ;指定しないと全てのアドレスにバインド
iaxcompat=yes
language=en
bandwidth=medium
disallow=all
allow=ulaw
allow=gsm
jitterbuffer=no

[host1]
type=friend
secret=EKWfVd47p7n4
host=10.10.10.1 ;host1のIPアドレス
context=from-incoming
;host1から着信したときにhost2が参照するhost2のextensions.confのcontext
qualify=yes

利用者:ふじかわ/test

2018-09-25T23:20:54Z

ふじかわ:

利用者:ふじかわ/test

2018-09-25T23:08:56Z

ふじかわ:

CLIが0から始まるときに81をつける 
extensions.conf
same = n,Set(CALLERID(all)=${IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):1}:${CALLERID(num)})})

利用者:ふじかわ/test

2018-09-25T23:01:59Z

ふじかわ:

CLIが0から始まるときに81をつける 
extensions.conf
same = n,Set(CALLERID(all)=IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):-1}:${CALLERID(num)})

利用者:ふじかわ/test

2018-09-25T23:00:57Z

ふじかわ: ページの作成:「CLIが0から始まるときに81をつける extensions.conf same = n,Set(CALLERID(all)=IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):-1}:${CALLERID(num)})」

CLIが0から始まるときに81をつける
extensions.conf
same = n,Set(CALLERID(all)=IF($[${CALLERID(num):0:1}=0]?81${CALLERID(num):-1}:${CALLERID(num)})

Asterisk

2018-09-24T05:14:43Z

ふじかわ: /* 携帯電話 */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]
*chan_dongle
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)/USSDに対応。開発は活発ではないけど使える模様。

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==外部プログラムとの連携==
*[[自動発信|コール用ファイル]](call file)
*AGI: Asterisk Gateway Interface
*AMI: Asterisk Manager Interface
*ARI: Asterisk REST Interface
*ダイヤルプランから
:Application_Exec, Function_SHELL, Function_FILE
:Application_ReadFileは非推奨。

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 
*[https://www.amazon.co.jp/dp/B00B0NJ6I8/takahashitaka-22/ref=nosim Ubuntu 12.04 と EC2で作る Asterisk電話サーバ](kindle)

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。
*[http://www.amazon.co.jp/dp/B00HQ0RA8M/takahashitaka-22/ref=nosim Asterisk: The Definitive Guide 4th edition]
:Asterisk 11に対応。pjprojectの記述はまだありません。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

SIP-Fail2ban

2018-09-24T04:10:33Z

ふじかわ: /* ステータス確認 */

IAXでのFail2banは'''[[IAX-Fail2ban]]'''を参照してください。
==fail2ban==
ログファイルとiptablesを利用したファイアウォールの一種。Brute Forceアタックの対策に使いやすい。 
:http://www.fail2ban.org/
:http://sourceforge.net/projects/fail2ban/
iptablesおよびpythonを必要とします。最新のFail2banではAsteriskにも対応しています。

==CentOS==
CentOSではeaplからyumでインストールすることが可能です。
yum install -y epel-release
yum --enablerepo=epel -y install fail2ban
yumでインストールした最新のFail2BanはAsteriskのログフォーマットを変更し、ローカル設定ファイルを作成するだけで使用することができます。 
まずAsteriskのlogger.confを修正し
[general]
; Customize the display of debug message time stamps
; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS)
; see strftime(3) Linux manual for format specifiers
dateformat=%F %T
dateformatの箇所のコメント(;)を外して有効にし、Asteriskを再起動します。 
/etc/fail2ban/に以下の内容のjail.localというファイルを作成します。ファイルがある場合には修正します。
[DEFAULT]
ignoreip =
backend = polling
bantime = 3600 ; 1hour
maxretry= 5
usedns = no

[asterisk]
enabled = true
fail2banを起動すると監視が始まります。

===起動の確認===
iptables -Lでiptablesの状態を確認するとfail2banでbanされたIPアドレス等が確認できます。
Chain f2b-asterisk-tcp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere

Chain f2b-asterisk-udp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere
デフォルトではban時間は1時間です。

==INVITEによるBrute force攻撃への対策==
REGISTERメッセージによる攻撃以外に、INVITEによるBrute force攻撃も確認されています。

この攻撃時に出力されるログメッセージは以下のようなものになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c

このログメッセージの攻撃元IPアドレスが、FROMヘッダに記載されているIPアドレスになっています。

このままでは、NAT配下のサーバーからの攻撃や、FROMヘッダが偽装された場合にfail2banで対応することができません。

そこで、Asteriskへパッチを当てて、実際の攻撃元IPアドレスを表示するように修正します。

===Asteriskへパッチを当てる===

次のようなパッチをAsteriskに適用します。

このパッチはAsterisk-1.4.40を対象にしていますが、1.6系、1.8系にも同様の修正で対応できます。

--- asterisk-1.4.40.orig/channels/chan_sip.c 2011-01-05 02:11:48.000000000 +0900
+++ asterisk-1.4.40/channels/chan_sip.c 2011-03-10 17:59:26.000000000 +0900
@@ -15456,7 +15456,7 @@
ast_log(LOG_NOTICE, "Sending fake auth rejection for user %s\n", get_header(req, "From"));
transmit_fake_auth_response(p, SIP_INVITE, req, XMIT_RELIABLE);
} else {
- ast_log(LOG_NOTICE, "Failed to authenticate user %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate user %s (%s:%d)\n", get_header(req, "From"), ast_inet_ntoa(sin->sin_addr), ntohs(sin->sin_port));
transmit_response_reliable(p, "403 Forbidden", req);
}
p->invitestate = INV_COMPLETED;

こちらは Asterisk-1.8.23.0 用です。Asterisk-11.5.1 でもほぼ同じコードが使えます。

--- asterisk-1.8.23.0/channels/chan_sip.c.orig 2013-08-02 11:41:03.233638321 +0900
+++ asterisk-1.8.23.0/channels/chan_sip.c 2013-12-06 14:51:08.698990909 +0900
@@ -22673,7 +22673,7 @@
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -23334,7 +23334,7 @@
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -25164,7 +25164,7 @@
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -25384,7 +25384,7 @@
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

Asterisk 11.23.1用パッチです。

--- channels/chan_sip.c.orig 2016-09-09 01:28:35.000000000 +0900
+++ channels/chan_sip.c 2016-10-28 23:26:38.985774935 +0900
@@ -18751,7 +18751,7 @@ static void receive_message(struct sip_p
return;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return;
@@ -24963,7 +24963,7 @@ static int handle_request_options(struct
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -25798,7 +25798,7 @@ static int handle_request_invite(struct
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -27788,7 +27788,7 @@ static int handle_request_publish(struct
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -28003,7 +28003,7 @@ static int handle_request_subscribe(stru
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s for SUBSCRIBE\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s) for SUBSCRIBE\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

パッチを当てて、Asteriskをコンパイルし直し、再起動します。

すると、先ほどの攻撃時のログは以下のように出力されるようになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c (123.45.67.89:5060)

ログの(　)内に攻撃元の実IPアドレスが表示されるようになり、これを元にfail2banで攻撃を検知することができます。

===fail2banへ設定を追加===

修正したログに合わせたフィルタ設定をfail2banに追加します。

/etc/fail2ban/filter.d/asterisk.conf の failregex の項目に以下を追加します。

NOTICE.* .*: Failed to authenticate user .* $<HOST>:.*$

フィルタ追加後、fail2banを再起動し設定完了です。

==securityログの設定==
/etc/asterisk/logger.confに
[logfiles]
security => security
を追加（コメント解除）して、/var/log/asterisk/securityにできるログをfail2banに監視させる方法もあります。

==ステータス確認==
fail2ban-client コマンドで問い合わせるのがいいです。
# コマンド一覧
fail2ban-client

# 有効なjail一覧
fail2ban-client status

# jail名"asterisk"のステータス
fail2ban-client status asterisk

# 手動でban/unban
fail2ban-client set asterisk banip 11.22.33.44
fail2ban-client set asterisk unbanip 11.22.33.44
banされてることになっていても、actionが正しく書けていないと実際にはfirewalldやiptablesなどに反映されず、攻撃されっぱなしもあり得るので、挙動確認が大事です。 
fail2ban-server コマンドは直接叩いてはいけないようです。 
または、ログファイル /var/log/fail2ban.log を見てもいいです。

[[Category:セキュリティ]]

SIP-Fail2ban

2018-09-24T04:00:51Z

ふじかわ: /* securityログの設定 */

IAXでのFail2banは'''[[IAX-Fail2ban]]'''を参照してください。
==fail2ban==
ログファイルとiptablesを利用したファイアウォールの一種。Brute Forceアタックの対策に使いやすい。 
:http://www.fail2ban.org/
:http://sourceforge.net/projects/fail2ban/
iptablesおよびpythonを必要とします。最新のFail2banではAsteriskにも対応しています。

==CentOS==
CentOSではeaplからyumでインストールすることが可能です。
yum install -y epel-release
yum --enablerepo=epel -y install fail2ban
yumでインストールした最新のFail2BanはAsteriskのログフォーマットを変更し、ローカル設定ファイルを作成するだけで使用することができます。 
まずAsteriskのlogger.confを修正し
[general]
; Customize the display of debug message time stamps
; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS)
; see strftime(3) Linux manual for format specifiers
dateformat=%F %T
dateformatの箇所のコメント(;)を外して有効にし、Asteriskを再起動します。 
/etc/fail2ban/に以下の内容のjail.localというファイルを作成します。ファイルがある場合には修正します。
[DEFAULT]
ignoreip =
backend = polling
bantime = 3600 ; 1hour
maxretry= 5
usedns = no

[asterisk]
enabled = true
fail2banを起動すると監視が始まります。

===起動の確認===
iptables -Lでiptablesの状態を確認するとfail2banでbanされたIPアドレス等が確認できます。
Chain f2b-asterisk-tcp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere

Chain f2b-asterisk-udp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere
デフォルトではban時間は1時間です。

==INVITEによるBrute force攻撃への対策==
REGISTERメッセージによる攻撃以外に、INVITEによるBrute force攻撃も確認されています。

この攻撃時に出力されるログメッセージは以下のようなものになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c

このログメッセージの攻撃元IPアドレスが、FROMヘッダに記載されているIPアドレスになっています。

このままでは、NAT配下のサーバーからの攻撃や、FROMヘッダが偽装された場合にfail2banで対応することができません。

そこで、Asteriskへパッチを当てて、実際の攻撃元IPアドレスを表示するように修正します。

===Asteriskへパッチを当てる===

次のようなパッチをAsteriskに適用します。

このパッチはAsterisk-1.4.40を対象にしていますが、1.6系、1.8系にも同様の修正で対応できます。

--- asterisk-1.4.40.orig/channels/chan_sip.c 2011-01-05 02:11:48.000000000 +0900
+++ asterisk-1.4.40/channels/chan_sip.c 2011-03-10 17:59:26.000000000 +0900
@@ -15456,7 +15456,7 @@
ast_log(LOG_NOTICE, "Sending fake auth rejection for user %s\n", get_header(req, "From"));
transmit_fake_auth_response(p, SIP_INVITE, req, XMIT_RELIABLE);
} else {
- ast_log(LOG_NOTICE, "Failed to authenticate user %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate user %s (%s:%d)\n", get_header(req, "From"), ast_inet_ntoa(sin->sin_addr), ntohs(sin->sin_port));
transmit_response_reliable(p, "403 Forbidden", req);
}
p->invitestate = INV_COMPLETED;

こちらは Asterisk-1.8.23.0 用です。Asterisk-11.5.1 でもほぼ同じコードが使えます。

--- asterisk-1.8.23.0/channels/chan_sip.c.orig 2013-08-02 11:41:03.233638321 +0900
+++ asterisk-1.8.23.0/channels/chan_sip.c 2013-12-06 14:51:08.698990909 +0900
@@ -22673,7 +22673,7 @@
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -23334,7 +23334,7 @@
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -25164,7 +25164,7 @@
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -25384,7 +25384,7 @@
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

Asterisk 11.23.1用パッチです。

--- channels/chan_sip.c.orig 2016-09-09 01:28:35.000000000 +0900
+++ channels/chan_sip.c 2016-10-28 23:26:38.985774935 +0900
@@ -18751,7 +18751,7 @@ static void receive_message(struct sip_p
return;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return;
@@ -24963,7 +24963,7 @@ static int handle_request_options(struct
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -25798,7 +25798,7 @@ static int handle_request_invite(struct
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -27788,7 +27788,7 @@ static int handle_request_publish(struct
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -28003,7 +28003,7 @@ static int handle_request_subscribe(stru
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s for SUBSCRIBE\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s) for SUBSCRIBE\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

パッチを当てて、Asteriskをコンパイルし直し、再起動します。

すると、先ほどの攻撃時のログは以下のように出力されるようになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c (123.45.67.89:5060)

ログの(　)内に攻撃元の実IPアドレスが表示されるようになり、これを元にfail2banで攻撃を検知することができます。

===fail2banへ設定を追加===

修正したログに合わせたフィルタ設定をfail2banに追加します。

/etc/fail2ban/filter.d/asterisk.conf の failregex の項目に以下を追加します。

NOTICE.* .*: Failed to authenticate user .* $<HOST>:.*$

フィルタ追加後、fail2banを再起動し設定完了です。

==securityログの設定==
/etc/asterisk/logger.confに
[logfiles]
security => security
を追加（コメント解除）して、/var/log/asterisk/securityにできるログをfail2banに監視させる方法もあります。

==ステータス確認==
fail2ban-client コマンドで問い合わせるのがいいです。
fail2ban-client コマンド一覧
fail2ban-client status 有効なjail一覧
fail2ban-client status asterisk jail名"asterisk"のステータス
banされてることになっていても、actionが正しく書けていないと実際にはfirewalldやiptablesなどに反映されず、攻撃されっぱなしもあり得るので、挙動確認が大事です。 
fail2ban-server コマンドは直接叩いてはいけないようです。 
または、ログファイル /var/log/fail2ban.log を見てもいいです。

[[Category:セキュリティ]]

SIP-Fail2ban

2018-09-24T04:00:23Z

ふじかわ: securityログ、ステータス確認

IAXでのFail2banは'''[[IAX-Fail2ban]]'''を参照してください。
==fail2ban==
ログファイルとiptablesを利用したファイアウォールの一種。Brute Forceアタックの対策に使いやすい。 
:http://www.fail2ban.org/
:http://sourceforge.net/projects/fail2ban/
iptablesおよびpythonを必要とします。最新のFail2banではAsteriskにも対応しています。

==CentOS==
CentOSではeaplからyumでインストールすることが可能です。
yum install -y epel-release
yum --enablerepo=epel -y install fail2ban
yumでインストールした最新のFail2BanはAsteriskのログフォーマットを変更し、ローカル設定ファイルを作成するだけで使用することができます。 
まずAsteriskのlogger.confを修正し
[general]
; Customize the display of debug message time stamps
; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS)
; see strftime(3) Linux manual for format specifiers
dateformat=%F %T
dateformatの箇所のコメント(;)を外して有効にし、Asteriskを再起動します。 
/etc/fail2ban/に以下の内容のjail.localというファイルを作成します。ファイルがある場合には修正します。
[DEFAULT]
ignoreip =
backend = polling
bantime = 3600 ; 1hour
maxretry= 5
usedns = no

[asterisk]
enabled = true
fail2banを起動すると監視が始まります。

===起動の確認===
iptables -Lでiptablesの状態を確認するとfail2banでbanされたIPアドレス等が確認できます。
Chain f2b-asterisk-tcp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere

Chain f2b-asterisk-udp (1 references)
target prot opt source destination
REJECT all -- 46.17.42.180 anywhere reject-with icmp-port-unreachable
RETURN all -- anywhere anywhere
デフォルトではban時間は1時間です。

==INVITEによるBrute force攻撃への対策==
REGISTERメッセージによる攻撃以外に、INVITEによるBrute force攻撃も確認されています。

この攻撃時に出力されるログメッセージは以下のようなものになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c

このログメッセージの攻撃元IPアドレスが、FROMヘッダに記載されているIPアドレスになっています。

このままでは、NAT配下のサーバーからの攻撃や、FROMヘッダが偽装された場合にfail2banで対応することができません。

そこで、Asteriskへパッチを当てて、実際の攻撃元IPアドレスを表示するように修正します。

===Asteriskへパッチを当てる===

次のようなパッチをAsteriskに適用します。

このパッチはAsterisk-1.4.40を対象にしていますが、1.6系、1.8系にも同様の修正で対応できます。

--- asterisk-1.4.40.orig/channels/chan_sip.c 2011-01-05 02:11:48.000000000 +0900
+++ asterisk-1.4.40/channels/chan_sip.c 2011-03-10 17:59:26.000000000 +0900
@@ -15456,7 +15456,7 @@
ast_log(LOG_NOTICE, "Sending fake auth rejection for user %s\n", get_header(req, "From"));
transmit_fake_auth_response(p, SIP_INVITE, req, XMIT_RELIABLE);
} else {
- ast_log(LOG_NOTICE, "Failed to authenticate user %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate user %s (%s:%d)\n", get_header(req, "From"), ast_inet_ntoa(sin->sin_addr), ntohs(sin->sin_port));
transmit_response_reliable(p, "403 Forbidden", req);
}
p->invitestate = INV_COMPLETED;

こちらは Asterisk-1.8.23.0 用です。Asterisk-11.5.1 でもほぼ同じコードが使えます。

--- asterisk-1.8.23.0/channels/chan_sip.c.orig 2013-08-02 11:41:03.233638321 +0900
+++ asterisk-1.8.23.0/channels/chan_sip.c 2013-12-06 14:51:08.698990909 +0900
@@ -22673,7 +22673,7 @@
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -23334,7 +23334,7 @@
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -25164,7 +25164,7 @@
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -25384,7 +25384,7 @@
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

Asterisk 11.23.1用パッチです。

--- channels/chan_sip.c.orig 2016-09-09 01:28:35.000000000 +0900
+++ channels/chan_sip.c 2016-10-28 23:26:38.985774935 +0900
@@ -18751,7 +18751,7 @@ static void receive_message(struct sip_p
return;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return;
@@ -24963,7 +24963,7 @@ static int handle_request_options(struct
return 0;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
return 0;
@@ -25798,7 +25798,7 @@ static int handle_request_invite(struct
goto request_invite_cleanup;
}
if (res < 0) { /* Something failed in authentication */
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response_reliable(p, "403 Forbidden", req);
p->invitestate = INV_COMPLETED;
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
@@ -27788,7 +27788,7 @@ static int handle_request_publish(struct
p->lastinvite = seqno;
return 0;
} else if (auth_result < 0) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s)\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);
sip_scheddestroy(p, DEFAULT_TRANS_TIMEOUT);
ast_string_field_set(p, theirtag, NULL);
@@ -28003,7 +28003,7 @@ static int handle_request_subscribe(stru
if (res == AUTH_CHALLENGE_SENT) /* authpeer = NULL here */
return 0;
if (res != AUTH_SUCCESSFUL) {
- ast_log(LOG_NOTICE, "Failed to authenticate device %s for SUBSCRIBE\n", sip_get_header(req, "From"));
+ ast_log(LOG_NOTICE, "Failed to authenticate device %s (%s) for SUBSCRIBE\n", sip_get_header(req, "From"), ast_sockaddr_stringify(addr));
transmit_response(p, "403 Forbidden", req);

pvt_set_needdestroy(p, "authentication failed");

パッチを当てて、Asteriskをコンパイルし直し、再起動します。

すると、先ほどの攻撃時のログは以下のように出力されるようになります。

Failed to authenticate user "Anonymous" <sip:anonymous@192.168.1.2>;tag=as105e401c (123.45.67.89:5060)

ログの(　)内に攻撃元の実IPアドレスが表示されるようになり、これを元にfail2banで攻撃を検知することができます。

===fail2banへ設定を追加===

修正したログに合わせたフィルタ設定をfail2banに追加します。

/etc/fail2ban/filter.d/asterisk.conf の failregex の項目に以下を追加します。

NOTICE.* .*: Failed to authenticate user .* $<HOST>:.*$

フィルタ追加後、fail2banを再起動し設定完了です。

==securityログの設定==
logger.confに
[logfiles]
security => security
を追加（コメント解除）して、/var/log/asterisk/securityにできるログをfail2banに監視させる方法もあります。

==ステータス確認==
fail2ban-client コマンドで問い合わせるのがいいです。
fail2ban-client コマンド一覧
fail2ban-client status 有効なjail一覧
fail2ban-client status asterisk jail名"asterisk"のステータス
banされてることになっていても、actionが正しく書けていないと実際にはfirewalldやiptablesなどに反映されず、攻撃されっぱなしもあり得るので、挙動確認が大事です。 
fail2ban-server コマンドは直接叩いてはいけないようです。 
または、ログファイル /var/log/fail2ban.log を見てもいいです。

[[Category:セキュリティ]]

Linksys SPA3102

2018-09-24T02:42:05Z

ふじかわ:

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。 
EOLからだいぶ経過しているのですが、2018年時点で海外通販で新品として売っているのは（正常に動作はするけど）コピー品が多いようです。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・

デフォルトの設定ではINVITEを送れば誰でもPSTNに発信できてしまいます(PSTN Line - VoIP-To-PSTN Gateway Setup - VoIP Caller Auth Method: none)。あまりよろしくないので、PSTN Line - SIP Settings - Restrict Source IP: Yesにすると、Asteriskサーバ以外からのINVITEを拒否できます（proxyからのINVITEのみ信頼する。use outbound proxy:yesのときはさらにoutbound proxyも信頼する）。またはVoIP Caller Auth Method:をnoneから変更してPINかID/Passwordを使った認証も利用できます。

同様に、知らない人にLine 1を鳴らされたくないときは"Line 1 - SIP Settings - Restrict Source IP: yes"を設定します。

==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

アナログ回線の接続

2018-09-24T02:39:46Z

ふじかわ: /* アナログ・インタフェースカード */

Asteriskにアナログ回線と接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]
*X100P

== アナログ収容USBアダプター ==
*Sangoma u100 USBfxo [http://www.sangoma.com/products_and_solutions/hardware/analog_telephony/usb_fxo.html メーカーサイト]

==アナログ回線ゲートウェイ==
*[[ICOM VE-AG1]]
*[[Quintum]]

==VoIPルータ==
*[[ICOM SR-5200]] (メーカー製造中止)
*[[ICOM AP-5100VoIP]]

==VoIPゲートウェイ==
*[[Linksys SPA3102]]
*Grandstream HT-503
*[[Grandstream GXW4104]]
*[[Grandstream GXW4108]]
*[[MultiTech MultiVOIP210]]
*[[MultiTech MultiVOIP410]]
*[[MultiTech MultiVOIP810]]

アナログ回線の接続

2018-09-23T18:41:57Z

ふじかわ: /* VoIPゲートウェイ */

Asteriskにアナログ回線と接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]

== アナログ収容USBアダプター ==
*Sangoma u100 USBfxo [http://www.sangoma.com/products_and_solutions/hardware/analog_telephony/usb_fxo.html メーカーサイト]

==アナログ回線ゲートウェイ==
*[[ICOM VE-AG1]]
*[[Quintum]]

==VoIPルータ==
*[[ICOM SR-5200]] (メーカー製造中止)
*[[ICOM AP-5100VoIP]]

==VoIPゲートウェイ==
*[[Linksys SPA3102]]
*Grandstream HT-503
*[[Grandstream GXW4104]]
*[[Grandstream GXW4108]]
*[[MultiTech MultiVOIP210]]
*[[MultiTech MultiVOIP410]]
*[[MultiTech MultiVOIP810]]

アナログ回線の接続

2018-09-23T18:41:24Z

ふじかわ: ふじかわ (トーク) による編集を 219.127.232.253 による直前の版へ差し戻しました

Asteriskにアナログ回線と接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]

== アナログ収容USBアダプター ==
*Sangoma u100 USBfxo [http://www.sangoma.com/products_and_solutions/hardware/analog_telephony/usb_fxo.html メーカーサイト]

==アナログ回線ゲートウェイ==
*[[ICOM VE-AG1]]
*[[Quintum]]

==VoIPルータ==
*[[ICOM SR-5200]] (メーカー製造中止)
*[[ICOM AP-5100VoIP]]

==VoIPゲートウェイ==
*[[Linksys SPA3102]]
*[[Grandstream GXW4104]]
*[[Grandstream GXW4108]]
*[[MultiTech MultiVOIP210]]
*[[MultiTech MultiVOIP410]]
*[[MultiTech MultiVOIP810]]

アナログ回線の接続

2018-09-23T18:38:38Z

ふじかわ: /* アナログ回線ゲートウェイ */

Asteriskにアナログ回線と接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]

== アナログ収容USBアダプター ==
*Sangoma u100 USBfxo [http://www.sangoma.com/products_and_solutions/hardware/analog_telephony/usb_fxo.html メーカーサイト]

==アナログ回線ゲートウェイ==
*[[ICOM VE-AG1]]
*[[Quintum]]
*Grandstream HT-503
*SPA3000/SPA3102

==VoIPルータ==
*[[ICOM SR-5200]] (メーカー製造中止)
*[[ICOM AP-5100VoIP]]

==VoIPゲートウェイ==
*[[Linksys SPA3102]]
*[[Grandstream GXW4104]]
*[[Grandstream GXW4108]]
*[[MultiTech MultiVOIP210]]
*[[MultiTech MultiVOIP410]]
*[[MultiTech MultiVOIP810]]

アナログ回線の接続

2018-09-23T18:37:59Z

ふじかわ:

Asteriskにアナログ回線と接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]

== アナログ収容USBアダプター ==
*Sangoma u100 USBfxo [http://www.sangoma.com/products_and_solutions/hardware/analog_telephony/usb_fxo.html メーカーサイト]

==アナログ回線ゲートウェイ==
*[[ICOM VE-AG1]]
*[[Quintum]]
*Grandstream HT-503

==VoIPルータ==
*[[ICOM SR-5200]] (メーカー製造中止)
*[[ICOM AP-5100VoIP]]

==VoIPゲートウェイ==
*[[Linksys SPA3102]]
*[[Grandstream GXW4104]]
*[[Grandstream GXW4108]]
*[[MultiTech MultiVOIP210]]
*[[MultiTech MultiVOIP410]]
*[[MultiTech MultiVOIP810]]

Asterisk

2018-09-22T01:49:57Z

ふじかわ: /* 日本語 */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]
*chan_dongle
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)に対応。開発は活発ではないけど使える模様。

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==外部プログラムとの連携==
*[[自動発信|コール用ファイル]](call file)
*AGI: Asterisk Gateway Interface
*AMI: Asterisk Manager Interface
*ARI: Asterisk REST Interface
*ダイヤルプランから
:Application_Exec, Function_SHELL, Function_FILE
:Application_ReadFileは非推奨。

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 
*[https://www.amazon.co.jp/dp/B00B0NJ6I8/takahashitaka-22/ref=nosim Ubuntu 12.04 と EC2で作る Asterisk電話サーバ](kindle)

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。
*[http://www.amazon.co.jp/dp/B00HQ0RA8M/takahashitaka-22/ref=nosim Asterisk: The Definitive Guide 4th edition]
:Asterisk 11に対応。pjprojectの記述はまだありません。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

Asterisk

2018-09-22T01:46:42Z

ふじかわ: /* 洋書 */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]
*chan_dongle
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)に対応。開発は活発ではないけど使える模様。

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==外部プログラムとの連携==
*[[自動発信|コール用ファイル]](call file)
*AGI: Asterisk Gateway Interface
*AMI: Asterisk Manager Interface
*ARI: Asterisk REST Interface
*ダイヤルプランから
:Application_Exec, Function_SHELL, Function_FILE
:Application_ReadFileは非推奨。

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。
*[http://www.amazon.co.jp/dp/B00HQ0RA8M/takahashitaka-22/ref=nosim Asterisk: The Definitive Guide 4th edition]
:Asterisk 11に対応。pjprojectの記述はまだありません。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

Asterisk

2018-09-22T01:41:50Z

ふじかわ: 外部プログラムとの連携/call file/agi/ami/ari/dialplan

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]
*chan_dongle
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)に対応。開発は活発ではないけど使える模様。

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==外部プログラムとの連携==
*[[自動発信|コール用ファイル]](call file)
*AGI: Asterisk Gateway Interface
*AMI: Asterisk Manager Interface
*ARI: Asterisk REST Interface
*ダイヤルプランから
:Application_Exec, Function_SHELL, Function_FILE
:Application_ReadFileは非推奨。

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

Asterisk

2018-09-22T01:19:33Z

ふじかわ: /* 携帯電話 */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]
*chan_dongle
:USB経由でHuaweiのUSBドングルを接続するチャネルドライバ。音声/SMS(日本語も)に対応。開発は活発ではないけど使える模様。

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

Asterisk

2018-09-22T01:16:44Z

ふじかわ: /* FAX */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト
*spandsp + res_fax_spandsp
:Asterisk13以降。なおapp_faxは非推奨
*IAXModem + Hylafax

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

Asterisk

2018-09-22T01:14:55Z

ふじかわ: /* Skype */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト。ディスコン。
*[https://www.skype.com/ja/features/skype-connect/ Skype Connect]
:Skype公式のSIP接続サービス。US$6.95/ch/月

===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

IPドアホン

2018-09-21T00:55:52Z

ふじかわ: niteray

IP接続のドアホン(インタフォン)など
==Grandstream==
===GDS3710===
http://www.grandstream.jp/%E3%83%9B%E3%83%BC%E3%83%A0/%E8%A3%BD%E5%93%81%E6%83%85%E5%A0%B1/ip%E3%83%8D%E3%83%83%E3%83%88%E3%83%AF%E3%83%BC%E3%82%AF%E9%98%B2%E7%8A%AF%E3%82%AB%E3%83%A1%E3%83%A9/hd%E3%82%AB%E3%83%A1%E3%83%A9%E6%90%AD%E8%BC%89ip%E3%83%89%E3%82%A2%E3%83%9B%E3%83%B3/gds3710/ 
プロトコル:SIP 
実勢価格: 
解説ページ:[[GDS3710]] 
PoE:対応(802.3af) 
ACアダプタ:なし 
ディスプレイ:なし 
LANポート数:1 
備考:カメラ付きドアホン。開錠用接点等もあり。 
==2N==
[https://www.2n.cz/en_GB/products/intercoms サイト]
==NiteRay==
[http://www.niteray.com/ メーカーサイト] 
[https://nitery.en.alibaba.com/ Alibaba] 
[https://www.aliexpress.com/item/-/32891499419.html Q506] 
[https://www.aliexpress.com/item/-/32261187402.html Q520]

IPドアホン

2018-09-21T00:35:36Z

ふじかわ: 2N

Asterisk動作確認済みOS

2018-09-20T20:39:51Z

ふじかわ: /* 16.04 */

工事中。情報追加歓迎！このページは簡単な説明と詳細ページへのリダイレクトに使用します。 
[[Asteriskインストールメモ]]のページも参照のこと。
==CentOS==
===4.x===
===5.x===
; Asterisk 1.6.0.17
数カ月運用試験を行ったが安定して動作している。

動作環境
* [http://ja.wikipedia.org/wiki/PSTN PSTN]: NTT東日本ひかり電話オフィスタイプ(番号:２,回線:４)
* FXS Gateway: アナログ電話 2台
* Asterisk: Digium社のRepositoryを使用 (1.6.0.17で固定,適用patch無し)
===6.x===
===7.x===
; Asterisk 13
make configではsystemdのスクリプトは作成されず、init.dスクリプトが作成されるが問題なく動作。

==Windows==
以前はCygwinや仮想化を使用してWindows上でAsteriskを動作させることができましたが、Windows 10以降ではWindows Subsystem for Linux(WSL)を使ってAsteriskを動作させることができます。どうしてもLinux系シャシを使いたくない場合にどうぞ。
:[[Asterisk WSL]]
==Fedora==

==FreeBSD==

==Mac OS X==
==Solaris==
→ [[Asterisk Solaris]]
==Voyage Linux==
Debian派生のCF向けディストリビューション 
:→[[Voyage Linux]]
==Ubuntu==
===16.04===
apt-get install asterisk
だけでインストールできるので、あとは/etc/asteriskの設定ファイルをいじるだけでいい。実行ユーザはasterisk:asterisk。
ただしMySQL ODBC connectorがパッケージでは入らない模様

Asterisk動作確認済みOS

2018-09-20T20:38:55Z

ふじかわ: ubuntu 16.04

Asterisk動作確認済みOS

2018-09-20T20:36:22Z

ふじかわ: /* CentOS */

Asterisk動作確認済みOS

2018-09-20T20:35:45Z

ふじかわ: /* 7.x */

工事中。情報追加歓迎！このページは簡単な説明と詳細ページへのリダイレクトに使用します。 
[[Asteriskインストールメモ]]のページも参照のこと。
==CentOS==
===4.x===
===5.x===
; Asterisk 1.6.0.17
数カ月運用試験を行ったが安定して動作している。

動作環境
* [http://ja.wikipedia.org/wiki/PSTN PSTN]: NTT東日本ひかり電話オフィスタイプ(番号:２,回線:４)
* FXS Gateway: アナログ電話 2台
* Asterisk: Digium社のRepositoryを使用 (1.6.0.17で固定,適用patch無し)
===6.x===
===7.x===
make configではsystemdのスクリプトは作成されず、init.dスクリプトが作成されるが問題なく動作。

==Windows==
以前はCygwinや仮想化を使用してWindows上でAsteriskを動作させることができましたが、Windows 10以降ではWindows Subsystem for Linux(WSL)を使ってAsteriskを動作させることができます。どうしてもLinux系シャシを使いたくない場合にどうぞ。
:[[Asterisk WSL]]
==Fedora==

==FreeBSD==

==Mac OS X==
==Solaris==
→ [[Asterisk Solaris]]
==Voyage Linux==
Debian派生のCF向けディストリビューション 
:→[[Voyage Linux]]

自動発信

2018-09-20T20:19:13Z

ふじかわ: /* 補足 */

[[Category:Asterisk]]
Asteriskから自動発信させる方法です。この機能を使うことで自動的にAsteriskが『どこか』にダイアルして勝手に通話(!?)したりという動作を行えます。
==コール用ファイル==
以下のようなファイルを作ります。
#
Channel: SIP/201
MaxRetries: 3
RetryTime: 60
WaitTime: 30
Context: default
Extension: 300
Priority: 2
Channelは呼び出すチャネル名です。外線発信するならばextensions.confで記述するのと同様にZap/番号、などの指定を書きます。この例ではSIP/201を呼び出します。 
MaxRetries等はその通り何回リトライするかなどの設定です。デフォルトは0回（最初の発信のみでリトライしない）。 
Contextはこのチャネル接続をどのコンテキスト内で行うかを指定します。 
Extensionは接続するチャネルの『相手』を指定します。ダイアルプランでかまいませんので、IVRメニュー等のextenでもかまいません。この例では[default]の300番を指定しています。 

==ファイルの投入==
ファイルを作成したならば /var/spool/asterisk/outgoing/ ディレクトリへ移動します。コピーだとコピー途中のファイルを読んでしまうことがあるので、mvで移動が適切です。この際ファイルのパーミッションに注意してください。Asteriskをroot以外で実行している場合にはファイルのオーナやアクセス権を適切に設定しておく必要があります。 
ファイルが投入されるとAsteriskはこれを見つけ、その内容に応じて勝手にダイアルします。上の例のファイルをサンプル設定ファイルで使うと、SIP/201 の電話機を呼び出し、MeetMeに接続します。201の電話を取るとMeetMeのメッセージが聞こえるはずです。 

==外部アプリケーション連携==
つまり適切なファイルを作成し、outgoing/ ディレクトリにそのファイルを投入するとAsteriskが自動でダイアルし指定されたextenと接続しますので、外部のアプリケーションからAsteriskに発呼させることができます。例えばWebから何かをダイアルするということも簡単に行えるわけです。
==補足==
ファイルは直接、/var/spool/asterisk/outgoing/ディレクトリ上で作成してはいけません。中途半端なファイルであってもAsteriskは読み取ってしまいます。 
ファイルは別なディレクトリ上で作成し、パーミッションを設定した後、mvコマンドでディレクトリに投入するようにします。ファイルのユーザ、グループともにAsteriskの実行ユーザID、グループとあわせる必要があります。

呼が終了するまでファイルはoutgoingディレクトリに留まり、呼が終了すると削除または"Archive: yes"を指定してあるとoutgoing_doneに移ります。

自動発信

2018-09-20T20:13:44Z

ふじかわ: /* ファイルの投入 */

自動発信

2018-09-20T20:08:02Z

ふじかわ: /* ファイルの投入 */

[[Category:Asterisk]]
Asteriskから自動発信させる方法です。この機能を使うことで自動的にAsteriskが『どこか』にダイアルして勝手に通話(!?)したりという動作を行えます。
==コール用ファイル==
以下のようなファイルを作ります。
#
Channel: SIP/201
MaxRetries: 3
RetryTime: 60
WaitTime: 30
Context: default
Extension: 300
Priority: 2
Channelは呼び出すチャネル名です。外線発信するならばextensions.confで記述するのと同様にZap/番号、などの指定を書きます。この例ではSIP/201を呼び出します。 
MaxRetries等はその通り何回リトライするかなどの設定です。デフォルトは0回（最初の発信のみでリトライしない）。 
Contextはこのチャネル接続をどのコンテキスト内で行うかを指定します。 
Extensionは接続するチャネルの『相手』を指定します。ダイアルプランでかまいませんので、IVRメニュー等のextenでもかまいません。この例では[default]の300番を指定しています。 

==ファイルの投入==
ファイルを作成したならば /var/spool/asterisk/outgoing/ ディレクトリへ移動します。このときコピーではなくmvで移動が適切です。この際ファイルのパーミッションに注意してください。Asteriskをroot以外で実行している場合にはファイルのオーナやアクセス権を適切に設定しておく必要があります。 
ファイルが投入されるとAsteriskはこれを見つけ、その内容に応じて勝手にダイアルします。上の例のファイルをサンプル設定ファイルで使うと、SIP/201 の電話機を呼び出し、MeetMeに接続します。201の電話を取るとMeetMeのメッセージが聞こえるはずです。 

==外部アプリケーション連携==
つまり適切なファイルを作成し、outgoing/ ディレクトリにそのファイルを投入するとAsteriskが自動でダイアルし指定されたextenと接続しますので、外部のアプリケーションからAsteriskに発呼させることができます。例えばWebから何かをダイアルするということも簡単に行えるわけです。
==補足==
ファイルは直接、/var/spool/asterisk/outgoing/ディレクトリ上で作成してはいけません。中途半端なファイルであってもAsteriskは読み取ってしまいます。 
ファイルは別なディレクトリ上で作成し、パーミッションを設定した後、mvコマンドでディレクトリに投入するようにします。ファイルのユーザ、グループともにAsteriskの実行ユーザID、グループとあわせる必要があります。

自動発信

2018-09-20T20:06:45Z

ふじかわ: /* コール用ファイル */

[[Category:Asterisk]]
Asteriskから自動発信させる方法です。この機能を使うことで自動的にAsteriskが『どこか』にダイアルして勝手に通話(!?)したりという動作を行えます。
==コール用ファイル==
以下のようなファイルを作ります。
#
Channel: SIP/201
MaxRetries: 3
RetryTime: 60
WaitTime: 30
Context: default
Extension: 300
Priority: 2
Channelは呼び出すチャネル名です。外線発信するならばextensions.confで記述するのと同様にZap/番号、などの指定を書きます。この例ではSIP/201を呼び出します。 
MaxRetries等はその通り何回リトライするかなどの設定です。デフォルトは0回（最初の発信のみでリトライしない）。 
Contextはこのチャネル接続をどのコンテキスト内で行うかを指定します。 
Extensionは接続するチャネルの『相手』を指定します。ダイアルプランでかまいませんので、IVRメニュー等のextenでもかまいません。この例では[default]の300番を指定しています。 

==ファイルの投入==
ファイルを作成したならば /var/spool/asterisk/outgoing/ ディレクトリへコピーないしは移動します。この際ファイルのパーミッションに注意してください。Asteriskをroot以外で実行している場合にはファイルのオーナやアクセス権を適切に設定しておく必要があります。 
ファイルが投入されるとAsteriskはこれを見つけ、その内容に応じて勝手にダイアルします。上の例のファイルをサンプル設定ファイルで使うと、SIP/201 の電話機を呼び出し、MeetMeに接続します。201の電話を取るとMeetMeのメッセージが聞こえるはずです。 
==外部アプリケーション連携==
つまり適切なファイルを作成し、outgoing/ ディレクトリにそのファイルを投入するとAsteriskが自動でダイアルし指定されたextenと接続しますので、外部のアプリケーションからAsteriskに発呼させることができます。例えばWebから何かをダイアルするということも簡単に行えるわけです。
==補足==
ファイルは直接、/var/spool/asterisk/outgoing/ディレクトリ上で作成してはいけません。中途半端なファイルであってもAsteriskは読み取ってしまいます。 
ファイルは別なディレクトリ上で作成し、パーミッションを設定した後、mvコマンドでディレクトリに投入するようにします。ファイルのユーザ、グループともにAsteriskの実行ユーザID、グループとあわせる必要があります。

Asteriskが使用するポート一覧

2018-09-20T19:39:16Z

ふじかわ: /* ファイアウォールの設定 */

Asteriskはデフォルトでは以下のポートを使用します。各ポートは設定ファイル(.conf)で変更可能です。 
ファイアウォールで何を通すべきで、何を遮断すべきかの判断の参考にしてください。 
==注意==
インターネット上で使用したい場合にはウェルノウンからずらして設定するのが安全です。例えばSIP(5060/udp)を開いたまま放置しておくと、すぐに攻撃がきます。
==SIP(chan_sip)==
*シグナリング(呼制御)
:sip.confで設定
:5060/udp,tcp
:基本はUDP。設定によりTCP(TCP-SIP)使用可能。

==PJSIP(chan_pjsip)==
*シグナリング(呼制御)
:pjsip.confで設定
:5060/udp,tcp
:transport設定によりUDP/TCP使用可能。
:デフォルトではSIPとポート番号が被るのでchan_sipとchan_pjsip併用時には注意。
==IAX(chan_iax)==
:iax.confで設定
:4569/udp
==H.323(chan_ooh323)==
:ooh323.confで設定
:1720,1820(サンプル設定ファイル内で使用)

==UNISTIM(chan_unistim)==
:unistim.confで設定
:5000/udp
==音声メディア(RTP)==
:rtp.confで設定
:10000～20000/udp
::範囲の算出方法 : 1SIP端末の1通話あたり2個必要(上り下り)。
::ただし保留や転送を行う際に実質2通話になる場合には4個必要になるので余裕を持つこと。
::SIP端末によっては同時に多数の通話を捌けるものがあるので要注意。
::収容する端末数が20であっても同時通話数の想定が10までなら10×2×2＝40以上の範囲を設定しておく。
==FAX(T.38 UDPTL)==
:udptl.confで設定
:4000～4999

==HTTP(Asterisk内蔵Webサーバ)==
:http.confで設定
:8088,8089/tcp
==AMI(Asterisk Manager Interface)==
:manager.confで設定
:5038,5039/tcp
==ファイアウォールの設定==
例えばsip.confでSIPに'''5090'''を使用し、rtp.confでRTPに'''10000-11000'''を設定している場合には5090/udp、10000-11000/udpを通過するように設定すればSIPでの通話が可能になります。

firewalldの設定例
firewall-cmd --zone=public --add-port=5090/udp --permanent
firewall-cmd --zone=public --add-port=10000-11000/udp --permanent
firewall-cmd --reload

Asteriskが使用するポート一覧

2018-09-20T19:35:16Z

ふじかわ: /* SIP(chan_sip) */

Linksys SPA3102

2018-09-20T12:42:55Z

ふじかわ: /* 外線ゲートウェイとして使用する場合 */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・

デフォルトの設定ではINVITEを送れば誰でもPSTNに発信できてしまいます(PSTN Line - VoIP-To-PSTN Gateway Setup - VoIP Caller Auth Method: none)。あまりよろしくないので、PSTN Line - SIP Settings - Restrict Source IP: Yesにすると、Asteriskサーバ以外からのINVITEを拒否できます（proxyからのINVITEのみ信頼する。use outbound proxy:yesのときはさらにoutbound proxyも信頼する）。またはVoIP Caller Auth Method:をnoneから変更してPINかID/Passwordを使った認証も利用できます。

同様に、知らない人にLine 1を鳴らされたくないときは"Line 1 - SIP Settings - Restrict Source IP: yes"を設定します。

==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

Linksys SPA3102

2018-09-20T12:02:51Z

ふじかわ: /* 外線ゲートウェイとして使用する場合 */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・

デフォルトの設定ではINVITEを送れば誰でもPSTNに発信できてしまいます(PSTN Line - VoIP-To-PSTN Gateway Setup - VoIP Caller Auth Method: none)。あまりよろしくないので、PSTN Line - SIP Settings - Restrict Source IP: Yesにすると、Asteriskサーバ以外からのINVITEを拒否できます（proxyからのINVITEのみ信頼する。use outbound proxy:yesのときはさらにoutbound proxyも信頼する）。またはVoIP Caller Auth Method:をnoneから変更してPINかID/Passwordを使った認証も利用できます。

==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

Asterisk 13 pjsip

2018-09-20T10:17:52Z

ふじかわ: /* Asteriskのコンパイル */

[[カテゴリ:Asterisk]]
[[カテゴリ:pjsip]]
Asterisk 12以降では新たなSIPチャネルとしてpjsipが採用されました。これは従来のchan_sipを置換するものではなく、chan_sipに加えてpjsipが追加されたものです。
==Asterisk 13.8.0以降==
configure時に--with-pjproject-bundledを付けることで自動ダウンロードとコンパイルができます。
==事前準備==
pjprojectが必要です。[[Pjsip]]のページを参照して pjprojectをインストールしておきてください。

==Asteriskのコンパイル==
make clean; ./cofigureをやり直すとmake menuselectでres_pjsip等が現れるはずです。 
もしpjprojectをインストールしているにも関わらず、meke menuselectで選択できない場合にはpkg-configをインストールしていない、あるいはpkg-configのパスが誤っている可能性があります。
echo $PKG_CONFIG_PATH

export PKG_CONFIG_PATH=/usr/lib/pkgconfig
./configure
上の例を参考にして環境変数を設定してから./configureを実行してみてください。

==注意！！==
あたりまえの話ですがchan_sipとpjsipを併用する場合にはどちらかのSIPポートを5060からずらしてください。デフォルトでは、どちらも5060を使おうとします。
==ひかり電話HGW==
ひかり電話のホームゲートウェイはpjsipで使用できます。chan_sipのようにパッチは必要ありません。 
[[pjsip ひかり電話HGW]]

Asterisk 13

2018-09-20T10:14:49Z

ふじかわ: /* 概要 */

[[カテゴリ:Asterisk]]
[[カテゴリ:pjsip]]

Asterisk 13.0.0が2014年10月24日(現地時間)リリースされました。 
:メンテナンス終了は2020年10月
:セキュリティフィックス提供終了は2021年10月
==概要==
Asterisk 13は最新のAsteriskのメジャーリリースで、Asterisk 11同様にLTS(Long Term Support:通常4年)になります。Asterisk 13のEOLは2021年10月が予定されています。 
:https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions
Asterisk-addonsは1.8系以降ではAsterisk本体に統合されています。 

==日本語音声の扱い==
Asterisk 13からは日本語音声はAsterisk本体に統合されました。このため日本語対応パッチは不要となります。日本語実現の方法はコミュニティパッチと同じですが、統合された音声ファイルが本家からダウンロードできます。このため当VoIP-Info.jpによる日本語対応パッチおよび日本語音声ファイルの提供は13以降については行いません。

==インストール==
===前提となるパッケージ類===
GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(zaptel)、libxml2、SQLite3、libuuid-devel uuid-devel、json-c、json-c-devel 
CentOS 6.3 Basic Serverの場合、以下の手順でコンパイル環境を整えます。 
開発環境系パッケージを一括インストールしておく。
yum groupinstall "Development Libraries" "Additional Development"
パッケージを追加 
yum install gcc gcc-c++
yum install libxml2 libxml2-devel openssl-devel ncurses-devel sqlite-devel newt-devel libuuid-devel uuid-devel
yum install json-c json-c-devel

openssl-develをインストールするとkrb5-devel,zlib-develも一緒に付いて来るので別途インストールの必要はありません。 
Asteriskは現在のバージョンではBerkley DBではなくSQLite3をDBとして使用しますので、SQLite3と開発環境が必要です。 
newt-develがないとmenuselectがフルスクリーンコントロールになりません。テキストベースになります。 
 
format_mp3など、一部のソースはAsteriskに含まれないため別途入手しますが、この際にSubversionが必要となりますので、Subversionも入れておきます。
yum install subversion

Asteriskは10以降でMySQLサポートが"非常に"制限されています。このためCDRをMySQLで管理するような場合にはODBCが必要となるため、AsteriskのODBCサポート(res_odbc)を有効にする場合には以下も必要です。
yum install unixODBC unixODBC-devel mysql-connector-odbc
yum install libtool-ltdl libtool-ltdl-devel
 
システムを最新の状態にアップデート
yum update
カーネルが更新された場合にはリブートしておきます。 
===janssonのインストール===
Asterisk 12以降でlibjanssonが必要となっています。このため以下の手順で、Asteriskをインストールする'''前'''にインストールしておきます。 
:http://www.digip.org/jansson/
から最新のjanssonを入手 
# tar zxvf jansson-2.7.tar.gz
# cd jansson-2.7
# ./configure
# make
# make install
 
以上でコンパイル/インストール環境は整ったはずです。 
事前にDAHDIをインストールするために環境を整えた場合にはgcc-c++とopenssl-develの追加だけでコンパイル可能になるはずです。
なおjanssonライブラリは通常 /usr/local/lib にインストールされます。このため ld.so を調整しておかないとAsteriskが共有ライブラリの読み込みに失敗して起動しません。 
CentOS等の場合には /etc/ld.so.conf を確認します。/usr/local/lib が参照されていない場合には以下のように修正します。
include ld.so.conf.d/*.conf
/usr/local/lib
ファイルを修正した後、ldconfigを実行します。

===Asteriskソースの入手===
Asterisk 13のソースは以下からダウンロードできます。なお asterisk-13-current.tar.gz が最新バージョンへのシンボリックリンクとなっていますので、これをダウンロードすれば最新バージョンが入手できます。
http://downloads.asterisk.org/pub/telephony/asterisk/
展開するディレクトリはどこでもかまいませんが、ここでは/usr/src/とします。
# cd /usr/src
# wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-13-current.tar.gz
入手したら展開しておきます。展開すると現在のAsteriskのバージョンのディレクトリに展開されます。以降それぞれの作業は、それぞれの展開したサブディレクトリで行います。
# tar zxvf asterisk-13-current.tar.gz
# cd asterisk-13.x.x

===Asteriskのコンパイルとインストール===
基本的にconfigureしてmakeするだけです。
# ./configure
*13.8.x以降でpjsipを使いたい場合には以下を実行(別途インストールの必要なし)
# ./configure --with-pjproject-bundled
日本語音声ファイルをインストールする場合には./configureの後 make menuselectを実行します。
# make menuselect
メニュー画面から '''Core Sound Packages'''で'''CORE_SOUND-JA-....'''の必要なフォーマットのファイルを選択し、[Save & Exit]でmenuselectを終了します。あとはコンパイルとインストールを行うだけです。
# make
# make install
# make samples
# make config
これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。 
最低限のPBXとして動作させるには設定ファイルに[[Asterisk 13 サンプル設定ファイル]]を使用してみてください。 
# cd /etc
# mv asterisk asterisk.bak
# mkdir asterisk
# cd asterisk
# wget https://voip-info.jp/downloads/asterisk/conf/conf-sample-13_0627.tar.gz
# tar zxvf conf-sample-13_current.tar.gz

===MP3を使用する場合の注意===
MP3関連(MoHなど)を使用する場合には、MP3系のソースはAsterisk本体に含まれていないため、コンパイル時にエラーになりますが、ソース入手のスクリプトが付属しています。
# ./contrib/scripts/get_mp3_source.sh
これを実行すればMP3関連のモジュールがコンパイルできるようになります。
===コールパーク使用上の注意===
Asterisk 13では従来のスタイル(features.conf)で使用するパーキング設定は使えなくなっています。res_parking.confを使用してください。複数のパーキングロットを使用することができます。 
:https://wiki.asterisk.org/wiki/display/AST/Asterisk+12+Configuration_res_parking

===SIPチャネルとしてPjsipを使う場合===
13.8.xより前のバージョンでは以下のページを参照 
[[Asterisk 13 pjsip]]

==サンプル設定ファイル==
Asterisk 13以降用にサンプルの設定ファイルを一新しました。 
:[[Asterisk 13 サンプル設定ファイル]]

==ひかり電話ホームの使用==
[[ひかり電話HGWパッチ]] を参照してください。13から名前およびCLIコマンドを改めました。 
またpjsipならパッチなしで直接扱えます。 [[pjsip ひかり電話HGW]]を参照してください。

Asteriskの派生ディストリビューション

2018-09-20T10:08:36Z

ふじかわ: RasPBXの追加

Asteriskから派生したディストリビューションも各種存在します。
*[[Asterisk Now]]
:Digium純正の派生ディストリビューション。Linuxを含みWebブラウザによる管理機能を搭載する。Ver1.5からその構成が大きく変わり、CentOS+FreePBXベースとなった。
*[[AstLinux]]
:コンパクトなディストリビューション、CFやUSBメモリからも起動できる。
*[[trixbox]]
:AsteriskとCentOSにFreePBX+αのGUIをセットにしたディストリビューション。無償のコミュニティエディションであるtrixboxCEの他、有償のtrixboxProシリーズがある。以前は [[Asterisk@Home]] と呼ばれていました。
*[[CosmoPBX]]
:KnoppixベースのLive CD
*[[Askozia]]
:FreeBSDベースの組み込み、並びにx86向けディストリビューション。公式版に日本語も含まれている。ドイツ製の為か、非常にコンパクト且つシンプルに設計されており、CFでも動作可能。次期リリースはLinux版も含まれる予定。
*[[Asterisk Bootable CDROM]]
*[[FreePBX]]
:AsteriskNOWにも採用されている管理インタフェース。OSとAsteriskやその他のコンポーネントを含むDistroがあるため使いやすい。
*[[PBX in a Flash]]
:CentOS+FreePBXをベースに、とっても楽しい機能満載の日々Trick&Tips満載の、病み付きになりそうなディストリビューション。
*[[Elastix]]
:LinuxベースのAsterisk+FreePBX+Hylafax他、SugarCRMやA2Billなど、簡単をコンセプトと言ってる割には盛りだくさんなオールインワンディストリビューション。他にはコールセンター向けエディションもある、ラテンの香りのするプロジェクト。
*[[InfiniTalk]]
:CentOS 64bitベース、Asterisk1.8のAsterisk realtimeをPostgreで実現し、Asteriskの設定も初期インストールに含めたディストリビューション。OSインストールを含めてから10分でインストール完了する簡単設定。

*[[vicidialNow]]
:CentOSベースで、コールセンター向けを想定して作られているオールインワンディストリビューション。Asterisk+vicidial+vTiger(SugarCRMの派生)+MySQLを中心に構成されている。vTigerの開発元でも有る。
*[http://www.raspberry-asterisk.org/ RasPBX]
:microSDに書いてRaspberry Piに入れるだけで簡単にAsterisk 13+FreePBX14+chan_dongleなどを実行できる。

Asterisk

2018-09-20T09:59:20Z

ふじかわ: /* 各バージョンの情報 */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
2018/8/31までにDigiumの全ての株式をSangomaが取得し買収するとのことですので、今後、DigiumはSangoma傘下になります。オープンソースの方針は維持されるとのことです。 
 
PBXというと会社内の電話やビジネスホン等を思い浮かべるのですが、Asteriskが使用されるのは、いわゆる電話の分野だけではありません。通話を繋いだり切ったり(呼制御)、通話を必要とするサービスは旧来の電話だけで使われるわけではありません。様々な音声サービスに使用できるのがAsteriskです。このため電話交換機からインターネット上の音声サービスまで様々に使用されているのがAsteriskです。 
日本でAsteriskが広く知られるようになったのは2005年頃からです。 
===対応するプロトコル===
*IP系
:SIP
:H.323
:UNISTIM
:IAX(Inter Asterisk eXchange)
:MGCP
:Skinny(Cisco)
*レガシー系
:BRI/PRI(ISDNボード必要)
:アナログ(アナログボード必要)
:ゲートウェイを使用することでSIP-アナログ、SIP-ISDNも、もちろん接続できます
===[[導入事例]]===
[[導入事例]]のページにサマリーをまとめてあります。

==バージョン==
Asterisk 1.8まで
:偶数番号(1.0,1.2,1.4,1.6,1.8)がリリースバージョン
:奇数番号は開発バージョンで一般には公開されない
Asterisk 10以降
:11,13,
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15
::STD(Standard:標準サポートバージョン
次期リリース予定は16(LTS)で2018年中

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2018年6月)ならばAsterisk 13がお勧めです。次期長期サポートバージョンであるAsterisk 16は2018年中に公開予定です。
===オプションのパッケージ ===
*[[DAHDI]](旧Zaptel) 
:Asterisk 1.4.20以降およびAsterisk 1.6からはZaptelにかわり[[DAHDI]]が使用されます。 
:アナログ、BRI/PRIのボードを使用しない場合には不要です。
*libpri 
:PRIを使用しなければ必要ありません。 
*OS/ディストリ依存情報 
:[[Asteriskインストールメモ]] 
*よくわからない場合は[[謎の補助説明ページ]]もどうぞ(このページを見ても疑問が氷解するとは限りませんが)
:[[Asterisk サンプル設定ファイル]]を使ってみてください。 
:[[extension道場]]も参考になります。 
===各バージョンの情報===
*旧バージョンの情報
:[[Asterisk 旧バージョン]]
*Asterisk 13
:[[Asterisk 13]] (EOLは2019年→2021/10/24に延長[https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions])
*Asterisk 14
:STDリリースのため使用は推奨しません。 
*Asterisk 15
:2017年リリース(Standard)
:STDリリースのため使用は推奨しません。 

===DAHDIへの移行===
:[[DAHDIインストール]]
===Asterisk+DB===
'''注意:今後の方向性としてMySQLの直接サポートはなくなるようです。ODBCを使用して下さい。'''
:[[Asterisk+MySQL]]
:[[Asterisk+PostgreSQL]]
:[[Asterisk CDR SQLite]]
:[[Asterisk 11 ODBC]]

===使用する上でのヒント===
*[[Asterisk Tips]]
===注意点などの追加情報===
*[[Asterisk 追加情報]]
===セキュリティ===
*[[利用者:MR G]]の[[パケットフィルタリング]]
*'''[[Asterisk SIP セキュリティ]]'''
*'''[[SIP-Fail2ban]]'''
*[[Asteriskが使用するポート一覧]]

===参考になるページ===
MR Gさんのページ [[利用者:MR G]] 
[[Asterisk NAT]] 
kei_ef_2000(a.k.a ふかうみ)さんの「Asterisk SugarLookup」解説ページ[[利用者:kei ef 2000]] 
===参考になるかどうかよくわからないページ===
[[バカstarisk]] 
[[あすりん(仮)]]

==派生ディストリビューション==
[[Asteriskの派生ディストリビューション]]
==アンインストール==
[[アンインストール情報]]のページへ

==Asteriskの動作する環境==
IA系のマシンでLinuxをOSとして使用します。多くのLinuxディストリビューションで動作しています。ただしLinux 2.4カーネルを使用する場合には、ZatelがUSB-UHCIを必要とするため注意が必要です。Linux 2.6カーネル系では特に大きな問題はありません。
===OS===
[[Asterisk動作確認済みOS]]
===関連情報===
[[Asterisk Timer]] 
[[Zaptel udev]] 
[[Asterisk MacOSXでの動作]] 
[[Asterisk FreeBSDでの動作]] 

===特殊なプラットフォーム===
*小型アプライアンス類
:コンパクトなAsteriskマシンが欲しい方は[[アプライアンス]]ページを参照 
*OpenWRT 
:ルータ用代替ファームウェア。Asteriskのインストールも可能。 

==Asteriskと回線や電話機等の接続==
AsteriskはSIPやH.323といったIPベースの接続の他、アナログやISDNなど様々な回線に対応します。
===IP===
*[[IP電話機]]
*[[ITSP接続]]
*[[ENUM]]
===アナログ===
*[[アナログ回線の接続]]
*[[アナログ電話機の接続]]
===ISDN===
*[[ISDN接続]]
===ひかり電話===
*[[ひかり電話対応]]
===回線交換機（アナログ式PBX）===
*[[OD接続(E&M)]]
*[[FXS接続]]
*[[FXO接続]]

=== 携帯電話 ===

*[[Bluetooth接続(chan_mobile)]]

===Skype===
*[[Skype for Asterisk]]
:Digiumのプロダクト
===FAX===
*[[Fax for Asterisk]]
:Digiumのプロダクト

==Asteriskの管理==
*コマンドライン
:[[Asterisk_CLI]]
*[[Asterisk Manager Interface]]
:Asterisk管理インタフェース
*GUI
:Asteriskは基本的にはGUIを持ちません。Asterisk NOWはブラウザによる管理インタフェースを持っています。 
:[[Asterisk-GUI]](純正) 
:[[Asterisk GUI]] 
:ADM 

==IP電話関連機器はどこで買えますか？==
日本国内での入手性も序々に良くなってきました。 
[[購入情報]] のページを参照してください。 

==日本国内対応==
Asteriskを日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*[[Asterisk パッチ]]
*[[Asterisk 日本語音声]]
*[[音声合成]]

===接続および使い方===
*[[ひかり電話対応]]
*[[ラインキー問題]]

==書籍==
===日本語===
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798011290/takahashitaka-22/ref=nosim AsteriskでつくるIP電話システム』]([[たかはし]]の著書)
:1.0ベースのため1.2系は当Wikiでフォローしています。 
:VoIPの基本からAsteriskのインストール/稼動までの入門向きです。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798016322/takahashitaka-22/ref=nosim 『Asterisk徹底活用ガイド』]([[たかはし]]の著書)
:Asterisk 1.2/1.4対応になっています。各種設定のリファレンスおよび設定事例など
:Asteriskに特化した内容となっています。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4798017795/takahashitaka-22/ref=nosim 『AsteriskNOWではじめるIP電話』]([[たかはし]]の著書)
:AsteriskNOWによるAsteriskの入門書です。
*[http://www.amazon.co.jp/exec/obidos/ASIN/4873112893/takahashitaka-22/ref=nosim Asterisk-テレフォニーの未来-]
:オライリーの翻訳版。Asterisk 1.2対応も若干入っているようです。http://www.oreilly.co.jp/books/4873112893/ 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4777512789/takahashitaka-22/ref=nosim Trixbox実践ガイドブック―オープンソースの「PBXソフト」で「IPビジネスフォン」を作る]
*[http://www.amazon.co.jp/exec/obidos/ASIN/4839922810/takahashitaka-22/ref=nosim AsteriskによるIP-PBXシステム構築ガイド] 
:1.2ベースの本のようです。1.2のソースCD付。 
*[http://www.amazon.co.jp/exec/obidos/ASIN/4274066835/takahashitaka-22/ref=nosim Asterisk運用・開発ガイド] 
:APIなど開発/運用者向けの詳細な記載あり、上級者向け。 

===洋書===
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596009623/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony] 
:こちらも1.0ベースの本。 
:Asterisk : The Future of Telephony (Asterisk Documentation Project) 
:The Future of TelephonyはCreative Commons licenseの元、オンライン(PDF文書)で公開されています。 
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/0596510489/takahashitaka-22/ref=nosim Asterisk : The Future of Telephony (2nd Edition)] 
:2ndエディションで1.4対応だそうです。
*[http://www.amazon.co.jp/Asterisk-Telephony-Jim-Van-Meggelen/dp/059652692X/takahashitaka-22/ref=nosim Asterisk Cookbook (Cookbook)] 
:発売日：2008/12/30何度か発売が伸びています。日本語版は出るのかは不明です。[http://www.asteriskcookbook.com/wiki/index.php/Main_Page Asterisk Cookbook Wiki]などあるようです。

==問い合わせ先など==
*[[Asteriskコンサルタント]]
*セミナー/イベントなど
:[[イベント情報]]のページで告知しています。

==外部リンク==
Asteriskの日本国内情報は[[外部リンク]]ページを参照してください。
:Digium http://www.digium.com 
:Asterisk http://www.asterisk.org

アナログ回線の接続

2018-09-20T03:20:19Z

ふじかわ: /* VoIPゲートウェイ */

Linksys SPA3102

2018-09-20T03:14:25Z

ふじかわ: /* 外線ゲートウェイとして使用する場合 */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・ 
デフォルトの設定ではINVITEを送れば誰でもPSTNに発信できてしまいます(PSTN Line - VoIP-To-PSTN Gateway Setup - VoIP Caller Auth Method: none)。あまりよろしくないので、PSTN Line - SIP Settings - Restrict Source IP: Yesにすると、Asteriskサーバ以外からのINVITEを拒否できます（proxyからのINVITEのみ信頼する。use outbound proxy:yesのときはさらにoutbound proxyも信頼する）。またはVoIP Caller Auth Method:をnoneから変更してPINかID/Passwordを使った認証も利用できます。

==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

Linksys SPA3102

2018-09-20T03:11:46Z

ふじかわ: /* 外線ゲートウェイとして使用する場合 */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・
デフォルトの設定では PSTN Line - VoIP-To-PSTN Gateway Setup - VoIP Caller Auth Method: none になっていますが、これではINVITEを送れば誰でもPSTNに発信できてしまいます。あまりよろしくないので、PSTN Line - SIP Settings - Restrict Source IP: Yesにすると、Asteriskサーバ以外からのINVITEを拒否できます（proxyからのINVITEのみ信頼する。use outbound proxy:yesのときはさらにoutbound proxyも信頼する）。またはVoIP Caller Auth Method:でPINかID/Passwordを使った認証も利用できます。

==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

Linksys SPA3102

2018-09-19T15:57:51Z

ふじかわ: /* 日本っぽいトーンマップ(作りかけ) */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・
==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

Linksys SPA3102

2018-09-19T15:39:41Z

ふじかわ: /* 日本っぽいトーンマップ(作りかけ) */

[[画像:SPA-3102.jpg]] 
Sipura改めLinkSys改めCiscoのVoIPゲートウェイ。
*WANポート×1
*LANポート×1
*FXSポート×1
*FXOポート×1
SPA3102はVoIPゲートウェイ+ルータ機能を持つためWANポートが付いています。VoIPの機能的にはFXS×1,FXO×1のSPA3000とほぼ同じです。日本のナンバーディスプレイには対応していません。FXO->FXSの場合にも単純なパススルーではないのでナンバーディスプレイは動作しません。
==設定==
細かい設定ができるので、とにかくヤヤコシイ。
===SPA3102をVoIPゲートウェイとして使う場合===
====パソコンで設定する場合====
ルータ機能を搭載しているため、既設のLANに接続する場合には要注意です。DHCPサーバ機能がLANポート側で動作するため、DHCPサーバを使用しているネットワークにそのまま繋ぎこまず、一旦、LANから切り離したPCで設定を行って以下のように設定を変更します。
*パソコンはDHCPでIPアドレスを取ってきます
SPA3102のIPアドレス(ゲートウェイアドレス)にブラウザでアクセスします 
Admin Login->Advancedの後、Routerタブから 
WAN Setupで
Connection Type:DHCP
LAN Setupで
Networking Service:Bridge
Enable DHCP Server:no
VoiceタブからSystem設定で
Enabe Web Admin Access:yes
====電話機で設定する場合====
電話機を使ってもWAN側設定は可能です。この場合、既存のLANにはWAN(Internet)側ポートを接続しておき、LAN側には何も接続しません。
受話器を取って"****"をダイアル
"LinkSys Configuration..."のトーキーが聞こえる
"101#"をダイアル
"0#"をダイアルするとWAN側がDHCPモードになる
"1"を押してセーブする
"7932#"をダイアル
"1#"をダイアルするとWeb管理画面が有効になる
再起動して、"****"でメニューに入った後、"110#"でIPアドレスが確認できる。
注1) 101#のオプション設定がマニュアルと異なるようです。ファームウエアによって若干の違いがあるようなので注意してください。 
注2) IPアドレスの確認は110と恐ろしい番号なので、間違ってダイアルしないようにPSTNの線は設定時には抜いておきましょう:) 

以上の設定を行った後、[Subit All Changes]で保存し、WANポート側を既設LANに接続して再起動します。すると既設LANのDHCPからWANポート側にIPアドレスを取得してきますので、単なるゲートウェイとして使用可能になります。 
※なおSPA3000はルータ機能がないので、このような設定は必要ありません。ゲートウェイとして使いたい場合にはSPA3000を入手する方がいいでしょう。そもそもルータ機能はまず要りませんから・・・。 

==回線関係の設定==
以下のFXS/FXOの設定方法はSPA3000でも同じはずです 
とにかくヤヤコシイので余計な箇所は触らないようにします。 
==FXSポートの設定==
Line1(SPA3102の場合にはVoiceタブの下)がFXSポート側の設定になります。 
Line1設定
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
ここからが少し問題。単にATAとして使う場合には、デフォルトのままで使えると思いますが、FXOを外線にし内線と外線を切り替えて使用する場合にはAsterisk同様にダイアルプランの設定が必要です。 
*全ての番号をAsterisk側へ投げる場合
(xx.)
*2～9で始まる番号はAsteriskで、0,1で始まる番号はFXOへ投げる場合
([2-9]x.|[01]x.<:@gw0>)
Asteriskのexten同様に変数を使ってダイアルプランを記述します。xは任意の1つの番号で、.はそれに続く任意の桁数の番号を意味します。つまりx.と書くと1桁以上の番号ならAsterisk(SIP)側へダイアルします。ただしx.だけでは1桁の番号を期待するようで、あっという間に桁間タイマーがタイムアウトしてしまうのでxx.を指定するのが良いようです。 

FXOを併用する場合の設定はちょっとヤヤコシくて上の例では次のような意味になっています。
[2-9]x.
2から9の間の数字で始まる任意の桁数の番号ならばAsteriskで処理
[01]x.<:@gw0>
0または1で始まる任意の桁数の番号ならばゲートウェイ0(gw0)に呼を流す。

ここでゲートウェイ0(gw0)というのはPSTN、すなわちFXOポートのことです。たとえば201のように2で始まる内線番号がダイアルされるとAsterisk側へダイアルされますが、117や03-xxxx-xxxxのような0や1で始まる番号がダイアルされるとFXO側にダイアルされるという仕組みです。ルール間はパイプ(|)でつなぎます。

===ケイデンスの設定===
デフォルトの設定ではRINGがアメリカ向けのため、日本の電話機を接続するとベルが鳴らない、あるいは不規則になるという不都合があります。このためRINGケイデンスだけ設定を変更しておきます。なおトーンも全てプログラマブルなのですが、設定方法は暇があったら書きます・・・。
*Admin->Advanced->Regionalで
Ring1 Cadence: 20(1/2)

==FXOポートの設定==
SPA3000/SPA3102のFXOポートは全く独立したポートで、これそのものがSIPエンティティです。このためAsterisk等で使用すると外線ゲートウェイとして使用することができます。 
なお現時点ではJATE認定品ではありませんので、電話回線に直接接続しないでください。繋ぎたい場合にはISDN TAのアナログポートなどに接続して使って下さい。 
===単にFXS->FXOパススルーとして使う場合===
SPA3000/3102の場合にはFXSとFXOがそれぞれ独立したSIPエンティティであるため、パススルーとして動作させることは出来ません。このためパススルー的に使うには、SPA内部でVoIPデータを接続するという方法を使っています。上のFXS設定でゲートウェイ0を指定したのはこのためです。 
パススルー的に使う場合には設定を以下のようにします。
*Voice->PSTN Line設定で
Line Enable: yes
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: no
PSTN Ring Thru Line1: yes
以上の設定で単なるスルー的に使えるはずです。ただし、PSTNへの発信はLine1で設定したダイアルプランのルールに従います。着信の場合にはPSTN側で着信があるとLine1(FXS)の電話機が鳴ります。

===外線ゲートウェイとして使用する場合===
外線ゲートウェイとして使う場合には、PSTN LineをSIPエンティティとしてAsteriskへRegisterします。
*Voice->PSTN Line設定で
Line Enable: yes
Proxy:AsteriskなどのIPアドレス
Outbound Proxy:AsteriskなどのIPアドレス
Use Outbound Proxy: yes
Register: yes
Display Name:CID名を設定
User ID:Asterisk等にRegisterするユーザ名
Password:パスワード
VoIP-To-PSTN Gateway Enable: yes
PSTN-To-VoIP Gateway Enable: yes
PSTN Ring Thru Line1: yes
なおSIP PortがLine1(FXS)とは異なった値になっていることを確認しておいてください(デフォルトでは5061)。
SPA3000/3102はPSTNからの着信に対し、PINでユーザ認証を行ってから発信させる機能を持ってます。このため自動着信し、そこでダイアルさせる場合にはユーザの設定等が必要となりますが、単にAsteriskの外線ゲートウェイとして使いたい場合には、全ての着信を特定のextenへ飛ばしてしまいます。
*Voice->PSTN Line設定で
Dial Plan 2を以下のように設定
(S0<:着信させる番号@Asteriskサーバアドレス>)たとえば着信extenが1000ならば
(S0<:1000@192.168.1.1>)のように記述します。
次にPSTN-To-VoIP Gateway Setupの項目にある
PSTN Caller Default DP: 2
PSTN Ring thru Line1: no
に設定します。これで回線側からの全ての着信は、着信extenへと送られます。この着信ですが、現在のファームウェア(SPA3102で3.3.6)では、Ring中はPSTNポートはオフフックせず、接続先がAnswerしてからオフフックするようになっています。 
なおゲートウェイとしてPSTNへの発信に使うには
Dial(SIP/電話番号@SPAのピア名)のように記述すればPSTNに対して発信できるようになります。
sip.confとかの書き方はまぁ普通に・・・
==相互接続性==
*Asterisk
:問題なし
*RT-200NE
:内線収容可能。アナログポート増設に使用可能。
==日本っぽいトーンマップ(作りかけ)==
Dial Tone:400@-19;10(*/0/1)
Second Dial Tone:400@-19;10(.15/.125/1)
Outside Dial Tone:420@-16;10(*/0/1)
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
Busy Tone:400@-19;10(.5/.5/1)
Reorder Tone:480@-19,620@-19;10(.25/.25/1+2)
Off Hook Warning Tone:480@-10,620@0;10(.125/.125/1+2)
Ring Back Tone:400@-19,385@-20;*(1/2/1+2)
Confirm Tone:600@-16;1(.25/.25/1)
SIT1 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT2 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT3 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
SIT4 Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
MWI Dial Tone:400@-19;10(.2/.2/1,.2/.2/1,.2/.2/1,*/0/1)
Cfwd Dial Tone:350@-19,440@-19;2(.2/.2/1+2);10(*/0/1+2)
Holding Tone:400@-20,384@-22;20(.5/.5/1+2,.05/.45/1,.05/.45/1,0/3/0)
Conference Tone:350@-19;20(.1/.1/1,.1/9.7/1)
Secure Call Indication Tone:397@-19,507@-19;15(0/2/0,.2/.1/1,.1/2.1/2)
VoIP PIN Tone:600@-10;*(0/1/1,.1/.1/1,.1/.1/1,.1/.5/1)
PSTN PIN Tone:600@-10;*(0/.7/1,.2/.1/1,.2/.1/1,.2/.5/1)
Feature Invocation Tone:350@-16;*(.1/.1/1)

書式
周波数1,周波数2,...,周波数n;ケイデンス1;ケイデンス2;...;ケイデンスn
最大127文字、6つの周波数、6つのケイデンス
周波数は "Hz@dBm" で表す。
ケイデンスは "長さ(鳴る時間/無音時間/周波数)" で表す

例：
Prompt Tone:520@-19,620@-19;10(*/0/1+2)
周波数1: 520 Hz @ -19 dBm
周波数2: 620 Hz @ -19 dBm
10秒間鳴らす
* 連続音
0 無音時間なし
1+2 周波数1と2の和音

通話録音

2018-09-16T14:17:40Z

ふじかわ: /* アプリケーションを使用する */

[[Category:Asterisk]]
[[Category:Tips]]
意外とニーズが多いそうなので簡単に解説。
注意：通話を録音する際には法的な問題がないかどうかを、まずクリアにしてください。
Asteriskではモニタなどの機能で通話録音が可能です。
==アプリケーションを使用する==
次のような記述を行うことで、通話録音を行えます。
[record-out]
exten => _0.,1,Set(CALLFILENAME=${EXTEN:1}-${TIMESTAMP})
exten => _0.,2,Monitor(wav,${CALLFILENAME},m)
exten => _0.,3,Dial(ダイアルアウト先など)
exten => _0.,4,Congestion
exten => _0.,104,Congestion
この例では0番発信した場合の相手との通話を全て録音します。録音されたファイルはWAVフォーマットで /var/spool/asterisk/monitor/ の下に置かれます。 
Monitorのオプションを何も指定しない場合には通話は-inと-outというふたつのファイルに分かれて記録されますが、上記の例のように"m"を指定していると、通話終了後にsoxmixが呼び出され通話はひとつのファイルに保存されます。

${TIMESTAMP}はAsterisk 1.4から非推奨になりました。${STRFTIME(${EPOCH},Asia/Tokyo,%Y%m%d-%H%M%S)}を利用できます。

==automon==
Asterisk 1.2からはautomonと呼ばれる動的なモニタ機能が追加されました。 
次のような記述を行います。
exten => _0.,1,Set(DYNAMIC_FEATURES=automon)
exten => _0.,2,Dial(ダイアル先,60,W) <--"W"オプションを付ける
exten => _0.,3,Congestion
"W"オプションを付けてDialコマンドを実行すると発呼した側に録音の許可がなされます。相手と通話中にダイアルした側から"*1"（features.confで定義）をプッシュすると録音が開始されます。小文字"w"を付けると着信側に録音が許可されるので、着信extenではこちらを使います。録音されたファイルは同じく/var/spool/asterisk/monitor/ の下にauto-が先頭についた名前で保存されます。

==MixMonitor==
*MixMonitorを使ったマクロ
features.conf
[applicationmap]
apps => 99,caller,Macro,apprecord

extensions.conf
[globals]
DYNAMIC_FEATURES=apps
==中略==
[macro-apprecord]
exten => s,1,GotoIf($["${XAD}" = "0" | "${XAD}" = ""]?startrec:stoprec)
exten => s,n(startrec),Playback(startmonitor)
exten => s,n,Set(XAD=1)
exten => s,n,Set(MONITOR_FILENAME=${CHANNEL:4:3}) ;内線番号の桁数によって適宜変更してください。
exten => s,n,MixMonitor(${MONITOR_FILENAME}.wav,b,cp /var/spool/asterisk/monitor/
${MONITOR_FILENAME}.wav /var/spool/asterisk/monitor/${MONITOR_FILENAME}-${DATETIME}.wav)
exten => s,n,MacroExit
exten => s,n(stoprec),StopMixMonitor
exten => s,n,Set(XAD=0)
exten => s,n,Playback(stopmonitor)
exten => s,n,MacroExit
内線番号でwavファイルが作られます。
[default]
exten => 999,1,Set(MONITOR_FILENAME=${CHANNEL:4:3})
exten => 999,n,Wait(1)
exten => 999,n,Monitor(/var/spool/asterisk/monitor/${MONITOR_FILENAME})
適当なextenで聞き返すこともできます。

Tips: 下記の設定ををMixMonitor実行前に行っておくと、転送しても録音が継続されます。

exten => s,n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)

通話録音

2018-09-16T10:46:35Z

ふじかわ: /* automon */

[[Category:Asterisk]]
[[Category:Tips]]
意外とニーズが多いそうなので簡単に解説。
注意：通話を録音する際には法的な問題がないかどうかを、まずクリアにしてください。
Asteriskではモニタなどの機能で通話録音が可能です。
==アプリケーションを使用する==
次のような記述を行うことで、通話録音を行えます。
[record-out]
exten => _0.,1,Set(CALLFILENAME=${EXTEN:1}-${TIMESTAMP})
exten => _0.,2,Monitor(wav,${CALLFILENAME},m)
exten => _0.,3,Dial(ダイアルアウト先など)
exten => _0.,4,Congestion
exten => _0.,104,Congestion
この例では0番発信した場合の相手との通話を全て録音します。録音されたファイルはWAVフォーマットで /var/spool/asterisk/monitor/ の下に置かれます。 
Monitorのオプションを何も指定しない場合には通話は-inと-outというふたつのファイルに分かれて記録されますが、上記の例のように"m"を指定していると、通話終了後にsoxmixが呼び出され通話はひとつのファイルに保存されます。

${TIMESTAMP}はAsterisk 1.4から非推奨になりました。${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)}を利用できます。

==automon==
Asterisk 1.2からはautomonと呼ばれる動的なモニタ機能が追加されました。 
次のような記述を行います。
exten => _0.,1,Set(DYNAMIC_FEATURES=automon)
exten => _0.,2,Dial(ダイアル先,60,W) <--"W"オプションを付ける
exten => _0.,3,Congestion
"W"オプションを付けてDialコマンドを実行すると発呼した側に録音の許可がなされます。相手と通話中にダイアルした側から"*1"（features.confで定義）をプッシュすると録音が開始されます。小文字"w"を付けると着信側に録音が許可されるので、着信extenではこちらを使います。録音されたファイルは同じく/var/spool/asterisk/monitor/ の下にauto-が先頭についた名前で保存されます。

==MixMonitor==
*MixMonitorを使ったマクロ
features.conf
[applicationmap]
apps => 99,caller,Macro,apprecord

extensions.conf
[globals]
DYNAMIC_FEATURES=apps
==中略==
[macro-apprecord]
exten => s,1,GotoIf($["${XAD}" = "0" | "${XAD}" = ""]?startrec:stoprec)
exten => s,n(startrec),Playback(startmonitor)
exten => s,n,Set(XAD=1)
exten => s,n,Set(MONITOR_FILENAME=${CHANNEL:4:3}) ;内線番号の桁数によって適宜変更してください。
exten => s,n,MixMonitor(${MONITOR_FILENAME}.wav,b,cp /var/spool/asterisk/monitor/
${MONITOR_FILENAME}.wav /var/spool/asterisk/monitor/${MONITOR_FILENAME}-${DATETIME}.wav)
exten => s,n,MacroExit
exten => s,n(stoprec),StopMixMonitor
exten => s,n,Set(XAD=0)
exten => s,n,Playback(stopmonitor)
exten => s,n,MacroExit
内線番号でwavファイルが作られます。
[default]
exten => 999,1,Set(MONITOR_FILENAME=${CHANNEL:4:3})
exten => 999,n,Wait(1)
exten => 999,n,Monitor(/var/spool/asterisk/monitor/${MONITOR_FILENAME})
適当なextenで聞き返すこともできます。

Tips: 下記の設定ををMixMonitor実行前に行っておくと、転送しても録音が継続されます。

exten => s,n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)

通話録音

2018-09-15T09:33:27Z

ふじかわ: /* アプリケーションを使用する */

[[Category:Asterisk]]
[[Category:Tips]]
意外とニーズが多いそうなので簡単に解説。
注意：通話を録音する際には法的な問題がないかどうかを、まずクリアにしてください。
Asteriskではモニタなどの機能で通話録音が可能です。
==アプリケーションを使用する==
次のような記述を行うことで、通話録音を行えます。
[record-out]
exten => _0.,1,Set(CALLFILENAME=${EXTEN:1}-${TIMESTAMP})
exten => _0.,2,Monitor(wav,${CALLFILENAME},m)
exten => _0.,3,Dial(ダイアルアウト先など)
exten => _0.,4,Congestion
exten => _0.,104,Congestion
この例では0番発信した場合の相手との通話を全て録音します。録音されたファイルはWAVフォーマットで /var/spool/asterisk/monitor/ の下に置かれます。 
Monitorのオプションを何も指定しない場合には通話は-inと-outというふたつのファイルに分かれて記録されますが、上記の例のように"m"を指定していると、通話終了後にsoxmixが呼び出され通話はひとつのファイルに保存されます。

${TIMESTAMP}はAsterisk 1.4から非推奨になりました。${STRFTIME(${EPOCH},,%Y%m%d-%H%M%S)}を利用できます。

==automon==
Asterisk 1.2からはautomonと呼ばれる動的なモニタ機能が追加されました。 
次のような記述を行います。
exten => _0.,1,Set(DYNAMIC_FEATURES=automon)
exten => _0.,2,Dial(ダイアル先,60,W) <--"W"オプションを付ける
exten => _0.,3,Congestion
"W"オプションを付けてDialコマンドを実行すると発呼した側に録音の許可がなされます。相手と通話中にダイアルした側から"*1"をプッシュすると録音が開始されます。小文字"w"を付けると着信側に録音が許可されるので、着信extenではこちらを使います。録音されたファイルは同じく/var/spool/asterisk/monitor/ の下にauto-が先頭についた名前で保存されます。
==MixMonitor==
*MixMonitorを使ったマクロ
features.conf
[applicationmap]
apps => 99,caller,Macro,apprecord

extensions.conf
[globals]
DYNAMIC_FEATURES=apps
==中略==
[macro-apprecord]
exten => s,1,GotoIf($["${XAD}" = "0" | "${XAD}" = ""]?startrec:stoprec)
exten => s,n(startrec),Playback(startmonitor)
exten => s,n,Set(XAD=1)
exten => s,n,Set(MONITOR_FILENAME=${CHANNEL:4:3}) ;内線番号の桁数によって適宜変更してください。
exten => s,n,MixMonitor(${MONITOR_FILENAME}.wav,b,cp /var/spool/asterisk/monitor/
${MONITOR_FILENAME}.wav /var/spool/asterisk/monitor/${MONITOR_FILENAME}-${DATETIME}.wav)
exten => s,n,MacroExit
exten => s,n(stoprec),StopMixMonitor
exten => s,n,Set(XAD=0)
exten => s,n,Playback(stopmonitor)
exten => s,n,MacroExit
内線番号でwavファイルが作られます。
[default]
exten => 999,1,Set(MONITOR_FILENAME=${CHANNEL:4:3})
exten => 999,n,Wait(1)
exten => 999,n,Monitor(/var/spool/asterisk/monitor/${MONITOR_FILENAME})
適当なextenで聞き返すこともできます。

Tips: 下記の設定ををMixMonitor実行前に行っておくと、転送しても録音が継続されます。

exten => s,n,Set(AUDIOHOOK_INHERIT(MixMonitor)=yes)