Merge branch 'master' of https://github.com/mongodb/specifications into mkbook

Author: actions-user

source/auth/tests/mongodb-oidc.md

@@ -35,8 +35,8 @@ Drivers MUST implement all prose tests in this section. Unless otherwise noted,
 configured with `retryReads=false`.
 
 > [!NOTE]
-> For test cases that create fail points, drivers MUST either use a unique `appName` or explicitly remove the fail point
-> callback to prevent interaction between test cases.
+> For test cases that create fail points, drivers MUST use a unique `appName` to prevent interaction with other
+> environment processes, and explicitly remove the fail point to prevent interaction between test runs.
 
 After setting up your OIDC
 [environment](https://github.com/mongodb-labs/drivers-evergreen-tools/blob/master/.evergreen/auth_oidc/README.md),

source/auth/tests/unified/mongodb-oidc-no-retry.json

@@ -21,6 +21,7 @@ createEntities:
       authMechanismProperties: { $$placeholder: 1 }
       retryReads: false
       retryWrites: false
+      appName: &appName mongodb-oidc-no-retry
     observeEvents:
     - commandStartedEvent
     - commandSucceededEvent
@@ -87,6 +88,7 @@ tests:
           failCommands:
           - find
           errorCode: 391 # ReauthenticationRequired
+          appName: *appName
   - name: find
     object: collection0
     arguments:
@@ -121,6 +123,7 @@ tests:
           failCommands:
           - insert
           errorCode: 391 # ReauthenticationRequired
+          appName: *appName
   - name: insertOne
     object: collection0
     arguments:
@@ -160,6 +163,7 @@ tests:
           failCommands:
           - insert
           closeConnection: true
+          appName: *appName
   - name: insertOne
     object: collection0
     arguments:
@@ -180,6 +184,7 @@ tests:
           failCommands:
           - saslStart
           errorCode: 18
+          appName: *appName
   - name: insertOne
     object: collection0
     arguments:
@@ -219,11 +224,12 @@ tests:
           failCommands:
           - saslStart
           errorCode: 18
+          appName: *appName
   - name: insertOne
     object: collection0
     arguments:
       document:
         _id: 1
         x: 1
     expectError:
-      errorCode: 18
+      errorCode: 18

source/auth/tests/unified/mongodb-oidc-no-retry.yml

@@ -291,10 +291,9 @@ Endpoint. The pool has the following properties:
     to avoid clearing the pool. The pool MUST NOT add the backpressure error labels during an authentication step
     after the `hello` message. For errors that the driver can distinguish as never occurring due to server overload,
     such as DNS lookup failures, non‑I/O TLS errors (e.g., certificate validation or hostname‑mismatch failures), or
-    errors encountered while establishing a connection to a SOCKS5 proxy, the driver MUST clear the connection pool and
-    MUST mark the server Unknown for these error types. In contrast, if an I/O error (for example, an EOF error) occurs
-    during the TLS handshake, the driver MUST treat it as a potential overload condition and MUST add the backpressure
-    error labels.
+    errors encountered while establishing a connection to a SOCKS5 proxy, the driver MUST NOT add backpressure error
+    labels for these error types. In contrast, if an I/O error (for example, an EOF error) occurs during the TLS
+    handshake, the driver MUST treat it as a potential overload condition and MUST add the backpressure error labels.
 
 ```typescript
 interface ConnectionPool {
@@ -472,7 +471,7 @@ try:
   return connection
 except error:
   close connection
-  add `SystemOverloadedError` label if appropriate (see "backpressure-enabled" in [Connection Pool](#connection-pool))
+  add `SystemOverloadedError` and `RetryableError` labels if appropriate (see "backpressure-enabled" in [Connection Pool](#connection-pool))
   throw error # Propagate error in manner idiomatic to language.
 ```