The user tracking feature allows you to track sessions by user and capture a username to reference in traffic and attack log messages.
When FortiWeb detects users that match the criteria that you specify in a user tracking policy, it stores the session ID and username.
FortiWeb only tracks users who have logged in successfully. It uses one of the following methods to determine whether a log in is successful:
When either of the following two events occurs, FortiWeb stops tracking the session user:
When you enable Session Timeout Enforcement in a user tracking rule, you can also configure a Session Freeze Time. After a session has been idle for longer than the timeout value, if a request has the session ID of the timed-out session, FortiWeb takes the action you specify in the rule. FortiWeb continues to take this action against requests with the session ID for the length of time specified by Session Freeze Time.
You can also use the user tracking feature to create a filter in a custom rule that matches specific users. This type of custom rule requires you to create a user tracking policy and apply it to the protection profile that uses the custom rule. See Combination access control & rate limiting.
|
You can apply a user tracking policy using either an inline or offline protection profile. However, in offline protection mode, Session Fixation Protection, Session Timeout Enforcement, and the deny, redirect and period block actions are not supported. |
1. Go to Tracking > User Tracking > User Tracking Rule.
2. Click Create New, and then complete the following settings:
| Name | Enter a name that identifies the rule. |
| Authentication URL | Enter the URL to match in authorization requests. Ensure that the value begins with a forward slash ( / ). |
| Username Field | Enter the username field value to match in authorization requests. |
| Password Field | Enter the password field value to match in authorization requests. |
| Session ID Name | Type the name of the session ID that is used to identify each session. Examples of session ID names are sid, PHPSESSID, and JSESSIONID. |
| Default Authentication Result | Enter the authentication result that FortiWeb associates with requests that match the criteria but do not match an entry in the Authentication Result Condition Table. When the login result is successful, FortiWeb tracks the session using the session ID and username values. |
| Log Off Path | Optionally, enter the URL of the request that a client sends to log out of the application. When the client sends this URL, FortiWeb stops tracking the user session. Ensure that the value begins with a forward slash ( / ). |
| Session Timeout | Enter the length of time in minutes that FortiWeb waits before it stops tracking an inactive user session. Valid values are from 1 to 14400. |
| Session Fixation Protection | Select On to configure FortiWeb to erase session IDs from the cookie and argument fields of a matching login request. FortiWeb erases the IDs for non-authenticated sessions only. For web applications that do not renew the session cookie when a user logs in, it is possible for an attacker to trick a user into authenticating with a session ID that the attacker acquired earlier. This feature prevents the attacker from accessing the web app in an authenticated session. When this feature removes session IDs, FortiWeb does not generate a log message because it is very common for a legitimate user to access a web application using an existing cookie. For example, a client who leaves his or her web browser open between sessions presents the cookie from an earlier session. Caution: This option is not supported in offline protection mode. |
| Session Timeout Enforcement | Select On to configure FortiWeb to remove the session ID for user sessions that are idle for longer than the session timeout threshold. When a session is reset, the client has to log in again to access the back-end server. If a session exceeds the timeout threshold, instead of tracking subsequent matching sessions by user, FortiWeb takes the specified action, for a length of time specified by Session Freeze Time. Caution: This option is not supported in offline protection mode. |
| Session Freeze Time | Enter the length of time after a session exceeds the timeout threshold that FortiWeb takes the specified action against requests with the ID of the timed-out session. After the freeze time has elapsed, FortiWeb removes the session ID for idle sessions but no longer takes the specified action. Available only when Session Timeout Enforcement is On. |
| Action |
Select the action that FortiWeb takes against requests with the ID of a timed-out session during the specified time period:
When the action generates a log message, the message field value is Available only when Session Timeout Enforcement is On. |
| Block Period |
Type the number of seconds that you want to block requests with the ID of a timed-out session. This setting is available only if Action is set to Period Block. The valid range is from 1 to 3,600 (1 hour). The default value is 60. See also Monitoring currently blocked IPs. |
| Severity |
When the session timeout settings generate an attack log, each log message contains a Severity Level (
The default value is Low. |
| Trigger Policy | Select which trigger, if any, that FortiWeb uses when it logs or sends an alert email about the session timeout. See Viewing log messages. Available only when Session Timeout Enforcement is On. |
3. Click OK.
4. To add an entry to the Authentication Result Condition Table, click Create New, and then complete the following settings:
| Authentication Result Type | Specify the status FortiWeb assigns to user logins that match this table item: Failed or Successful. FortiWeb tracks sessions by user only when the status is Successful. If the request does not match any rules in this table, FortiWeb uses the value specified by Default Authentication Result. |
| HTTP Match Target | Select the location of the value to match with the string or regular expression specified in this table item: Return Code, Response Body, Redirect URL. |
| Value Type | Indicate whether Value is a Simple String or a Regular Expression. |
| Value | Enter the value to match. |
5. Click OK, and then add any additional table entries that are required.
6. Create any additional rules that are required.
7. To add the rules to a policy, go to Tracking > User Tracking > User Tracking Policy, click Create New, enter a name for the policy, and then click OK.
8. Click Create New, select the user tracking rule to add, and then click OK.
9. Add any additional rules that are required, and then click OK.
10. To apply the user tracking rule, select it in an inline or offline protection profile (see Configuring a protection profile for inline topologies or Configuring a protection profile for an out-of-band topology or asynchronous mode of operation).