summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJeremy Harris <jgh146exb@wizmail.org>2022-07-19 23:37:27 +0100
committerJeremy Harris <jgh146exb@wizmail.org>2022-07-19 23:37:27 +0100
commit7a97480c2bb86d9385597680ec2d4461e1656193 (patch)
tree46f2211324f2fd4d333cbb48c9c41acd9fd65118 /doc
parente7ec503729970a03d4509921342bc81313976126 (diff)
downloadexim4-7a97480c2bb86d9385597680ec2d4461e1656193.tar.gz
Event for auth fail
Diffstat (limited to 'doc')
-rw-r--r--doc/doc-docbook/spec.xfpt13
-rw-r--r--doc/doc-txt/NewStuff2
2 files changed, 14 insertions, 1 deletions
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index c76aceb69..935a78a39 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -27647,7 +27647,16 @@ no successful authentication.
Successful authentication sets up information used by the
&%authresults%& expansion item.
-
+.new
+.cindex authentication "failure event"
+If an authenticator is run and does not succeed,
+an event (see &<<CHAPevents>>&) of type "auth:fail" is raised.
+While the event is being processed the variables
+&$sender_host_authenticated$& (with the authenticator name)
+and &$authenticated_fail_id$& (as set by the suthenticator &%server_set_id%& option)
+will be valid.
+See <<CHAPevents>> for details on events.
+.wen
.section "Testing server authentication" "SECID169"
@@ -42701,6 +42710,7 @@ expansion must check this, as it will be called for every possible event type.
The current list of events is:
.itable all 0 0 4 25* left 10* center 15* center 50* left
+.row auth:fail after main "per driver per authentication attempt"
.row dane:fail after transport "per connection"
.row msg:complete after main "per message"
.row msg:defer after transport "per message per delivery try"
@@ -42733,6 +42743,7 @@ should define the event action.
An additional variable, &$event_data$&, is filled with information varying
with the event type:
.itable all 0 0 2 20* left 80* left
+.row auth:fail "smtp response"
.row dane:fail "failure reason"
.row msg:defer "error string"
.row msg:delivery "smtp confirmation message"
diff --git a/doc/doc-txt/NewStuff b/doc/doc-txt/NewStuff
index 807d9e434..bd7f02cfa 100644
--- a/doc/doc-txt/NewStuff
+++ b/doc/doc-txt/NewStuff
@@ -11,6 +11,8 @@ Version 4.97
1. The expansion-test faciility (exim -be) can set variables.
+ 2. An event on a failing SMTP AUTH, server side.
+
Version 4.96
------------