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

Asterisk on Docker

2025-09-07T03:40:03Z

Takatyan:

[[Asterisk 22]]をDockerで動かそう！ 
Dockerとは、コンテナ仮想化のためのプラットフォームです。

Asteriskには公式のDockerイメージがないようです。
インターネットを探すと、有志が構築したイメージやDockerfileがありますが、古かったり、マルチステージビルドでなく最終イメージのサイズが大きかったりして、良さそうなものがなかったので、独自のDockerfileを作成しました。

Linuxで、x86_64のマシンで試しています。[[Opusコーデック]]がARM非対応のため、ARMは試しておりません。

==イメージをビルドする==
次のDockerfileとdocker-entrypoint.shを用意します。

===Dockerfile===
このDockerfileは、[[Opusコーデック]]を使用しています。

<nowiki>FROM debian:bookworm-slim AS base

RUN echo "APT::Install-Recommends 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& echo "APT::Install-Suggests 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& apt-get update -qq \
&& apt -y install readline-common uuid libxml2 libsqlite3-0 libssl3 net-tools dnsutils ca-certificates curl xmlstarlet \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives

FROM base AS build
ARG asterisk_version=22.5.1
ENV TZ Asia/Tokyo
WORKDIR /build
RUN apt-get update \
&& apt -y install build-essential libedit-dev uuid-dev pkg-config libxml2-dev libsqlite3-dev sqlite3 libssl-dev net-tools dnsutils \
\
&& curl http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-${asterisk_version}.tar.gz | tar xfz - \
&& cd /build/asterisk-${asterisk_version} \
&& ./configure --with-jansson-bundled \
&& make menuselect.makeopts \
&& menuselect/menuselect --enable codec_opus --enable CORE-SOUNDS-EN-WAV --disable CORE-SOUNDS-EN-GSM menuselect.makeopts \
&& make -j$(nproc) \
&& make install \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives \
&& cd / && tar cfz libasterisk.tar.gz usr/lib/libasteriskpj.* usr/lib/libasteriskssl.*

FROM base
RUN mkdir /usr/lib/asterisk
COPY --from=build /usr/lib/asterisk/modules /usr/lib/asterisk/modules
COPY --from=build /usr/sbin/astcanary /usr/sbin/astdb2bdb /usr/sbin/astdb2sqlite3 /usr/sbin/asterisk /usr/sbin/astversion /usr/sbin/astgenkey /usr/sbin/autosupport /usr/sbin/
COPY --from=build /usr/sbin/rasterisk /usr/sbin/safe_asterisk /usr/sbin/
COPY --from=build /var/lib/asterisk /var/lib/asterisk_orig
COPY --from=build /var/spool/asterisk /var/spool/asterisk_orig
COPY --from=build /libasterisk.tar.gz /libasterisk.tar.gz
RUN tar xf /libasterisk.tar.gz \
&& cd /var/lib/asterisk/sounds \
&& curl -o core-sound-ja.tgz -L https://github.com/takao-t/asterisk-sound-ja/raw/refs/heads/master/core-sound-ja.tgz \
&& tar xf core-sound-ja.tgz \
&& rm -f core-sound-ja.tgz

ADD docker-entrypoint.sh /
RUN ["chmod", "755", "docker-entrypoint.sh"]

WORKDIR /
ENTRYPOINT ["./docker-entrypoint.sh"]</nowiki>

===docker-compose.sh===

<nowiki>#!/usr/bin/sh

if [ -d "/var/spool/asterisk" ]; then
# フォルダ構成だけでもコピー　ファイルは上書きしない
cp -r -n /var/spool/asterisk_orig/* /var/spool/asterisk
fi
if [ ! -e "/var/lib/asterisk/astdb.sqlite3" ]; then
# astdb.sqlite3がないということは初回の起動またはマウントされてない
if [ -d "/var/lib/asterisk" ]; then
# フォルダはある。初回起動
cp -r -n /var/lib/asterisk_orig/* /var/lib/asterisk
else
# フォルダもない。マウントされてない。リネームで対応
mv /var/lib/asterisk_org /var/lib/asterisk
fi
fi

exec /usr/sbin/asterisk -f</nowiki>

/var/lib/asteriskにastdb.sqlite3がなければ初回起動として、ファイルをコピーします。

===ビルド===
docker build --build-arg asterisk_version=22.5.1 -t asterisk:22.5.1 .

このイメージはビルドすると409MB程度となります。

==イメージを起動する==
設定ファイルは別途用意してください。

通常、Dockerでイメージを起動する場合、ネットワークはbridgeネットワークを用い、-pオプションでポートを指定しますが、Asteriskでbridgeネットワークを使用すると、UDPポートでの通信がうまく行かなかったため、--network hostを使い、直接Dockerホストのポートで待ち受けをさせます。

例えば、設定ファイルは'''./asterisk-conf'''、ログファイルは'''./asterisk-log'''に配置、更に、astdb.sqlite3を含むastvarlibdir、録音ファイルや留守番電話のastspooldirをボリュームマウントする場合、次のように起動します。

docker run -d --name asterisk --rm --network host -v $(pwd)/asterisk-conf:/etc/asterisk:ro -v $(pwd)/asterisk-log:/var/log/asterisk:rw -v $(pwd)/asterisk-spool:/var/spool/asterisk:rw -v $(pwd)/asterisk-lib:/var/lib/asterisk:rw asterisk:22.5.1

特に問題なく動けばOKです。

==Asterisk CLIに入る==
docker exec -it asterisk asterisk -vvvvcr

で入れます。

Asterisk pjsip trunk @niftyフォン-C

2025-09-04T03:40:24Z

Takatyan: Asterisk 22の情報追加、他アップデート。

[[カテゴリ:Asterisk]]
[[カテゴリ:Pjsip]]
[[カテゴリ:ITSP]]
== [http://ipphone.nifty.com/niftyphone/c @niftyフォン-C]とは ==

インターネットサービスプロバイダ「@nifty」の提供するIP電話サービスで、050番のIP電話の1つです。 
NTTコミュニケーションズの基盤を利用しています([http://ipphone.nifty.com/niftyphone/c/kiyaku/index.htm @niftyフォン-Cの利用規約] 第1条第1項)。

== 特徴 ==

=== メリット ===
* @niftyの接続サービスを利用していれば(@niftyをプロバイダとして利用しているだけでもOK)'''基本料金0円'''で維持費がユニバーサルサービス料のみ。
* 同じくNTTコミュニケーションズの基盤を利用する、050plus等のIP電話への通話料が無料。
* Asteriskに収容可能('''重要'''、ただし非公式)。
* 2025年8月現在でも(@niftyの接続サービスを利用していれば)新規申し込み可能。
* 携帯電話から発信するよりは、通話料は安い。

=== デメリット ===
* 050IP電話の需要は減少傾向らしくサービスの継続性に疑問がある。
* @niftyの接続サービスにロックインされ、他の事業者に番号を持ち運べない。
* 110, 119等1XY 特番、0120, 0570等0AB0 特番には発信できない。
* 2024年よりNTTの固定電話の発信も全国一律料金となり、050IP電話も通話料金が安いとは今や言えなくなっている。

== Asterisk 22 ==

Asterisk 16から設定を変更せずとも発着信可能(2025年8月)

== Asterisk 16 ==

以下の設定で発着信可能(2020年8月)

=== pjsip.conf ===
<nowiki>
; 050NNNNNNNN は@niftyフォン-Cの050電話番号
; ABCDEFGHIはVoIPユーザ ID
; abcdefghiはVoIPユーザパスワード
; v???NN.nifty.comはVoIPサーバ名(SIPサーバアドレス、REGISTERサーバアドレス)
; nifty.comはSIP-URL(SIPドメイン名)

[atniftyphone]
type=aor
contact=sip:ABCDEFGHI@v???NN.nifty.com

[atniftyphone]
type=identify
endpoint=atniftyphone
match=v???NN.nifty.com

[atniftyphone]
type=auth
auth_type=userpass
username=ABCDEFGHI
password=abcdefghi

[atniftyphone]
type=registration
transport=transport-udp
outbound_auth=atniftyphone
contact_user=050NNNNNNNN
server_uri=sip:v???NN.nifty.com
client_uri=sip:050NNNNNNNN@nifty.com
retry_interval=60

[atniftyphone]
type=endpoint
transport=transport-udp
context=from-atniftyphone
disallow=all
allow=ulaw
dtmf_mode=inband
direct_media=no
send_pai=yes
inband_progress=no
outbound_auth=atniftyphone
from_user=050NNNNNNNN
from_domain=nifty.com
aors=atniftyphone
language=ja ; お好みで</nowiki>

=== extensions.conf ===

一例です。

<nowiki>; 発信
[default]
exten => _0.,1,Dial(PJSIP/${EXTEN}@atniftyphone)
same => n,Congestion
same => n,Hangup

; 着信
[globals]
ATNIFTYPHONENUMBER=050NNNNNNNN

[from-atniftyphone]
exten => ${ATNIFTYPHONENUMBER},1,Dial(.....) ; 着信先を設定する
same => n,Congestion
same => n,Hangup</nowiki>

=== 確認 ===
[[Asterisk CLI]]で<code>pjsip registrations show</code>を実行し、次のようにRegisteredと表示されればOK
<nowiki><Registration/ServerURI..............................> <Auth....................> <Status.......>
==========================================================================================

atniftyphone/sip:v???NN.nifty.com atniftyphone Registered (exp. 1740s)

Objects found: 1</nowiki>

(上記はAsterisk 22の表示です) 
''Unregistered''の場合はしばらく待つ。''Rejected''の場合は、設定間違いまたは、下記注意点を参照。

=== 注意点 ===
@niftyフォン-CはPPPoE接続経由でのアクセスが必須？のようであり、IPv4 over IPv6技術を利用したv6プラスやOCNバーチャルコネクト経由では使用できませんので、PPPoE接続を併用するなどの工夫が必要となります。

@niftyフォン-Cはqualifyには非対応のようで、qualify_frequency、authenticate_qualifyを設定するとうまくいきませんのでご注意ください。

また、@niftyフォン-Cのサーバーには、過剰なREGISTERを拒否する仕組みがあるようで、Asteriskの再起動を繰り返すなどしてREGISTERが繰り返されると、REGISTERを拒否されることがあるようです(上記確認で''Rejected''と表示される)。

Asterisk Startup systemd

2025-09-02T10:39:28Z

Takatyan:

[[カテゴリ:Asterisk]]

systemdは2010年頃から、それまでのSystem V initに代わって導入された、システム・サービスマネージャです。

Asteriskは16頃から、systemdとの連携に対応しており、systemdと連携することにより、Asteriskの起動成功をsystemdに報告することができます。
:参考：https://github.com/asterisk/asterisk/commit/07b95f7c65b7c083724f1af2b26f93cc22cad58c

==systemd連携を利用する==

configureを実行する前に、Debian系列ではlibsystemd-dev、RedHatの系列ではsystemd-develをインストールしておきます。
その後Asteriskをビルドします。

ビルドが済んだasteriskの実行ファイルにlddを実行し、libsystemdへのリンクが表示されれば、systemdと連携するAsteriskがビルドできています。

<nowiki>$ ldd /usr/sbin/asterisk
(略)
libsystemd.so.0 => /lib64/libsystemd.so.0 (0x00007fe58cda0000)</nowiki>

現在では、<code>make config</code>でインストールされるsystemdユニットファイルはsystemdとの連携を利用する形式になっています。

==systemdと連携しない場合==

systemdとの連携機能を使用せず、単にsystemdにAsteriskを起動するだけをさせたい場合、以下の内容で /etc/systemd/system/asterisk.service ファイルを作成します。 
:出所 https://community.asterisk.org/t/solved-centos-7-compatible-init-d-or-systemd-script-for-asterisk-13/66359 
[Unit]
Description=Asterisk PBX and telephony daemon
Documentation=man:asterisk(8)
Wants=network.target
After=network.target

[Service]
Type=simple
#User=asterisk
#Group=asterisk
Environment=HOME=/var/lib/asterisk
WorkingDirectory=/var/lib/asterisk
ExecStart=/usr/sbin/asterisk -f -C /etc/asterisk/asterisk.conf
ExecStop=/usr/sbin/asterisk -rx 'core stop now'
ExecReload=/usr/bin/asterisk -rx 'core reload'

# safe_asterisk emulation
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
User/Groupをasteriskにする場合にはコメントを外してください。 

==起動と終了==
以下を実行して起動します。
systemctl daemon-reload
systemctl enable
systemctl start asterisk

利用者:Takatyan/sandbox/Asterisk on Docker

2025-09-01T03:59:12Z

Takatyan: Takatyan がページ「利用者:Takatyan/sandbox/Asterisk on Docker」を「Asterisk on Docker」に移動しました

#転送 [[Asterisk on Docker]]

Asterisk on Docker

2025-09-01T03:59:12Z

Takatyan: Takatyan がページ「利用者:Takatyan/sandbox/Asterisk on Docker」を「Asterisk on Docker」に移動しました

[[Asterisk 22]]をDockerで動かそう！
Dockerとは、コンテナ仮想化のためのプラットフォームです。

Asteriskには公式のDockerイメージがないようです。
インターネットを探すと、有志が構築したイメージやDockerfileがありますが、古かったり、マルチステージビルドでなく最終イメージのサイズが大きかったりして、良さそうなものがなかったので、独自のDockerfileを作成しました。

Linuxで、x86_64のマシンで試しています。[[Opusコーデック]]がARM非対応のため、ARMは試しておりません。

==Dockerfile==
このDockerfileは、[[Opusコーデック]]を使用しています。

<nowiki>FROM debian:bookworm-slim AS base

RUN echo "APT::Install-Recommends 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& echo "APT::Install-Suggests 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& apt-get update -qq \
&& apt -y install readline-common uuid libxml2 libsqlite3-0 libssl3 net-tools dnsutils ca-certificates curl xmlstarlet \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives

FROM base AS build
ARG asterisk_version=22.5.1
ENV TZ Asia/Tokyo
WORKDIR /build
RUN apt-get update \
&& apt -y install build-essential libedit-dev uuid-dev pkg-config libxml2-dev libsqlite3-dev sqlite3 libssl-dev net-tools dnsutils \
\
&& curl http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-${asterisk_version}.tar.gz | tar xfz - \
&& cd /build/asterisk-${asterisk_version} \
&& ./configure --with-jansson-bundled \
&& make menuselect.makeopts \
&& menuselect/menuselect --enable codec_opus --enable CORE-SOUNDS-EN-WAV --disable CORE-SOUNDS-EN-GSM menuselect.makeopts \
&& make -j$(nproc) \
&& make install \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives \
&& cd / && tar cfz libasterisk.tar.gz usr/lib/libasteriskpj.* usr/lib/libasteriskssl.*

FROM base
RUN mkdir /usr/lib/asterisk
COPY --from=build /usr/lib/asterisk/modules /usr/lib/asterisk/modules
COPY --from=build /usr/sbin/astcanary /usr/sbin/astdb2bdb /usr/sbin/astdb2sqlite3 /usr/sbin/asterisk /usr/sbin/astversion /usr/sbin/astgenkey /usr/sbin/autosupport /usr/sbin/
COPY --from=build /usr/sbin/rasterisk /usr/sbin/safe_asterisk /usr/sbin/
COPY --from=build /var/lib/asterisk /var/lib/asterisk
COPY --from=build /libasterisk.tar.gz /libasterisk.tar.gz
RUN tar xf /libasterisk.tar.gz \
&& cd /var/lib/asterisk/sounds \
&& curl -o core-sound-ja.tgz -L https://github.com/takao-t/asterisk-sound-ja/raw/refs/heads/master/core-sound-ja.tgz \
&& tar xf core-sound-ja.tgz \
&& rm -f core-sound-ja.tgz

ENTRYPOINT ["/usr/sbin/asterisk", "-f", "-C", "/etc/asterisk/asterisk.conf"]</nowiki>

==イメージをビルドする==
docker build --build-arg asterisk_version=22.5.1 -t asterisk:22.5.1 .

このイメージはビルドすると409MB程度となります。

==イメージを起動する==
設定ファイルは別途用意してください。

通常、Dockerでイメージを起動する場合、ネットワークはbridgeネットワークを用い、-pオプションでポートを指定しますが、Asteriskでbridgeネットワークを使用すると、UDPポートでの通信がうまく行かなかったため、--network hostを使い、直接Dockerホストのポートで待ち受けをさせます。

例えば、設定ファイルは'''./asterisk-conf'''、ログファイルは'''./asterisk-log'''に配置する場合、

docker run -d --name asterisk --rm --network host -v $(pwd)/asterisk-conf:/etc/asterisk:ro -v $(pwd)/asterisk-log:/var/log/asterisk:rw asterisk:22.5.1

特に問題なく動けばOKです。

==Asterisk CLIに入る==
docker exec -it asterisk asterisk -vvvvcr

Asterisk on Docker

2025-09-01T03:58:53Z

Takatyan:

Asterisk on Docker

2025-08-28T06:01:12Z

Takatyan: ページの作成:「Asterisk 22をDockerで動かそう！ Asteriskには公式のDockerイメージがないようです。インターネットを探すと、有志が構築したイメージやDockerfileがありますが、古かったり、マルチステージビルドでなく最終イメージのサイズが大きかったりして、良さそうなものがなかったので、独自のDockerfileを作成しました。 Linuxで、x86_64のマシンで試しています…」

[[Asterisk 22]]をDockerで動かそう！

Asteriskには公式のDockerイメージがないようです。
インターネットを探すと、有志が構築したイメージやDockerfileがありますが、古かったり、マルチステージビルドでなく最終イメージのサイズが大きかったりして、良さそうなものがなかったので、独自のDockerfileを作成しました。

Linuxで、x86_64のマシンで試しています。[[Opusコーデック]]がARM非対応のため、ARMは試しておりません。

==Dockerfile==
このDockerfileは、[[Opusコーデック]]を使用しています。

<nowiki>FROM debian:bookworm-slim AS base

RUN echo "APT::Install-Recommends 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& echo "APT::Install-Suggests 0;" >> /etc/apt/apt.conf.d/01norecommends \
&& apt-get update -qq \
&& apt -y install readline-common uuid libxml2 libsqlite3-0 libssl3 net-tools dnsutils ca-certificates curl xmlstarlet \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives

FROM base AS build
ARG asterisk_version=22.5.1
ENV TZ Asia/Tokyo
WORKDIR /build
RUN apt-get update \
&& apt -y install build-essential libedit-dev uuid-dev pkg-config libxml2-dev libsqlite3-dev sqlite3 libssl-dev net-tools dnsutils \
\
&& curl http://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-${asterisk_version}.tar.gz | tar xfz - \
&& cd /build/asterisk-${asterisk_version} \
&& NOISY_BUILD=yes ./configure --with-jansson-bundled \
&& make menuselect.makeopts \
&& menuselect/menuselect --enable codec_opus --enable CORE-SOUNDS-EN-WAV --disable CORE-SOUNDS-EN-GSM menuselect.makeopts \
&& make -j$(nproc) \
&& make install \
&& apt-get autoremove -y \
&& apt-get clean \
&& rm -rf /var/lib/apt/lists /var/cache/apt/archives \
&& cd / && tar cfz libasterisk.tar.gz usr/lib/libasteriskpj.* usr/lib/libasteriskssl.*

FROM base
RUN mkdir /usr/lib/asterisk
COPY --from=build /usr/lib/asterisk/modules /usr/lib/asterisk/modules
COPY --from=build /usr/sbin/astcanary /usr/sbin/astdb2bdb /usr/sbin/astdb2sqlite3 /usr/sbin/asterisk /usr/sbin/astversion /usr/sbin/astgenkey /usr/sbin/autosupport /usr/sbin/
COPY --from=build /usr/sbin/rasterisk /usr/sbin/safe_asterisk /usr/sbin/
COPY --from=build /var/lib/asterisk /var/lib/asterisk
COPY --from=build /libasterisk.tar.gz /libasterisk.tar.gz
RUN tar xf /libasterisk.tar.gz \
&& cd /var/lib/asterisk/sounds \
&& curl -o core-sound-ja.tgz -L https://github.com/takao-t/asterisk-sound-ja/raw/refs/heads/master/core-sound-ja.tgz \
&& tar xf core-sound-ja.tgz \
&& rm -f core-sound-ja.tgz

ENTRYPOINT ["/usr/sbin/asterisk", "-f", "-C", "/etc/asterisk/asterisk.conf"]</nowiki>

==イメージをビルドする==
docker build --build-arg asterisk_version=22.5.1 -t asterisk:22.5.1

このイメージはビルドすると416MB程度となります。

==イメージを起動する==
設定ファイルは別途用意してください。

通常、Dockerでイメージを起動する場合、ネットワークはbridgeネットワークを用い、-pオプションでポートを指定しますが、Asteriskでbridgeネットワークを使用すると、UDPポートでの通信がうまく行かなかったため、--network hostを使い、直接Dockerホストのポートで待ち受けをさせます。

例えば、設定ファイルは'''./asterisk-conf'''、ログファイルは'''./asterisk-log'''に配置する場合、

docker run -d --name asterisk --rm --network host -v $(pwd)/asterisk-conf:/etc/asterisk:ro -v $(pwd)/asterisk-log:/var/log/asterisk:rw asterisk:22.5.1

特に問題なく動けばOKです。

Asterisk

2024-08-14T08:46:53Z

Takatyan: /* バージョン */

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
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,16,18
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15,17
::STD(Standard:標準サポートバージョン)

{| class="wikitable" style="margin:auto"
|-
! バージョン !! リリース日(現地時間) !! サポート期限 !! セキュリティサポート期限 !! LTS
|-
| Asterisk 10 || || || || ✗
|-
| Asterisk 11 || || || || ◯
|-
| Asterisk 12 || || || || ✗
|-
| [[Asterisk 13]] || 2014年10月24日 || 2020年10月24日 || 2021年10月24日 || ◯
|-
| Asterisk 14 || 2016年09月26日 || 2017年09月26日 || 2018年09月26日 || ✗
|-
| Asterisk 15 || 2017年10月03日 || 2018年10月03日 || 2019年10月03日 || ✗
|-
| [[Asterisk 16]] || 2018年10月09日 || 2026年10月19日 || 2027年10月09日 || ◯
|-
| Asterisk 17 || 2019年10月28日 || 2020年10月28日 || 2021年10月28日 || ✗
|-
| [[Asterisk 18]] || 2020年10月20日 || 2024年10月20日 || 2025年10月20日 || ◯
|-
| Asterisk 19 || 2021年11月02日 || 2022年11月02日 || 2023年11月02日 || ✗
|-
| [[Asterisk 20]] || 2022年10月19日 || 2026年10月19日 || 2027年10月19日 || ◯
|-
| [[Asterisk 21]] || 2023年10月18日 || 2025年10月18日 || 2026年10月18日 || ✗
|}

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2023年11月)時点で安定していると思われるのはAsterisk 18です。 
EOLまでの時間を気にする場合にはAsterisk 20を検討してください。 

===オプションのパッケージ===
*[[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リリースのため使用は推奨しません。 
*Asterisk 16
:2018年10月リリース。LTS。(Security Onlyは2022/10、EOLは2023/10)
*Asterisk 17
:STDリリースのため使用は推奨しません。 
*Asterisk 18
:2020年10月リリース。LTS。(Security Onlyは2024/10、EOLは2025/10)
*Asterisk 20
:2022年10月リリース。LTS。

===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を日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*<s>[[Asterisk パッチ]]</s>(現在のバージョンでは必要ありません)
*[[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 pjsip

2024-08-12T15:54:59Z

Takatyan: CLIからcore reloadでリロードする方法を記載。

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

AsiteriskでチャネルにPjSIPを使用する際の設定方法など 
注意！：Asterisk 21(non LTS)ではchan_sipが削除されています。次のAsterisk 22(LTS)でもchan_sipは提供されないと思われますので、早急にpjsipへの移行を進めてください。
==コンパイル==
Asterisk 13まではpjprojectを別個インストールするか、configureに--with-pjproject-bundledを付けて実行する必要がありましたが、Asterisk 16からはデフォルトでbundledインストールされるようになりました。 
各バージョン毎のインストール方法についてはAsteriskのそれぞれのページを参照してください。 
[[Asterisk 13]] 
[[Asterisk 16]] 
※Asterisk 16以降ではデフォルトでコンパイルされるためasteriskをmakeするだけです。

==変換ツール==
Asterisk 13以降であればソースディレクトリ/contrib/scripts/sip_to_pjsip の下にPythonのスクリプトがあります(複数)。sip.confのあるディレクトリでこれを実行するとpjsip.confに変換してくれます。#includeしている場合にはそれらも変換してくれますが、完璧ではないです。
==Asterisk 16以降における注意点==
PjSIPはres_statsd.soに依存します。このためres_statsdがloadされていないと、res_pjsipがloadされない問題が発生します。 
(Asterisk 16ではモジュールの依存関係チェックが厳密化されています) 
res_statsdモジュールはstatsd.confファイルが無いとloadされないため、statsd.confファイルが無いだけで、PjSIPが使えないという困った状態になります。ソースファイルに含まれる statsd.conf.sample を /etc/asterisk/statsd.conf にコピーしておいてください。もっとも、このファイルはコメントされた行だけなので要するに空なのですが。

==パラメータ一覧==
[[Asterisk pjsip parameters]]

==基本設定==
*間違いやすいところ
:sip.confでは1wordだったのがアンダーバーが入る
:dtmfmode → dtmf_mode
:fromdomain → from_domain
===グローバル設定===
設定は基本としてはpjsip.confに書きます。 
*[[Asterisk_pjsip_parameters#GLOBAL]] 
グローバル設定を使用する場合にはtype=globalのセクションを書きます。 
<nowiki>[global]
type=global
max_forwards = 50</nowiki>
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。 
*[[Asterisk_pjsip_parameters#SYSTEM]] 

===インクルード===
Asteriskの他の設定ファイル同様に#includeが使えます。なので、電話機と回線は別ファイルにした方が見通しは良いかもしれません。例えば 
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070

#include pjsip_phones.conf
#include pjsip_trunk_hikari.conf
のようにファイルを分割し、includeすると管理が楽になります。

基本で必要なものは以下です。

===トランスポート===
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。 

===ACL===
ACLの例は次の通りです。
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
※deny,permitはこの順でないとpermitしてdenyしてしまう模様で、逆に書くと誰も使えなくなります。 
 
pjsip.confに複数のACL(type=acl)を書くとそのセクション名にかかわらず後ろにあるACLの方が勝つ模様。 
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16

[acl-my]
type=acl
deny=0.0.0.0/0.0.0.0
permit=10.10.0.0/16
と、書くとacl-myが勝つので要注意です。複数を許可したい場合には1セクションで
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
permit=10.10.0.0/16
のように書きます。 
*[[Asterisk_pjsip_parameters#ACL.28res_pjsip_acl.29]]
→[[Asterisk pjsip ACL]]

===認証情報(Auth)===
sip_confではピア(エンドポイント)の認証がわかりにくかったのですが、PjSIPでは別なセクションで(type=auth)認証情報を定義するようになりました。このため、認証情報がピア名(sip.confの[ ])に紐付かなくなりました。 
慣れないとわかりにくい感じがしますが、管理がより柔軟になります。例えば
[some-phone]
type = endpoint
.
.
.
auth = phone-auth
outbound_auth = phone-out-auth
のようなendpointが定義されている場合には、2つのauthセクションが必要です。
[phone-auth]
type = auth
username = phone123
password = phonepassword
このAuthは'[some-phone]'エンドポイントに接続、つまり外からの"入り"の際の認証情報です。 
[phone-out-auth]
略
このAuthはoutbound_authで設定されているので、このエンドポイントからの"出"の際の認証情報です。 

==電話機==
電話機の接続は [[Asterisk pjsip 電話機]] のページへ
==トランク==
回線接続側は [[Asterisk pjsip trunks]]のページへ

==Wizard==
Asteriskにはpjsip_wizardが組み込まれており、PjSIPの設定を簡素化することができます。使う場合の条件は以下の通りです。
*基本の設定はpjsip.confに書く
:transportなどの情報はpjsip.confに書く必要があります
*Wizard用のファイル名はpjsip_wizard.conf
*共通化したテンプレート内で各セクションを指定するにはスラッシュ(/)で区切る
*Wizardは電話機でもトランクでも使用できる
:registration/を書くとregistrationセクションがつくられる
記述例:
:endpoint/context=mycontext
:endpoint/dtmf_mode=inband
:aor/max_contacts = 1
pjsip_wizard.confの記述例
;電話機用テンプレート(共通設定)
[phone-defaults](!)
type=wizard
transport = transport-udp
accepts_registrations = yes
sends_registrations = no
accepts_auth = yes
sends_auth = no
endpoint/context = default
endpoint/dtmf_mode = rfc4733
endpoint/call_group = 1
endpoint/pickup_group = 1
endpoint/language = ja
endpoint/disallow = all
endpoint/allow = ulaw
endpoint/rtp_symmetric = yes
endpoint/force_rport = yes
endpoint/direct_media = no
endpoint/send_pai = yes
endpoint/send_rpid = yes
endpoint/rewrite_contact = yes
endpoint/inband_progress = yes
endpoint/allow_subscribe = yes
endpoint/transport = transport-udp
aor/max_contacts = 1
aor/qualify_frequency = 30
aor/authenticate_qualify = no

;各電話機個別設定
[phone1](phone-defaults)
inbound_auth/username = phone1
inbound_auth/password = mypasswordishere

==CLIコマンド==
*sip show peersに対応するのはpjsip show endpoints
*sip show peer phone1などピア情報を表示するのはpjsip show endpoint phone1
*AORを表示するのは一覧ならpjsip show aorsでピアの情報を表示するのはpjsip show aor phone1のようにする
*それぞれの設定項目で何が設定されているかを確認するには pjsip show endpoint phone1 のようにすると phone1 の endpoint パラメータ一覧が表示される。aorを見たければ pjsip show aor phone1。これはトランクの場合も同様で pjsip show registration hikari-hgw のようにするとregister関係のパラメータがみえる。
===デバッグ===
chan_sipのsip debug代わりに使えるのは、pjsip debug history。SIPメッセージの確認はこちらの方が簡単かも。

ヒストリをクリア
*CLI> pjsip set history clear
PJSIP History cleared

ヒストリをONに設定
*CLI> pjsip set history on
PJSIP History enable

なんかやる

ヒストリをOFFに設定
*CLI> pjsip set history off
PJSIP History disabled

ヒストリをみる
*CLI> pjsip show history
No. Timestamp (Dir) Address SIP Message
===== ========== ============================== ===================================
00047 1620781794 * <== 192.168.254.10:5060 INVITE sip:201@192.168.254.234:5070 SIP/2.0
00048 1620781794 * ==> 192.168.254.10:5060 SIP/2.0 401 Unauthorized
00049 1620781794 * <== 192.168.254.10:5060 ACK sip:201@192.168.254.234:5070 SIP/2.0
00050 1620781794 * <== 192.168.254.10:5060 INVITE sip:201@192.168.254.234:5070 SIP/2.0
00051 1620781794 * ==> 192.168.254.10:5060 SIP/2.0 100 Trying
00052 1620781794 * ==> 192.168.254.3:5060 INVITE sip:phone1@192.168.254.3:5060 SIP/2.0
00053 1620781794 * <== 192.168.254.3:5060 SIP/2.0 100 Trying
00054 1620781795 * ==> 192.168.254.4:5060 OPTIONS sip:phone6@192.168.254.4:5060 SIP/2.0
00055 1620781795 * <== 192.168.254.4:5060 SIP/2.0 200 OK
00056 1620781796 * <== 192.168.254.3:5060 SIP/2.0 180 Ringing
00057 1620781796 * ==> 192.168.254.10:5060 SIP/2.0 183 Session Progress
00058 1620781797 * <== 192.168.254.3:5060 SIP/2.0 200 OK
00059 1620781797 * ==> 192.168.254.3:5060 ACK sip:phone1@192.168.254.3:5060 SIP/2.0
00060 1620781797 * ==> 192.168.254.10:5060 SIP/2.0 200 OK
00061 1620781797 * <== 192.168.254.10:5060 ACK sip:192.168.254.234:5070 SIP/2.0
00062 1620781799 * <== 192.168.254.3:5060 BYE sip:asterisk@192.168.254.234:5070 SIP/2.0
00063 1620781799 * ==> 192.168.254.3:5060 SIP/2.0 200 OK
00064 1620781799 * ==> 192.168.254.10:5060 BYE sip:phone3@192.168.254.10:5060 SIP/2.0
00065 1620781799 * <== 192.168.254.10:5060 SIP/2.0 200 OK

特定のメッセージを確認する
*CLI> pjsip show history entry 56
<--- History Entry 56 Received from 192.168.254.3:5060 at 1620781796 --->
SIP/2.0 180 Ringing
Via: SIP/2.0/UDP 192.168.254.234:5070;rport=5070;received=192.168.254.234;branch=z
Call-ID: fd5b758b-06e4-48cf-97e9-c815623ba9af
From: "203" <sip:203@192.168.254.234>;tag=bedf1400-19fc-4c8d-80c2-f7a280ca9978
To: <sip:phone1@192.168.254.3>;tag=1946423440
CSeq: 4197 INVITE
Allow: INVITE, ACK, CANCEL, BYE, INFO, UPDATE, OPTIONS, MESSAGE, NOTIFY, REFER
Contact: <sip:phone1@192.168.254.3:5060>
Server: Panasonic-KX-HDV330N/02.504 (bcc3423c1e0c)
Content-Length: 0
Content-Length: 0

chan_sipのようにダラダラ出したい場合は
*CLI> pjsip set logger on

==挙動上の注意点==
===挙動そのもの===
chan_sipより制限が少し"きつい"です。SIPメッセージの中に少しおかしなものがあってもchan_sipでは制限が緩かったので、通っていたものがPjSIPでは通らないことがあります。CLI等で'syntax error'のようなメッセージが出る場合にはSIPメッセージにおかしなところがあるかもしれないので調べてください。
===AddHeader===
chan_sipの場合にはSIPAddHeaderでSIPヘッダを追加できましたが、PjSIPではファンクションPJSIP_HEDER()を使用します。ただしこのファンクションはextenの途中で使用しても効果がありません。Dial時にサブルーチンコールしてやる必要があります。 
例えばAlert-Info: hogeを追加するにはまず以下のよなルーチンを定義します。
[add-alert]
exten => s,1,Set(PJSIP_HEADER(add,Alert-Info)=hoge)
exten => s,n,Return
Dial時に以下のようにしてコールします
exten => 201,1,Dial(PJSIP/201,,b(add-alert,s,1))
===エンドポイントの識別===
エンドポイントを識別する際に例えば同一IPアドレスから複数のユーザ名でREGISTERあるいはINVITEしてくるような場合、ユーザ名が正しく識別されないことがあります。これはエンドポイントを識別する際の判断要素の問題で、endpoint_identifier_order で決まります。 
グローバル設定の endpoint_identifier_order は、デフォルトでip,username,anonymous,header,auth_usernameの順で識別するため、IPアドレスが同一だと同一エンドポイントであると評価してしまいます。このためユーザ名で識別したいような場合には endpoint_identifier_order = username,ip のようにipより前にusernameを指定します。 
現在の状態を確認するにはCLIから pjsip show identifiers を実行します。
*CLI> pjsip show identifiers
Identifier Names:
name not specified
ip
username
anonymous
auth_username
header
request_uri

==設定変更の反映==
*モジュール数が多すぎて一発リロードする方法がよくわからない
** [[Asterisk CLI]]で <pre>core reload</pre> を行えば、その他のモジュールといっしょにリロードできます(Asterisk 16と20で確認)。
*module reload res_pjsip.soを実行すれば"だいたい"はいけそう
:wizardのaor/を変更しても反映されない場合がある

==PjSIPで拡張される機能==
[[pjsip_機能拡張]]

Pjsip 機能拡張

2024-08-12T13:34:31Z

Takatyan:

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

chan_pjsipではchan_sipでは実現できなかった機能が提供されています。
==複数レジスト==
同一のユーザ名/パスワードで複数のUA(SIPクライアント)がRegisterできます。 
AORのmax_contactsがこの数を制御します。endpointでRegisterするタイプのクライアント、要するに電話機等ではAORでmax_contacts = 1を指定することで、Asteriskに対してRegisterしてくるUAを1にしますが、これをmax_contacts = 4に設定すると、4つまでのUAがRegisterできるようになります。 
EndppointやAORの設定は[[Asterisk pjsip]]のページを参照してください。 
ただし、ダイヤルする際の引数がこれまでとは異なるので注意します。 
Dialの引数にはファンクション、PJSIP_DIAL_CONTACTSを用います。
${PJSIP_DIAL_CONTACTS(phone1,phone1)
書式:PJSIP_DIAL_CONTACTS(endpoint[,aor[,request_user]])
上記の例ではエンドポイントphone1でAORもphone1のダイヤル先を取得します。 
このファンクションは次のような値を返します。
PJSIP/phone1/sip:phone1@192.168.1.27:5060&PJSIP/phone1/sip:phone1@192.168.1.14:60614;rinstance=1b2883b26cbc3051
上記の例ではphone1はphone1@192.168.1.27:5060と:phone1@192.168.1.14:60614からRegisterされています。この返値をDialコマンドに渡せば複数のUAに対してダイヤルします。
exten => 2001,1,Dial(${PJSIP_DIAL_CONTACTS(phone1,phone1))
このように書くことでphone1に対してRegisterしている2つのUA(電話機)に対してダイヤルすることができます。 
ACD機能ではないので内線の複数収容には向きませんが、あるユーザにひとつのユーザIDとパスワードを発行し、デスクフォンとスマートフォンを同時に使わせるような場合には便利です。
===複数レジストの副作用===
同一エンドポイントに対して複数レジストが可能なため一部電話機において副作用が発生します。 
unregisterせずにregisterしようとする電話機ではregisterしたまま再度registerしようとするため、前のregisterと新しいregisterを「別なcontact」としてAsteriskが判断してしまいます。 
以下の例では電話機のエンドポイント名は"FAP003"です。
[Feb 6 08:19:35] WARNING[27107] res_pjsip_registrar.c: Registration attempt from endpoint 'FAP003' (192.168.254.16:32062) to AOR 'FAP003' will exceed max contacts of 2
このようなメッセージが出る場合、pjsipの同一エンドポイントのmax contactsに達してしまっているので、それ以上のregisterができません。 
解決方法としては再registerする(電話機が再起動したときなど)にunregisterしてからregisterするオプションを電話機で設定してください。もし、電話機でそのようなオプションがない場合には一定時間(3600秒)経つとcontactが捨てられますので、再度registerできるようになるはずですが、設定やデバッグ中などで頻繁に再起動したい場合には以下の手順でcontact情報を消すことができます。 
*CLI> database show registrar/contact
を実行します。表示から以下のようなエントリを探します。
/registrar/contact/FAP003;@fe086ca9ab600f0098c73dd73bd0487d: {"via_addr":"192.168.254.16","qualify_timeout":(略)
registrar/contactの"FAP003;@fe086ca9ab600f0098c73dd73bd0487d"部分がキーになっています。"FAP003"の部分は使用している電話機のエンドポイント名なので環境にあわせて読み替えてください。このエントリを削除すればmax contactsから1つ減らすことができるので、再度registerすることができるようになります。以下の例のように削除します。
database del registrar/contact FAP003;@fe086ca9ab600f0098c73dd73bd0487d
※Grandstreamの一部電話機では再register時のunregisterを実行「しない」がデフォルト設定になっているようです。(「再起動時に登録を取り消す」オプションを「すべて」に設定するとunregisterします) 
 
====Asterisk側での解決方法====
PjSIPの設定で、該当するエンドポイントのAORに remove_existing = yes を入れます。remove_existing はデフォルトでは no に設定されています。これを入れると(おそらく)同一IPからのregisterは同じものとみなして再度registerされる際に元のを削除します。 
コピペで使う人もいるのでwizardの設定例にも書いておきました。

Asterisk

2024-08-08T02:12:45Z

Takatyan: バージョンの表を作成.

[[Category:Asterisk]]
[[Category:VoIP]]
==Asterisk: Open Source Communication Framework==
AsteriskはオープンソースのPBXでDigiumのMark Spencerによって始められました。(主に)Linuxプラットフォーム上で動作します。 
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,16,18
::LTS(Long Term Support:長期サポートバージョン)
:10,12,14,15,17
::STD(Standard:標準サポートバージョン)

{| class="wikitable" style="margin:auto"
|-
! バージョン !! リリース日(現地時間) !! サポート期限 !! セキュリティサポート期限 !! LTS
|-
| Asterisk 10 || || || || ✗
|-
| Asterisk 11 || || || || ◯
|-
| Asterisk 12 || || || || ✗
|-
| [[Asterisk 13]] || 2014年10月24日 || 2020年10月24日 || 2021年10月24日 || ◯
|-
| Asterisk 14 || 2016年09月26日 || 2017年09月26日 || 2018年09月26日 || ✗
|-
| Asterisk 15 || 2017年10月03日 || 2018年10月03日 || 2019年10月03日 || ✗
|-
| [[Asterisk 16]] || 2018年10月09日 || 2026年10月19日 || 2027年10月09日 || ◯
|-
| Asterisk 17 || 2019年10月28日 || 2020年10月28日 || 2021年10月28日 || ✗
|-
| [[Asterisk 18]] || 2020年10月20日 || 2024年10月20日 || 2025年10月20日 || ◯
|-
| Asterisk 19 || 2021年11月02日 || 2022年11月02日 || 2023年11月02日 || ✗
|-
| [[Asterisk 20]] || 2022年10月19日 || 2026年10月19日 || 2027年10月19日 || ◯
|}

==Asteriskの入手とインストール==
Asteriskは http://www.asterisk.org から入手することができます。ソースの配布はftp/httpダウンロードの他、Subversionでも行われています。Subversionでの入手方法は[[Asterisk Subversion]]のページを参照してください。 
 
===どのバージョンをインストールすれば？===
現在(2023年11月)時点で安定していると思われるのはAsterisk 18です。 
EOLまでの時間を気にする場合にはAsterisk 20を検討してください。 

===オプションのパッケージ===
*[[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リリースのため使用は推奨しません。 
*Asterisk 16
:2018年10月リリース。LTS。(Security Onlyは2022/10、EOLは2023/10)
*Asterisk 17
:STDリリースのため使用は推奨しません。 
*Asterisk 18
:2020年10月リリース。LTS。(Security Onlyは2024/10、EOLは2025/10)
*Asterisk 20
:2022年10月リリース。LTS。

===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を日本国内に対応させる情報は下記を参照してください。 
===ローカライズ===
*<s>[[Asterisk パッチ]]</s>(現在のバージョンでは必要ありません)
*[[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 サンプル設定ファイル extensions.conf

2022-11-28T03:33:39Z

Takatyan: 変更を反映させる方法とCLIからの確認・テストを記載。

更なる例は[[Extension道場]]に記載があります。

==context==
extenの設定で一番わかりにくいのがこの、コンテキストだと思います。コンテキストとは<nowiki>' [ ] '</nowiki>で括られたセクションのことをいい、指定されたブロックをそのコンテキストと呼びます。
[incoming]
・
・
incoming context
・
・
[outgoing]
・
・
この例では<nowiki>[incoming]</nowiki>で指定された部分から、次の<nowiki>[outgoing]</nowiki>の前までの部分が
incomingコンテキストとなります。 
sip.confやiax.confなどでcontext=incomingが指定されていると、その相手(ITSPや電話機)からの着信や接続要求はこのコンテキスト内で行われます。
==exten==
extensions.confの基本的な書き方は次の通りです。
exten => 番号,プライオリティ,アプリケーション
番号
:これがextenそのもので、いわゆる内線番号に相当します。
プライオリティ
:処理の順番を書きます
アプリケーション
:Asteriskのアプリケーション・コマンドを書きます
:この部分にはアプリケーション・コマンドだけでなくファンクションと呼ばれるもの、あるいはPBX組み込み機能を記述することができます。
:アプリケーション・コマンドはモジュールのプレフィクスが app_ のものです。
:ファンクションはモジュールプレフィクスが func_ のものです。

==same==
前項extenでは、以降の例で見られるように「番号」を毎行書いていく必要があります。
これは面倒であり、Asterisk 1.6.2以降では、sameを使うと省略できます。

例えば、4312番にダイヤルしたときの動作を次のように書いているとします。
exten => 4312,1,NoOp()
exten => 4312,n,Dial(ダイヤル先)
exten => 4312,n,Hangup

sameを使うとこのように書けます。4312は最初のexten行のみに記載し、2行目以降はsameを使い、省略します。
exten => 4312,1,NoOp()
same => n,Dial(ダイヤル先)
same => n,Hangup

4312番への動作を書き終わり、別の番号への動作を書くときは、また「exten => 番号,1,処理」から書き始めます。

==generalセクション==
その名の通り全般のオプション指定を行います。
[general]
writeprotect=no
priorityjumping=no
writeprotect
:CLIによるextenの変更を許可するか禁止するかを指定します。
priorityjumping
:Asterisk 1.0系との互換性のためのオプションです。n+101ジャンプを使うか使わないかを指定しますが、今後は使わない方向ですのでnoを指定しておきます。
==globalsセクション==
グローバル変数を設定します。設定値は見ての通りで、Asteriskでは
変数=値
で、変数が設定できます。
[globals]
USEVOICEMAIL=YES
SPEAKINGCLOCK=317
ECHOTEST=333
;For Hikari Denwa
MYNUMBER=03XXXXXXXX
==defaultセクション==
この部分がdefaultコンテキストです。context=defaultが指定されたものは、ここで処理が行われます。 
全部を転記すると長くなりすぎるので、一部だけ解説します。 
===時報===
; Speaking Clock
exten => ${SPEAKINGCLOCK},1,Answer()
exten => ${SPEAKINGCLOCK},n,Wait(1)
exten => ${SPEAKINGCLOCK},n,Set(FutureTime=$[${EPOCH} + 5])
exten => ${SPEAKINGCLOCK},n,SayUnixTime(${FutureTime},Japan,YbdAPHM)
exten => ${SPEAKINGCLOCK},n,Playback(jp-desu)
exten => ${SPEAKINGCLOCK},n,playback(beep)
exten => ${SPEAKINGCLOCK},n,Hangup
ここで変数の参照を行っています。内線番号は変数、SPEAKINGCLOCKに指定された番号になります。値を参照するには'''${ }'''で括ります。 
プライオリティは本来、1,2,と順番に書くのですがAsterisk 1.2からオートインクリメントが可能になり'''n'''を記述しておくと自動的に+1するようになりました。 
===一斉呼び出し===
; Ring 201-204 phones
exten => 200,1,Dial(SIP/201&SIP/202&SIP/203&SIP/204&IAX2/201&IAX2/202&IAX2/203&IAX2/204)
exten => 200,n,Hangup
この例はSIP/201またはIAX/201～SIP/204またはIAX/204を一斉に呼び出す方法を示しています。Dialコマンドでは&で区切り複数の相手を指定することで、一斉に呼び出すことができます。 
===個別呼び出し===
; Local SIP/IAX phones 201-209
exten => _20Z,1,GotoIf($["${USEVOICEMAIL}"="YES"]?use-vm)
exten => _20Z,n,Dial(SIP/${EXTEN}&IAX2/${EXTEN},,tT)
exten => _20Z,n,Hangup
exten => _20Z,n(use-vm),Dial(SIP/${EXTEN}&IAX2/${EXTEN},60,tTwW)
exten => _20Z,n,NoOp(${DIALSTATUS})
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="BUSY"]?vm-rec)
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="NOANSWER"]?vm-rec)
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="CHANUNAVAIL"]?vm-rec)
exten => _20Z,n,Hangup
exten => _20Z,n(vm-rec),Answer()
exten => _20Z,n,Wait(1)
exten => _20Z,n,Voicemail(${EXTEN})
exten => _20Z,n,Hangup
まずextenの部分では_20Zのように指定してありますが、これはパターンマッチを意味します。Zは1～9までの数字に合致します。これにより個々の電話機を呼び出すextenをひとつづつ記述するのではなく、これだけで一括記述できるわけです。 
個別の内線番号を呼び出す設定ですが、ボイスメール使用可否の判断のため少し複雑になっています。 
n(use-vm) は'''ラベル'''です。Goto命令でジャンプさせる場合に、プライオリティの数字を指定するのではなくラベルを指定することができます。 
DIALSTATUSなどの変数は、各アプリケーションコマンドがセットします。例えばDIALSTATUSはDial()がセットし、ダイヤルした結果をその変数に入れます。 

===アプリケーション実行===
基本的に、Asteriskの機能はアプリケーションコマンドで実装されています。Dialもそのひとつですが、機能を「まとめて」ひとつのアプリケーションとなっている例としてはVoicemailやMeetMeがあります。
exten => 299,1,Answer()
exten => 299,n,Wait(1)
exten => 299,n,VoicemailMain(${CALLERID(num)},s)
exten => 299,n,Hangup
例えばこの部分はボイスメールのメニュー、再生などを行うVoicemailMainというアプリケーションを実行しています。この際の引数として発信者番号(<nowiki>${CALLERID(num)}</nowiki>)を使い、パスワード認証を行わない(s)という呼び出し方になっています。アプリケーションの引数とその意味を簡単に確認するには、CLIから core show application voicemailmainなどのようにアプリケーション名を指定します。
*CLI> core show application voicemailmain
-= Info about application 'VoiceMailMain' =-

[Synopsis]
Check Voicemail messages

[Description]
VoiceMailMain([mailbox][@context][,options]): This application allows the
calling party to check voicemail messages. A specific mailbox, and optional
corresponding context, may be specified. If a mailbox is not provided, the
calling party will be prompted to enter one. If a context is not specified,
the 'default' context will be used.

Options:
p - Consider the mailbox parameter as a prefix to the mailbox that
is entered by the caller.
g(#) - Use the specified amount of gain when recording a voicemail
message. The units are whole-number decibels (dB).
s - Skip checking the passcode for the mailbox.
a(#) - Skip folder prompt and go directly to folder specified.
Defaults to INBOX
VoicemailやMeetMeそれ自体の設定は、それぞれのアプリケーション用の設定ファイルで行います。voicemail.confやmeetme.confがそれです。

==反映とテスト==
extensions.confを変更したら、[[Asterisk CLI]]から次のコマンドを実行すると反映されます。
dialplan reload

現在読み込まれているextensions.confの内容(以下ダイヤルプランと言います)を見るには、Asterisk CLIで次のコマンドを実行します。
dialplan show

パターンマッチの内容のテストとして、例えばusersコンテキストから6421にダイヤルした場合の動作を表示するには、次のコマンドを実行します。
dialplan show 6421@users
この場合、真っ先にマッチするだろうパターン以外のダイヤルプランも表示されます。 
Hangup()やBusy()アプリケーションによって発信が終了されない場合、同じコンテキスト内の、真っ先にマッチするだろうパターンでないダイヤルプランの、探すべき優先度の行にも移っていく仕様なのでご注意ください。

参考:https://wiki.asterisk.org/wiki/display/AST/Pattern+Matching

Asterisk サンプル設定ファイル extensions.conf

2022-11-28T03:01:47Z

Takatyan: extensions.confでのsameの記載を追加。

==context==
extenの設定で一番わかりにくいのがこの、コンテキストだと思います。コンテキストとは<nowiki>' [ ] '</nowiki>で括られたセクションのことをいい、指定されたブロックをそのコンテキストと呼びます。
[incoming]
・
・
incoming context
・
・
[outgoing]
・
・
この例では<nowiki>[incoming]</nowiki>で指定された部分から、次の<nowiki>[outgoing]</nowiki>の前までの部分が
incomingコンテキストとなります。 
sip.confやiax.confなどでcontext=incomingが指定されていると、その相手(ITSPや電話機)からの着信や接続要求はこのコンテキスト内で行われます。
==exten==
extensions.confの基本的な書き方は次の通りです。
exten => 番号,プライオリティ,アプリケーション
番号
:これがextenそのもので、いわゆる内線番号に相当します。
プライオリティ
:処理の順番を書きます
アプリケーション
:Asteriskのアプリケーション・コマンドを書きます
:この部分にはアプリケーション・コマンドだけでなくファンクションと呼ばれるもの、あるいはPBX組み込み機能を記述することができます。
:アプリケーション・コマンドはモジュールのプレフィクスが app_ のものです。
:ファンクションはモジュールプレフィクスが func_ のものです。

==same==
前項extenでは、以降の例で見られるように「番号」を毎行書いていく必要があります。
これは面倒であり、Asterisk 1.6.2以降では、sameを使うと省略できます。

例えば、4312番にダイヤルしたときの動作を次のように書いているとします。
exten => 4312,1,NoOp()
exten => 4312,n,Dial(ダイヤル先)
exten => 4312,n,Hangup

sameを使うとこのように書けます。4312は最初のexten行のみに記載し、2行目以降はsameを使い、省略します。
exten => 4312,1,NoOp()
same => n,Dial(ダイヤル先)
same => n,Hangup

4312番への動作を書き終わり、別の番号への動作を書くときは、また「exten => 番号,1,処理」から書き始めます。

==generalセクション==
その名の通り全般のオプション指定を行います。
[general]
writeprotect=no
priorityjumping=no
writeprotect
:CLIによるextenの変更を許可するか禁止するかを指定します。
priorityjumping
:Asterisk 1.0系との互換性のためのオプションです。n+101ジャンプを使うか使わないかを指定しますが、今後は使わない方向ですのでnoを指定しておきます。
==globalsセクション==
グローバル変数を設定します。設定値は見ての通りで、Asteriskでは
変数=値
で、変数が設定できます。
[globals]
USEVOICEMAIL=YES
SPEAKINGCLOCK=317
ECHOTEST=333
;For Hikari Denwa
MYNUMBER=03XXXXXXXX
==defaultセクション==
この部分がdefaultコンテキストです。context=defaultが指定されたものは、ここで処理が行われます。 
全部を転記すると長くなりすぎるので、一部だけ解説します。 
===時報===
; Speaking Clock
exten => ${SPEAKINGCLOCK},1,Answer()
exten => ${SPEAKINGCLOCK},n,Wait(1)
exten => ${SPEAKINGCLOCK},n,Set(FutureTime=$[${EPOCH} + 5])
exten => ${SPEAKINGCLOCK},n,SayUnixTime(${FutureTime},Japan,YbdAPHM)
exten => ${SPEAKINGCLOCK},n,Playback(jp-desu)
exten => ${SPEAKINGCLOCK},n,playback(beep)
exten => ${SPEAKINGCLOCK},n,Hangup
ここで変数の参照を行っています。内線番号は変数、SPEAKINGCLOCKに指定された番号になります。値を参照するには'''${ }'''で括ります。 
プライオリティは本来、1,2,と順番に書くのですがAsterisk 1.2からオートインクリメントが可能になり'''n'''を記述しておくと自動的に+1するようになりました。 
===一斉呼び出し===
; Ring 201-204 phones
exten => 200,1,Dial(SIP/201&SIP/202&SIP/203&SIP/204&IAX2/201&IAX2/202&IAX2/203&IAX2/204)
exten => 200,n,Hangup
この例はSIP/201またはIAX/201～SIP/204またはIAX/204を一斉に呼び出す方法を示しています。Dialコマンドでは&で区切り複数の相手を指定することで、一斉に呼び出すことができます。 
===個別呼び出し===
; Local SIP/IAX phones 201-209
exten => _20Z,1,GotoIf($["${USEVOICEMAIL}"="YES"]?use-vm)
exten => _20Z,n,Dial(SIP/${EXTEN}&IAX2/${EXTEN},,tT)
exten => _20Z,n,Hangup
exten => _20Z,n(use-vm),Dial(SIP/${EXTEN}&IAX2/${EXTEN},60,tTwW)
exten => _20Z,n,NoOp(${DIALSTATUS})
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="BUSY"]?vm-rec)
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="NOANSWER"]?vm-rec)
exten => _20Z,n,GotoIf($["${DIALSTATUS}"="CHANUNAVAIL"]?vm-rec)
exten => _20Z,n,Hangup
exten => _20Z,n(vm-rec),Answer()
exten => _20Z,n,Wait(1)
exten => _20Z,n,Voicemail(${EXTEN})
exten => _20Z,n,Hangup
まずextenの部分では_20Zのように指定してありますが、これはパターンマッチを意味します。Zは1～9までの数字に合致します。これにより個々の電話機を呼び出すextenをひとつづつ記述するのではなく、これだけで一括記述できるわけです。 
個別の内線番号を呼び出す設定ですが、ボイスメール使用可否の判断のため少し複雑になっています。 
n(use-vm) は'''ラベル'''です。Goto命令でジャンプさせる場合に、プライオリティの数字を指定するのではなくラベルを指定することができます。 
DIALSTATUSなどの変数は、各アプリケーションコマンドがセットします。例えばDIALSTATUSはDial()がセットし、ダイヤルした結果をその変数に入れます。 

===アプリケーション実行===
基本的に、Asteriskの機能はアプリケーションコマンドで実装されています。Dialもそのひとつですが、機能を「まとめて」ひとつのアプリケーションとなっている例としてはVoicemailやMeetMeがあります。
exten => 299,1,Answer()
exten => 299,n,Wait(1)
exten => 299,n,VoicemailMain(${CALLERID(num)},s)
exten => 299,n,Hangup
例えばこの部分はボイスメールのメニュー、再生などを行うVoicemailMainというアプリケーションを実行しています。この際の引数として発信者番号(<nowiki>${CALLERID(num)}</nowiki>)を使い、パスワード認証を行わない(s)という呼び出し方になっています。アプリケーションの引数とその意味を簡単に確認するには、CLIから core show application voicemailmainなどのようにアプリケーション名を指定します。
*CLI> core show application voicemailmain
-= Info about application 'VoiceMailMain' =-

[Synopsis]
Check Voicemail messages

[Description]
VoiceMailMain([mailbox][@context][,options]): This application allows the
calling party to check voicemail messages. A specific mailbox, and optional
corresponding context, may be specified. If a mailbox is not provided, the
calling party will be prompted to enter one. If a context is not specified,
the 'default' context will be used.

Options:
p - Consider the mailbox parameter as a prefix to the mailbox that
is entered by the caller.
g(#) - Use the specified amount of gain when recording a voicemail
message. The units are whole-number decibels (dB).
s - Skip checking the passcode for the mailbox.
a(#) - Skip folder prompt and go directly to folder specified.
Defaults to INBOX
VoicemailやMeetMeそれ自体の設定は、それぞれのアプリケーション用の設定ファイルで行います。voicemail.confやmeetme.confがそれです。

アナログ電話機の接続

2022-03-19T13:30:03Z

Takatyan: /* ATA(Analog Telephone Adapter) */

Asteriskと普通のアナログ電話機を接続する方法です。主に以下の手段があります。
==アナログ・インタフェースカード==
*Digium [[TDM400P]]
==ATA(Analog Telephone Adapter)==
アナログ電話機を、VoIPベースのネットワークなどの電話網に接続する製品である。
*[[VoIPアダプタ(NTT東西)|VoIPアダプタ]] NTT東日本/西日本がレンタル、販売していたVoIPアダプタ。
*[[Linksys SPA3102]]
*[[Linksys PAP2T]]
*[[Digium IAXy]]
*[[Grandstream HT286]]

==VoIPルータ==
*[[ICOM SR-5200]]　(メーカー製造中止)
*[[YAMAHA RT57i|YAMAHA RT57i/RT58i]]
*[[YAMAHA RTV700]]

==VoIPゲートウェイ==
*[[Quintum]]
*Grandstream GXW4004,GXW4008,GXW4024（FXSタイプ）
*Grandstream GXW4104,GXW4108（FXOタイプ）
*MultiTech MultiVOIP210
*MultiTech MultiVOIP410
*MultiTech MultiVOIP810
==変なアナログ電話機==
*[[STP1960]]

VoIPアダプタ(NTT東西)

2022-03-19T13:26:52Z

Takatyan: ページの作成:「NTT東西がレンタル・販売していた、VoIPアダプタ。 固有の製品名、型番...」

NTT東西がレンタル・販売していた、[[アナログ電話機の接続#ATA.28Analog_Telephone_Adapter.29|VoIPアダプタ]]。 
固有の製品名、型番のようなものがない。

==機能==
Asteriskに対してREGISTし、接続されたアナログ電話機での発着信が可能。 
（NTTの公式の商品説明では、事業者の提供する050IP電話等に直接接続することが想定されているようだが、後述の仕様により使いづらい） 
アナログ電話回線(以下「加入電話」）も接続可能で、発信先電話番号によって使用する回線をIP電話・加入電話を自動で切り替える。 
（ただし加入電話回線なしでも使用可能）

設定はWebブラウザから行う。 
他、簡易ブロードバンドルーター機能(PPPoEを喋る)搭載、UPnP対応といった機能を搭載している。

==入手==
2022年現在では、NTTからの販売は終了しており、インターネットオークション等で中古品を手に入れることとなる。

==動作・仕様==
本機の仕様・動作にはともちゃ氏が[https://tomocha.net/docs/voip/ 述べて]いるように、多数の注意すべき点がある。

*「設定はWebブラウザから可能」ではあるが、本機にはRJ-45のWAN端子とLAN端子があり、LAN端子側に接続したPCからのみ可能。
:Webブラウザから見える設定画面には「WAN側からの保守」なる設定項目があるが、これはベンダー用の機能であって、設定画面にWAN端子側からアクセス可能になるという機能ではない。

本品はルータモードとアダプターモードからなる2つの動作モードを備えている。しかし、次のような問題点がある。

===ルータモード===
* LAN端子側のDHCPサーバーを無効化できない。
* 本機のWAN・LAN端子は100Mbpsまで対応で1Gbps非対応であり、またそのスループットは5Mbps程度との報告がある(https://bb.watch.impress.co.jp/cda/special/1731.html )。2022年現在ではおよそ実用的ではない。
* NAPT(いわゆるポート開放)機能はない。ブロードバンドルーターとしての機能は極めて簡易である。

===アダプターモード===
* UPnP対応ルーターの配下で使用することが必須となる（WAN端子側にUPnP対応ルーターが見つからない場合、SIP REGISTに進まない動作となっている）。
* アダプターモードでも、実はルーター(L3スイッチ)として動作し、LAN端子側からWAN端子側にアクセス可能。
* ルータモードと同様に、LAN端子側のDHCPサーバーを無効化できない。
* SIPサーバーへの接続喪失時の再接続の動作に問題がある。

==LAN内のAsteriskにREGISTして使う==
上記のような特徴のある本機だが、
WAN端子で家庭内LANに接続し、同じ家庭内LAN内にあるAsteriskにREGISTして、接続した電話機の発着信機能のみ使用して、ルーター機能等は使用しない場合には、次のように設定すると使用できる。 
VoIPアダプタのファームウェアはVer3.47、Asteriskバージョンは16.12.0にて試した。

===接続===
* 本機のWAN端子は、家庭内LANに接続する。
* LAN端子は、設定用PCを接続する。これは設定作業時のみ接続し、終わったら外して良い。
* 電話機ポートにはアナログ電話機を接続する。
* 電話回線ポートには、電話回線を接続してもよい。

===Asterisk側の設定===
'''重要''' Asterisk側では本機に対し、μ-lawコーデックの使用を許可しなければならない。 
pjsip.confでの設定例：
<nowiki>
[201](endpoint-default)
allow = !all,alaw,ulaw,opus,g722,gsm</nowiki>

他、一般的なSIPクライアント向けの設定を行う。

===本機の設定===
設定画面の開き方は、説明書を参照のこと。 

====「ネットワーク設定」====
*「PPPoE/IP設定」では、接続種別はイーサネットとする。
:同画面「IP設定」では、WAN側端子におけるIPアドレス設定を行う。DHCPを使用してIPアドレスを取得する場合は「ダイナミック」、静的IPアドレスを設定する場合は「スタティック」とし、各自の環境に合わせた必要な設定を行う。
*「ルータ/アダプタ設定、UPnP使用」画面では「ルータ」モードに設定する。「UPnP使用」は「使用しない」にする。
* DHCPサーバー設定などはルータモードでは変更不可能である。

====「IP電話設定」====
このページは説明書通りに設定すればよい。 
「電話回線の種別」は、電話回線を接続していないときはPB(プッシュ回線)にしておくのが良いだろう。接続する電話機がダイヤル回線専用等の場合は、本機もダイヤル回線の設定にする。 

====「設定情報の確認」====
設定情報の「確認」なるページにどうしてSIPサーバー情報の設定項目が配置されているのだろうか。
* 「SIPサーバアドレス」にはLAN内のSIPサーバーアドレスを入力する。
* 「REGISTERサーバアドレス」「REGISTERサーバポート番号」はそれぞれSIPサーバーのアドレスとポートを入力しておく。
* 「IP電話番号」はAsteriskからみた、このVoIPアダプタの電話番号を入れておく。この欄は数字しか入力できないわけではないようだ。
* 「市外局番」は何に使用されるのかが判然としないが、入力しておく。（市外局番を省略して発信した場合に、自動的に付加されるのか？）

====設定の確認====
以上のように設定を行い、「その他設定」内「システム情報と端末の状態」ページで、「端末の状態」欄に
<nowiki>
SIP: 登録が完了しました。</nowiki>

と表示されていれば使用可能である。このとき、本機本体前面では、少なくとも、電源ランプ、VoIPランプ、WANランプが点灯していればよい。

====その他====

説明書に記載のある、「加入電話回線を選択する電話番号」にはいわゆる1XY特番が記載されており、これらの番号に対しては、IP電話経由での発信ができない。 
Asteriskでの内線通話としてこれらの番号をダイヤルすることはできないことに注意する必要がある。 
（110/118/119に対してダイヤルした後は「本品の再起動が必要になります」とも記載がある）

==参考文献==

* ともちゃ氏による動作検証・考察
:https://tomocha.net/docs/voip/
* NTT西日本の製品ページ
:https://www.ntt-west.co.jp/kiki/consumer/flets/voip/index.html
* 取扱説明書
:https://www.ntt-west.co.jp/kiki/download/flets/voip/VoIP-adapta0804.pdf
* NTT西日本 VoIPアダプタのファームウェア
:https://www.ntt-west.co.jp/kiki/download/flets/voip/index15.html

Asterisk ログファイル

2020-08-23T05:24:34Z

Takatyan:

[[カテゴリ:Asterisk]]

Asteriskのログファイルについて
==ログファイル==
デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。 
ログファイルの設定は/etc/asterisk/logger.confで行います。
<nowiki>; /etc/asterisk/logger.conf
[logfiles]
messages => notice,warning,error</nowiki>

noticeレベルログとして認証失敗も記録されるため、Asteriskをインターネットに公開していると、膨大なログが出力されます。 
[[SIP-Fail2ban|Fail2ban]]を使用していても、しつこい攻撃者がいると、ログが増えていきます。 
ログファイルを置くvarパーティションが溢れないようにログファイルの管理を行う必要があります。

==ログの記録レベルを変更する==
必要がなければ、ログの記録レベルを落として出力を減らすのも、1つの手段です。 
/etc/asterisk/logger.confのlogfilesセクションにて、上記の例にならいログレベルをカンマ区切りで記載します。 
レベルとしてはdebug, trace, notice, warning, error, verbose, dtmf, fax, securityが記載できます。ログレベルとして「*」を使用すると、全ログレベルを意味します。 
また、ログレベルの前に[json]を付与するとJSON出力が可能です。

<nowiki>; /etc/asterisk/logger.conf
[logfiles]
full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！''' 
'''Fail2banを使用している場合は、ログ出力のレベルを変更すると動作に影響を及ぼす恐れがあります。注意して変更してください。'''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

==自動でログをローテートする==
Asteriskには、内蔵のログローテート機構があります。 
===ローテートの仕方の設定===
ログのローテートのファイル名の付け方をlogger.confの[general]セクションで設定できます。 
<nowiki>; /etc/asterisk/logger.conf
[general]
rotatestrategy=sequential</nowiki>

; none
: 全くローテートを行いません。
; sequential(デフォルト)
: ローテートするたびに、最も新しいログファイルのファイル名の通し番号が最も大きくなるように変名します。
; rotate
: ローテートするたびに、過去のログファイルのファイル名の通し番号を1ずつ増やし、最も新しいログファイルの末尾の数字を0とします。
; timestamp
: 通し番号の代わりにタイムスタンプを使用します。

sequentialとrotateの違いが分かりにくいですが、例えば「messages」ログファイルを今、ローテートするとして、既にmessages.0　messages.1　messages.2がある場合、
; sequential
: ローテートすると、messagesはmessages.3に変名されます。0～2はそのままです。
; rotate
: ローテートすると、messages.2はmessages.3に、messages.1がmessages.2に、messages.0がmessages.1に変名され、messagesはmessage.0に変名されます。
その後、新しいmessagesが作られ、ローテート後はこの新しいmessagesに書き込まれます。

===古いファイルを自動で消す===
varパーティションが溢れないようにするためには、古いファイルを自動で消す必要があります。 
古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。 

<nowiki>; /etc/asterisk/logger.conf
[general]
rotatestrategy=rotate
exec_after_rotate=rm -f $["${filename}" : "(.+)\.0$"].4</nowiki>

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

: 解説：上記の設定ファイルではAsterisk expressionsの記法が使用されています。${filename}は、rotatestrategy=rotateにおいては「/var/log/asterisk/messages.0」のような文字列になります。
: これに正規表現 "(.+)\.0$" をマッチ（:演算子は正規表現をマッチさせる演算子ですが、暗黙の「^」により文字列の先頭にマッチされます）させ、Asterisk expressionsの正規表現は他の多数の言語でいう$1を返す仕様のため、
: これに".4"を付与したものを削除することで、最も古いログファイルを削除します。
: 詳細は[[Asterisk expressions]]を参照してください。

===ローテートの実行===

ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。 

そこで、systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
<nowiki># /etc/systemd/system/asterisk-logrotate.service
[Unit]
Description=Asterisk log rotate
Requires=asterisk.service

[Service]
Type=simple
# root以外のユーザーでAsteriskを実行している場合は下2行でAsteriskの実行ユーザーに合わせてください
#User=asterisk
#Group=asterisk
ExecStart=/usr/sbin/asterisk -rx 'logger rotate'</nowiki>

<nowiki># /etc/systemd/system/asterisk-logrotate.timer
[Unit]
Description=Asterisk log rotate timer

[Timer]
OnCalendar=Mon *-*-* 04:00:00
RandomizedDelaySec=300
Persistent=true

[Install]
WantedBy=timers.target</nowiki>

設定したら、systemdにユニットファイルをリロードさせ、タイマーを始動します。
<nowiki># systemctl daemon-reload
# systemctl start asterisk-logrotate.timer
# systemctl enable asterisk-logrotate.timer</nowiki>

手動で1回ローテートしてみようと思う場合、次を実行します。
<nowiki># systemctl start asterisk-logrotate.service</nowiki>

==外部の機構によりログをローテートする==
上記はAsterisk内蔵のログローテート機構によるローテートを説明しました。logrotate等、外部のログローテートツールを使用してログローテートを行う方法もあります。 
その場合の詳細は割愛しますが、[https://www.voip-info.org/logrotate/ voip-info.org]等には参考となる情報があるようです。 
外部のログローテートツールによる場合でも、ローテート後にはCLIからlogger reloadを実行すればAsteriskはログを開き直すようです。

Asterisk ログファイル

2020-08-20T16:12:11Z

Takatyan: /* 古いファイルを自動で消す */

[[カテゴリ:Asterisk]]

Asteriskのログファイルについて
==ログファイル==
デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。 
ログファイルの設定は/etc/asterisk/logger.confで行います。
<nowiki># /etc/asterisk/logger.conf
[logfiles]
messages => notice,warning,error</nowiki>

noticeレベルログとして認証失敗も記録されるため、Asteriskをインターネットに公開していると、膨大なログが出力されます。 
[[SIP-Fail2ban|Fail2ban]]を使用していても、しつこい攻撃者がいると、ログが増えていきます。 
ログファイルを置くvarパーティションが溢れないようにログファイルの管理を行う必要があります。

==ログの記録レベルを変更する==
必要がなければ、ログの記録レベルを落として出力を減らすのも、1つの手段です。 
/etc/asterisk/logger.confのlogfilesセクションにて、上記の例にならいログレベルをカンマ区切りで記載します。 
レベルとしてはdebug, trace, notice, warning, error, verbose, dtmf, fax, securityが記載できます。ログレベルとして「*」を使用すると、全ログレベルを意味します。 
また、ログレベルの前に[json]を付与するとJSON出力が可能です。

<nowiki>full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！''' 
'''Fail2banを使用している場合は、ログ出力のレベルを変更すると動作に影響を及ぼす恐れがあります。注意して変更してください。'''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

==自動でログをローテートする==
Asteriskには、内蔵のログローテート機構があります。 
===ローテートの仕方の設定===
ログのローテートのファイル名の付け方をlogger.confの[general]セクションで設定できます。 
<nowiki>[general]
rotatestrategy=sequential</nowiki>

; none
: 全くローテートを行いません。
; sequential(デフォルト)
: ローテートするたびに、最も新しいログファイルのファイル名の通し番号が最も大きくなるように変名します。
; rotate
: ローテートするたびに、過去のログファイルのファイル名の通し番号を1ずつ増やし、最も新しいログファイルの末尾の数字を0とします。
; timestamp
: 通し番号の代わりにタイムスタンプを使用します。

sequentialとrotateの違いが分かりにくいですが、例えば「messages」ログファイルを今、ローテートするとして、既にmessages.0　messages.1　messages.2がある場合、
; sequential
: ローテートすると、messagesはmessages.3に変名されます。0～2はそのままです。
; rotate
: ローテートすると、messages.2はmessages.3に、messages.1がmessages.2に、messages.0がmessages.1に変名され、messagesはmessage.0に変名されます。
その後、新しいmessagesが作られ、ローテート後はこの新しいmessagesに書き込まれます。

===古いファイルを自動で消す===
varパーティションが溢れないようにするためには、古いファイルを自動で消す必要があります。 
古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。 

<nowiki>[general]
rotatestrategy=rotate
exec_after_rotate=rm -f $["${filename}" : "(.+)\.0$"].4</nowiki>

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

: 解説：上記の設定ファイルではAsterisk expressionsの記法が使用されています。${filename}は、rotatestrategy=rotateにおいては「/var/log/asterisk/messages.0」のような文字列になります。
: これに正規表現 "(.+)\.0$" をマッチ（:演算子は正規表現をマッチさせる演算子ですが、暗黙の「^」により文字列の先頭にマッチされます）させ、Asterisk expressionsの正規表現は他の多数の言語でいう$1を返す仕様のため、
: これに".4"を付与したものを削除することで、最も古いログファイルを削除します。
: 詳細は[[Asterisk expressions]]を参照してください。

===ローテートの実行===

ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。 

そこで、systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
<nowiki># /etc/systemd/system/asterisk-logrotate.service
[Unit]
Description=Asterisk log rotate
Requires=asterisk.service

[Service]
Type=simple
#User=asterisk
#Group=asterisk
ExecStart=/usr/sbin/asterisk -rx 'logger rotate'</nowiki>

<nowiki># /etc/systemd/system/asterisk-logrotate.timer
[Unit]
Description=Asterisk log rotate timer

[Timer]
OnCalendar=Mon *-*-* 04:00:00
RandomizedDelaySec=300
Persistent=true

[Install]
WantedBy=timers.target</nowiki>

設定したら、systemdにユニットファイルをリロードさせ、タイマーを始動します。
<nowiki># systemctl daemon-reload
# systemctl start asterisk-logrotate.timer
# systemctl enable asterisk-logrotate.timer</nowiki>

手動で1回ローテートしてみようと思う場合、次を実行します。
<nowiki># systemctl start asterisk-logrotate.service</nowiki>

==外部の機構によりログをローテートする==
上記はAsterisk内蔵のログローテート機構によるローテートを説明しました。logrotate等、外部のログローテートツールを使用してログローテートを行う方法もあります。 
その場合の詳細は割愛しますが、[https://www.voip-info.org/logrotate/ voip-info.org]等には参考となる情報があるようです。 
外部のログローテートツールによる場合でも、ローテート後にはCLIからlogger reloadを実行すればAsteriskはログを開き直すようです。

Asterisk ログファイル

2020-08-20T15:27:31Z

Takatyan:

[[カテゴリ:Asterisk]]

Asteriskのログファイルについて
==ログファイル==
デフォルトの設定では/var/log/asterisk/messagesに、ログレベルnotice, warning, errorが出力されます。 
ログファイルの設定は/etc/asterisk/logger.confで行います。
<nowiki># /etc/asterisk/logger.conf
[logfiles]
messages => notice,warning,error</nowiki>

noticeレベルログとして認証失敗も記録されるため、Asteriskをインターネットに公開していると、膨大なログが出力されます。 
[[SIP-Fail2ban|Fail2ban]]を使用していても、しつこい攻撃者がいると、ログが増えていきます。 
ログファイルを置くvarパーティションが溢れないようにログファイルの管理を行う必要があります。

==ログの記録レベルを変更する==
必要がなければ、ログの記録レベルを落として出力を減らすのも、1つの手段です。 
/etc/asterisk/logger.confのlogfilesセクションにて、上記の例にならいログレベルをカンマ区切りで記載します。 
レベルとしてはdebug, trace, notice, warning, error, verbose, dtmf, fax, securityが記載できます。ログレベルとして「*」を使用すると、全ログレベルを意味します。 
また、ログレベルの前に[json]を付与するとJSON出力が可能です。

<nowiki>full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！''' 
'''Fail2banを使用している場合は、ログ出力のレベルを変更すると動作に影響を及ぼす恐れがあります。注意して変更してください。'''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

==自動でログをローテートする==
Asteriskには、内蔵のログローテート機構があります。 
===ローテートの仕方の設定===
ログのローテートのファイル名の付け方をlogger.confの[general]セクションで設定できます。 
<nowiki>[general]
rotatestrategy=sequential</nowiki>

; none
: 全くローテートを行いません。
; sequential(デフォルト)
: ローテートするたびに、最も新しいログファイルのファイル名の通し番号が最も大きくなるように変名します。
; rotate
: ローテートするたびに、過去のログファイルのファイル名の通し番号を1ずつ増やし、最も新しいログファイルの末尾の数字を0とします。
; timestamp
: 通し番号の代わりにタイムスタンプを使用します。

sequentialとrotateの違いが分かりにくいですが、例えば「messages」ログファイルを今、ローテートするとして、既にmessages.0　messages.1　messages.2がある場合、
; sequential
: ローテートすると、messagesはmessages.3に変名されます。0～2はそのままです。
; rotate
: ローテートすると、messages.2はmessages.3に、messages.1がmessages.2に、messages.0がmessages.1に変名され、messagesはmessage.0に変名されます。
その後、新しいmessagesが作られ、ローテート後はこの新しいmessagesに書き込まれます。

===古いファイルを自動で消す===
varパーティションが溢れないようにするためには、古いファイルを自動で消す必要があります。 
古いログファイルを4世代保持しておき、古いファイルから消していくためには、[general]セクションで次のように設定します。 

''記載途中''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

===ローテートの実行===

ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。 

そこで、systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
<nowiki># /etc/systemd/system/asterisk-logrotate.service
[Unit]
Description=Asterisk log rotate
Requires=asterisk.service

[Service]
Type=simple
#User=asterisk
#Group=asterisk
ExecStart=/usr/sbin/asterisk -rx 'logger rotate'</nowiki>

<nowiki># /etc/systemd/system/asterisk-logrotate.timer
[Unit]
Description=Asterisk log rotate timer

[Timer]
OnCalendar=Mon *-*-* 04:00:00
RandomizedDelaySec=300
Persistent=true

[Install]
WantedBy=timers.target</nowiki>

設定したら、systemdにユニットファイルをリロードさせ、タイマーを始動します。
<nowiki># systemctl daemon-reload
# systemctl start asterisk-logrotate.timer
# systemctl enable asterisk-logrotate.timer</nowiki>

手動で1回ローテートしてみようと思う場合、次を実行します。
<nowiki># systemctl start asterisk-logrotate.service</nowiki>

==外部の機構によりログをローテートする==
上記はAsterisk内蔵のログローテート機構によるローテートを説明しました。logrotate等、外部のログローテートツールを使用してログローテートを行う方法もあります。 
その場合の詳細は割愛しますが、[https://www.voip-info.org/logrotate/ voip-info.org]等には参考となる情報があるようです。 
外部のログローテートツールによる場合でも、ローテート後にはCLIからlogger reloadを実行すればAsteriskはログを開き直すようです。

Asterisk ログファイル

2020-08-20T07:41:14Z

Takatyan: /* 自動でログをローテートする */

Asterisk ログファイル

2020-08-20T06:26:54Z

Takatyan: /* ログファイル */

Asterisk ログファイル

2020-08-20T06:23:05Z

Takatyan: ページの作成:「カテゴリ:Asterisk Asteriskのログファイルについて ==ログファイル== デフォルトの設定ではmessagesログとして、notice, warning, error...」

[[カテゴリ:Asterisk]]

Asteriskのログファイルについて
==ログファイル==
デフォルトの設定ではmessagesログとして、notice, warning, errorが出力されます。 
ログファイルの設定は/etc/asterisk/logger.confで行います。
<nowiki># etc/asterisk/logger.conf
[logfiles]
messages => notice,warning,error</nowiki>

noticeレベルログとして認証失敗も記録されるため、Asteriskをインターネットに公開していると、膨大なログが出力されます。 
[[SIP-Fail2ban|Fail2ban]]を使用していても、しつこい攻撃者がいると、ログが増えていきます。 
ログファイルを置くvarパーティションが溢れないようにログファイルの管理を行う必要があります。

==ログの記録レベルを変更する==
必要がなければ、ログの記録レベルを落として出力を減らすのも、1つの手段です。 
/etc/asterisk/logger.confのlogfilesセクションにて、上記の例にならいログレベルをカンマ区切りで記載します。 
レベルとしてはdebug, trace, notice, warning, error, verbose, dtmf, fax, securityが記載できます。ログレベルとして「*」を使用すると、全ログレベルを意味します。 
また、ログレベルの前に[json]を付与するとJSON出力が可能です。

<nowiki>full-json => [json]debug,verbose,notice,warning,error,dtmf,fax</nowiki>

'''警告：debugログレベル及びこれを含む*ログレベルを使用すると、極めて多量のログが出力されます。運用モードではdebugログを出力しないことを強く勧めます！''' 
'''Fail2banを使用している場合は、ログ出力のレベルを変更すると動作に影響を及ぼす恐れがあります。注意して変更してください。'''

設定ファイルを変更したら、[[Asterisk CLI]]でlogger reloadを行うと変更が反映されます。

==自動でログをローテートする==
まず、ログのローテートそのものは、[[Asterisk CLI]]でlogger rotateを行うと実行されます。 

systemdの下で定期的にログローテートを行うためのユニットファイルの一例を示します。
<nowiki># /etc/systemd/system/asterisk-logrotate.service
[Unit]
Description=Asterisk log rotate
Requires=asterisk.service

[Service]
Type=simple
#User=asterisk
#Group=asterisk
ExecStart=/usr/sbin/asterisk -rx 'logger rotate'</nowiki>

<nowiki># /etc/systemd/system/asterisk-logrotate.timer
[Unit]
Description=Asterisk log rotate timer

[Timer]
OnCalendar=Mon *-*-* 04:00:00
RandomizedDelaySec=300
Persistent=true

[Install]
WantedBy=timers.target</nowiki>

設定したら、systemdにユニットファイルをリロードさせ、タイマーを始動します。
<nowiki># systemctl daemon-reload
# systemctl start asterisk-logrotate.timer
# systemctl enable asterisk-logrotate.timer</nowiki>

手動で1回ローテートしてみようと思う場合、次を実行します。
<nowiki># systemctl start asterisk-logrotate.service</nowiki>

==外部の機構によりログをローテートする==
上記はAsterisk内蔵のログローテート機構によるローテートを説明しました。logrotate等、外部のログローテートツールを使用してログローテートを行う方法もあります。 
その場合の詳細は割愛しますが、[https://www.voip-info.org/logrotate/ voip-info.org]等には参考となる情報があるようです。 
外部のログローテートツールによる場合でも、ローテート後にはCLIからlogger reloadを実行すればAsteriskはログを開き直すようです。

Asterisk pjsip 電話機

2020-08-17T04:19:39Z

Takatyan: Asterisk pjsip NATへのリンクを追加。

[[カテゴリ:Asterisk]]
[[カテゴリ:Pjsip]]
AsteriskでPjSIPを使用した場合の電話機関連設定
==電話機設定例==
電話機を設定する場合にはセクションが3つ必要です。エンドポイントそれ自体とaor,authの3つです。
[phone1]
type = aor
max_contacts = 1
qualify_frequency = 30
authenticate_qualify = no

[phone1]
type = auth
username = phone3
password = mysecretpassword

[phone1]
type = endpoint
context = default
transport=transport-udp
dtmf_mode = rfc4733
disallow = all
allow = ulaw
allow = alaw
rtp_symmetric = yes
force_rport = yes
rewrite_contact = yes
direct_media = no
send_pai = yes
inband_progress = yes
call_group = 1
pickup_group = 1
language = ja
device_state_busy_at = 1
auth = phone1
outbound_auth = phone1
aors = phone1
AORの max_contacts = 1 が設定されていないと電話機はAsteriskに対してRegisterできません。このmax_contactsが2以上に設定されている場合には、複数の電話機が同じアカウントでRegisterできるようになります。 
エンドポイントにACLを使用する場合には 
acl=myhouse
のように書きますが、この場合の名前付きACLは'''Asteriskの名前付きALC'''です。 
つまりacl.confに設定されている名前付きACLということです。pjsipのACLではないので注意してください。 
==Wizardを使用した場合の設定例==
Wizardを使用した場合、共通設定部分をテンプレート化し、各電話機の認証情報だけ別に書くことができます。
;電話機用テンプレート(共通設定)
[phone-defaults](!)
type=wizard
transport = transport-udp
accepts_registrations = yes
sends_registrations = no
accepts_auth = yes
sends_auth = no
endpoint/context = default
endpoint/dtmf_mode = rfc4733
endpoint/call_group = 1
endpoint/pickup_group = 1
endpoint/language = ja
endpoint/disallow = all
endpoint/allow = ulaw
endpoint/rtp_symmetric = yes
endpoint/force_rport = yes
endpoint/direct_media = no
endpoint/send_pai = yes
endpoint/send_rpid = yes
endpoint/rewrite_contact = yes
endpoint/inband_progress = yes
endpoint/allow_subscribe = yes
endpoint/transport = transport-udp
aor/max_contacts = 1
aor/qualify_frequency = 30
aor/authenticate_qualify = no

;各電話機個別設定
[phone1](phone-defaults)
inbound_auth/username = phone1
inbound_auth/password = mypasswordishere

==NAT==
NAT環境での設定については[[Asterisk pjsip NAT]]を参照のこと。

==複数同時レジスト==
同一のユーザ名とパスワードで、電話機を複数同時にレジストすることができます。AORのmax_contactsで指定した数字が同時レジストできる台数になります。
詳しい使い方は [[Pjsip 機能拡張]] を参照してください。

Asterisk pjsip NAT

2020-08-14T04:16:25Z

Takatyan: ページの作成:「== Asteriskサーバがグローバル、端末がNAT背後の場合 == Asteriskサーバ側がグローバルIPアドレスを持ち、それにアクセスする端末...」

== Asteriskサーバがグローバル、端末がNAT背後の場合 ==
Asteriskサーバ側がグローバルIPアドレスを持ち、それにアクセスする端末側がNAT背後にある場合、pjsip.confのtype=endpoint、type=aorのセクションに次のように記載します。
<nowiki>
[201]
type = aor
max_contacts = 1
qualify_frequency = 1000

[201]
type = endpoint
context = default
disallow = all
allow = ulaw
rtp_symmetric = yes
rewrite_contact = yes
direct_media = no
auth = 201
outbound_auth = 201
aors = 201</nowiki>

重要なのはdirect_media, rtp_symmetric, rewrite_contactです。direct_mediaをnoにすると、端末間通話で常にAsteriskが映像・音声を中継しますから、NATの背後の端末同士の通話が可能となります。 
rtp_symmetric, rewrite_contactの設定は従来のsip.confではnat=yesに相当します。
また相手(端末側)のNATテーブルをキープするためにtype=aorのセクションに'''qualify_frequency=1000'''(単位はミリ秒)を記述しておくと良いでしょう。遅延の大きい端末相手ならば2000あたりに設定します。

==AsteriskサーバがNAT背後==
この場合は、通信相手となる端末または回線(ITSP)の状況にも大きく依存するようですが、下記の手段が有用と思われます。
===対応1===
pjsip.confのtype=transportのセクションで次のように記載します。
<nowiki>external_media_address=fqdnhostname.example.com
external_signaling_address=fqdnhostname.example.com
local_net=192.168.0.0/16
local_net=127.0.0.1/32</nowiki>

external_media_address, external_signaling_addressにはグローバルIPアドレス、またはDDNS(Dynamic DNS)サービスを利用しホスト名(FQDN)を記載します。

ルータのNATを調整し、SIP(5060/UDP)とRTP(デフォルトでは10000～20000/UDP)をAsteriskサーバのプライベートIPアドレスに向けます。 
ただし、これらの対処を行ってもRegisterできないITSPがあります。 

===対応2===
上記の方法で解決しない場合、SIP-NAT機能を持つルータを使えば解決する場合があるとのことですがpjsipを使用する場合の詳細は未検証。

利用者:Takatyan

2020-08-14T01:54:18Z

Takatyan:

* Takatyanの投稿した内容については、サイト管理人[[たかはし]]、および、その許諾する者に対し、あらゆる利用を認めます。
* 一方で、投稿内容の正しさについてはTakatyanは一切保証しませんし、たとえ誤りがあっても、投稿内容を利用したことについての責任は負いません。
* Takatyanは個人的に試して判明したことや、調べてわかったことをまとめて投稿しているか、明らかな誤字修正等を行うのみであり、宣伝等の意図はありません。

[[Category:人々]]

Asterisk動作確認済みOS

2020-08-08T10:31:06Z

Takatyan: /* CentOS */ CentOS 8no

工事中。情報追加歓迎！このページは簡単な説明と詳細ページへのリダイレクトに使用します。 
[[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スクリプトが作成されるが問題なく動作。
===8.x===
; Asterisk 16
Asterisk 16でも、systemdのユニットファイルの作成は実装されていないようだ。動作は問題ない。systemdに管理させるためには[[Asterisk Startup systemd|こちら]]。

==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 pjsip trunks

2020-08-08T09:52:36Z

Takatyan: /* 基本設定 */ スペルミス修正

[[カテゴリ:Asterisk]]
[[カテゴリ:pjsip]]
==使いかた==
このページではトランク接続の部分のみについて解説します。#include pjsip_trunks.conf などして使うと良いでしょう。

==基本設定==
トランク接続でもグローバル設定やACLは使用されます。最低限トランスポートの設定は行っておきましょう。 
基本となる設定はpjsip.confに書きます。 
*[[Asterisk_pjsip_parameters#GLOBAL]] 
グローバル設定を使用する場合にはtype=globalのセクションを書きます。 
<nowiki>[global]
type=global
max_forwards = 50</nowiki>
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。 
*[[Asterisk_pjsip_parameters#SYSTEM]] 
===トランスポート===
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。 

==CLI==
*外部に対するregisterを確認するには pjsip show registrations

==ひかり電話HGW==
[[Asterisk pjsip trunk hgw]]
==楽天OpenGate(B2BUA)==
[[Asterisk pjsip trunk opengate]]
==Brastel Basix==
[[Asterisk pjsip trunk basix]]
==@niftyフォン-C==
[[Asterisk pjsip trunk @niftyフォン-C]]
==拠点間接続==
[[Asterisk pjsip trunk intra]]

Asterisk pjsip

2020-08-08T09:51:51Z

Takatyan: /* グローバル設定 */ スペルミス修正

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

AsiteriskでチャネルにPjSIPを使用する際の設定方法など
==コンパイル==
Asterisk 13まではpjprojectを別個インストールするか、configureに--with-pjproject-bundledを付けて実行する必要がありましたが、Asterisk 16からはデフォルトでbundledインストールされるようになりました。 
各バージョン毎のインストール方法についてはAsteriskのそれぞれのページを参照してください。 
[[Asterisk 13]] 
[[Asterisk 16]] 

==変換ツール==
Asterisk 13以降であればソースディレクトリ/contrib/scripts/sip_to_pjsip の下にPythonのスクリプトがあります(複数)。sip.confのあるディレクトリでこれを実行するとpjsip.confに変換してくれます。#includeしている場合にはそれらも変換してくれますが、完璧ではないです。
==Asterisk 16における注意点==
PjSIPはres_statsd.soに依存します。このためres_statsdがloadされていないと、res_pjsipがloadされない問題が発生します。 
(Asterisk 16ではモジュールの依存関係チェックが厳密化されています) 
res_statsdモジュールはstatsd.confファイルが無いとloadされないため、statsd.confファイルが無いだけで、PjSIPが使えないという困った状態になります。ソースファイルに含まれる statsd.conf.sample を /etc/asterisk/statsd.conf にコピーしておいてください。もっとも、このファイルはコメントされた行だけなので要するに空なのですが。

==パラメータ一覧==
[[Asterisk pjsip parameters]]

==基本設定==
*間違いやすいところ
:sip.confでは1wordだったのがアンダーバーが入る
:dtmfmode → dtmf_mode
:fromdomain → from_domain
===グローバル設定===
設定は基本としてはpjsip.confに書きます。 
*[[Asterisk_pjsip_parameters#GLOBAL]] 
グローバル設定を使用する場合にはtype=globalのセクションを書きます。 
<nowiki>[global]
type=global
max_forwards = 50</nowiki>
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。 
*[[Asterisk_pjsip_parameters#SYSTEM]] 

===インクルード===
Asteriskの他の設定ファイル同様に#includeが使えます。なので、電話機と回線は別ファイルにした方が見通しは良いかもしれません。例えば 
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070

#include pjsip_phones.conf
#include pjsip_trunk_hikari.conf
のようにファイルを分割し、includeすると管理が楽になります。

基本で必要なものは以下です。

===トランスポート===
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。 

===ACL===
ACLの例は次の通りです。
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
※deny,permitはこの順でないとpermitしてdenyしてしまう模様で、逆に書くと誰も使えなくなります。 
 
pjsip.confに複数のACL(type=acl)を書くとそのセクション名にかかわらず後ろにあるACLの方が勝つ模様。 
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16

[acl-my]
type=acl
deny=0.0.0.0/0.0.0.0
permit=10.10.0.0/16
と、書くとacl-myが勝つので要注意です。複数を許可したい場合には1セクションで
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
permit=10.10.0.0/16
のように書きます。 
*[[Asterisk_pjsip_parameters#ACL.28res_pjsip_acl.29]]
→[[Asterisk pjsip ACL]]

===認証情報(Auth)===
sip_confではピア(エンドポイント)の認証がわかりにくかったのですが、PjSIPでは別なセクションで(type=auth)認証情報を定義するようになりました。このため、認証情報がピア名(sip.confの[ ])に紐付かなくなりました。 
慣れないとわかりにくい感じがしますが、管理がより柔軟になります。例えば
[some-phone]
type = endpoint
.
.
.
auth = phone-auth
outbound_auth = phone-out-auth
のようなendpointが定義されている場合には、2つのauthセクションが必要です。
[phone-auth]
type = auth
username = phone123
password = phonepassword
このAuthは'[some-phone]'エンドポイントに接続、すまり外からの"入り"の際の認証情報です。 
[phone-out-auth]
略
このAuthはoutbound_authで設定されているので、このエンドポイントからの"出"の際の認証情報です。 

==電話機==
電話機の接続は [[Asterisk pjsip 電話機]] のページへ
==トランク==
回線接続側は [[Asterisk pjsip trunks]]のページへ

==Wizard==
Asteriskにはpjsip_wizardが組み込まれており、PjSIPの設定を簡素化することができます。使う場合の条件は以下の通りです。
*基本の設定はpjsip.confに書く
:transportなどの情報はpjsip.confに書く必要があります
*Wizard用のファイル名はpjsip_wizard.conf
*共通化したテンプレート内で各セクションを指定するにはスラッシュ(/)で区切る
*Wizardは電話機でもトランクでも使用できる
:registration/を書くとregistrationセクションがつくられる
:例: endpoint/dtmf_mode
pjsip_wizard.confの記述例
;電話機用テンプレート(共通設定)
[phone-defaults](!)
type=wizard
transport = transport-udp
accepts_registrations = yes
sends_registrations = no
accepts_auth = yes
sends_auth = no
endpoint/context = default
endpoint/dtmf_mode = rfc4733
endpoint/call_group = 1
endpoint/pickup_group = 1
endpoint/language = ja
endpoint/disallow = all
endpoint/allow = ulaw
endpoint/rtp_symmetric = yes
endpoint/force_rport = yes
endpoint/direct_media = no
endpoint/send_pai = yes
endpoint/send_rpid = yes
endpoint/rewrite_contact = yes
endpoint/inband_progress = yes
endpoint/allow_subscribe = yes
endpoint/transport = transport-udp
aor/max_contacts = 1
aor/qualify_frequency = 30
aor/authenticate_qualify = no

;各電話機個別設定
[phone1](phone-defaults)
inbound_auth/username = phone1
inbound_auth/password = mypasswordishere

==CLIコマンド==
*sip show peersに対応するのはpjsip show endpoints
*sip show peer phone1などピア情報を表示するのはpjsip show endpoint phone1
*AORを表示するのは一覧ならpjsip show aorsでピアの情報を表示するのはpjsip show aor phone1のようにする
*それぞれの設定項目で何が設定されているかを確認するには pjsip show endpoint phone1 のようにすると phone1 の endpoint パラメータ一覧が表示される。aorを見たければ pjsip show aor phone1。これはトランクの場合も同様で pjsip show registration hikari-hgw のようにするとregister関係のパラメータがみえる。

==挙動上の注意点==
===挙動そのもの===
chan_sipより制限が少し"きつい"です。SIPメッセージの中に少しおかしなものがあってもchan_sipでは制限が緩かったので、通っていたものがPjSIPでは通らないことがあります。CLI等で'syntax error'のようなメッセージが出る場合にはSIPメッセージにおかしなところがあるかもしれないので調べてください。
===AddHeader===
chan_sipの場合にはSIPAddHeaderでSIPヘッダを追加できましたが、PjSIPではファンクションPJSIP_HEDER()を使用します。ただしこのファンクションはextenの途中で使用しても効果がありません。Dial時にサブルーチンコールしてやる必要があります。 
例えばAlert-Info: hogeを追加するにはまず以下のよなルーチンを定義します。
[add-alert]
exten => s,1,Set(PJSIP_HEADER(add,Alert-Info)=hoge)
exten => s,n,Return
Dial時に以下のようにしてコールします
exten => 201,1,Dial(PJSIP/201,,b(add-alert,s,1))

==設定変更の反映==
*モジュール数が多すぎて一発リロードする方法がよくわからない
*module reload res_pjsip.soを実行すれば"だいたい"はいけそう
:wizardのaor/を変更しても反映されない場合がある
==PjSIPで拡張される機能==
[[pjsip_機能拡張]]

Asterisk pjsip trunk @niftyフォン-C

2020-08-07T14:30:51Z

Takatyan: /* pjsip.conf */

[[カテゴリ:Asterisk]]
[[カテゴリ:Pjsip]]
[[カテゴリ:ITSP]]
== @niftyフォン-Cとは ==

インターネットサービスプロバイダ「@nifty」の提供するIP電話サービスで、050番のIP電話の1つです。 
NTTコミュニケーションズの基盤を利用しています([http://ipphone.nifty.com/niftyphone/c/kiyaku/index.htm @niftyフォン-Cの利用規約] 第1条第1項)。

== 特徴 ==

=== メリット ===
* @niftyの接続サービスを利用していれば'''基本料金0円'''で維持費がユニバーサルサービス料のみ。
* 同じくNTTコミュニケーションズの基盤を利用する、050plus等のIP電話への通話料が無料。
* Asteriskに収容可能('''重要'''、ただし非公式)。

=== デメリット ===
* 2020年の今日としては、公式サイトのデザインが明らかに古くFlashを使用したページなどがある。
* 050IP電話の需要は減少傾向らしくサービスの継続性に疑問がある。
* @niftyの接続サービスにロックインされ、他の事業者に番号を持ち運べない。
* 110, 119等1XY 特番、0120, 0570等0AB0 特番には発信できない。

== Asterisk 16 ==

以下の設定で発着信可能(2020年8月)

=== pjsip.conf ===
<nowiki>
; 050NNNNNNNN は@niftyフォン-Cの050電話番号
; ABCDEFGHIはVoIPユーザ ID
; abcdefghiはVoIPユーザパスワード
; v???NN.nifty.comはVoIPサーバ名(SIPサーバアドレス、REGISTERサーバアドレス)
; nifty.comはSIP-URL(SIPドメイン名)

[atniftyphone]
type=aor
contact=sip:ABCDEFGHI@v???NN.nifty.com

[atniftyphone]
type=identify
endpoint=atniftyphone
match=v???NN.nifty.com

[atniftyphone]
type=auth
auth_type=userpass
username=ABCDEFGHI
password=abcdefghi

[atniftyphone]
type=registration
transport=transport-udp
outbound_auth=atniftyphone
contact_user=050NNNNNNNN
server_uri=sip:v???NN.nifty.com
client_uri=sip:050NNNNNNNN@nifty.com
retry_interval=60

[atniftyphone]
type=endpoint
transport=transport-udp
context=from-atniftyphone
disallow=all
allow=ulaw
dtmf_mode=inband
direct_media=no
send_pai=yes
inband_progress=no
outbound_auth=atniftyphone
from_user=050NNNNNNNN
from_domain=nifty.com
aors=atniftyphone
language=ja ; お好みで</nowiki>

=== extensions.conf ===

一例です。

<nowiki>; 発信
[default]
exten => _0.,1,Dial(PJSIP/${EXTEN}@atniftyphone)
same => n,Congestion
same => n,Hangup

; 着信
[globals]
ATNIFTYPHONENUMBER=050NNNNNNNN

[from-atniftyphone]
exten => ${ATNIFTYPHONENUMBER},1,Dial(.....) ; 着信先を設定する
same => n,Congestion
same => n,Hangup</nowiki>

=== 注意点 ===
@niftyフォン-Cはqualifyには非対応のようで、qualify_frequency、authenticate_qualifyを設定するとうまくいきませんのでご注意ください。

[https://qa.nifty.com/cs/catalog/faq_nqa/qid_11216/1.htm?category1=100004&category3=300070&category2=200013 @niftyフォン-C よくある質問「@niftyフォンが正しく設定されているか確認する方法はありますか。」]では、 
「@niftyフォン利用確認用の試験番号」なるものが記載されており、「発信テストにご利用いただき、@niftyフォン特有の発信音がするか、ご確認ください。」とあるが、 
上記の設定のAsterisk16から発信してみたところ「おかけになった電話番号は、通信できない状態にあり、かかりません。」というガイダンスが繰り返し流れる。特有の発信音とはどのような音なのであろうか。

Asterisk pjsip trunks

2020-08-07T14:08:24Z

Takatyan: Asterisk pjsip trunk @niftyフォン-Cへのリンクを追加

[[カテゴリ:Asterisk]]
[[カテゴリ:pjsip]]
==使いかた==
このページではトランク接続の部分のみについて解説します。#include pjsip_trunks.conf などして使うと良いでしょう。

==基本設定==
トランク接続でもグローバル設定やACLは使用されます。最低限トランスポートの設定は行っておきましょう。 
基本となる設定はpjsip.confに書きます。 
*[[Asterisk_pjsip_parameters#GLOBAL]] 
グローバル設定を使用する場合にはtype=grobalのセクションを書きます。 
[grobal]
type=grobal
max_forwards = 50
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。 
*[[Asterisk_pjsip_parameters#SYSTEM]] 
===トランスポート===
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。 

==CLI==
*外部に対するregisterを確認するには pjsip show registrations

==ひかり電話HGW==
[[Asterisk pjsip trunk hgw]]
==楽天OpenGate(B2BUA)==
[[Asterisk pjsip trunk opengate]]
==Brastel Basix==
[[Asterisk pjsip trunk basix]]
==@niftyフォン-C==
[[Asterisk pjsip trunk @niftyフォン-C]]
==拠点間接続==
[[Asterisk pjsip trunk intra]]

Asterisk pjsip trunk @niftyフォン-C

2020-08-07T14:06:31Z

Takatyan: ページの作成:「カテゴリ:Asterisk カテゴリ:Pjsip カテゴリ:ITSP == @niftyフォン-Cとは == インターネットサービスプロバイダ「@nifty」の提...」

[[カテゴリ:Asterisk]]
[[カテゴリ:Pjsip]]
[[カテゴリ:ITSP]]
== @niftyフォン-Cとは ==

インターネットサービスプロバイダ「@nifty」の提供するIP電話サービスで、050番のIP電話の1つです。 
NTTコミュニケーションズの基盤を利用しています([http://ipphone.nifty.com/niftyphone/c/kiyaku/index.htm @niftyフォン-Cの利用規約] 第1条第1項)。

== 特徴 ==

=== メリット ===
* @niftyの接続サービスを利用していれば'''基本料金0円'''で維持費がユニバーサルサービス料のみ。
* 同じくNTTコミュニケーションズの基盤を利用する、050plus等のIP電話への通話料が無料。
* Asteriskに収容可能('''重要'''、ただし非公式)。

=== デメリット ===
* 2020年の今日としては、公式サイトのデザインが明らかに古くFlashを使用したページなどがある。
* 050IP電話の需要は減少傾向らしくサービスの継続性に疑問がある。
* @niftyの接続サービスにロックインされ、他の事業者に番号を持ち運べない。
* 110, 119等1XY 特番、0120, 0570等0AB0 特番には発信できない。

== Asterisk 16 ==

以下の設定で発着信可能(2020年8月)

=== pjsip.conf ===
<nowiki>
; 050NNNNNNNN は@niftyフォン-Cの050電話番号
; ABCDEFGHIはVoIPユーザ ID
; abcdefghiはVoIPユーザパスワード
; v???NN.nifty.comはVoIPサーバ名(SIPサーバアドレス、REGISTERサーバアドレス)
nifty.comはSIP-URL(SIPドメイン名)

[atniftyphone]
type=aor
contact=sip:ABCDEFGHI@v???NN.nifty.com

[atniftyphone]
type=identify
endpoint=atniftyphone
match=v???NN.nifty.com

[atniftyphone]
type=auth
auth_type=userpass
username=ABCDEFGHI
password=abcdefghi

[atniftyphone]
type=registration
transport=transport-udp
outbound_auth=atniftyphone
contact_user=050NNNNNNNN
server_uri=sip:v???NN.nifty.com
client_uri=sip:050NNNNNNNN@nifty.com
retry_interval=60

[atniftyphone]
type=endpoint
transport=transport-udp
context=from-atniftyphone
disallow=all
allow=ulaw
dtmf_mode=inband
direct_media=no
send_pai=yes
inband_progress=no
outbound_auth=atniftyphone
from_user=050NNNNNNNN
from_domain=nifty.com
aors=atniftyphone
language=ja ; お好みで</nowiki>

=== extensions.conf ===

一例です。

<nowiki>; 発信
[default]
exten => _0.,1,Dial(PJSIP/${EXTEN}@atniftyphone)
same => n,Congestion
same => n,Hangup

; 着信
[globals]
ATNIFTYPHONENUMBER=050NNNNNNNN

[from-atniftyphone]
exten => ${ATNIFTYPHONENUMBER},1,Dial(.....) ; 着信先を設定する
same => n,Congestion
same => n,Hangup</nowiki>

=== 注意点 ===
@niftyフォン-Cはqualifyには非対応のようで、qualify_frequency、authenticate_qualifyを設定するとうまくいきませんのでご注意ください。

[https://qa.nifty.com/cs/catalog/faq_nqa/qid_11216/1.htm?category1=100004&category3=300070&category2=200013 @niftyフォン-C よくある質問「@niftyフォンが正しく設定されているか確認する方法はありますか。」]では、 
「@niftyフォン利用確認用の試験番号」なるものが記載されており、「発信テストにご利用いただき、@niftyフォン特有の発信音がするか、ご確認ください。」とあるが、 
上記の設定のAsterisk16から発信してみたところ「おかけになった電話番号は、通信できない状態にあり、かかりません。」というガイダンスが繰り返し流れる。特有の発信音とはどのような音なのであろうか。

メインページ

2020-08-07T10:54:11Z

Takatyan: /* テレワーク関連に対する注意喚起 */ マークアップを改善

== '''VoIP-Info.jp Wiki''' ==
このページでは[[Asterisk]]の話題を中心にVoIP関連の情報交換を行なっています。 
なおこのページは http://www.voip-info.jp http://voip-info.jp のいずれでもアクセスできます。 
Asterisk PBX、VoIP、IP電話に興味をお持ちの皆様ご参加下さい。 
 
Asteriskをビジネスとして扱われている方は[[Asteriskコンサルタント]]のページへ。仕事を依頼したい、仕事として受けたいなど、ビジネスマッチングにお使い下さい。 
 
'''SPAM投稿が多いため、ポリシーを変更します。ユーザ登録を行わないと書き込み/編集はできません。''' 
書き込みを行われる方は、[http://www.voip-info.jp/index.php/%E7%89%B9%E5%88%A5:%E3%83%AD%E3%82%B0%E3%82%A4%E3%83%B3 ログインまたはアカウント作成]のページから、ユーザ登録を行ってください。 
(アクセスログ等は取得しています。迷惑行為等に対しては関係各所へ通報いたします。) 
 
'''警告''':以前のWikiからもそうでしたが、広告宣伝に情報が埋もれることだけは避けたいので、特定企業への誘導リンク等は適切なページへ貼ってください。[[購入情報]]や[[Asteriskコンサルタント]]のページがそれに相当します。 
広告出稿をご希望の場合はwebmaster'at'voip-info.jpへメールでお問合せください [[広告]]。
 
各種ユーザ会関連情報は[[コミュニティ]]のページへ。 

=='''COVID-19関連情報'''==
===テレワーク関連に対する注意喚起===
テレワーク関連で、SIPポートへのアタックが考えられますので注意喚起しておきます。
====影響を受ける環境/状況====
テレワーク環境(家庭等)でSIP対応の電話機、ソフトフォンなどを使用しておりクラウドサービスや、会社のIP-PBXに接続している場合。
====考えられる攻撃====
これまでインターネット上に広まっていたSIPポート(主に5060/udp)に対する攻撃を一般家庭でも受ける可能性があります。 
現象としては『謎の』着信がある、正体の不明の相手からの通話要求があるが電話に出られない、出ても何も聞こえないなどです。
====攻撃の影響を受ける理由/場合:====
SIP対応の電話機あるいはソフトフォンがローカル(電話機やソフトフォン自体が使用する)のSIPポートとして5060を使用している場合、SIPポートに対するアタックの対象となります。これはAsterisk等のサーバのSIPポートが5060であるかどうかに関係しません。 
[電話機 5060] <=====> [Asterisk 5060]
一般的にSIPの電話機/ソフトフォン(SIPクライアント)はAsteriskやIP-PBXに対して、自分の「所在」を登録するためREGISTERを行い、通話を開始するためにはINVITEを行います。この際、SIPクライアントが「目がけて行く」先は、AsteriskやIP-PBXの IPアドレス:ポート番号です。ご承知の通り、このポート番号が5060番の場合、インターネット上から攻撃を受けることがよくあり、皆さんもポート番号をずらす、あるいはファイアウォールで防御する等の対策を取られていると思います。ところが昨今のテレワーク環境においては、このAsteriskやIP-PBXのポート番号ではなく、SIP電話機やソフトフォン側のポート番号で、一部の電話機/ソフトフォンでは『ローカルSIPポート』として5060を使うものがあることが知られています。ここで、問題とするのはこのローカルSIPポートです。
====対策：====
不用意な攻撃を受けないようにする方法はいくつかあります。
:; 電話機/ソフトフォンのポート番号をずらす :電話機あるいはソフトフォンの設定で、ローカルSIPポートを5060以外のところにずらしてください。ここで、〇〇番が良い、などと書くとその情報が伝播して攻撃対象となることが考えられますので、『不都合のない適切な』値に設定してください。この対策においては、クライアント側だけ変更すればよく、Asterisk等のサーバ側ポート番号は現在使用しているものから変更する必要は通常ありません。
:; 家庭側でもフィルタ/ファイアウォールを施す :クラウド上のIP-PBXや会社のサーバのIPアドレスが固定、あるいは、ある範囲にある場合ならば、家庭側のルータ等でSIPポート番号に対する『入り』(着信)をそのIPアドレスからのみ許可するようにしてください。
急な対応により、不用意なSIP電話機やソフトフォンも増えているかと思いますので、皆様、お気をつけください。サーバ側の5060ポートに対しては慎重に行動されているかとは思いますが、家庭等に電話機を持っていった場合、5060が開いているかもしれないということを失念されていることがあります。今回、問題としているのは電話機ソフトフォン側のポート番号ですので、注意をお願いします。 
:当然ですがVPNで会社にトンネルを張ってる場合には関係ありませんので念のため。

===安直にサーバを立てないでください===
Asteriskの情報に辿り着き、クラウド上等にPBXを構築する場合、ネット上の一般的な情報だけを元に安直にAsteriskサーバを立てるのはやめましょう。インターネット上で開いているサーバには十分なセキュリティを施しておかないと、いわゆる『タダがけ』でやられます。特にSIPの5060ポートに対する攻撃は、あっという間に来ます。[[Asterisk SIP セキュリティ]] のページを参考にして注意して運用してください。
===テレワークの参考情報===
テレビ会議等で、音が『気持ち悪い』ような場合には、ヘッドフォンの片方を耳からはずして、片耳状態で使ってみてください。 
モノラル音源の場合、音像の定位が頭の中心にきてしまうため気持ち悪く感じるためです。私たちは頭の中心で誰かが喋ることに慣れていません。携帯電話など、電話での会話は片耳で聞くことに慣れているので、テレビ会議でも片耳で聞けば気持ち悪くなくなります。 
画面上の人物と音の来る方向が一致しないのも『気持ち悪い』原因となりますので、あまり人物を注視しない方が良いでしょう。 

===会社の電話(番号)をテレワークでも使いたい===
これは我々の得意とする分野です。お困りの場合には [[コミュニティ]] のページからユーザ会にご参加いただき、案件を投げてもらえれば手を挙げてくれるベンダーさんもいるかと思います。[[Asteriskコンサルタント]] ページも参考にしてください。
 
=='''注意喚起'''==
===DNSへのアタックに注意===
DNSへのアタックが多発しています。サーバを運用している方は特にご注意ください。普通のアクセスルータでも、まずいケースがありますのでアクセス回線でも速度がおかしい場合には注意した方がよいかもしれません。 
ヤマハルータによるこの対策方法をまとめておきました。→ [[DNSamp対策]]

===SIPポートへの攻撃についてご注意下さい===
SIPポートへの攻撃が流行っているようですので、ご注意下さい。 
現在多い攻撃は'''SIPのREGISTERを総当たりで試す'''というものです。 
対策方法等については : '''[[Asterisk SIP セキュリティ]]''' 
Fail2banによるiptablesでのブロック方法の設定をまとめました : '''[[SIP-Fail2ban]]''' 

=='''注目の情報'''==
*[[ABS]] をリリースしました
:軽量なAsteriskベースのPBXをお探しの場合にどうぞ
:キーテレホン挙動もできるのでビジホン用途でも使えます [[ABS]]
*Asterisk16
:Asterisk16がリリースされました。13に続くLTSです。
:Asteriskのバージョンと位置付けはこちら https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions

*新サンプル設定ファイル
:サンプル設定ファイルの内容を一新し13対応としました。
:[[Asterisk 13 サンプル設定ファイル]]

*'''Sangoma「が」Digium「を」買収'''
:特設ページ作りました [[Sangoma_Digium]]

==イベント・セミナー情報==
毎月やってる定例会はこちら。
:http://www.denphone.com/voip-asterisk-lounge-jp

==お願い==
最近、SPAMが増えつつあります。気付いた方は正常なページへの差し戻しまたは削除をお願いします。同一ページが複数回のSPAM書き込みを受けた場合にはページの保護をお願いします。

==RSSフィードについて==
メインのWikiのRSSフィードは[[%E7%89%B9%E5%88%A5:Recentchanges|最近更新したページ]]のツールボックス(左サイドバーの広告の下)にあります。 
フォーラム(Google Groups)のRSSフィードは下記です。 
:https://groups.google.com/forum/feed/asterisk-ug/msgs/rss.xml?num=50
ご利用ください。

==Wikiの管理者権限==
管理者権限が欲しい人は[[たかはし]]まで、ご連絡ください。 
Wikiページの書き換えや更新は、ユーザ登録を行っていただければできます。まだ登録されていない方は[[特別:Userlogin|アカウント作成ページ]]からユーザ登録をお願いします。

SIP-Fail2ban

2020-08-07T10:40:29Z

Takatyan: /* CentOS 8 */

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

==CentOS==
CentOSではepelから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 を見てもいいです。

== CentOS 8 ==

Asterisk16, CentOS 8でも同様にepelからdnfでインストールすることが可能です。 
CentOS 8では、iptablesではなく、nftables及びfirewalldが使用されていますが、問題なく対応しています。
dnf install -y epel-release
dnf --enablerepo=epel -y install fail2ban fail2ban-systemd

Asteriskのlogger.confの変更、/etc/fail2ban/jail.localの作成は上記、[[#CentOS|以前のCentOS]]と同様にしてください。 
しかし、2020年8月7日時点では、ここでfail2banを起動しても
2020-08-07 16:39:54,981 fail2ban.transmitter [58697]: WARNING Command ['server-stream', [['set', 'syslogsocket', 'auto']
(略)
Received ValueError('Action firewallcmd-rich-rules already exists',)
2020-08-07 16:39:54,981 fail2ban [58697]: ERROR NOK: ('Action firewallcmd-rich-rules already exists',)

というエラーが出て動きません。さしあたりの回避策として/etc/fail2ban/jail.d/00-firewalld.confを次のように変更します。
(略)
[DEFAULT]
banaction = firewallcmd-ipset
banaction_allports = firewallcmd-ipset
#banaction = firewallcmd-rich-rules[actiontype=<multiport>]
#banaction_allports = firewallcmd-rich-rules[actiontype=<allports>]

これでfail2banを起動すると監視が始まります。
systemctl enable fail2ban
systemctl start fail2ban

稼働状態の確認としては、上記fail2ban-clientコマンドまたは、次のコマンドが使用できます。
ipset --list

Asterisk 16及び[[Asterisk pjsip|pjsip]]を使用していると、Asteriskにパッチを当てる等しなくても[[#INVITEによるBrute force攻撃への対策|INVITEによるBrute force攻撃]]も防御できるようです。

SIP-Fail2ban

2020-08-07T07:54:37Z

Takatyan: /* CentOS 8 */

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

==CentOS==
CentOSではepelから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 を見てもいいです。

== CentOS 8 ==

Asterisk16, CentOS 8でも同様にepelからdnfでインストールすることが可能です。
dnf install -y epel-release
dnf --enablerepo=epel -y install fail2ban fail2ban-systemd

Asteriskのlogger.confの変更、/etc/fail2ban/jail.localの作成は上記以前のCentOSと同様にしてください。 
しかし、2020年8月7日時点では、ここでfail2banを起動しても
2020-08-07 16:39:54,981 fail2ban.transmitter [58697]: WARNING Command ['server-stream', [['set', 'syslogsocket', 'auto']
(略)
Received ValueError('Action firewallcmd-rich-rules already exists',)
2020-08-07 16:39:54,981 fail2ban [58697]: ERROR NOK: ('Action firewallcmd-rich-rules already exists',)

というエラーが出て動きません。さしあたりの回避策として/etc/fail2ban/jail.d/00-firewalld.confを次のように変更します。
(略)
[DEFAULT]
banaction = firewallcmd-ipset
banaction_allports = firewallcmd-ipset
#banaction = firewallcmd-rich-rules[actiontype=<multiport>]
#banaction_allports = firewallcmd-rich-rules[actiontype=<allports>]

これでfail2banを起動すると監視が始まります。
systemctl enable fail2ban
systemctl start fail2ban

稼働状態の確認としては、上記fail2ban-clientコマンドまたは、次のコマンドが使用できます。
ipset --list

黒電話ハック

2020-08-06T01:46:28Z

Takatyan: /* 基本的な話 */

最近どーも、黒電話をハックして再発見＆再発明しようとしている人が多いようなのでページを作っておきます。 
==まず読むべきもの==
*電話はなぜつながるのか知っておきたいNTT電話、IP電話、携帯電話の基礎知識
:https://www.amazon.co.jp/dp/4822282864/
*NTT技術参考資料(通称：ぎさんし)
:https://www.ntt-east.co.jp/gisanshi/
==基本的な話==
アナログ電話機は2線式で全二重の音声通信をやっています。なので自分の音声も相手の音声も同一の線に乗ります。 
:だから受話器からは自分の声も聞こえます
基本的な電圧(直流バイアス)は48V(正確には-48V)
:"電話"仕様のDCは48Vが基本です
:PoEで48Vが使われるのはこの仕様が理由で、もともとツイストペア線ネットワークは電話線流用から始まっているため
:鳴動(ベルを鳴らす)の際には直流バイアスに加えて48V(42～53V)の交流(AC:15～20Hz)を重畳します(技参資:3.5.2参照)。
:"呼び"のインピーダンスは600Ωです。ただし端末(電話機)のインピーダンスは線路(電線)を加えたものになるので、これより低いのが普通です。
"シグナリング"は受話器を上げた、下した、ダイヤルしたなどの操作によって相手と繋いだり切ったりすることを言います。 
"ダイヤル"には2種類の方法があり回転(ロータリー)式の電話機はDP(ダイヤルパルス)、押しボタン(プッシュ)式の電話機はDT(ダイヤルトーン)です。
:DPは10PPSと20PPSの2種類があります。PPSは秒間のパルスの数のこと
:DPは受話器の上げ下ろし(オフ/オンフック)と等価なので器用な人はフックボタンでダイヤルできます
:DTは2種類のトーンを同時に出して制御する方式です
電話機に繋ぐポートを'''FXS'''、電話回線に繋ぐポートを'''FXO'''といいます。

==ネットにつなぐには？==
アナログ電話機をIP化する装置をATA(Analog Telephone Adapter)といいます。ATAはとても安い値段で売ってます。 
:ただし、日本製ではないものが多いためDPに対応するATAは多くありません。 
:DPに対応している代表的なものはNTT東西のひかり電話アダプタというかルータ(PRとかRT)か、ヤマハのアナログポートを持つものです。 
:Grandstream の [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/ata%E3%83%BB%E3%82%B2%E3%83%BC%E3%83%88%E3%82%A6%E3%82%A7%E3%82%A4/%E3%82%A2%E3%83%8A%E3%83%AD%E3%82%B0%E9%9B%BB%E8%A9%B1%E3%82%A2%E3%83%80%E3%83%97%E3%82%BF/handytone-802/ HT-802]がDPサポートしているって話もあるので人柱募集。
::HT-801/4号A自動式電話機の組み合わせで発信および着信を確認しました。おそらく600-A1電話機でもイケるでしょう。ただし20pps(600/601-A2)による発信はダメみたいで、ダイヤルしてもせいぜい１桁までしか反応してくれない。
:電話回線(NTT側)をIP化する装置はゲートウェイと呼びます。ATAによってはこの機能をあわせもつものもあります。
:::ただし停電時バックアップ用にのみFXOを持つものはゲートウェイにはなりません。
ATAを使うとIP化できるので一般的にはSIPで制御できるようになります。SIPになればAsteriskとかで制御簡単。 
:IP化したけど、どうやって制御すんねーん！という人はAsteriskについて調べてください。ってか、ここ。 
:USBのFXSもありますがあまりメジャーではないです。USB FXSを使う場合は制御がDAHDI(旧Zaptel)のものが多いのでAsteriskが要ります
:目覚まし(モーニングコール)とか簡単にできるんだけどなぁ・・・

==マイコンにつなぐには？==
マイコンとかRaspberry Piにつなぐにはアナログの呼制御(シグナリング)をしてやらないとなのでちゃんとやろうとすると回路を作らないとだめです。 
Raspberry Pi用にはFXS/FXOモジュールが乗るPi TDMというのが出ていたりします。
:https://switchpi.com/shop-now/

Opusコーデック

2020-08-06T01:42:00Z

Takatyan: ページの作成:「== 概要 == OpusコーデックはAsteriskで利用可能な音声コーデックの1つ。技術的特徴は[https://ja.wikipedia.org/wiki/Opus_(音声圧縮) Wikipedi...」

== 概要 ==

OpusコーデックはAsteriskで利用可能な音声コーデックの1つ。技術的特徴は[https://ja.wikipedia.org/wiki/Opus_(音声圧縮) Wikipediaの記事]を参照のこと。

可変ビットレートであり、ビットレートに比して高音質で、低遅延とのことです。

== 注意事項 ==

インストール前に、提供元の[http://downloads.digium.com/pub/telephony/codec_opus/README README]をお読みください。

使用状況の統計を24時間ごとにコミュニティサーバーに送信する旨が記載されています。

また、バイナリパッケージの提供であり、x86またはx86_64のみの提供であるため、Raspberry Pi等のARMプロセッサ環境に対してはインストールできません。

了解された上で、インストールを行ってください。

== インストール ==

=== Asterisk 16 ===

Asterisk 16では、ビルド時にmake menuconfigでインストールするかどうかを選択します。

インストールするを選択した場合、make install時にOpusコーデックのバイナリがダウンロードされ、インストールされます。

make menuconfig

Codec Translators → 下の方「External」の更に下 → codec_opusを選択肢、Enterキーで*マークをつけ、Save & Exitし、makeします。

もし

XXX codec_opus

とXXXが表示されていて選択できない場合、何らかの依存ソフトウェアがインストールされていないためインストールできないようです。
codec_opusを選択した状態で、下の方の「Depends on」に記載されているソフトウェアをインストールします。

''CentOS 8ではxmlstarletが不足していましたが、何故かdnfからインストールできなかったので、RPMパッケージを手動でインストールしました。''

依存ソフトウェアをインストールしたら、./configureからやり直します。その場合make menuconfigで設定した内容は消去されるので、必要な場合設定内容を手元にメモしてから./configureをやり直し、再度make menuconfigを実行します。

make menuconfigが完了したら、makeでビルドを行います。続いて、sudo make installまたはrootユーザーでmake installを行います。Opusの追加のみの場合は、上書きインストールをしても問題は発生しませんでした。

==== 設定 ====

Asterisk設定ファイルのmodules.confに次の2行を追加します。
load = codec_opus.so
load = res_format_attr_opus.so

追加しなくても動く場合もあるようですが、他コーデックとの変換に失敗する場合は上記の追加で改善します。（他コーデックと変換については下記「CLIでの確認」も参照。）

続いて、pjsip.confのendpoint等でallow=opusと記載します。使用するクライアントでもOpusを使用する設定を行います。

==== CLIでの確認 ====

Opusが使用可能かどうかは、[[Asterisk CLI]]で次のコマンドを実行するとわかります。

CLIコマンド：
core show codecs

結果（抜粋）：
29 audio opus opus (Opus Codec)

CLIコマンド(コーデック同士の変換にかかるミリ秒を表示)：
core show translation

結果：
Translation times between formats (in microseconds) for one second of data
Source Format (Rows) Destination Format (Columns)

ulaw gsm slin8 slin12 slin16 slin24 slin32 slin44 slin48 slin96 slin192 g722 testlaw opus
ulaw - 15000 9000 17000 17000 17000 17000 17000 17000 17000 17000 17250 15000 23000
gsm 15000 - 9000 17000 17000 17000 17000 17000 17000 17000 17000 17250 15000 23000
slin8 6000 6000 - 8000 8000 8000 8000 8000 8000 8000 8000 8250 6000 14000
slin12 14500 14500 8500 - 8000 8000 8000 8000 8000 8000 8000 14000 14500 14000
slin16 14500 14500 8500 8500 - 8000 8000 8000 8000 8000 8000 6000 14500 14000
slin24 14500 14500 8500 8500 8500 - 8000 8000 8000 8000 8000 14500 14500 14000
slin32 14500 14500 8500 8500 8500 8500 - 8000 8000 8000 8000 14500 14500 14000
slin44 14500 14500 8500 8500 8500 8500 8500 - 8000 8000 8000 14500 14500 14000
slin48 14500 14500 8500 8500 8500 8500 8500 8500 - 8000 8000 14500 14500 6000
slin96 14500 14500 8500 8500 8500 8500 8500 8500 8500 - 8000 14500 14500 14500
slin192 14500 14500 8500 8500 8500 8500 8500 8500 8500 8500 - 14500 14500 14500
g722 15600 15600 9600 17500 9000 17000 17000 17000 17000 17000 17000 - 15600 23000
testlaw 15000 15000 9000 17000 17000 17000 17000 17000 17000 17000 17000 17250 - 23000
opus 23500 23500 17500 17500 17500 17500 17500 17500 9000 17000 17000 23500 23500 -

他コーデックとの変換については、Opusと変換する他方のコーデックのモジュールについてもmodules.confに記載する必要があるようで、必要な場合、上記のmodules.confへの追加例に倣って記載してください。

== 使ってみる ==

ulawではVoicemailmainで各音声の末尾が切れているような感じ（「メッセージ」の「ジ」が聞こえる前に次の音声に移ってしまう）でしたが、Opusにしたら改善しました。

利用者:Takatyan

2020-08-05T09:23:56Z

Takatyan:

* Takatyanの投稿した内容については、サイト管理人[[たかはし]]、または、その許諾する者に対し、あらゆる利用を認めます。
* 一方で、投稿内容の正しさについてはTakatyanは一切保証しませんし、たとえ誤りがあっても、投稿内容を利用したことについての責任は負いません。
* Takatyanは個人的に試して判明したことや、調べてわかったことをまとめて投稿しているか、明らかな誤字修正等を行うのみであり、宣伝等の意図はありません。

[[Category:人々]]

Asterisk SIP セキュリティ

2020-08-05T09:22:47Z

Takatyan: /* SIPのユーザ名/パスワードを、わかりにくくする */

AsteriskのSIPのセキュリティを向上させる方法
=大前提=
　まず第一に用事がない(外からREGISTさせる必要がない)Asteriskはインターネットから到達可能な所に置かない、つまりインターネットに出さない/開かないのが当然の措置です。一般的な内線網であれば、外部との接続にはゲートウェイ等が用いられるためIPリーチャブルなところにAsteriskを置く必要はありません。 
　サンプル設定ファイルをそのまま使用してはいけません。サンプル設定ファイルの中身は「誰でも」見られますし、公開されています。つまり攻撃者も同じ情報を入手できるということです。 
　当たり前の話ですが、外部に対してサーバを開くことの危険性を理解していないのであれば、サーバをインターネット上に出すべきではありません。
==allowguest==
　現在配布しているサンプル設定ファイルでは allowguest=no を指定してありますが、以前配布していたものにはこの指定がなく、デフォルトの yes になっていましたので注意してください。 
　基本 sip.conf には allowguest=no を指定しておいて下さい。yes を指定する場合/理由は自分で調べてください。 

=総当たり対策=
SIPのユーザ名、パスワードを総当たりしてくる攻撃の対策方法。 
総当たりで来るので、対策はそこそこ面倒です。 
==SIPポート番号をずらす==
デフォルトのSIPポートは5060/udpですが、これを別なポート番号にしてください。 
現在よく見られる攻撃は5060を狙い撃ちで来ます。このためSIPポート番号を移動することによって効果的な"逃げ"が行えます。 
ただしSIPポート番号を変更した場合には電話機等のSIPクライアント側も設定変更を行う必要があります(当然ですが)。 
==iptablesなどソースIPによるフィルタリング==
　一般的なセキュリティ対策と同様に通す/通さないIPアドレスが明確な場合には効果的な対策のひとつです。 
　特定のIPアドレスないしは、レンジからのREGISTERやSIPのセッションしか通さないのであれば、そのIPアドレスに対してのみSIP(5060)とRTP(UDPの10000～20000など)を開きます。 
　ただしこの方法は「相手」のIPアドレスが明確な場合にのみ使える方法です。 
==Fail2banを使用する==
fail2ban はログファイルを検査することにより、iptablesへ登録することでブロックする方式のツールです。SSHへのBruto Forceアタック対策などに使用されますが、Asteriskのログ検査を行うことでSIPをブロックするのにも使用できます。 
→[[SIP-Fail2ban]]

==ドメイン認証を使う==
sip.confのグローバルに以下の設定を追加します。
domain=nanntoka.kanntoka.tld
こうすると、SIPチャネルはこのドメインを持つものからのREGISTER以外は受付けなくなります。ただし、IPアドレスをドメインに使っている場合には、このIPアドレスも併記する必要があります。 
domain=nanntoka.kanntoka.tld
domain=192.168.1.120
このように複数を記述することができます。 
ただしこの方法は簡単に裏をかかれる可能性が高いので過信してはいけません。設定したから安全だと思わないように。他のセキュリティ対策を必ず併用してください。 
 
==SIPのユーザ名/パスワードを、わかりにくくする==
===パスワードを長くする===
まず第一にパスワードを長くし、わかりにくい文字列に変更すると総当たりされた場合に、ヒットする確率を下げることができます。
===ピア名を長くする===
サンプルの設定ファイルでは簡素化のために"内線番号=SIPピア名"という形で記述していますが、これは必ずしもイコールである必要はありません。ここをイコールにしている理由は
exten => _2XX,1,Dial(SIP/${EXTEN})
のように内線番号そのままでSIPピアにダイヤルしたいからです。もし、この利便性を捨ててかまわないのであれば、以下のような記述はアリです。
---sip.conf---
[4207f1257d2a12cb]
username=4207f1257d2a12cb
secret=なんちゃら
・
・
---extensions.conf
exten => 201,1,Dial(SIP/4207f1257d2a12cb)
内線番号とSIPのピア名の紐付けを行っているのはextensions.confです。なので、extensions.confの中で正しく記述されていれば、SIPのピア(ユーザ)名は内線番号と一致している必要はありません。
===上の応用===
上の方法を応用して、「ひみつのフレーズ」を付加することでピア(ユーザ)名を「わかりにくく」することが可能です。ただし、この「ひみつのフレーズ」を知られてしまっては意味がないので注意してください。 
まず sip.conf はこんな感じ
---sip.conf---
[5e8518af331d-201]
username=5e8518af331d-201
secret=なんちゃら
・
・
次にextensions.confはこんな感じ
exten => _201.,1,Dial(SIP/5e8518af331d-${EXTEN})
このフレーズの部分 5e8518af331d を使うことで、ピア名を長くしてしまうわけです。

==Asterisk 11の名前付きACLを使う==
Asterisk 11から名前付きACL(Named ACL)が使用可能になっています。これを使うことで、SIPのピア毎にアクセス制御をかけることが可能です。
*[[Asterisk 11 名前付きACL]]

=外にかけられないように対策=
勝手に外(外線)に対して発信できないように規制をかけることで、電話を勝手に使われて費用が発生してしまうことを防ぐことができます。 
==外線プレフィックスを特殊なものにしてしまう==
一般的に外線発信を単に、頭'0'で始めたり'0'ないしは'9' (03-, 003-のスタイル)で行えるようにしてしまっている所が多いと思います。これをワザと変なものにしてしまいます。例えば567とか何か適当なプレフィックスを外線発信用としてしまえば、ユーザ/パス総当たり->外線プレフィックス総当たりと両方を破って外に出られてしまうという危険性はかなり低くなります。 
exten => _567.,1,Dial(SIP/${EXTEN:3}@outband-gateway)
とかのように書いてしまいます。 
==内線番号によって発信規制する==
これはREGISTERされてCIDを騙られると効果はありませんが、特定の内線からのみ外線発信しておくことで若干は効果が期待できます。 
==発信先規制を入れる==
海外に通話できる番号を禁止してしまいましょう。そうすれば海外に対して発信できないので超高額な電話代の請求をされる可能性は、ぐっと低くなります。 
例えば頭が'00'とか'010'に対しては発信させないようにextenで書いてしまいます。ですが、これでは国際通話ができないので不便という場合には「超長いプレフィックス」などを使うとダイヤルできるようにしておくと良いでしょう。 
==そもそもの海外発信契約を止める==
キャリアと契約すると黙っていても国際通話ができるようになっていますが、これを止めます。一番安全かもしれません。
[[Category:セキュリティ]]

利用者:Takatyan

2020-08-05T07:18:59Z

Takatyan: ページの作成:「* Takatyanの投稿した内容については、サイト管理人たかはし、または、その許諾する者に対し、あらゆる利用を認めます。 *...」

Asterisk pjsip

2020-08-05T06:59:37Z

Takatyan: /* CLIコマンド */ スペルミス修正

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

AsiteriskでチャネルにPjSIPを使用する際の設定方法など
==コンパイル==
Asterisk 13まではpjprojectを別個インストールするか、configureに--with-pjproject-bundledを付けて実行する必要がありましたが、Asterisk 16からはデフォルトでbundledインストールされるようになりました。 
各バージョン毎のインストール方法についてはAsteriskのそれぞれのページを参照してください。 
[[Asterisk 13]] 
[[Asterisk 16]] 

==変換ツール==
Asterisk 13以降であればソースディレクトリ/contrib/scripts/sip_to_pjsip の下にPythonのスクリプトがあります(複数)。sip.confのあるディレクトリでこれを実行するとpjsip.confに変換してくれます。#includeしている場合にはそれらも変換してくれますが、完璧ではないです。
==Asterisk 16における注意点==
PjSIPはres_statsd.soに依存します。このためres_statsdがloadされていないと、res_pjsipがloadされない問題が発生します。 
(Asterisk 16ではモジュールの依存関係チェックが厳密化されています) 
res_statsdモジュールはstatsd.confファイルが無いとloadされないため、statsd.confファイルが無いだけで、PjSIPが使えないという困った状態になります。ソースファイルに含まれる statsd.conf.sample を /etc/asterisk/statsd.conf にコピーしておいてください。もっとも、このファイルはコメントされた行だけなので要するに空なのですが。

==パラメータ一覧==
[[Asterisk pjsip parameters]]

==基本設定==
*間違いやすいところ
:sip.confでは1wordだったのがアンダーバーが入る
:dtmfmode → dtmf_mode
:fromdomain → from_domain
===グローバル設定===
設定は基本としてはpjsip.confに書きます。 
*[[Asterisk_pjsip_parameters#GLOBAL]] 
グローバル設定を使用する場合にはtype=grobalのセクションを書きます。 
[grobal]
type=grobal
max_forwards = 50
SIPの基本パラメータやPjSIPの動作に関わるパラメータはSystemで設定します。 
*[[Asterisk_pjsip_parameters#SYSTEM]] 

===インクルード===
Asteriskの他の設定ファイル同様に#includeが使えます。なので、電話機と回線は別ファイルにした方が見通しは良いかもしれません。例えば 
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070

#include pjsip_phones.conf
#include pjsip_trunk_hikari.conf
のようにファイルを分割し、includeすると管理が楽になります。

基本で必要なものは以下です。

===トランスポート===
[transport-udp]
type = transport
protocol = udp
bind = 0.0.0.0:5070
sip.confに書いていたものと同じですが、トランスポートはセクションで明示指定します。上の例では5070ポートにbindさせていますが、5060を使用する場合にはここを5060にします。 

===ACL===
ACLの例は次の通りです。
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
※deny,permitはこの順でないとpermitしてdenyしてしまう模様で、逆に書くと誰も使えなくなります。 
 
pjsip.confに複数のACL(type=acl)を書くとそのセクション名にかかわらず後ろにあるACLの方が勝つ模様。 
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16

[acl-my]
type=acl
deny=0.0.0.0/0.0.0.0
permit=10.10.0.0/16
と、書くとacl-myが勝つので要注意です。複数を許可したい場合には1セクションで
[acl]
type=acl
deny=0.0.0.0/0.0.0.0
permit=192.168.0.0/16
permit=10.10.0.0/16
のように書きます。 
*[[Asterisk_pjsip_parameters#ACL.28res_pjsip_acl.29]]
→[[Asterisk pjsip ACL]]

===認証情報(Auth)===
sip_confではピア(エンドポイント)の認証がわかりにくかったのですが、PjSIPでは別なセクションで(type=auth)認証情報を定義するようになりました。このため、認証情報がピア名(sip.confの[ ])に紐付かなくなりました。 
慣れないとわかりにくい感じがしますが、管理がより柔軟になります。例えば
[some-phone]
type = endpoint
.
.
.
auth = phone-auth
outbound_auth = phone-out-auth
のようなendpointが定義されている場合には、2つのauthセクションが必要です。
[phone-auth]
type = auth
username = phone123
password = phonepassword
このAuthは'[some-phone]'エンドポイントに接続、すまり外からの"入り"の際の認証情報です。 
[phone-out-auth]
略
このAuthはoutbound_authで設定されているので、このエンドポイントからの"出"の際の認証情報です。 

==電話機==
電話機の接続は [[Asterisk pjsip 電話機]] のページへ
==トランク==
回線接続側は [[Asterisk pjsip trunks]]のページへ

==Wizard==
Asteriskにはpjsip_wizardが組み込まれており、PjSIPの設定を簡素化することができます。使う場合の条件は以下の通りです。
*基本の設定はpjsip.confに書く
:transportなどの情報はpjsip.confに書く必要があります
*Wizard用のファイル名はpjsip_wizard.conf
*共通化したテンプレート内で各セクションを指定するにはスラッシュ(/)で区切る
*Wizardは電話機でもトランクでも使用できる
:registration/を書くとregistrationセクションがつくられる
:例: endpoint/dtmf_mode
pjsip_wizard.confの記述例
;電話機用テンプレート(共通設定)
[phone-defaults](!)
type=wizard
transport = transport-udp
accepts_registrations = yes
sends_registrations = no
accepts_auth = yes
sends_auth = no
endpoint/context = default
endpoint/dtmf_mode = rfc4733
endpoint/call_group = 1
endpoint/pickup_group = 1
endpoint/language = ja
endpoint/disallow = all
endpoint/allow = ulaw
endpoint/rtp_symmetric = yes
endpoint/force_rport = yes
endpoint/direct_media = no
endpoint/send_pai = yes
endpoint/send_rpid = yes
endpoint/rewrite_contact = yes
endpoint/inband_progress = yes
endpoint/allow_subscribe = yes
endpoint/transport = transport-udp
aor/max_contacts = 1
aor/qualify_frequency = 30
aor/authenticate_qualify = no

;各電話機個別設定
[phone1](phone-defaults)
inbound_auth/username = phone1
inbound_auth/password = mypasswordishere

==CLIコマンド==
*sip show peersに対応するのはpjsip show endpoints
*sip show peer phone1などピア情報を表示するのはpjsip show endpoint phone1
*AORを表示するのは一覧ならpjsip show aorsでピアの情報を表示するのはpjsip show aor phone1のようにする
*それぞれの設定項目で何が設定されているかを確認するには pjsip show endpoint phone1 のようにすると phone1 の endpoint パラメータ一覧が表示される。aorを見たければ pjsip show aor phone1。これはトランクの場合も同様で pjsip show registration hikari-hgw のようにするとregister関係のパラメータがみえる。

==挙動上の注意点==
===挙動そのもの===
chan_sipより制限が少し"きつい"です。SIPメッセージの中に少しおかしなものがあってもchan_sipでは制限が緩かったので、通っていたものがPjSIPでは通らないことがあります。CLI等で'syntax error'のようなメッセージが出る場合にはSIPメッセージにおかしなところがあるかもしれないので調べてください。
===AddHeader===
chan_sipの場合にはSIPAddHeaderでSIPヘッダを追加できましたが、PjSIPではファンクションPJSIP_HEDER()を使用します。ただしこのファンクションはextenの途中で使用しても効果がありません。Dial時にサブルーチンコールしてやる必要があります。 
例えばAlert-Info: hogeを追加するにはまず以下のよなルーチンを定義します。
[add-alert]
exten => s,1,Set(PJSIP_HEADER(add,Alert-Info)=hoge)
exten => s,n,Return
Dial時に以下のようにしてコールします
exten => 201,1,Dial(PJSIP/201,,b(add-alert,s,1))

==設定変更の反映==
*モジュール数が多すぎて一発リロードする方法がよくわからない
*module reload res_pjsip.soを実行すれば"だいたい"はいけそう
:wizardのaor/を変更しても反映されない場合がある
==PjSIPで拡張される機能==
[[pjsip_機能拡張]]

Asterisk 16

2020-08-03T05:25:12Z

Takatyan: CentOS 8の記載を追加

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

Asterisk 16.0.0が2018年10月9日(現地時間)リリースされました。 
:メンテナンス終了は2022年10月
:セキュリティフィックス提供終了は2023年10月
==概要==
Asterisk 16は最新のAsteriskのメジャーリリースで、Asterisk 13同様にLTS(Long Term Support:通常4年)になります。
:https://wiki.asterisk.org/wiki/display/AST/Asterisk+Versions
===Asterisk 13からの変更点で重要なもの===
*app_faxは廃止予定
:res_faxへ移行のこと
*'''app_macroは廃止予定'''
:デフォルトではapp_macroはコンパイルされない
:app_stack(Gosub)へ移行のこと → [[extension_Macro_To_Gosub]]
*AMI/ARIのイベントにいくつか変更あり
*libjanssonは2.11以上のバージョンが必要
*cdr_syslogは廃止予定
:デフォルトではコンパイルされない
*res_config_sqliteは廃止予定
:デフォルトではres_config_sqliteはコンパイルされない
:res_config_sqlite3に移行のこと
*'''res_monitorは廃止予定'''
:app_mixmonitorに移行のこと
*libeditは組み込みでは提供されなくなったのでOSのパッケージでインストールのこと

==注意==
将来的にSIPチャネルはPjSipが標準となる模様です。なるべくはやい時期にchan_sipからPjSipへの移行をお勧めします。Asterisk 16からはconfigureのオプションなしでもbundledでpjsipをダウンロードするようです。→ [[Asterisk pjsip]] 
なおAsterisk 16ではPjSIPはstatsdに依存しています。上のページの注意点をよく読んで設定してください。 
 
Macroが廃止予定にされているので注意が必要です。Macroを多用している場合には早い時期にGosub/Returnへの書き換えが必要です。 
'''単純にmake installしてしまうとMacro()もDialのMも動かなくなるのでハマりますよ！'''

==日本語音声の扱い==
core sound packageでJAが使用可能ですが、Asterisk 16で変更された音声に対応しているかどうかは不明です。

==インストール==
===前提となるパッケージ類===
GCC、G++(GNU-C++)、OpenSSL、Ncurses、bison、カーネルソース(DAHDIを使う場合)、libxml2、SQLite3、libuuid-devel uuid-devel、json-c、json-c-devel 
CentOS 7 minimalからインストールする場合、以下の手順でコンパイル環境を整えます。 
CentOS 8 minimalからインストールする場合で、yum installで必要なパッケージが無い旨のエラーが出たときは「--enablerepo=PowerTools」を付与して実行すると上手くいきます。 
Asterisk 16からlibeditがパッケージで必要となったため追加しておく必要があります。 
開発環境系パッケージを一括インストールしておきます。
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 libedit-devel
yum install json-c json-c-devel

openssl-develをインストールするとkrb5-devel,zlib-develも一緒に付いて来るので別途インストールの必要はありません。 
Asteriskは現在のバージョンではBerkley DBではなくSQLite3をDBとして使用しますので、SQLite3と開発環境が必要です。 
newt-develがないとmenuselectがフルスクリーンコントロールになりません。テキストベースになります。 
 
CentOSのminimalだと足りないツール類がいくつかあるので入れておきます。
yum install wget bzip2 patch
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のインストール===
個別インストールせずbundledインストールが可能です。configureのオプションで指定してください。
./configure --with-jansson-bundled

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

===Asteriskのコンパイルとインストール===
基本的にconfigureしてmakeするだけです。
# ./configure
*16でjanssonをbundleインストールするには以下を実行します(通常はこの方法)
# ./configure --with-jansson-bundled
日本語音声ファイルをインストールする場合には./configureの後 make menuselectを実行します。
# make menuselect
メニュー画面から '''Core Sound Packages'''で'''CORE_SOUND-JA-....'''の必要なフォーマットのファイルを選択し、[Save & Exit]でmenuselectを終了します。 
extenでMacro()を使用している場合、デフォルトではコンパイルされなくなったので注意してください。make menuselectでappのMacroを明示的にON指定してください(deprecatedの下にあります)。 
 
以前のバージョンからアップグレードを行う場合、変更されたモジュール類が多いので、一旦、以前のモジュールをディレクトリごと名前変更してバックアップしてからインストールしてください。 
mv /usr/lib/asterisk/module /usr/lib/asterisk/module.13.bak

あとはコンパイルとインストールを行うだけです。
# make
# make install
# make samples
*make configはCentOS 7では注意
:[[Asterisk Startup systemd]] 
CentOS 7以前のOSならばmake configしておくと自動起動します。
# make config
これで新規インストールは完了します。最後の make config で起動時に自動起動するようになります。 

===MP3を使用する場合の注意===
MP3関連(MoHなど)を使用する場合には、MP3系のソースはAsterisk本体に含まれていないため、コンパイル時にエラーになりますが、ソース入手のスクリプトが付属しています。
# ./contrib/scripts/get_mp3_source.sh
これを実行すればMP3関連のモジュールがコンパイルできるようになります。

===SIPチャネルとしてPjsipを使う場合===
Asterisk 16からPjSIPはデフォルトでbundled扱いでダウンロード/コンパイルが行われます。このためconfigureを実行するだけでPjSIPも組み込まれます。

==サンプル設定ファイル==
単純な使用ならばAsterisk 13用の設定ファイルが使えます。 
:[[Asterisk 13 サンプル設定ファイル]]
PjSIPを使用して電話機を収容したい場合には以下のファイルを使ってください。 
:PjSIP用サンプル設定ファイル https://www.voip-info.jp/images/8/87/Conf-sample-pj.zip

==ひかり電話ホームの使用==
*chan_sipの今後のサポートが怪しいので、PjSIPを使ってください。
:[[pjsip ひかり電話HGW]]を参照してください。
:chan_sipをどうしても使いたい場合にはMACアドレス認証を使ってください。
:<del>パッチを作るかどうかはお悩み中</del>
:今後はパッチは提供しません。chan_sipが廃止方向にあるのでpjsipを使ってください。

利用者:Takatyan/sandbox

2018-08-26T06:03:50Z

Takatyan:

[[カテゴリ:Asterisk]]
[[Category:練習場]]

このページは[[利用者:Takatyan|Takatyan]]のサンドボックスです。編集を試したり下書きを置いておくための場所です。内容は記載途中のものに過ぎません。

chan_dongleは、USB接続で3Gモデムを接続し、音声通話、SMSをAsteriskから扱えるようにするモジュールです。

==インストール==
===前提条件===
* CentOS 7.5で検証しています。カーネルは「kernel-3.10.0-862.9.1.el7.x86_64」で検証しています。
* [[Asterisk 13|Asterisk 13.22.0]]をソースからビルドしてインストールしています。
* 使用可能な3Gモデムについては、[http://wiki.e1550.mobi/doku.php?id=requirements 公式サイト]を参照のこと。

===必要なツール===
ソースコードの入手及びビルドのために、git, autoconf, automakeが必要です。

sudo yum install git autoconf automake

===ソースコードの入手===
ソースコードは[https://github.com/bg111/asterisk-chan-dongle github]でオリジナルのものが配布されていますが、そのままではAsterisk 13にはインストールできません。
[https://github.com/bg111/asterisk-chan-dongle/pull/216/commits プルリクエスト216]は2018年8月現在プルされていませんが、これを手元でマージします。そのための手順は次のようになります。

git clone https://github.com/bg111/asterisk-chan-dongle.git
cd asterisk-chan-dongle
git fetch origin pull/216/head:asterisk_13
git checkout asterisk_13

これでAsterisk 13で使用できるchan_dongleソースコードができました。
ビルドの前に、SELinux有効下での使用を考えていらっしゃる方は下記を修正します。

// 119行目
// return snprintf(buf, length, "/var/lock/LCK..%s", basename);
return snprintf(buf, length, "/var/lock/'''lockdev/'''LCK..%s", basename);

これをビルド、インストールします。
./bootstrap
./configure --with-asterisk=../asterisk-13.22.0/include -with-astversion=13.22.0
make
sudo make install

'''以下記載途中'''

'''以下記載予定'''
* SELinux有効下で使う方法
* 設定ファイルの書き方

利用者:Takatyan/sandbox

2018-08-22T07:42:20Z

Takatyan:

[[カテゴリ:Asterisk]]
[[Category:練習場]]

このページは[[利用者:Takatyan|Takatyan]]のサンドボックスです。編集を試したり下書きを置いておくための場所です。内容は記載途中のものに過ぎません。

chan_dongleは、USB接続で3Gモデムを接続し、音声通話、SMSをAsteriskから扱えるようにするモジュールです。

==インストール==
===前提条件===
* CentOS 7.5で検証しています。カーネルは「kernel-3.10.0-862.9.1.el7.x86_64」で検証しています。
* [[Asterisk 13|Asterisk 13.22.0]]をソースからビルドしてインストールしています。
* 使用可能な3Gモデムについては、[http://wiki.e1550.mobi/doku.php?id=requirements 公式サイト]を参照のこと。
* コンパイラ等のツールは、Asteriskインストール時のもののほか、git、autoconf?など（検証中）
 
===ソースコードの入手===
ソースコードは[https://github.com/bg111/asterisk-chan-dongle github]でオリジナルのものが配布されていますが、そのままではAsterisk 13にはインストールできません。
[https://github.com/bg111/asterisk-chan-dongle/pull/216/commits プルリクエスト216]は2018年8月現在プルされていませんが、これを手元でマージします。そのための手順は次のようになります。

git clone https://github.com/bg111/asterisk-chan-dongle.git
cd asterisk-chan-dongle
git fetch origin pull/216/head:asterisk_13
git checkout asterisk_13

これでAsterisk 13で使用できるchan_dongleソースコードができました。
ビルドの前に、SELinux有効下での使用を考えていらっしゃる方は下記を修正します。

// 119行目
// return snprintf(buf, length, "/var/lock/LCK..%s", basename);
return snprintf(buf, length, "/var/lock/'''lockdev/'''LCK..%s", basename);

これをビルドします。
./configure --with-asterisk=../asterisk-13.22.0/include -with-astversion=13.22.0

'''以下記載途中'''

'''以下記載予定'''
* SELinux有効下で使う方法
* 設定ファイルの書き方

利用者:Takatyan/sandbox

2018-08-22T05:58:15Z

Takatyan:

[[カテゴリ:Asterisk]]
[[Category:練習場]]

このページは[[利用者:Takatyan|Takatyan]]のサンドボックスです。編集を試したり下書きを置いておくための場所です。内容は記載途中のものに過ぎません。

chan_dongleは、USB接続で3Gモデムを接続し、音声通話、SMSをAsteriskから扱えるようにするモジュールです。

==インストール==
===前提条件===
* CentOS 7.5で検証しています。カーネルは「kernel-3.10.0-862.9.1.el7.x86_64」で検証しています。
* [[Asterisk 13|Asterisk 13.22.0]]をソースからビルドしてインストールしています。
* 使用可能な3Gモデムについては、[http://wiki.e1550.mobi/doku.php?id=requirements 公式サイト]を参照のこと。
* コンパイラ等のツールは、Asteriskインストール時のもののほか、git、autoconf?など（検証中）
 
===ソースコードの入手===
ソースコードは[https://github.com/bg111/asterisk-chan-dongle github]でオリジナルのものが配布されていますが、そのままではAsterisk 13にはインストールできません。
[https://github.com/bg111/asterisk-chan-dongle/pull/216/commits プルリクエスト216]は2018年8月現在プルされていませんが、これを手元でマージします。そのための手順は次のようになります。

git clone https://github.com/bg111/asterisk-chan-dongle.git
cd asterisk-chan-dongle
git fetch origin pull/216/head:asterisk_13
git checkout asterisk_13

これでAsterisk 13で使用できるchan_dongleソースコードができました。これをビルドします。
./configure --with-asterisk=../asterisk-13.22.0/include -with-astversion=13.22.0

'''以下記載途中'''

'''以下記載予定'''
* SELinux有効下で使う方法
* 設定ファイルの書き方

利用者:Takatyan/sandbox

2018-08-22T05:54:31Z

Takatyan: Chan_dongleのページの下書き初版

[[カテゴリ:Asterisk]]
[[Category:練習場]]

このページは[[利用者:Takatyan|Takatyan]]のサンドボックスです。編集を試したり下書きを置いておくための場所です。内容は記載途中のものに過ぎません。

chan_dongleは、USB接続で3Gモデムを接続し、音声通話、SMSをAsteriskから扱えるようにするモジュールです。

==インストール==
===前提条件===
* CentOS 7.5で検証しています。カーネルは「kernel-3.10.0-862.9.1.el7.x86_64」で検証しています。
* [[Asterisk 13|Asterisk 13.22.0]]をソースからビルドしてインストールしています。
* 使用可能な3Gモデムについては、[http://wiki.e1550.mobi/doku.php?id=requirements 公式サイト]を参照のこと。
* コンパイラ等のツールは、Asteriskインストール時のもののほか、git、autoconf?など（検証中）
 
===ソースコードの入手===
ソースコードは[https://github.com/bg111/asterisk-chan-dongle github]でオリジナルのものが配布されていますが、そのままではAsterisk 13にはインストールできません。
[https://github.com/bg111/asterisk-chan-dongle/pull/216/commits プルリクエスト216]は2018年8月現在プルされていませんが、これを手元でマージします。そのための手順は次のようになります。

git clone https://github.com/bg111/asterisk-chan-dongle.git
cd asterisk-chan-dongle
git fetch origin pull/216/head:asterisk_13
git checkout asterisk_13

これでAsterisk 13で使用できるchan_dongleソースコードができました。これをビルドします。
./configure --with-asterisk=../asterisk-13.22.0/include -with-astversion=13.22.0

'''以下記載途中'''

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

Asterisk on Docker

Asterisk pjsip trunk @niftyフォン-C

Asterisk Startup systemd

利用者:Takatyan/sandbox/Asterisk on Docker

Asterisk on Docker

Asterisk on Docker

Asterisk on Docker

Asterisk

Asterisk pjsip

Pjsip 機能拡張

Asterisk

Asterisk サンプル設定ファイル extensions.conf

Asterisk サンプル設定ファイル extensions.conf

アナログ電話機の接続

VoIPアダプタ(NTT東西)

Asterisk ログファイル

Asterisk ログファイル

Asterisk ログファイル

Asterisk ログファイル

Asterisk ログファイル

Asterisk ログファイル

Asterisk pjsip 電話機

Asterisk pjsip NAT

利用者:Takatyan

Asterisk動作確認済みOS

Asterisk pjsip trunks

Asterisk pjsip

Asterisk pjsip trunk @niftyフォン-C

Asterisk pjsip trunks

Asterisk pjsip trunk @niftyフォン-C

メインページ

SIP-Fail2ban

SIP-Fail2ban

黒電話 ハック

Opusコーデック

利用者:Takatyan

Asterisk SIP セキュリティ

利用者:Takatyan

Asterisk pjsip

Asterisk 16

利用者:Takatyan/sandbox

利用者:Takatyan/sandbox

利用者:Takatyan/sandbox

利用者:Takatyan/sandbox

黒電話ハック