-
Notifications
You must be signed in to change notification settings - Fork 27
PS-10193 [DOCS] - Update Audit Log Filter variables, options in 8.0 #575
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: 8.0
Are you sure you want to change the base?
Conversation
1dd9fc8
to
4c0ad75
Compare
4c0ad75
to
96d9724
Compare
96d9724
to
1ecc915
Compare
1ecc915
to
c6873aa
Compare
c6873aa
to
6da6429
Compare
6da6429
to
89f34e5
Compare
89f34e5
to
2b76817
Compare
2b76817
to
718097f
Compare
718097f
to
35ef1d9
Compare
Your branch is up to date with 'origin/8.0'. modified: docs/audit-log-filter-variables.md
35ef1d9
to
7a240fc
Compare
Audit‑log functions always accept and return strings in `utf8mb4`. | ||
|
||
The following audit log filter functions are available. | ||
!!! warning "Plugin Compatibility" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Plugin compatibility
|
||
The following sections describe the audit log filter plugin functionality organized by purpose: | ||
|
||
## Plugin Management |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Plugin management
| [`audit_log_filter_disable`](#audit_log_filter_disable) | Variable | Disable plugin logging | | ||
|
||
`keyring_id` - If the function does not contain a keyring_id, the function returns the current encryption password. You can also request a specific encryption password with the keyring ID of either the current password or an archived password. | ||
## Filter Management |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Filter management
| [`audit_log_filter_filter_id`](#audit_log_filter_filter_id) | Variable | Current session filter ID | | ||
|
||
#### Example | ||
## Log Reading and Navigation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Log reading and navigation
| {"password":"passw0rd","iterations":5689} | | ||
+---------------------------------------------+ | ||
``` | ||
## Log File Management |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Log file management
#### Parameters | ||
|
||
If this function is used with [`audit_log_read()](#audit_log_read), the `audit_log_read()` function starts reading at that position. | ||
* `filter_name` - a selected filter name as a string. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should have the same format everywhere. Previously, the first word after the hyphen started with a capital letter, for example, * ON
- Load the plugin if it is available (line 123), * FORCE
- Load the plugin even if it has been disabled (line 127)
I suggest using lowercase after the hyphen everywhere.
* `filter_name` - a selected filter name as a string. | ||
|
||
#### Parameters | ||
* `definition` - The filter definition as a `JSON` value. The `JSON` structure defines |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Use lowercase after the hyphen since the previous bullet also uses lowercase
filter_name - a selected filter name as a string.
The new filter has a different filter ID. Generates an error if the filter name exists. | ||
The default value is 0 (zero) - the session has no assigned filter. | ||
|
||
## Log Reading and Navigation |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Log reading and navigation
* OFF | ||
* FORCE | ||
* FORCE_PLUS_PERMANENT | ||
## Log File Management |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Log file management
| SYNCHRONOUS | Calls sync() after each event (safest, slowest performance) | | ||
|
||
Pruning requires the following options: | ||
## Encryption and Security |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Encryption and security
Your branch is up to date with 'origin/8.0'.
modified: docs/audit-log-filter-variables.md