@@ -37,45 +37,48 @@ multiple users. As a |service| administrator, you can:
37
37
- source IP addresses
38
38
- timestamps for successful and failed attempts
39
39
40
- - Configure a JSON-formatted audit filter to customize MongoDB auditing
40
+ - :atlas:`Configure a JSON-formatted audit filter
41
+ </database-auditing/#configure-a-custom-auditing-filter>` to
42
+ customize MongoDB auditing
41
43
and select the actions, database users, |service| roles, and |ldap| groups
42
44
that you want to audit. If you create a custom audit filter, you can
43
45
skip using the managed {+atlas-ui+} auditing filter builder and configure
44
- your own tailored filter of event auditing.
46
+ your own tailored filter of event auditing. For a full list of
47
+ events you can configure for auditing, and for a list of examples,
48
+ see :manual:`MongoDB auditing </core/auditing>` and :atlas:`Example Auditing Filters
49
+ </database-auditing/#example-auditing-filters>`.
45
50
46
51
You can :manual:`configure manual auditing </core/auditing>` of most of the
47
52
documented :manual:`system event actions </reference/audit-message/mongo/>`
48
53
in |service|. Granular MongoDB database auditing allows you to track
49
54
usage of all DDL (Data Definition Language), DML (Data Manipulation Language),
50
- and DCL (Data Control Language) commands in detail. For a full list of
51
- events you can configure for auditing, and for a list of examples,
52
- see :manual:`MongoDB auditing </core/auditing>`. See also
55
+ and DCL (Data Control Language) commands in detail. See also
53
56
:atlas:`Set up Database Auditing </database-auditing>`.
54
57
55
- - :atlas:`Audit the actions of temporary database users </production-notes/#audit-temporary-database-users>`.
56
-
57
58
.. _accessing-audit-logs:
58
59
59
60
Accessing Audit Logs
60
61
````````````````````
61
62
62
63
.. include:: /includes/cloud-docs/logs.rst
63
64
64
- To return and update your audit configuration per project, use the following
65
- `Atlas Administration API <https://www.mongodb.com/docs/atlas/reference/api-resources-spec/v2/>`__ commands:
65
+ To return and update your audit configuration per project, use the following {+atlas-cli+} commands:
66
66
67
- - :ref:`atlas- auditing- describe <atlas-auditing-describe>` returns the
67
+ - :ref:`atlas auditing describe <atlas-auditing-describe>` returns the
68
68
auditing configuration for the specified project.
69
- - :ref:`atlas- auditing- update <atlas-auditing-update>` updates
69
+ - :ref:`atlas auditing update <atlas-auditing-update>` updates
70
70
the auditing configuration for the specified project.
71
71
72
72
You can :ref:`view authentication attempts <access-tracking>` that users
73
- make against your {+cluster+}. |service| logs both successful and unsuccessful
73
+ make against your {+cluster+} with the {+atlas-cli+},
74
+ {+atlas-admin-api+}, or {+atlas-ui+}. |service| logs both successful and unsuccessful
74
75
authentication attempts, including the timestamp of each attempt and which
75
76
user tried to authenticate.
76
77
77
- You can :ref:`view and filter the activity feed <view-activity-feed>`
78
- for an organization or project.
78
+ You can also :ref:`view and filter the activity feed <view-activity-feed>`
79
+ for an organization or project with the {+atlas-cli+},
80
+ {+atlas-admin-api+}, or {+atlas-ui+}. The activity feed lists all
81
+ events at the organization or project level
79
82
80
83
To perform a full audit, you can use a combination of audit logs,
81
84
the ``mongodb.log``, and :ref:`the project activity feed <view-activity-feed>`.
@@ -89,6 +92,9 @@ To optimize costs, you can disable auditing in lower environments for developmen
89
92
Certain industries, like healthcare and financial services, may opt to keep
90
93
auditing enabled in development for compliance reasons.
91
94
95
+ Enabling auditing for all database users, including application
96
+ service users, might affect cluster performance. We recommend that you audit only the actions of users that require auditing.
97
+
92
98
For staging and production environments, enable auditing for
93
99
additional security. We recommend that you audit the following events at a minimum:
94
100
0 commit comments