Difference between revisions of "Nats4 Member Logging"

From TMM Wiki
Jump to navigationJump to search
 
(15 intermediate revisions by 6 users not shown)
Line 3: Line 3:
 
}}
 
}}
  
Member logging is a feature in [[NATS4]] that allows you to direct [[NATS]] to keep a record of all member logins. To use this feature, send a HTTP GET request from your server to the PHP script: ''member_loginlog.php'' with your selected site's [[ID Numbers|ID number]] and the member's username. This will return of a log of that particular member's login history.
+
'''Note: <br>
 +
''' -- This article is written for NATS 4 and NATS 5 <br />
 +
Member logging is a feature in [[NATS4]] that allows you to direct [[NATS]] to keep a record of all [[Ct#Member|member]] logins. To use this feature, send a HTTP GET request from your server to the PHP script: ''member_loginlog.php'' with your selected [[Ct#Site|site]]'s [[ID Numbers|ID number]] and the [[Ct#Member|member]]'s username. NATS will add a log entry in that particular member's login history.
  
 
For example, you can add the following code to a PHP script and then run it:
 
For example, you can add the following code to a PHP script and then run it:
Line 13: Line 15:
 
</pre>
 
</pre>
  
These logs are a secure feature in [[NATS]]. As a result, the IP address of the server that is requesting information must be in the [[Smarty]] configuration file ''$config['SECURE_IPS']'' setting.
+
These logs are a secure feature in [[NATS]]. As a result, the IP address of the server that is requesting information must be in the NATS configuration file (located in your <nats_directory>/includes/config.php) ''$config['SECURE_IPS']'' setting.
  
 
For example:
 
For example:
  
<pre>$config['SECURE_IPS'] = Array('123.123.123.123'); </pre>
+
<pre>$config['SECURE_IPS'] = Array('123.123.123.123', '234.234.234.234'); </pre>
  
 
Simply replace "123.123.123.123" in the above example code with your server's IP address.
 
Simply replace "123.123.123.123" in the above example code with your server's IP address.
Line 23: Line 25:
 
After this feature is activated, the specified member's login history will show up in the [[Members Admin|Members Admin's]] members details.  
 
After this feature is activated, the specified member's login history will show up in the [[Members Admin|Members Admin's]] members details.  
  
To find the member's login log, go to the [[NATS4 Members Admin|Members Admin]], find the member you are tracking, and click the "View Member Details" icon. Scroll down to the bottom of the Member Details page to find the Login Log for your specified member.
+
To find the [[Ct#Member|member]]'s login log, go to the [[NATS4 Members Admin|Members Admin]], find the member you are tracking, and click the "View Member Details" icon. Scroll down to the bottom of the Member Details page to find the Login Log for your specified member.
  
 
[[File:Login_log.PNG|450px|Example of a Member Login Log]]
 
[[File:Login_log.PNG|450px|Example of a Member Login Log]]
  
 
== Extra Features ==
 
== Extra Features ==
You can also record one login as accessing multiple sites. To add more than one site to your member login history, use the following siteid parameter:
+
If you are allowing members of one (1) site access to other NATS sites, you can specify multiple sites in the siteid parameter. If there are multiple siteids specified, NATS will use those siteids to find a member record match. NATS will record the login to only one (1) Member record. Consider the following:
 +
 
 +
1) Member A has a membership to site 5. You grant all members of site 5, 64, and 2 access to each other. With the following URL, NATS will locate Member A and record the login.<br>
 +
2) Member A has a membership to sites 5 and 64, as Member B. You grant all members of site 5, 64, and 2 access to each other. With the following URL, NATS will locate either Member A or Member B and record only one (1) login, depending on the first record returned from the database. So, it could be recorded on Member A or Member B, but not both.<br><br>
  
 
<pre>
 
<pre>
Line 35: Line 40:
  
 
[[Category:Also NATS4 Article]]
 
[[Category:Also NATS4 Article]]
 +
[[Category:NATS4 Members Admin]]

Latest revision as of 08:00, 2 August 2021

NATS 4
Members Admin
The Members Admin
View Member Details
Add Member
MySQL Auth
Mod Authn DB
Multisite Access
Member Logging
Member Password Retrieval
OpenID Connect
Mod Auth OpenIDC
ID Numbers

Note:
-- This article is written for NATS 4 and NATS 5
Member logging is a feature in NATS4 that allows you to direct NATS to keep a record of all member logins. To use this feature, send a HTTP GET request from your server to the PHP script: member_loginlog.php with your selected site's ID number and the member's username. NATS will add a log entry in that particular member's login history.

For example, you can add the following code to a PHP script and then run it:

$url="http://www.example.com/member_loginlog.php?username=$_SERVER[REMOTE_USER]&siteid=123&ip=$_SERVER[REMOTE_ADDR]";

@file($url);

These logs are a secure feature in NATS. As a result, the IP address of the server that is requesting information must be in the NATS configuration file (located in your <nats_directory>/includes/config.php) $config['SECURE_IPS'] setting.

For example:

$config['SECURE_IPS'] = Array('123.123.123.123', '234.234.234.234'); 

Simply replace "123.123.123.123" in the above example code with your server's IP address.

After this feature is activated, the specified member's login history will show up in the Members Admin's members details.

To find the member's login log, go to the Members Admin, find the member you are tracking, and click the "View Member Details" icon. Scroll down to the bottom of the Member Details page to find the Login Log for your specified member.

Example of a Member Login Log

Extra Features

If you are allowing members of one (1) site access to other NATS sites, you can specify multiple sites in the siteid parameter. If there are multiple siteids specified, NATS will use those siteids to find a member record match. NATS will record the login to only one (1) Member record. Consider the following:

1) Member A has a membership to site 5. You grant all members of site 5, 64, and 2 access to each other. With the following URL, NATS will locate Member A and record the login.
2) Member A has a membership to sites 5 and 64, as Member B. You grant all members of site 5, 64, and 2 access to each other. With the following URL, NATS will locate either Member A or Member B and record only one (1) login, depending on the first record returned from the database. So, it could be recorded on Member A or Member B, but not both.

$url="http://www.server.com/member_loginlog.php?username=$_SERVER[REMOTE_USER]&siteid=5,64,2&ip=$_SERVER[REMOTE_ADDR]";