udelarinterior.sympa

sympa

To jest rola Ansible, która konfiguruje menedżera list mailingowych Sympa.

Wymagania

Serwer z Debianem stretch lub Ubuntu. Opcjonalne bazy danych MySQL/MariaDB lub PostgreSQL. Menedżer bazy danych może być wcześniej zainstalowany na hoście (domyślnie) lub opcjonalnie zainstalowany przez samą rolę. Serwer WWW dla Sympa powinien być skonfigurowany osobno.

Zmienne roli

Pełna dokumentacja znajduje się pod adresem https://sympa-community.github.io/, rola została przetestowana z wersją Sympa 6.2.16 (pakiet sympa dla Debiana stretch).

Szablony list

sympa_template_lists to lista szablonów do zdefiniowania. Zobacz dokumentację szablonów list w dokumentacji sympa. Każdy wpis składa się z poniższych elementów i prowadzi do utworzenia folderu zawierającego pliki comment.tt2 i config.tt2 w /etc/sympa/create_list_templates/, gdzie atrybut name stanowi nazwę folderu:

Nazwa	Wymagane/Domyslne	Opis
`name`	:heavy_check_mark:	Nazwa folderu dla szablonu
`config`	:heavy_check_mark:	Zawartość, która zostanie zapisana w pliku `config.tt2`
`comment`	:heavy_check_mark:	Zawartość, która zostanie zapisana w pliku `comment.tt2`

Źródła danych

sympa_data_sources to lista źródeł danych do zdefiniowania. Zobacz dokumentację źródeł danych w dokumentacji sympa. Każdy wpis składa się z poniższych elementów i prowadzi do utworzenia pliku z rozszerzeniem incl w /etc/sympa/data_sources/:

Nazwa	Wymagane/Domyslne	Opis
`name`	:heavy_check_mark:	Nazwa pliku dla źródła danych
`content`	:heavy_check_mark:	Zawartość, która zostanie zapisana w pliku źródła danych

Menedżer aliasów

sympa_alias_manager to ścieżka do wykonywalnego pliku menedżera aliasów. Jeśli zmienna sympa_ldap_alias_entry jest zdefiniowana, zostanie zapisana w /etc/sympa/ldap_alias_entry.tt2. Jeśli zmienna sympa_ldap_alias_manager_conf jest zdefiniowana, zostanie zapisana w /etc/sympa/ldap_alias_manager.conf i może zawierać następujące wartości:

Nazwa	Wymagane/Domyslne	Opis
`host`	:heavy_check_mark:	URL hosta serwera LDAP.
`bind_dn`	:heavy_check_mark:	DN użytkownika do użycia.
`bind_pwd`	:heavy_check_mark:	Hasło użytkownika.
`base_dn`	:heavy_check_mark:	Podstawowy DN drzewa LDAP.
`mail_attribute`	`mailRoutingAddress`	Atrybut używany do zapisu.
`ssl`	`false`	Włącz lub wyłącz ssl
`queue_transport`	`sympa`	Nazwa normalnego transportu.
`bouncequeue_transport`	`sympabounce`	Nazwa transportu w przypadku bouncu.

Zmienne autoryzacji

sympa_auth to lista metod autoryzacji używanych w kolejności. Każdy wpis składa się z poniższych elementów:

Nazwa	Wymagane/Domyslne	Opis
`name`	:heavy_check_mark:	Nazwa opcji autoryzacji, jak ldap, user_table
`options`	:heavy_check_mark:	Słownik opcji dla metody autoryzacji

Przykład

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: ".*"

Tematy zmiennych

Lista tematów pod kluczem sympa_topics. Każdy wpis zawiera następujące elementy:

Nazwa	Wymagane/Domyslne	Opis
`path`	:heavy_check_mark:	Ścieżka kategorii
`title`	:heavy_check_mark:	Tytuł kategorii

Przykład

sympa_topics:
- path: art
  title: Sztuka
- path: art/expressionism
  title: Ekspresjonizm

Menedżer bazy danych

Nazwa	Wymagane/Domyslne	Opis
`sympa_db_type`	`mysql`	Wybór menedżera bazy danych. `MySQL` lub `Pg`. Akceptowane wartości to `mysql` i `PostgreSQL`. Inne opcje bazy danych nie są obsługiwane.
`sympa_install_db_package`	`False`	Czy menedżer bazy danych był wcześniej zainstalowany (`False`) czy rola instaluje go (`True`)

Zmienne Sympa

Nazwa	Wymagane/Domyslne	Opis
`sympa_domain`	`"{{ ansible_fqdn }}"`	Główna nazwa hosta robota
`sympa_listmaster`	`listmaster@{{ sympa_domain }}`	Lista adresów e-mail do przekształcenia w listmaster
`sympa_wwsympa_url`	:heavy_check_mark:	URL głównej strony internetowej
`sympa_email`	:heavy_multiplication_x:	Lokalna część adresu e-mail sympa
`sympa_db_password`	:heavy_check_mark:	Hasło do połączenia z bazą danych
`sympa_db_name`	`sympa`	Nazwa bazy danych
`sympa_db_host`	`localhost`	Nazwa hosta serwera bazy danych
`sympa_db_port`	`3306`	Port serwera bazy danych
`sympa_db_user`	`sympa`	Użytkownik do połączenia z bazą danych
`sympa_lang`	`en`	Domyślny język (jeden z obsługiwanych języków)#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:	Fragment HTML do umieszczenia logo w lewym górnym rogu
`sympa_gecos`	`SYMPA`	Gecos dla wiadomości wysyłanych przez Sympa.
`sympa_process_archive`	`False`	Archiwizacja rozproszonych wiadomości
`sympa_voot_feature`	`False`	Funkcja Voot
`sympa_max_wrong_password`	`19`	Liczba błędnych prób hasła
`sympa_static_content_path`	`/var/lib/sympa/static_content`	Katalog do przechowywania statycznych zawartości
`sympa_static_content_url`	`/static-sympa`	URL mapowany z katalogiem `sympa_static_content_path`
`sympa_syslog`	`LOCAL1`	Ułatwienie syslog dla sympa
`sympa_log_level`	`0`	Poziom logowania 0: normalny, 2,3,4: dla debugowania
`sympa_log_socket_type`	`unix`	Tryb komunikacji z syslogd (unix, inet)
`sympa_sendmail`	`/usr/bin/sendmail`	Ścieżka do MTA (sendmail, postfix, exim lub qmail) powinna wskazywać na binarny plik zgodny z sendmailem (np. plik nazwany "sendmail", który jest dostarczany z Postfix)
`sympa_maxsmtp`	`40`	Maks. liczba procesów Sendmail (uruchamianych przez Sympa)
`sympa_log_smtp`	`False`
`sympa_use_blacklist`	`[ send, create_list ]`	Lista operacji, dla których stosowany jest filtr czarnych list. Pusta lista wyłączy tę funkcję.
`sympa_max_size`	`5242880`	Domyślna maksymalna wielkość (w bajtach) dla wiadomości (może być ponownie zdefiniowana dla każdej listy)
`sympa_sendmail_nrcpt`	`25`	Maksymalna liczba odbiorców na rozmowę do Sendmail. Plik nrcpt_by_domain.conf pozwala na różne dostosowania dla każdej domeny docelowej.
`sympa_sendmail_avg`	`10`	Maks. liczba różnych domen na rozmowę do Sendmail
`sympa_rfc2369_header_fields`	`[help, subscribe, unsubscribe, post, owner, archive ]`	Określenie, które nagłówki listy mailowej RFC2369 dodać
`sympa_remove_headers`	[ `X-Sympa-To, X-Family-To, Return-Receipt-To, Precedence, X-Sequence, Disposition, Notification-To, Sender ]`	Określenie nagłówków, które mają być usunięte przed dystrybucją wiadomości
`sympa_reject_mail_from_automates_feature`	`True`	Odrzucać wiadomości od automatów (crontab itp.) wysyłanych na listę?
`sympa_packet_priority`	`5`	Domyślna priorytet dla pakietu wysyłanego w trybie zbiorczym.
`sympa_bulk_fork_threshold`	`1`	Minimalna liczba pakietów w bazie danych, zanim zbiorczy proces będzie się dzielił, aby zwiększyć współczynnik wysyłania
`sympa_bulk_max_count`	`3`	Maksymalna liczba zbiorów, które będą działały na tym samym serwerze
`sympa_bulk_lazytime`	`600`	Liczba sekund, przez którą akuszer zbiorów pozostanie uruchomiony bez przetwarzania wiadomości przed spontaniczną śmiercią.
`sympa_bulk_sleep`	`1`	Liczba sekund, przez którą akuszer zbiorów śpi między rozpoczęciem nowej pętli, jeśli nie znaleziono wiadomości do wysłania.
`sympa_bulk_wait_to_fork`	`10`	Liczba sekund, przez którą główny akuszer czeka między dwoma sprawdzeniami liczby pakietów.
`sympa_default_max_list_members`	`0`	Domyślna liczba subskrybentów na liście (0 oznacza brak limitu)
`sympa_spool`	`/var/spool/sympa`	Katalog zawierający różne wyspecjalizowane spooli
`sympa_queue`	`/var/spool/sympa/msg`	Katalog dla wykonywaniów przychodzących wiadomości
`sympa_queuemod`	`/var/spool/sympa/moderation`	Katalog dla moderacji spooli
`sympa_queuedigest`	`/var/spool/sympa/digest`	Katalog dla digestów spooli
`sympa_queueauth`	`/var/spool/sympa/auth`	Katalog dla spooli autoryzacji
`sympa_queueoutgoing`	`/var/spool/sympa/outgoing`	Katalog dla spooli archiwów
`sympa_queuesubscribe`	`/var/spool/sympa/subscribe`	Katalog dla spooli subskrypcji
`sympa_queuetopic`	`/var/spool/sympa/topic`	Katalog dla spooli tematów
`sympa_queuebounce`	`/var/spool/sympa/bounce`	Katalog dla przychodzącego zbouncowanego spooli
`sympa_queuetask`	`/var/spool/sympa/task`	Katalog dla spooli zadań
`sympa_queueautomatic`	`/var/spool/sympa/automatic`	Katalog dla spooli automatycznego tworzenia listy
`sympa_queuebulk`	`/var/spool/sympa/bulk`	Katalog dla wiadomości wychodzących spooli
`sympa_viewmail_dir`	`/var/spool/sympa/viewmail`	Katalog zawierający pliki HTML generowane przez MHonArc podczas wyświetlania wiadomości innych niż archiwa
`sympa_welcome_return_path`	`owner`	Ścieżka zwrotna wiadomości powitalnej (unikalna, właściciel) Jeśli ustawiona jako unikalna, nowy subskrybent jest usuwany, jeśli wiadomość powitalna bounce.
`sympa_remind_return_path`	`owner`	Ścieżka zwrotna wiadomości przypominającej (unikalna, właściciel) Jeśli ustawiona jako unikalna, subskrybent jest usuwany, jeśli wiadomość przypominająca bounce, użyj ostrożnie.
`sympa_bounce_path`	`/var/lib/sympa/bounce`	Katalog do przechowywania bounce. Lepiej, jeśli nie znajduje się na krytycznej partycji.
`sympa_expire_bounce`	`daily`	Nazwa zadania do wygasania starych bounce'ów
`sympa_bounce_warn_rate`	`30`	Współczynnik bounce'ów e-mailowych do ostrzegania właściciela listy
`sympa_bounce_halt_rate`	`50`	Współczynnik bounce'ów e-mailowych, aby zatrzymać listę (niezrealizowane)
`sympa_cache_list_config`	`none`	Użycie binarnej wersji struktury konfiguracji listy na dysku (none, binary_file)
`sympa_sympa_priority`	`1`	Priorytet poleceń Sympa
`sympa_request_priority`	`0`
`sympa_owner_priority`	`9`
`sympa_default_list_priority`	`5`	Domyślny priorytet dla wiadomości na liście
`sympa_parsed_family_files`	`[message.footer, message.header, message.footer.mome, message.header.mime, info ]`	Lista plików, które będą analizowane przez Sympa przy instancjonowaniu rodziny (zakaz spacji w nazwach plików)
`sympa_dkim_feature`	`False`
`sympa_dkim_add_signature_to`	`[ robot, list ]`	Wstaw podpis DKIM do wiadomości od robota, z listy lub z obu
`sympa_dkim_signature_apply_on`	`[md5_authenticated_messages, smime_authenticated_messages, dkim_authenticated_messages, editor_validated_messages ]`	Typ wiadomości, które otrzymują podpis DKIM przed dystrybucją do subskrybentów. Jest to lista z następującymi słowami kluczowymi: "md5_authenticated_messages", "smime_authenticated_messages", "dkim_authenticated_messages", "editor_validated_messages".
`sympa_dkim_private_key_path`	`/etc/ssl/dkim_private.key`	Lokalizacja pliku, w którym przechowywany jest klucz prywatny DKIM
`sympa_dkim_signer_domain`	:heavy_multiplication_x:	Etykieta "d=" zdefiniowana w rfc 4871, domyślnie jest to nazwa domeny wirtualnej
`sympa_dkim_selector`	:heavy_multiplication_x:	Wskaźnik
`sympa_dkim_signer_identity`	:heavy_multiplication_x:	Etykieta "i=" zdefiniowana w rfc 4871, domyślnie jest pusta
`sympa_antivirus_path`	:heavy_multiplication_x:	Ścieżka do silnika skanera antywirusowego, wspierane antywirusy: Clam AntiVirus/clamscan & clamdscan, McAfee/uvscan, Fsecure/fsav, Sophos, AVP i Trend Micro/VirusWall
`sympa_antivirus_args`	:heavy_multiplication_x:	Argument polecenia wtyczki antywirusowej
`sympa_antispam_tag_header_name`	`X-Spam-Status`	Jeśli filtr spamu (jak spamassassin lub j-chkmail) dodaje nagłówki smtp do oznaczania spamu, nazwa tego nagłówka (przykład X-Spam-Status)
`sympa_antispam_tag_header_spam_regexp`	:heavy_multiplication_x:	Wyrażenie regularne stosowane w tym nagłówku do weryfikacji, czy wiadomość jest spamem (przykład Yes)
`sympa_antispam_tag_header_ham_regexp`	:heavy_multiplication_x:	Wyrażenie regularne stosowane w tym nagłówku do weryfikacji, czy wiadomość NIE jest spamem (przykład No)
`sympa_spam_status`	:heavy_multiplication_x:	Wiadomości mają być filtrowane przez antyspam, który dodaje dodatkowe nagłówki do wiadomości. Wartość ta jest używana do wybrania specjalnego scenariusza w celu ustalenia statusu wiadomości spam: ham, spam lub niepewne. Ta wartość zastępuje antispam_tag_header_name, antispam_tag_header_spam_regexp i antispam_tag_header_ham_regexp.
`sympa_arc_path`	`/var/lib/sympa/arc`	Katalog do przechowywania archiwów HTML
`sympa_default_index`	`thrd`	Domyślna organizacja indeksu przy wchodzeniu do archiwum sieciowym: albo wątek albo w kolejności chronologicznej
`sympa_cookie_expire`	`0`	Czas życia HTTP cookies
`sympa_cookie_domain`	`localhost`	Ważność domeny cookies HTTP
`sympa_cookie_refresh`	`60`	Średni odstęp do odświeżenia identyfikatora sesji HTTP.
`sympa_custom_archiver`	:heavy_multiplication_x:	Aktywuje niestandardowy archiwizer do użycia zamiast MHonArc. Wartość tego parametru to absolutna ścieżka w systemie plików do skryptu niestandardowego archiwizera.
`sympa_default_home`	`home`	Typ głównej strony internetowej (listy, dom)
`sympa_edit_list`	`owner`
`sympa_ldap_force_canonical_email`	`1`	Korzystając z autoryzacji LDAP, jeśli identyfikator podany przez użytkownika był poprawnym adresem e-mail, jeśli ten parametr jest ustawiony na fałsz, to podany e-mail będzie używany do autoryzacji użytkownika. W przeciwnym razie użyty zostanie pierwszy e-mail zwrócony przez serwer LDAP.
`sympa_review_page_size`	`25`	Domyślna liczba wierszy w tablicy wyświetlającej użytkowników w stronie przeglądania
`sympa_web_page_title`	`Usługa listy mailingowej`	Tytuł głównej strony internetowej
`sympa_show_default_templates`	`false`	Pokazać lub ukryć domyślne szablony list
`sympa_template_lists`	`[]`	Lista szablonów do zdefiniowania.
`sympa_data_sources`	`false`	Lista źródeł danych do zdefiniowania.
`sympa_alias_manager`	``	Ścieżka do wykonywalnego pliku menedżera aliasów.
`sympa_ldap_alias_entry`	``	Multiliniowy ciąg, zapisany w `/etc/sympa/ldap_alias_entry.tt2`.
`sympa_ldap_alias_manager_conf`	``	Słownik zawierający atrybuty konfiguracji menedżera aliasów
`sympa_auth`	`[{ name: "user:table", options: {regexp: ".*"}}]`	Lista metod autoryzacji używanych w kolejności.

Zmienne robotów Sympa

sympa_robots to lista definicji robotów Sympa, domyślnie pusta. Każdy wpis zawiera:

Nazwa	Wymagane/Domyslne	Opis
`domain`	:heavy_check_mark:	Główny adres e-mail robota i domena WWW
`server_admin`	:heavy_check_mark:	Administrator VHost serwera WWW
`listmaster`	:heavy_check_mark:	lista adresów e-mail listmasterów
`listmaster`	:heavy_check_mark:
`create_list`