diff --git a/source/fundamentals/authentication.txt b/source/fundamentals/authentication.txt index 6152db22..931a1e64 100644 --- a/source/fundamentals/authentication.txt +++ b/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 `__ + 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: - ```` - value of the AWS access key ID - ```` - value of the AWS secret access key diff --git a/source/upgrade/v3.txt b/source/upgrade/v3.txt index 46f85994..c2d93da6 100644 --- a/source/upgrade/v3.txt +++ b/source/upgrade/v3.txt @@ -145,6 +145,11 @@ 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`` @@ -152,4 +157,4 @@ Version 3.0 Breaking Changes `Double.NaN, `__ `Double.PositiveInfinity, `__ and `Double.NegativeInfinity. `__ - on MSDN. \ No newline at end of file + on MSDN.