Mercurial > prosody-modules
annotate mod_lastlog/README.markdown @ 5298:12f7d8b901e0
mod_audit: Support for adding location (GeoIP) to audit events
This can be more privacy-friendly than logging full IP addresses, and also
more informative to a user - IP addresses don't mean much to the average
person, however if they see activity from outside their expected country, they
can immediately identify suspicious activity.
As with IPs, this field is configurable for deployments that would like to
disable it. Location is also not logged when the geoip library is not
available.
author | Matthew Wild <mwild1@gmail.com> |
---|---|
date | Sat, 01 Apr 2023 13:11:53 +0100 |
parents | dd6313ddd3e0 |
children |
rev | line source |
---|---|
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
1 --- |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
2 labels: |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
3 - 'Stage-Beta' |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
4 summary: Log last login time |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
5 ... |
1782 | 6 |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
7 Introduction |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
8 ============ |
1782 | 9 |
10 Simple module that stores the timestamp of when a user logs in. | |
11 | |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
12 Usage |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
13 ===== |
1782 | 14 |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
15 As with all modules, copy it to your plugins directory and then add it |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
16 to the modules\_enabled list: |
1782 | 17 |
1859
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
18 ``` lua |
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
19 modules_enabled = { |
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
20 -- other modules |
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
21 "lastlog", |
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
22 } |
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
23 ``` |
1782 | 24 |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
25 Configuration |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
26 ============= |
1782 | 27 |
28 There are some options you can add to your config file: | |
29 | |
3117
dd6313ddd3e0
mod_lastlog: Split Values into Type/Default. (documentation)
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
1859
diff
changeset
|
30 Name Type Default Description |
dd6313ddd3e0
mod_lastlog: Split Values into Type/Default. (documentation)
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
1859
diff
changeset
|
31 ------------------------- ------- ------- ------------------------------------ |
dd6313ddd3e0
mod_lastlog: Split Values into Type/Default. (documentation)
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
1859
diff
changeset
|
32 lastlog\_ip\_address boolean false Log the IP address of the user? |
dd6313ddd3e0
mod_lastlog: Split Values into Type/Default. (documentation)
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
1859
diff
changeset
|
33 lastlog\_stamp\_offline boolean false Add timestamp to offline presence? |
1782 | 34 |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
35 Usage |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
36 ===== |
1782 | 37 |
38 You can check a user's last activity by running: | |
39 | |
1859
4b838e61c68e
mod_lastlog/README: Adjust formatting / indentation to help pandoc produce fancy html
Kim Alvefur <zash@zash.se>
parents:
1803
diff
changeset
|
40 prosodyctl mod_lastlog username@example.com |
1782 | 41 |
1803
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
42 Compatibility |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
43 ============= |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
44 |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
45 ----- ------- |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
46 0.9 Works |
4d73a1a6ba68
Convert all wiki pages to Markdown
Kim Alvefur <zash@zash.se>
parents:
1782
diff
changeset
|
47 ----- ------- |