From a49426589ce53b1085b1388ea89fe96a2c25d677 Mon Sep 17 00:00:00 2001
From: dev <dev>
Date: Mon, 24 Aug 2026 04:06:35 +0000
Subject: [PATCH] .

---
 CGI/doc/readme | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 CGI/doc/readme

diff --git a/CGI/doc/readme b/CGI/doc/readme
new file mode 100644
index 0000000..eb045f9
--- /dev/null
+++ b/CGI/doc/readme
@@ -0,0 +1,70 @@
+Asterisk Manager Interface (AMI) 経由でBlack/White List を登録/削除
+
+[利用上の注意]
+入出力のサニタイジング処理を行っていません。
+このCGIはLAN側からのみ接続可能となるようにアクセスコントロールを施してください。
+インターネット上からアクセスさせる場合は、脆弱性が無いか十分に確認、修正を施してください。
+
+[ライセンス]
+MIT License
+Copyright © 2026 ChovitsClub
+https://opensource.org/licenses/mit-license.php
+その他、css/javascript等は各アプリケーションのライセンスに準じて下さい
+
+[開発環境]
+Raspberry Pi OS
+Debian13 (trixie) 
+Apache デフォルト設定
+
+htmlドキュメントルート
+・/var/www/html
+
+cgi-bin デフォルトディレクトリ
+・/usr/lib/cgi-bin
+
+[配置]
+・black-white.pl は、CGIが実行可能であるディレクトリ
+・ini/tmpl ファイルは、非公開ディレクトリへ配置します
+[-rwxr-xr-x] /usr/lib/cgi-bin/black-white.pl
+/var/www/asterisk
+              |-- [-rw-r--r--] black_whitelist.ini
+              |-- [-rw-r--r--] black_whitelist.tmpl
+
+[CGI 依存パッケージ]
+
+〇 perl 必須Module 
+・Config::Simple (libconfig-simple-perl)
+・CGI (libcgi-pm-perl)
+・HTML::Template (libhtml-template-perl)
+・Telephony::Asterisk::AMI (libtelephony-asterisk-ami-perl)
+
+[CGIの仕様]
+・ asterisk CUIが利用可能な場合は、わざわざCGIを利用する必要はありません。
+
+・ 設定ファイル black_whitelist.ini が存在する場合、AMI接続用のユーザー/パスワードは
+   設定ファイルの定義が優先されます。
+
+・ CGIでは、追加/削除のみ実装しています。修正(変更)は実装していません。
+   修正(変更)が必要な場合は、一旦削除して改めて追加してください。
+
+[asteriskの設定]
+・asterisk設定ファイル manager.confにて、AMI設定およびアクセスするユーザー名/パスワードを定義します。
+  以下は設定例です。ユーザー名/パスワードは適時変更して使用してください。
+
+---- /etc/asterisk/manager.conf -----
+[general]
+enabled = yes
+port = 5038
+bindaddr = 127.0.0.1
+authtimeout = 30
+authlimit = 5
+httptimeout = 30
+
+[asterisk]
+secret = ABCDEFGH
+deny=0.0.0.0/0.0.0.0
+permit=127.0.0.1/255.255.255.255
+read = all
+write = all
+----- 
+
-- 
2.43.7