Account Tracking - Revision history

Geo: Add limitation for join floods

2024-05-25T15:32:48Z

Add limitation for join floods

← Older revision		Revision as of 15:32, 25 May 2024
Line 187:		Line 187:
	}		}
	</pre></code>		</pre></code>

			== Other Limitations ==

			If the extended join capability is not enabled, Eggdrop can't check accounts when a user joins. This means handles with a +f flag that have an account, but not a matching hostmask, added will not be exempt from join flood controls and could be kicked/banned. To prevent this, you must either update the hostmask to match that of the user, or ensure Eggdrop has requested the extended join capability from the server if available.

Geo: /* Example Tcl Script */

2022-07-13T17:38:05Z

Example Tcl Script

← Older revision		Revision as of 17:38, 13 July 2022
Line 150:		Line 150:

	proc acct_op {nick user hand chan text} {		proc acct_op {nick user hand chan text} {
	set accthand [~~account2hand~~ $nick]		set accthand [finduser -a [getaccount $nick]]
	if [string match $accthand ""] {		if [string match $accthand ""] {
	putserv "PRIVMSG $chan :You are not authenticated"		putserv "PRIVMSG $chan :You are not authenticated"

Geo: /* Example Tcl Script */

2022-05-23T20:57:38Z

Example Tcl Script

← Older revision		Revision as of 20:57, 23 May 2022
Line 155:		Line 155:
	return 1		return 1
	}		}
	if {[matchattr $accthand +o] \|~~\| [matchattr $accthand~~ +o $chan]} {		if {[matchattr $accthand +o\|+o $chan]} {
	pushmode $chan +o $text		pushmode $chan +o $text
	putserv "PRIVMSG $chan :Op'ing $nick"		putserv "PRIVMSG $chan :Op'ing $nick"

Geo: /* Example Tcl Script */

2022-05-23T02:45:08Z

Example Tcl Script

← Older revision		Revision as of 02:45, 23 May 2022
Line 170:		Line 170:
	bind JOIN * * acct_track_join		bind JOIN * * acct_track_join

	proc ~~acct_track~~ {nick user hand chan acct} {		proc acct_track_acct {nick user hand chan acct} {
	if {[string match $acct ""]} {		if {[string match $acct ""]} {
	putserv "PRIVMSG $chan :$nick de-authenticated"		putserv "PRIVMSG $chan :$nick de-authenticated"

Geo: /* Example Tcl Script */

2022-05-23T02:43:47Z

Example Tcl Script

@@ Line 160: / Line 160: @@
      } else {
        putserv "PRIVMSG $chan :You do not have access to .op"
+     }
+}
 </pre></code>

Geo at 00:02, 23 May 2022

2022-05-23T00:02:46Z

← Older revision		Revision as of 00:02, 23 May 2022
Line 142:		Line 142:
	\|-		\|-
	\|}		\|}

			== Example Tcl Script ==
			This is an example script that allows an authenticated user to op someone via a public command

			<code><pre>
			bind PUB * .op acct_op

			proc acct_op {nick user hand chan text} {
			set accthand [account2hand $nick]
			if [string match $accthand ""] {
			putserv "PRIVMSG $chan :You are not authenticated"
			return 1
			}
			if {[matchattr $accthand +o] \|\| [matchattr $accthand +o $chan]} {
			pushmode $chan +o $text
			putserv "PRIVMSG $chan :Op'ing $nick"
			} else {
			putserv "PRIVMSG $chan :You do not have access to .op"
			}
			}
			</pre></code>

Geo at 02:56, 2 May 2022

2022-05-02T02:56:52Z

← Older revision		Revision as of 02:56, 2 May 2022
Line 1:		Line 1:
	If WHOX is ~~missing,~~ the ~~only accurate time is: never (idle~~ users ~~wont be accurate)~~. ~~Would need: users~~ to ~~talk with~~ account-~~tag <br>~~		In Eggdrop version 1.9.3, the ability to identify users based on their IRC service account name was added. However, Eggdrop's ability to 100% accurately track the account name associated with a user on a channel depends on three server-provided features
	~~If extended~~-join is ~~missing,~~ the ~~only accurate time is: immediately upon join~~ (~~new users joining won't be accurate~~). ~~Would need~~ to~~: send~~ a ~~periodic WHOX <br>~~		* WHOX. WHOX is an updated version of the WHO command that can provide the account name of users in a channel when requested. WHOX allows Eggdrop to obtain the account status of members already present in a channel when it joins. You can view if your IRC server supports WHOX by viewing the 005 line when you connect to the server.
	~~If account~~-notify is ~~missing,~~ the ~~only accurate time is: immediately upon join, (users who auth~~ after joining ~~won't be accurate)~~. ~~Would need to: send a periodic WHOX <br>~~		* Extended-join. Extended-join is an IRCv3 capability that sends the account name of a user (if present) when a user joins a channel. Extended-join allows Eggdrop to obtain the account status of a member as they join a channel. You can view if your IRC server supports this capability by sending /quote CAP LS with your IRC client and viewing the response.
			* Account-notify. Account-notify is an IRCv3 capability that notifies members in a channel when a user authenticates to server. Account-notify allows Eggdrop to update the account status of a user if they authenticate after joining a channel. You can view if your IRC server supports this capability by sending /quote CAP LS with your IRC client and viewing the response.

			If these three capabilities are all present and enabled, Eggdrop can accurately track a user's account status at all times. If one or more of these three capabilities is missing, Eggdrop will attempt a "best-effort" at tracking account status based on the information it can glean from the capabilities that are enabled. Additionally, you can negotiate the "account-tag" capability (if the IRC server supports it) and Eggdrop will update the account information of a user that speaks in a channel. For those that like tables, it looks like this:

	{\| class="wikitable"		{\| class="wikitable"
	! style="text-align:left;"\| ~~Updates~~ the account list when the...		! style="text-align:left;"\| Eggdrop updates the account list when the...
	! WHOX		! WHOX
			! extended-join
	! account-notify		! account-notify
	! account-tag		! account-tag
	~~! extended-join~~
	\|-		\|-
	\|... bot joins a channel		\|... bot joins a channel
Line 19:		Line 21:
	\|... auth'd user joins a channel		\|... auth'd user joins a channel
	\|		\|
			\| style="text-align:center;" \| X
	\|		\|
	\|		\|
	~~\| style="text-align:center;" \| X~~
	\|-		\|-
	\|... ~~auth'd~~ user ~~talks~~		\|... user authenticates on a channel
	\|		\|
	\|		\|
Line 29:		Line 31:
	\|		\|
	\|-		\|-
	\|... user ~~authenticates on a channel~~		\|... auth'd user talks
	\|		\|
	~~\| style="text-align:center;" \| X~~
	\|		\|
	\|		\|
			\| style="text-align:center;" \| X
	\|}		\|}

			== Use in Tcl Scripts ==
			The ability to track accounts opens up a wealth of possibilities for Tcl scripts. In order to trigger Tcl script events to cover all instances where a user logs in, it is recommended to pair an ACCOUNT bind with a JOIN bind. This will allow you to check the account (if any) associated with a user as they join, as well as if they authenticate after joining.

			== Imperfect Tracking ==
			If the WHOX, extended-join and account-notify are not all enabled, the accuracy of the account list looks like this:



	{\| class="wikitable"		{\| class="wikitable"

Geo at 20:39, 23 April 2022

2022-04-23T20:39:25Z

← Older revision		Revision as of 20:39, 23 April 2022
Line 1:		Line 1:
	If WHOX is missing, the only accurate time is: never (idle users wont be accurate). Would need: users to talk with account-tag		If WHOX is missing, the only accurate time is: never (idle users wont be accurate). Would need: users to talk with account-tag <br>
	If extended-join is missing, the only accurate time is: immediately upon join (new users joining won't be accurate). Would need to: send a periodic WHOX		If extended-join is missing, the only accurate time is: immediately upon join (new users joining won't be accurate). Would need to: send a periodic WHOX <br>
	If account-notify is missing, the only accurate time is: immediately upon join, (users who auth after joining won't be accurate). Would need to: send a periodic WHOX		If account-notify is missing, the only accurate time is: immediately upon join, (users who auth after joining won't be accurate). Would need to: send a periodic WHOX <br>

Geo at 20:39, 23 April 2022

2022-04-23T20:39:08Z

← Older revision		Revision as of 20:39, 23 April 2022
Line 1:		Line 1:
			If WHOX is missing, the only accurate time is: never (idle users wont be accurate). Would need: users to talk with account-tag
			If extended-join is missing, the only accurate time is: immediately upon join (new users joining won't be accurate). Would need to: send a periodic WHOX
			If account-notify is missing, the only accurate time is: immediately upon join, (users who auth after joining won't be accurate). Would need to: send a periodic WHOX


	{\| class="wikitable"		{\| class="wikitable"
	! style="text-align:left;"\| Updates the account list when the...		! style="text-align:left;"\| Updates the account list when the...

Geo at 02:47, 20 April 2022

2022-04-20T02:47:49Z

← Older revision		Revision as of 02:47, 20 April 2022
Line 68:		Line 68:
	\| ... all the time		\| ... all the time
	\|-		\|-
			\| style="text-align:center;" \| X
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	\|		\|
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	~~\| style="text-align:center;" \| X~~		\| ... when the bot joins the channel and the user is already authenticated, or if the user authenticates in a common channel, or an authenticated user joins then talks in a common channel
	\| ... when the bot joins the channel and the user is already authenticated, or if the user ~~is authenticated before they join~~ a common channel, or ~~once a they join~~ a common channel ~~then authenticate and then talk~~
	\|-		\|-
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	\| ~~style="text-align:center;" \| X~~		\|
	\|		\|
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	\| ... when the bot joins the channel and the user is already authenticated, or ~~if the user authenticates in a common channel, or~~ an authenticated user ~~joins then~~ talks ~~in a common channel~~		\| ... when the bot joins the channel and the user is already authenticated, or once an authenticated user talks after joining
	\|-		\|-
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	\|		\|
	\|
	\| style="text-align:center;" \| X		\| style="text-align:center;" \| X
	\| ... when the bot joins the channel and the user is already authenticated, or once ~~an authenticated user talks after joining~~		\| style="text-align:center;" \| X
			\| ... when the bot joins the channel and the user is already authenticated, or if the user is authenticated before they join a common channel, or once a they join a common channel then authenticate and then talk
	\|-		\|-
	\|		\|