Commit Graph
671 Commits
Author SHA1 Message Date
Wez Furlong e20488382c docs: update for amazon being available as a stable build 2024-01-04 10:56:41 -07:00
Wez Furlong 02080a1e85 move the note to the right file 2024-01-03 14:03:04 -07:00
Wez Furlong b1375f8e6b docs: update for latest release 2024-01-03 13:49:55 -07:00
Mike Hillyer 45c0a190d2 Fix formatting of one of the notes on the config tutorial page. 2023-12-21 15:06:30 -05:00
Mike Hillyer 998f6d5707 Add video link to example config video to tutorial page. 2023-12-21 14:52:29 -05:00
Mike Hillyer 7e29990e0d Add video embed to example config docs page. 2023-12-21 14:51:19 -05:00
Mike Hillyer 2f93cdbe14 Update commented out shaping setup call to point to user version of shaping file to make it work better for copy/paste users. 2023-12-21 14:18:38 -05:00
Mike Hillyer 3799d4f34a Update example config to make call to TSA helper setup more succinct. 2023-12-21 12:32:30 -05:00
Mike Hillyer a14ce4c672 Add non-canonical line ending check to example config to help with SMTP Smuggling. 2023-12-20 09:10:02 -05:00
Mike Hillyer 9ab48b8d13 Make the TSA config step in the config section of the tutorial more clear. 2023-12-19 18:02:28 -05:00
Wez Furlong 7498dfe458 docs: fix broken links in smtplisteners page 2023-12-14 17:20:13 -07:00
Wez Furlong 5d206834ce docs: fixup outdated source + pool information
Some sections didn't get updated to match changes
around how pools and sources are retrieved from the
configuration.

Thanks to @farhadhf for raising this

closes: https://github.com/KumoCorp/kumomta/pull/107
2023-12-14 17:17:06 -07:00
Wez Furlong 2925c7f565 docs: add missing socks5 config to reference section 2023-12-14 17:17:06 -07:00
Mike Hillyer 42d8a8cd03 Bring the configuration page of the tutorial in line with the latest example config. 2023-12-14 16:52:52 -05:00
Wez Furlong ce60eeb913 rfc5965 parser now accepts historic Received-Date and Version: 0.1
The version header from this old format is actually not at all
compatible with a strict reading of rfc5965 which allows only for
integer version fields; it is defined as `[1-9][0-9]*` which has
no room for decimal points.

Relax the field to accept an arbitrary string.

If Arrival-Date is not found, try pulling the equivalent information
from the historic Received-Date field.
2023-12-14 09:49:14 -07:00
Wez Furlong 0fff69c010 fix parsing durations from integers
closes: #108
2023-12-14 08:31:45 -07:00
Wez Furlong e9ec19fd23 fix an issue where msg:[sg]et_meta would not round-trip nil values 2023-12-13 14:21:12 -07:00
Mike Hillyer bc691df0da Tweak the DKIM diagram flow. 2023-12-10 11:12:06 -05:00
Mike Hillyer ac0aff9723 Updating DKIM helper example to use the full set of RFC recommended headers for signing, update the sending IP and Queue helper examples to use matching pool names so those copy/pasting will have an easier time, fix example is inbound doc to use correct linting. 2023-12-10 10:30:59 -05:00
Wez Furlong 803855f311 instructions for amazonlinux:2023 2023-12-08 13:59:42 -07:00
Wez Furlong 45bb89cede docs: show how to install rpm on amazon linux 2 2023-12-08 12:14:47 -07:00
Wez Furlong 91f56f99d9 docs: fix some build and syntax errors 2023-12-08 11:56:36 -07:00
Wez Furlong 80dc74f37f ci: more stuff to coax the amazon build into success 2023-12-08 11:51:23 -07:00
Wez Furlong b4e3118f82 fix: MTA-STS policy failed to match due to trailing periods 2023-12-07 15:02:58 -07:00
Mike Hillyer 95c3e3b444 Build out new page on inbound SMTP AUTH, update related documents and TOC, rename smtpauth page outbound_auth to differentiate from inbound_auth.md. Update smtp listener page to point to it, update refman auth plain page to reflect latest fields. 2023-12-07 17:00:58 -05:00
Mike Hillyer ee128768a8 Updating example config to include proper paths and full shaping elements. Update the TSA docs page to reflect new streamlined config. 2023-12-07 13:15:53 -05:00
Wez Furlong cdfe11cf22 Allow simple wildcard suffixes for header names in logs
refs: https://github.com/KumoCorp/kumomta/issues/74
2023-12-04 12:10:15 -07:00
Mike Hillyer c918669886 Quick warning text change. 2023-12-04 13:02:16 -05:00
Mike Hillyer f9c1135707 Update example config to show proper order of setups to ensure flow works. 2023-12-04 13:01:51 -05:00
Wez Furlong 868cadcce7 docs: changelog for #101 2023-11-30 10:36:57 -07:00
Mike Hillyer e1f07adf4f Flip the helpers to be first for the two sections that don't currently do so. 2023-11-30 11:03:12 -05:00
Wez Furlong ec937b52ef Allow using arbitrary bounce classification labels
refs: https://github.com/KumoCorp/kumomta/issues/98
2023-11-29 12:09:05 -07:00
Wez Furlong 8af7e85c6b docs: update version info for latest release 2023-11-29 12:08:34 -07:00
Wez Furlong eeabd6ad09 docs: changelog for 2023.11.28-b5252a41 2023-11-28 13:03:06 -07:00
Wez Furlong dfc635dada docs: fix broken link 2023-11-28 10:40:44 -07:00
Mike Hillyer 83c14e0674 Fixing one more. 2023-11-27 11:49:01 -05:00
Mike Hillyer 6339869f4a Lua preformatted block on one of the entries was causing the following entries to not register as separate bullets because of missing linebreak. 2023-11-27 11:37:51 -05:00
Mike Hillyer 3c7aa802c8 update troubleshooting and get help pages 2023-11-26 09:22:07 -05:00
Wez Furlong 837f9e5c0e automate updating the openapi spec files
I definitely forgot to do this on the very first change after
adding them, so I want to make it less likely in the future.

This causes the specs to get updated in the docs if they have
changed (other than the version field) since the last time they
were updated.

We check this during test and doc building.  That should be
sufficient to catch this during my dev loop.

refs: https://github.com/KumoCorp/kumomta/issues/96
2023-11-23 09:02:00 -07:00
Wez Furlong acaa095b45 docs: format 2023-11-23 08:36:40 -07:00
Wez Furlong c40f86e039 Add suppress-logging option to admin bounces
closes: https://github.com/KumoCorp/kumomta/issues/75
2023-11-23 08:36:07 -07:00
Mike Hillyer 1d8969e4a9 Update TOC with get help changes. 2023-11-23 10:13:51 -05:00
Mike Hillyer 90149c7309 Split out the get help page. 2023-11-23 10:11:51 -05:00
Wez Furlong 9282110479 docs: update openapi snapshots
Meant to include this in the previous commit!

refs: https://github.com/KumoCorp/kumomta/issues/96
2023-11-22 12:54:17 -07:00
Wez Furlong 0fc1108308 openapi: tidy up server URL and auth bits for rapidoc
refs: https://github.com/KumoCorp/kumomta/issues/96
2023-11-22 12:51:10 -07:00
Wez Furlong 0b87c020b4 add openapi.json metadata for http api
Adds `/api-docs/openapi.json` and `/rapidoc` endpoints to both
kumod and tsa-daemon.

The former exposes the subset of the API that is expressable
in the openapi schema as a json file that can be imported into
other tools.

The latter is a single-page web app that consumes the former
to provide an interactive API explorer.
We're using rapidoc for this, because I happen to think it looks
nicest and easiest to use, and we can integrate it into the docs
fairly nicely.

Which leads in nicely to say: I've integrated a read-only version
of rapidoc into the docs, and it even detects and adjusts to the
selected light/dark mode.

The `docs/update-openapi.sh` extracts the openapi.json data from
kumod and tsa-daemon and outputs to the correct place in the docs
directory structure to enable this.

refs: https://github.com/KumoCorp/kumomta/issues/96
2023-11-21 15:30:13 -07:00
Mike Hillyer 2ebf49d23b Re-organize TOC to move some operations pages to Policy section where they fit better. Removed page on tenant mapping now that we have the queues helper. 2023-11-21 16:48:41 -05:00
Mike Hillyer 667b3265ad Adding documentation page on Policy Helpers 2023-11-21 16:27:43 -05:00
Wez Furlong 8b8f53129f docs: changelog for the dkim h= wrapping fix 2023-11-18 12:07:35 -07:00
Mike Hillyer eead8d568f Split out the install/config/start sections of the tutorial. 2023-11-16 17:12:02 -05:00