DOCSP-43148 - Refactor AWS authentication

source/fundamentals/authentication.txt

@@ -153,12 +153,26 @@ MONGODB-AWS
    The ``MONGODB-AWS`` authentication mechanism is available only for
    MongoDB deployments on MongoDB Atlas.
 
-The ``MONGODB-AWS`` authentication mechanism uses your Amazon Web Services
-Identity and Access Management (AWS IAM) credentials to authenticate your
-user. You can either specify your credentials explicitly
-or instruct the driver to retrieve them automatically from an external source.
+The ``MONGODB-AWS`` authentication mechanism uses Amazon Web Services
+Identity and Access Management (AWS IAM) credentials to authenticate a user to MongoDB.
 
-The following sections contain code examples that use the following placeholders:
+To use AWS authentication, first perform the following steps:
+
+- Add the `MongoDB.Driver.Authentication.AWS <https://www.nuget.org/packages/MongoDB.Driver.Authentication.AWS>`__
+  NuGet package to your project.
+- Add the following line of code to your application's bootstrap code to register the
+  AWS authentication provider:
+
+  .. code-block:: csharp
+     :copyable: true
+
+     MongoClientSettings.Extensions.AddAWSAuthentication();
+
+After you register the AWS authentication provider, you can either specify the AWS IAM 
+credentials explicitly or instruct the driver to retrieve them automatically from an
+external source. The following sections describe both of these methods.
+
+The code examples in these sections use the following placeholders:
 
 - ``<awsKeyId>`` - value of the AWS access key ID
 - ``<awsSecretKey>`` - value of the AWS secret access key

source/upgrade/v3.txt

@@ -145,11 +145,16 @@ Version 3.0 Breaking Changes
 - The ``MongoClient`` constructor accepts only one ``Credential`` object instead of an
   array.
 
+- To use Amazon Web Services (AWS) authentication, you must add the
+  ``MongoDB.Driver.Authentication.AWS`` package to your project and register the
+  authentication provider in your application's bootstrap code. To learn more about
+  using AWS authentication with the {+driver-short+}, see :ref:`csharp-mongodb-aws`.
+
 - If you try to serialize or deserialize a floating-point
   ``Infinity`` or ``NaN`` value to an integral representation, the driver throws an
   ``OverflowException``. To learn more about floating-point ``Infinity`` and ``NaN``
   values, see
   `Double.NaN, <https://learn.microsoft.com/en-us/dotnet/api/system.double.nan?view=net-8.0#system-double-nan>`__
   `Double.PositiveInfinity, <https://learn.microsoft.com/en-us/dotnet/api/system.double.positiveinfinity?view=net-8.0#system-double-positiveinfinity>`__
   and `Double.NegativeInfinity. <https://learn.microsoft.com/en-us/dotnet/api/system.double.negativeinfinity?view=net-8.0#system-double-negativeinfinity>`__
-  on MSDN.
+  on MSDN.