diff --git a/faq/amavisd.sql.structure.md b/faq/amavisd.sql.structure.md new file mode 100644 index 00000000..1ce4f121 --- /dev/null +++ b/faq/amavisd.sql.structure.md @@ -0,0 +1,61 @@ +# Explanation of Amavisd SQL database structure + +[TOC] + +## Summary + +Amavisd has two settings to use its SQL tables: + +* `@storage_sql_dsn`: used to store: + + * basic info of inbound and outbound message. e.g. mail subject, + sender address, recipient address, timestamp, etc. Note: no mail body. + * quarantined mails. Note: it stores full message of quarantined mail, + including mail body. + + `@storage_sql_dsn` uses 4 sql tables: `msgs`, `msgrcpt`, `maddr`, `quarantine`. + +* `@lookup_sql_dsn`: used to store: + + * per-account spam policy + * per-account white/blacklists + + `@lookup_sql_dsn` uses 4 sql tables: `mailaddr`, `policy`, `users`, `wblist`. + +## Details + +### `@lookup_sql_dsn` + +* Table `amavisd.mailaddr` stores email addresses __NOT__ hosted on your server. + Note: value of column `mailaddr.email` could be something like below: + + * `@.`: a catch-all address. + * `@domain.com`: entire domain. + * `@.domain.com`: entire domain and all its sub-domains. + * `user@domain.com`: a single email address. + * `user@*`: email addresses start with `user@`. Note: This is used by iRedAPD, not Amavisd. + * `192.168.1.2`: a single IP address. Note: This is used by iRedAPD, not Amavisd. + * `192.168.*.2`: wildcard IP address. Note: This is used by iRedAPD, not Amavisd. + + The addresses are used in several tables: + + * `amavisd.wblist`: used by Amavisd. If sender (of inbound message) is + blacklisted, Amavisd will quarantine this email. + * `amavisd.outbound_wblist`. New in iRedMail-0.9.3, used by iRedAPD plugin + `amavisd_wblist` for white/blacklisting for outbound message. + +* `amavisd.users` stores mail addresses hosted on your server. Value of column + `users.email` uses same format as `amavisd.mailaddr` mentioned above. + +* `amavisd.wblist` stores white/blacklists for inbound message. `wblist.sid` + (sender id) refers to `mailaddr.id`, `wblist.rid` (recipient id) refers to + `users.id`. + +* `amavisd.outbound_wblist` stores white/blacklists for outbound message. + `outbound_wblist.sid` (sender id) refers to `users.id`, `outbound_wblist.rid` + (recipient id) refers to `mailaddr.id`. + + Note: this table is used by iRedAPD, not Amavisd. + +* `amavisd.policy`: used to define per-recipient spam policy, and max message + size limit. diff --git a/html/amavisd.sql.structure.html b/html/amavisd.sql.structure.html new file mode 100644 index 00000000..0d6c673d --- /dev/null +++ b/html/amavisd.sql.structure.html @@ -0,0 +1,99 @@ + + + + Explanation of Amavisd SQL database structure + + + + +

Explanation of Amavisd SQL database structure

+
+ +
+

Summary

+

Amavisd has two settings to use its SQL tables:

+ +

Details

+

@lookup_sql_dsn

+

Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it. + \ No newline at end of file diff --git a/html/index.html b/html/index.html index df65d2c9..3f6a7370 100644 --- a/html/index.html +++ b/html/index.html @@ -160,6 +160,7 @@

  • iRedAdmin-Pro: Default password restrictions
  • iRedAdmin-Pro: Enable self-service to allow users to manage their own preferences and more
  • iRedAdmin-Pro: Translate iRedAdmin to your local language
  • +
  • Explanation of Amavisd SQL database structure
  • Backup and restore
  • Locations of configuration and log files of mojor components
  • Document published under a CC BY-ND 3.0 license. If you found something wrong, please do contact us to fix it.