Watch keynotes and sessions from MongoDB.live, our virtual developer conference.

.NET Driver Version 2.11.0-beta2 Released

.NET Driver Version 2.11.0-beta2 Release Notes

This is a beta release for the 2.11.0 version of the driver.

The main new features in 2.11.0-beta2 support new features in MongoDB 4.4.0. These features include:

  • Support for all new
    $meta
    projections: randVal, searchScore, searchHighlights,
    geoNearDistance, geoNearPoint, recordId, indexKey and
    sortKey
  • Support for passing a hint to update commands as well as
    findAndModify update and replace operations
  • Support for allowDiskUse on find operations
  • Support for MONGODB-AWS authentication using Amazon Web Services
    (AWS) Identity and Access Management (IAM) credentials
  • Support for stapled OCSP (Online Certificate Status Protocol) (macOS only)
  • Support for shorter SCRAM (Salted Challenge Response Authentication Mechanism) conversations
  • Support for speculative SCRAM and MONGODB-X509 authentication
  • Support for the CommitQuorum option in createIndexes
  • Support for hedged reads

Other new additions and updates in this beta include:

  • A new target of .NET Standard 2.0
  • Support for Snappy compression on .NET Core on Windows (in addition
    to existing support on .NET Framework)
  • Support for Zstandard compression on Windows on 64-bit platforms
  • A new default of enabling certificate revocation checking.
  • A new URI option tlsDisableCertificateRevocationCheck to disable
    certificate revocation checking.
  • An expanded list of retryable write errors via the inclusion of
    ExceededTimeLimit, LockTimeout and ClientDisconnect
  • A new GuidRepresentationMode setting to opt-in to the new V3 GuidRepresentation mode
  • Improved SDAM (Server Discovery and Monitoring) error handling
  • Support for the AuthorizedDatabases option in ListDatabases
  • Session support for AsQueryable

The full list of JIRA issues that are currently scheduled to be resolved in this release is available at:

https://jira.mongodb.org/issues/?jql=project%20%3D%20CSHARP%20AND%20fixVersion%20%3D%202.11.0%20ORDER%20BY%20key%20ASC

The list may change as we approach the release date.

Documentation on the .NET driver can be found at:

http://mongodb.github.io/mongo-csharp-driver/

Upgrading

Backwards compatibility with driver version 2.7.0–2.10.x

Because certificate revocation checking is now enabled by default, an
application that is unable to contact the OCSP endpoints and/or CRL
distribution points specified in a server’s certificate may experience
connectivity issues (e.g. if the application is behind a firewall with
an outbound whitelist). This is because the driver needs to contact
the OCSP endpoints and/or CRL distribution points specified in the
server’s certificate and if these OCSP endpoints and/or CRL
distribution points are not accessible, then the connection to the
server may fail. In such a scenario, connectivity may be able to be
restored by disabling certificate revocation checking by adding
tlsDisableCertificateRevocationCheck=true to the application’s connection
string.

I’m very interested in learning more about MONGODB-AWS authentication. Does this feature only work for Atlas deployments? Can we use it in our Cloud Manager deployments?

Welcome to the community forums @Rayan_Alsubhi!

The new MONGODB-AWS authentication mechanism currently requires an Atlas cluster running MongoDB 4.4+.

Borrowing from the MongoDB 4.4 connection string documentation:

To use MONGODB-AWS, you must be connecting to a MongoDB Atlas cluster which has been configured to support authentication via AWS IAM credentials (i.e. an AWS access key ID and a secret access key, and optionally an AWS session token). The MONGODB-AWS authentication mechanism requires that the authSource be set to $external .

Regards,
Stennie

1 Like