1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-23 17:34:34 +03:00
samba-mirror/docs-xml/smbdotconf/logon/autheventnotification.xml
Andrew Bartlett 364b8be981 docs: Further discourage the use of the "event notification" options
BUG: https://bugzilla.samba.org/show_bug.cgi?id=14689

Signed-off-by: Andrew Bartlett <abartlet@samba.org>
Reviewed-by: Andreas Schneider <asn@samba.org>
2021-04-21 09:15:35 +00:00

30 lines
1.1 KiB
XML

<samba:parameter name="auth event notification"
context="G"
type="boolean"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>When enabled, this option causes Samba (acting as an
Active Directory Domain Controller) to stream authentication
events across the internal message bus. Scripts built using
Samba's python bindings can listen to these events by
registering as the service
<filename moreinfo="none">auth_event</filename>.</para>
<para>This is <emphasis>not</emphasis> needed for the audit
logging described in <smbconfoption name="log level"/>.</para>
<para>Instead, this should instead be considered a developer
option (it assists in the Samba testsuite) rather than a
facility for external auditing, as message delivery is not
guaranteed (a feature that the testsuite works around).</para>
<para>The authentication events are also logged via the normal
logging methods when the <smbconfoption name="log level"/> is
set appropriately, say to
<command moreinfo="none">auth_json_audit:3</command>.</para>
</description>
<value type="default">no</value>
</samba:parameter>