(DOCSP-38083) Deprecate blacklist and whitelist terminology. (#618)

lmkerbey-mdb · web-flow · commit 8fe2b6b98c95 · 2025-01-13T12:19:52.000-05:00
[JIRA](https://jira.mongodb.org/browse/DOCSP-38083)
diff --git a/config/redirects b/config/redirects
@@ -778,7 +778,7 @@ raw: /master/schema-advisor/consider-embedded-documents-arrays -> ${base}/v4.4/s
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/clusters/clusters-update-one -> ${base}/${version}/reference/api/clusters
 
 
-# Programmatic API Keys - Org Whitelist
+# Programmatic API Keys - Org Access List
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/org-api-key-whitelists/ -> ${base}/${version}/reference/api/whitelist/
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/org/get-all-org-api-key-whitelist/ -> ${base}/${version}/reference/api/whitelist/
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/org/get-one-org-api-key-whitelist/ -> ${base}/${version}/reference/api/whitelist/
@@ -794,7 +794,7 @@ raw: /master/schema-advisor/consider-embedded-documents-arrays -> ${base}/v4.4/s
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/global/update-one-global-api-key/ -> ${base}/${version}/reference/api/
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/global/delete-one-global-api-key/ -> ${base}/${version}/reference/api/
 
-# Programmatic API Keys - Global Whitelist
+# Programmatic API Keys - Global Access List
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/global-api-key-whitelists/ -> ${base}/${version}/reference/api/
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/global/get-all-global-whitelist/ -> ${base}/${version}/reference/api/
 [*-v4.0]: ${bucket_prefix}/${version}/reference/api/api-keys/global/get-one-global-whitelist/ -> ${base}/${version}/reference/api/
diff --git a/source/core/backup-preparations.txt b/source/core/backup-preparations.txt
@@ -460,17 +460,17 @@ to back up. You can apply a namespace filter to any database except
 ``admin`` and ``local`` and any collection that doesn't start with
 ``system``. 
 
-You create either a :guilabel:`Blacklist` of those to
-exclude or a :guilabel:`Whitelist` of those to include. You make your
+You create either a :guilabel:`Deny List` of those to
+exclude or a :guilabel:`Access List` of those to include. You make your
 selections when starting a backup and can later edit them as needed. If
 you change the filter in a way that adds data to your backup, a resync
 is required.
 
-Use the blacklist to prevent backup of collections that contain logging
+Use the deny list to prevent backup of collections that contain logging
 data, caches, or other ephemeral data. Excluding these kinds of
 databases and collections will allow you to reduce backup time and
-costs. Using a blacklist is often preferable to using a whitelist as a
-whitelist requires you to intentionally opt in to every namespace you
+costs. Using a deny list is often preferable to using an access list as a
+access list requires you to intentionally opt in to every namespace you
 want backed up.
 
 .. include:: /includes/facts/namespace-filter-version.rst
diff --git a/source/includes/api/alert-eventTypeNames-om.rst b/source/includes/api/alert-eventTypeNames-om.rst
@@ -19,7 +19,7 @@
 
 **Backup**
 - :alert:`BAD_CLUSTERSHOTS`
-- :alert:`CLUSTER_BLACKLIST_UPDATED_AUDIT`
+- :alert:`CLUSTER_DENYLIST_UPDATED_AUDIT`
 - :alert:`CLUSTER_CHECKKPOINT_UPDATED_AUDIT`
 - :alert:`CLUSTER_CREDENTIAL_UPDATED_AUDIT`
 - :alert:`CLUSTER_SNAPSHOT_SCHEDULE_UPDATED_AUDIT`
@@ -37,7 +37,7 @@
 - :alert:`RESTORE_REQUESTED_AUDIT`
 - :alert:`RESYNC_PERFORMED`
 - :alert:`RESYNC_REQUIRED`
-- :alert:`RS_BLACKLIST_UPDATED_AUDIT`
+- :alert:`RS_DENYLIST_UPDATED_AUDIT`
 - :alert:`RS_CREDENTIAL_UPDATED_AUDIT`
 - :alert:`RS_ROTATE_MASTER_KEY_AUDIT`
 - :alert:`RS_SNAPSHOT_SCHEDULE_UPDATED_AUDIT`
diff --git a/source/includes/api/list-tables/snapshot-cs-documents.rst b/source/includes/api/list-tables/snapshot-cs-documents.rst
@@ -104,14 +104,14 @@
      - A value that determines how :manual:`namespaces  </reference/glossary/#std-term-namespace>` are
        filtered for this snapshot.
 
-       - If this value is set to ``blacklist``, namespaces in
+       - If this value is set to ``denyList``, namespaces in
          ``namespaceFilterList.filterList`` are excluded from the
          snapshot.
-       - If this value is set to ``whitelist``, only namespaces in
+       - If this value is set to ``accessList``, only namespaces in
          ``namespaceFilterList.filterList`` are included in the
          snapshot.
 
-       The default value is ``blacklist``.
+       The default value is ``denyList``.
 
    * - parts
      - object array
diff --git a/source/includes/api/list-tables/snapshot-rs-documents.rst b/source/includes/api/list-tables/snapshot-rs-documents.rst
@@ -122,14 +122,14 @@
      - Label that determines how :manual:`namespaces  </reference/glossary/#std-term-namespace>` are
        filtered for this snapshot.
 
-       - If this value is set to ``blacklist``, namespaces in
+       - If this value is set to ``denylist``, namespaces in
          ``namespaceFilterList.filterList`` are excluded from the
          snapshot.
-       - If this value is set to ``whitelist``, only namespaces in
+       - If this value is set to ``accessList``, only namespaces in
          ``namespaceFilterList.filterList`` are included in the
          snapshot.
 
-       The default value is ``blacklist``.
+       The default value is ``denylist``.
 
    * - ``missingShards``
      - array of objects
diff --git a/source/includes/fact-pre-configured-mbru-command.rst b/source/includes/fact-pre-configured-mbru-command.rst
@@ -18,8 +18,8 @@
      --apiKey <apiKey> \
      --groupId <groupId> \
      --rsId <rsId> \
-     --whitelist <database1.collection1, database2, etc.> \
-     --blacklist <database1.collection1, database2, etc.> \
+     --accessList <database1.collection1, database2, etc.> \
+     --denyList <database1.collection1, database2, etc.> \
      --seedReplSetMember \
      --oplogSizeMB <size> \
      --seedTargetPort <port> \
diff --git a/source/includes/fact-restore-manual-replica-set-cloud.rst b/source/includes/fact-restore-manual-replica-set-cloud.rst
@@ -75,13 +75,13 @@
      - Provide the :manual:`replica set </reference/glossary/#std-term-replica-set>` ID.
      - :icon:`check-circle`
  
-   * - ``--whitelist``
+   * - ``--accessList``
      - Optional
      - Provide a list of databases and/or collections to which you
        want to limit the restore.
      -
  
-   * - ``--blacklist``
+   * - ``--denyList``
      - Optional
      - Provide a list of databases and/or collections to which you
        want to exclude from the restore.
diff --git a/source/includes/fact-restore-manual-replica-set-onprem.rst b/source/includes/fact-restore-manual-replica-set-onprem.rst
@@ -75,13 +75,13 @@
      - Provide the :manual:`replica set </reference/glossary/#std-term-replica-set>` ID.
      - :icon:`check-circle`
 
-   * - ``--whitelist``
+   * - ``--accessList``
      - Optional
      - Provide a list of databases and/or collections to which you
        want to limit the restore.
      -
 
-   * - ``--blacklist``
+   * - ``--denyList``
      - Optional
      - Provide a list of databases and/or collections to which you
        want to exclude from the restore.
diff --git a/source/includes/setting-fileConf-mms.publicApi.accesslistEnabled.rst b/source/includes/setting-fileConf-mms.publicApi.accesslistEnabled.rst
@@ -1,4 +1,4 @@
-.. setting:: mms.publicApi.whitelistEnabled
+.. setting:: mms.publicApi.accessListEnabled
 
    *Type*: boolean
 
diff --git a/source/includes/steps-enable-backup.yaml b/source/includes/steps-enable-backup.yaml
@@ -77,7 +77,7 @@ content: |
 
   To exclude databases and collections from this backup:
 
-  a.  Click :guilabel:`Blacklist`.
+  a.  Click :guilabel:`Deny List`.
 
   b.  Enter the first database and collection in the text box. For
       collections, enter the full namespace:
diff --git a/source/includes/steps-k8s-setup.yaml b/source/includes/steps-k8s-setup.yaml
@@ -15,7 +15,7 @@ level: 4
 ref: k8s-setup-step2
 content: |
 
-  If you disabled the ``mms.publicApi.whitelistEnabled`` setting in 
+  If you disabled the ``mms.publicApi.accessListEnabled`` setting in 
   your |mms| :ref:`configuration <conf-mms.properties>`, the 
   :guilabel:`Access List Entry` field is not visible in the UI. 
 
diff --git a/source/includes/steps-restore-single-database.yaml b/source/includes/steps-restore-single-database.yaml
@@ -72,8 +72,8 @@ content: |
               --apiKey <apiKey> \
               --groupId <groupId> \
               --rsId <rsId> \
-              --whitelist <database1.collection1, database2, etc.> \
-              --blacklist <database1.collection1, database2, etc.> \
+              --accessList <database1.collection1, database2, etc.> \
+              --denyList <database1.collection1, database2, etc.> \
               --seedReplSetMember \
               --oplogSizeMB <size> \
               --seedTargetPort <port> \
@@ -145,12 +145,12 @@ content: |
           - Required
           - Provide the :manual:`replica set </reference/glossary/#std-term-replica-set>` ID.
 
-        * - ``--whitelist``
+        * - ``--accessList``
           - Optional
           - Provide a list of databases and/or collections to which you
             want to limit the restore.
 
-        * - ``--blacklist``
+        * - ``--denyList``
           - Optional
           - Provide a list of databases and/or collections to which you
             want to exclude from the restore.
diff --git a/source/includes/steps-send-pit-sharded-cluster.yaml b/source/includes/steps-send-pit-sharded-cluster.yaml
@@ -50,8 +50,8 @@ content: |
           --apiKey <apiKey> \
           --groupId <groupId> \
           --rsId <rsId> \
-          --whitelist <database1.collection1, database2, etc.> \
-          --blacklist <database1.collection1, database2, etc.> \
+          --accessList <database1.collection1, database2, etc.> \
+          --denyList <database1.collection1, database2, etc.> \
           --seedReplSetMember \
           --oplogSizeMB <size> \
           --seedTargetPort <port> \
@@ -124,12 +124,12 @@ content: |
           - Required
           - Provide the :manual:`replica set </reference/glossary/#std-term-replica-set>` ID.
 
-        * - ``--whitelist``
+        * - ``--accessList``
           - Optional
           - Provide a list of databases and/or collections to which you
             want to limit the restore.
 
-        * - ``--blacklist``
+        * - ``--denyList``
           - Optional
           - Provide a list of databases and/or collections to which you
             want to exclude from the restore.
diff --git a/source/reference/alerts/ops-manager-create-list.rst b/source/reference/alerts/ops-manager-create-list.rst
@@ -20,7 +20,7 @@
 **Backup**
 
 - :alert:`BAD_CLUSTERSHOTS`
-- :alert:`CLUSTER_BLACKLIST_UPDATED_AUDIT`
+- :alert:`CLUSTER_DENYLIST_UPDATED_AUDIT`
 - :alert:`CLUSTER_CHECKKPOINT_UPDATED_AUDIT`
 - :alert:`CLUSTER_CREDENTIAL_UPDATED_AUDIT`
 - :alert:`CLUSTER_SNAPSHOT_SCHEDULE_UPDATED_AUDIT`
@@ -38,7 +38,7 @@
 - :alert:`RESTORE_REQUESTED_AUDIT`
 - :alert:`RESYNC_PERFORMED`
 - :alert:`RESYNC_REQUIRED`
-- :alert:`RS_BLACKLIST_UPDATED_AUDIT`
+- :alert:`RS_DENYLIST_UPDATED_AUDIT`
 - :alert:`RS_CREDENTIAL_UPDATED_AUDIT`
 - :alert:`RS_ROTATE_MASTER_KEY_AUDIT`
 - :alert:`RS_SNAPSHOT_SCHEDULE_UPDATED_AUDIT`
diff --git a/source/reference/alerts/ops-manager-list.rst b/source/reference/alerts/ops-manager-list.rst
@@ -94,7 +94,7 @@ Backup
      - Backup has possibly inconsistent cluster snapshots
      - Project, Global
 
-   * - .. alert:: CLUSTER_BLACKLIST_UPDATED_AUDIT 
+   * - .. alert:: CLUSTER_DENYLIST_UPDATED_AUDIT 
      - Excluded namespaces were modified for cluster
      - Project, Global
 
@@ -166,7 +166,7 @@ Backup
      - Backup requires a resync
      - Project, Global
 
-   * - .. alert:: RS_BLACKLIST_UPDATED_AUDIT 
+   * - .. alert:: RS_DENYLIST_UPDATED_AUDIT 
      - Excluded namespaces were modified for replica set
      - Project, Global
 
diff --git a/source/reference/api/snapshots/change-expiry-for-one-snapshot.txt b/source/reference/api/snapshots/change-expiry-for-one-snapshot.txt
@@ -164,7 +164,7 @@ Response Body
      } ],
      "namespaceFilterList" : {
        "filterList" : [ ],
-       "filterType" : "blacklist"
+       "filterType" : "denylist"
      },
      "parts" : [ {
        "CLUSTER-ID" : "{CLUSTER-ID}",
diff --git a/source/reference/api/snapshots/get-all-snapshots-for-config-server.txt b/source/reference/api/snapshots/get-all-snapshots-for-config-server.txt
@@ -122,7 +122,7 @@ Response Body
        } ],
        "namespaceFilterList" : {
          "filterList" : [ ],
-         "filterType" : "blacklist"
+         "filterType" : "denylist"
        },
        "parts" : [ {
          "clusterId" : "{CLUSTER-ID}",
diff --git a/source/reference/api/snapshots/get-all-snapshots-for-one-cluster.txt b/source/reference/api/snapshots/get-all-snapshots-for-one-cluster.txt
@@ -167,7 +167,7 @@ Response Body
        } ],
        "namespaceFilterList" : {
          "filterList" : [ ],
-         "filterType" : "blacklist"
+         "filterType" : "denylist"
        },
        "parts" : [ {
          "clusterId" : "{CLUSTER-ID}",
diff --git a/source/reference/api/snapshots/get-one-snapshot-for-config-server.txt b/source/reference/api/snapshots/get-one-snapshot-for-config-server.txt
@@ -123,7 +123,7 @@ Response Body
      } ],
      "namespaceFilterList" : {
        "filterList" : [ ],
-       "filterType" : "blacklist"
+       "filterType" : "denylist"
      },
      "parts" : [ {
        "dataSizeBytes" : 503779557,
diff --git a/source/reference/api/snapshots/get-one-snapshot-for-one-cluster.txt b/source/reference/api/snapshots/get-one-snapshot-for-one-cluster.txt
@@ -113,7 +113,7 @@ Response Body
      } ],
      "namespaceFilterList" : {
        "filterList" : [ ],
-       "filterType" : "blacklist"
+       "filterType" : "denylist"
      },
      "parts" : [ {
        "clusterId" : "{CLUSTER-ID}",
diff --git a/source/reference/audit-events.txt b/source/reference/audit-events.txt
@@ -200,11 +200,11 @@ Backup Audit Events
 
    A user updates the authentication credentials for a sharded cluster.
 
-.. event:: RS_BLACKLIST_UPDATED_AUDIT
+.. event:: RS_DENYLIST_UPDATED_AUDIT
 
    A user updates the namespaces filter for a replica set.
 
-.. event:: CLUSTER_BLACKLIST_UPDATED_AUDIT
+.. event:: CLUSTER_DENYLIST_UPDATED_AUDIT
 
    A user updates the namespaces filter for a sharded cluster.
 
diff --git a/source/reference/configuration.txt b/source/reference/configuration.txt
@@ -247,7 +247,7 @@ assignments.
 {+admin-api+}
 --------------------------------
 
-.. include:: /includes/setting-fileConf-mms.publicApi.whitelistEnabled.rst
+.. include:: /includes/setting-fileConf-mms.publicApi.accesslistEnabled.rst
 
 Push Live Migrations
 --------------------
diff --git a/source/release-notes/changelogs/backup-agent/changelog-backup-agent-eol.rst b/source/release-notes/changelogs/backup-agent/changelog-backup-agent-eol.rst
@@ -37,7 +37,7 @@ Backup Agent 3.9.0.336
 
 - Added support for MongoDB 3.2.0 config servers as replica sets.
 
-- Added the ability to only backup selected namespaces (whitelist).
+- Added the ability to only backup selected namespaces (access list).
 
 - Fixed issue with initial sync failing due to collections being
   deleted during the sync.
diff --git a/source/release-notes/changelogs/ops-manager/changelog-onprem-eol.rst b/source/release-notes/changelogs/ops-manager/changelog-onprem-eol.rst
@@ -349,7 +349,7 @@ Backup
 - Automated restores: added a new option to automatically restore a
   backup to a running :manual:`replica set </reference/glossary/#std-term-replica-set>` or :manual:`sharded cluster </reference/glossary/#std-term-sharded-cluster>`.
 
-- Added support for namespace whitelisting, which allows you to back up
+- Added support for namespace access listing, which allows you to back up
   only a subset of your data.
 
 - Added the ability to manage HTTP restore link expiration from the
diff --git a/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.0.rst b/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.0.rst
@@ -118,7 +118,7 @@
 
 *Released on 2019-07-04*
 
-- Removing whitelist from Admin (General > Users) now possible.
+- Removing access list from Admin (General > Users) now possible.
   Displays error message when Authentication expires
 
 - **Agent Upgrades:** :ref:`automation-5.4.20.5541`,
@@ -135,7 +135,7 @@
   of ``PEM`` key file and password no matter the
   :option:`tlsMode <mongod.--tlsMode>`.
 
-- **Fix:** Fixes support for the ``security.clusterIpSourceWhitelist``
+- **Fix:** Fixes support for the ``security.clusterIpSourceAccessList``
   MongoDB configuration option.
 
 - **Dependency Update:** Updates jetty to 9.4.18.
diff --git a/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.2.rst b/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.2.rst
@@ -168,7 +168,7 @@
   :doc:`update Global API Keys via the API </reference/api/api-keys/global/update-one-global-api-key>`
   results in an invalid request.
 - Fixes an unexpected error when trying to
-  :doc:`update a global whitelist IP </reference/api/api-keys/global/update-one-global-access-list>`.
+  :doc:`update a global access list IP </reference/api/api-keys/global/update-one-global-access-list>`.
 - :ref:`Sets the day of the week to takes a full snapshot <edit-snapshot-schedule>`.
   This ensures a recent complete backup.
 - Updates MongoDB Agent to :ref:`10.2.20.5992 <mongodb-10.2.20.5992>`.
diff --git a/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.4.rst b/source/release-notes/changelogs/ops-manager/changelog-onprem-v4.4.rst
@@ -410,7 +410,7 @@
   - Trying to update
     :ref:`Global API Keys <admin-console-general-api-keys>` via the
     |api| with an invalid request.
-  - Trying to update a global whitelist IP.
+  - Trying to update a global access list IP.
 
 - Includes :bic:`MongoDB Business Intelligence Connector v2.14.0 </>`.
 

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-.. setting:: mms.publicApi.whitelistEnabled`
	`1`	`+.. setting:: mms.publicApi.accessListEnabled`
`2`	`2`
`3`	`3`	`Type: boolean`
`4`	`4`