udelarinterior.sympa

sympa

これは、Sympa メーリングリストマネージャをセットアップする Ansible ロールです。

要件

Debian stretch または Ubuntu サーバ。MySQL/MariaDB または PostgreSQL データベースオプション。データベースマネージャは、ホストに事前にインストールされていることができます（デフォルト）もしくは、このロール自体によってオプションでインストールされます。Sympa のためのウェブサーバは別途構成する必要があります。

ロールの変数

完全なドキュメントについてはここを参照してください。このロールは、Sympaバージョン 6.2.16（Debian stretch sympa パッケージ）でテストされています。

リストテンプレート

sympa_template_lists は、定義されるテンプレートのリストです。内容についてはテンプレートリストの Sympa ドキュメントをご覧ください。各エントリは以下の内容を含み、/etc/sympa/create_list_templates/ に name 属性をフォルダ名としたフォルダが作成され、その中に comment.tt2 と config.tt2 が作成されます。

名称	必須/デフォルト	説明
`name`	:heavy_check_mark:	テンプレート用フォルダの名前
`config`	:heavy_check_mark:	`config.tt2` ファイルに書き込まれる内容
`comment`	:heavy_check_mark:	`comment.tt2` ファイルに書き込まれる内容

データソース

sympa_data_sources は、定義されるデータソースのリストです。内容についてはデータソースの Sympa ドキュメントをご覧ください。各エントリは以下の内容を含み、/etc/sympa/data_sources/ に incl という拡張子を持つファイルが作成されます：

名称	必須/デフォルト	説明
`name`	:heavy_check_mark:	データソースのファイル名
`content`	:heavy_check_mark:	データソースファイルに書き込まれる内容

エイリアスマネージャ

sympa_alias_manager はエイリアスマネージャ実行可能ファイルのパスです。 sympa_ldap_alias_entry 変数が定義されている場合は /etc/sympa/ldap_alias_entry.tt2 に書き込まれます。 sympa_ldap_alias_manager_conf 変数が定義されている場合は /etc/sympa/ldap_alias_manager.conf に書き込まれ、以下の値を含むことができます：

名称	必須/デフォルト	説明
`host`	:heavy_check_mark:	LDAPサーバのホストURL
`bind_dn`	:heavy_check_mark:	使用するユーザーのバインドDN
`bind_pwd`	:heavy_check_mark:	ユーザーのパスワード
`base_dn`	:heavy_check_mark:	LDAPツリーのベースDN
`mail_attribute`	`mailRoutingAddress`	書き込みに使用する属性
`ssl`	`false`	SSLの有効または無効
`queue_transport`	`sympa`	通常のトランスポートの名前
`bouncequeue_transport`	`sympabounce`	メールがバウンスしたときのトランスポートの名前

認証変数

sympa_auth は、順番に使用される認証メソッドのリストです。各エントリは以下の内容を含みます：

名称	必須/デフォルト	説明
`name`	:heavy_check_mark:	ldap、user_table のような認証オプション名
`options`	:heavy_check_mark:	認証メソッド用のオプションの辞書

例

sympa_auth:
- name: ldap
  options:
    host: ldap.example.com:636
    timeout: 20
    suffix: yoursuffix
    bind_dn: yourbinddn
    bind_password: yourpw
    use_tls: ldaps
    ca_verify: none
    get_dn_by_uid_filter: "(uid=[sender])"
    email_attribute: mail
    scope: sub
    authentication_info_url: https://example.com
- name: user_table
  options:
    regexp: ".*"

トピック変数

sympa_topics キーの下にトピックのリストがあります。各リストエントリは以下の内容を含みます：

名称	必須/デフォルト	説明
`path`	:heavy_check_mark:	カテゴリのパス
`title`	:heavy_check_mark:	カテゴリのタイトル

例

sympa_topics:
- path: art
  title: Art
- path: art/expressionism
  title: Expressionism

データベースマネージャ

名称	必須/デフォルト	説明
`sympa_db_type`	`mysql`	データベースマネージャの選択。`MySQL` または `Pg`。`mysql` と `PostgreSQL` の値が受け入れられます。他のデータベースオプションは管理されません。
`sympa_install_db_package`	`False`	DBマネージャが事前にインストールされているか（`False`）、ロールがインストールするか（`True`）を示します。

Sympa変数

名称	必須/デフォルト	説明
`sympa_domain`	`"{{ ansible_fqdn }}"`	メインロボットのホスト名
`sympa_listmaster`	`listmaster@{{ sympa_domain }}`	リストマスターに昇格するためのメールアドレスのリスト
`sympa_wwsympa_url`	:heavy_check_mark:	メインウェブページのURL
`sympa_email`	:heavy_multiplication_x:	Sympaのメールアドレスのローカル部分
`sympa_db_password`	:heavy_check_mark:	データベース接続のパスワード
`sympa_db_name`	`sympa`	データベースの名前
`sympa_db_host`	`localhost`	データベースサーバのホスト名
`sympa_db_port`	`3306`	データベースサーバのポート
`sympa_db_user`	`sympa`	データベース接続用ユーザー
`sympa_lang`	`en`	デフォルトの言語（サポートされている言語の1つ）#supported_lang ca, cs, de, el, es, et, en-US, fr, fi, hu, it, ja, ko, nl, nb, oc, pl, pt-BR, ru, sv, tr, vi, zh-CN, zh-TW
`sympa_logo_html_definition`	:heavy_multiplication_x:	左上隅にロゴを配置するHTMLスニペット
`sympa_gecos`	`SYMPA`	Sympa自体が送信するサービスメールのGecos
`sympa_process_archive`	`False`	配信されたメッセージをアーカイブに保存するかどうか
`sympa_voot_feature`	`False`	Voot機能
`sympa_max_wrong_password`	`19`	間違ったパスワードの試行回数
`sympa_static_content_path`	`/var/lib/sympa/static_content`	静的コンテンツを保存するためのディレクトリ
`sympa_static_content_url`	`/static-sympa`	`sympa_static_content_path`ディレクトリにマッピングされたURL
`sympa_syslog`	`LOCAL1`	Sympaのsyslogファシリティ
`sympa_log_level`	`0`	ログの冗長性 0: 通常, 2,3,4: デバッグ用
`sympa_log_socket_type`	`unix`	syslogdとの通信モード（unix, inet）
`sympa_sendmail`	`/usr/bin/sendmail`	MTA（sendmail, postfix, eximまたはqmail）へのパスはsendmail互換のバイナリ（例： "sendmail" という名前のバイナリはPostfixに付属）を指すべきです
`sympa_maxsmtp`	`40`	Sympaによって起動されるSendmailプロセスの最大数
`sympa_log_smtp`	`False`
`sympa_use_blacklist`	`[ send, create_list ]`	ブラックリストフィルタが適用される操作のリスト。空のリストはこの機能を無効にします。
`sympa_max_size`	`5242880`	メッセージのデフォルト最大サイズ（バイト単位）（各リストごとに再定義可能）
`sympa_sendmail_nrcpt`	`25`	Sendmailへの呼び出しごとの最大受信者数。nrcpt_by_domain.confファイルは、宛先ドメインごとに異なるチューニングを許可します。
`sympa_sendmail_avg`	`10`	Sendmailに呼び出される際の異なるドメインの最大数
`sympa_rfc2369_header_fields`	`[help, subscribe, unsubscribe, post, owner, archive ]`	追加するrfc2369メーリングリストヘッダーを指定
`sympa_remove_headers`	[ `X-Sympa-To, X-Family-To, Return-Receipt-To, Precedence, X-Sequence, Disposition, Notification-To, Sender ]`	メッセージ配信前に削除するヘッダー項目を指定
`sympa_reject_mail_from_automates_feature`	`True`	リストに送信された自動化（cron など）からのメールを拒否しますか？
`sympa_packet_priority`	`5`	バルク送信によるパケットのデフォルトの優先度
`sympa_bulk_fork_threshold`	`1`	送信率を上げるためにバルクがフォークする前のデータベース内パケットの最小数
`sympa_bulk_max_count`	`3`	同じサーバーで実行されるバルクの最大数
`sympa_bulk_lazytime`	`600`	スレーブバルクがメッセージを処理せずに動作し続ける秒数
`sympa_bulk_sleep`	`1`	メッセージを送信するための新しいループを開始する際、見つからなかった場合にバルクがスリープする秒数
`sympa_bulk_wait_to_fork`	`10`	マスターバルクが二つのパケット番号チェック間で待つ秒数
`sympa_default_max_list_members`	`0`	各リストの購読者数のデフォルト制限（0は無制限を意味します）
`sympa_spool`	`/var/spool/sympa`	さまざまな専門的なスプールを含むディレクトリ
`sympa_queue`	`/var/spool/sympa/msg`	メッセージが入るスプール用のディレクトリ
`sympa_queuemod`	`/var/spool/sympa/moderation`	モデレーションスプール用ディレクトリ
`sympa_queuedigest`	`/var/spool/sympa/digest`	ダイジェストスプール用ディレクトリ
`sympa_queueauth`	`/var/spool/sympa/auth`	認証スプール用ディレクトリ
`sympa_queueoutgoing`	`/var/spool/sympa/outgoing`	アーカイブスプール用ディレクトリ
`sympa_queuesubscribe`	`/var/spool/sympa/subscribe`	購読スプール用のディレクトリ
`sympa_queuetopic`	`/var/spool/sympa/topic`	トピックスプール用のディレクトリ
`sympa_queuebounce`	`/var/spool/sympa/bounce`	バウンスが入ってくるスプール用のディレクトリ
`sympa_queuetask`	`/var/spool/sympa/task`	タスクスプール用のディレクトリ
`sympa_queueautomatic`	`/var/spool/sympa/automatic`	自動リスト作成用スプールのディレクトリ
`sympa_queuebulk`	`/var/spool/sympa/bulk`	メッセージの出力スプール用ディレクトリ
`sympa_viewmail_dir`	`/var/spool/sympa/viewmail`	メッセージを表示する際にMHonArcが生成するHTMLファイルを含むディレクトリ
`sympa_welcome_return_path`	`owner`	ウェルカムメッセージのリターンパス（unique、owner）。uniqueに設定すると、ウェルカムメッセージがバウンスしたときに新しい購読者が削除されます。
`sympa_remind_return_path`	`owner`	リマインドメッセージのリターンパス（unique、owner）。uniqueに設定すると、リマインドメッセージがバウンスした場合に購読者が削除されます。注意して使用してください。
`sympa_bounce_path`	`/var/lib/sympa/bounce`	バウンスを保存するためのディレクトリ。重要なパーティションには保存しない方が良いです。
`sympa_expire_bounce`	`daily`	古いバウンスの有効期限切れのためのタスク名
`sympa_bounce_warn_rate`	`30`	リスト所有者への警告を出すためのバウンスメール率
`sympa_bounce_halt_rate`	`50`	リストを停止するためのバウンスメール率（未実装）
`sympa_cache_list_config`	`none`	ディスク上のリスト設定構造のバイナリバージョンを使用する（none、binary_fileのいずれか）
`sympa_sympa_priority`	`1`	Sympaコマンドの優先度
`sympa_request_priority`	`0`
`sympa_owner_priority`	`9`
`sympa_default_list_priority`	`5`	リストメッセージのデフォルトの優先度
`sympa_parsed_family_files`	`[message.footer, message.header, message.footer.mome, message.header.mime, info ]`	ファミリーをインスタンス化する際にSympaによって解析されるファイルのリスト（ファイル名にスペースを含まない）
`sympa_dkim_feature`	`False`
`sympa_dkim_add_signature_to`	`[ robot, list ]`	ロボット、リストのメッセージにDKIM署名を追加
`sympa_dkim_signature_apply_on`	`[md5_authenticated_messages, smime_authenticated_messages, dkim_authenticated_messages, editor_validated_messages ]`	配信前にDKIM署名が追加されるメッセージのタイプ。リストは次のキーワードのいずれかで構成されます。"md5_authenticated_messages"、"smime_authenticated_messages"、"dkim_authenticated_messages"、"editor_validated_messages"
`sympa_dkim_private_key_path`	`/etc/ssl/dkim_private.key`	DKIMプライベートキーが保存されるファイルの場所
`sympa_dkim_signer_domain`	:heavy_multiplication_x:	RFC 4871で定義された "d=" タグで、デフォルトは仮想ホストのドメイン名
`sympa_dkim_selector`	:heavy_multiplication_x:	セレクタ
`sympa_dkim_signer_identity`	:heavy_multiplication_x:	RFC 4871で定義された "i=" タグで、デフォルトはnull
`sympa_antivirus_path`	:heavy_multiplication_x:	ウイルススキャナエンジンのパス。サポートされるウイルス対策：Clam AntiVirus/clamscan & clamdscan, McAfee/uvscan, Fsecure/fsav, Sophos, AVP and Trend Micro/VirusWall
`sympa_antivirus_args`	:heavy_multiplication_x:	ウイルス対策プラグインコマンドの引数
`sympa_antispam_tag_header_name`	`X-Spam-Status`	スパムフィルタ（spamassassinやj-chkmailなど）がスパムにタグ付けするためのSMTPヘッダー名（例：X-Spam-Status）
`sympa_antispam_tag_header_spam_regexp`	:heavy_multiplication_x:	メッセージがスパムであることを確認するためにこのヘッダーに適用される正規表現（例：Yes）
`sympa_antispam_tag_header_ham_regexp`	:heavy_multiplication_x:	メッセージがスパムでないことを確認するためにこのヘッダーに適用される正規表現（例：No）
`sympa_spam_status`	:heavy_multiplication_x:	スパムフィルタによってフィルタリングされるべきメッセージ。スパムステータスを決定するために特別なシナリオを選択するために使用されるパラメータです。ham、spam、unsureのいずれかの状態を持つメッセージに対して適用されます。
`sympa_arc_path`	`/var/lib/sympa/arc`	HTMLアーカイブを保存するディレクトリ
`sympa_default_index`	`thrd`	ウェブアーカイブに入るときのデフォルトのインデックスの組織：スレッド方式または時系列順
`sympa_cookie_expire`	`0`	HTTPクッキーの寿命
`sympa_cookie_domain`	`localhost`	HTTPクッキーの有効ドメイン
`sympa_cookie_refresh`	`60`	HTTPセッションIDを更新する平均的な間隔
`sympa_custom_archiver`	:heavy_multiplication_x:	MHonArcの代わりに使用するカスタムアーカイバを有効化します。このパラメータの値は、カスタムアーカイバのスクリプトへのファイルシステム上の絶対パスです。
`sympa_default_home`	`home`	メインウェブページのタイプ（リスト、ホーム）
`sympa_edit_list`	`owner`
`sympa_ldap_force_canonical_email`	`1`	LDAP認証を使用する場合、ユーザーが提供した識別子が有効なメールの場合、このパラメータがfalseに設定されていると、提供されたメールがユーザーの認証に使用されます。それ以外では、LDAPサーバから返された最初のメールが使用されます。
`sympa_review_page_size`	`25`	レビューページに表示されるユーザーの配列のデフォルト行数
`sympa_web_page_title`	`Mailing lists service`	メインウェブページのタイトル
`sympa_show_default_templates`	`false`	デフォルトリストテンプレートを表示または非表示にする
`sympa_template_lists`	`[]`	定義されるテンプレートのリスト。
`sympa_data_sources`	`false`	定義されるデータソースのリスト。
`sympa_alias_manager`	``	エイリアスマネージャ実行可能ファイルへのパス。
`sympa_ldap_alias_entry`	``	`/etc/sympa/ldap_alias_entry.tt2`に書かれる複数行文字列。
`sympa_ldap_alias_manager_conf`	``	エイリアスマネージャ設定属性を含む辞書
`sympa_auth`	`[{ name: "user:table", options: {regexp: ".*"}}]`	順番に使用される認証方式のリスト。

Sympaロボット変数

sympa_robotsは、デフォルトでは空のSympaロボット定義のリストです。各エントリは以下の内容を含みます。

名称	必須/デフォルト	説明
`domain`	:heavy_check_mark:	ロボットのメールおよびウェブドメイン
`server_admin`	:heavy_check_mark:	ウェブサーバのVHost管理者
`listmaster`	:heavy_check_mark:	リストマスターのメールエントリのリスト
`create_list`