DRIVERS-2672 Add OIDC machine workflow spec.

source/auth/tests/README.rst

@@ -2,17 +2,25 @@
 Auth Tests
 ==========
 
-The YAML and JSON files in this directory tree are platform-independent tests
-that drivers can use to prove their conformance to the Auth Spec at least with
-respect to connection string URI input.
+Introduction
+============
+
+This document describes the format of the driver spec tests included in the
+JSON and YAML files included in the ``legacy`` sub-directory. Tests in the
+``unified`` directory are written using the `Unified Test Format
+<../../unified-test-format/unified-test-format.rst>`_.
+
+The YAML and JSON files in the ``legacy`` directory tree are
+platform-independent tests that drivers can use to prove their conformance to
+the Auth Spec at least with respect to connection string URI input.
 
 Drivers should do additional unit testing if there are alternate ways of
 configuring credentials on a client.
 
 Driver must also conduct the prose tests in the Auth Spec test plan section.
 
 Format
-------
+======
 
 Each YAML file contains an object with a single ``tests`` key. This key is an
 array of test case objects, each of which have the following keys:

source/auth/tests/legacy/connection-string.yml

@@ -350,59 +350,30 @@ tests:
     mechanism: MONGODB-AWS
     mechanism_properties:
       AWS_SESSION_TOKEN: token!@#$%^&*()_+
-- description: should recognise the mechanism and request callback (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC
-  callback:
-  - oidcRequest
+- description: should recognise the mechanism with aws provider (MONGODB-OIDC)
+  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:aws
   valid: true
   credential:
     username:
     password:
     source: "$external"
     mechanism: MONGODB-OIDC
     mechanism_properties:
-      REQUEST_TOKEN_CALLBACK: true
-- description: should recognise the mechanism when auth source is explicitly specified
-    and with request callback (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authSource=$external
-  callback:
-  - oidcRequest
+      PROVIDER_NAME: aws
+- description: should recognise the mechanism when auth source is explicitly specified and with provider (MONGODB-OIDC)
+  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authSource=$external&authMechanismProperties=PROVIDER_NAME:aws
   valid: true
   credential:
     username:
     password:
     source: "$external"
     mechanism: MONGODB-OIDC
     mechanism_properties:
-      REQUEST_TOKEN_CALLBACK: true
-- description: should recognise the mechanism with request and refresh callback (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC
+      PROVIDER_NAME: aws
+- description: should ignore username and password if specified for aws provider (MONGODB-OIDC)
+  uri: mongodb://user:pass@localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:aws
   callback:
   - oidcRequest
-  - oidcRefresh
-  valid: true
-  credential:
-    username:
-    password:
-    source: "$external"
-    mechanism: MONGODB-OIDC
-    mechanism_properties:
-      REQUEST_TOKEN_CALLBACK: true
-      REFRESH_TOKEN_CALLBACK: true
-- description: should recognise the mechanism and username with request callback (MONGODB-OIDC)
-  uri: mongodb://principalName@localhost/?authMechanism=MONGODB-OIDC
-  callback:
-  - oidcRequest
-  valid: true
-  credential:
-    username: principalName
-    password:
-    source: "$external"
-    mechanism: MONGODB-OIDC
-    mechanism_properties:
-      REQUEST_TOKEN_CALLBACK: true
-- description: should recognise the mechanism with aws device (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:aws
   valid: true
   credential:
     username:
@@ -411,46 +382,23 @@ tests:
     mechanism: MONGODB-OIDC
     mechanism_properties:
       PROVIDER_NAME: aws
-- description: should recognise the mechanism when auth source is explicitly specified
-    and with aws device (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authSource=$external&authMechanismProperties=PROVIDER_NAME:aws
-  valid: true
-  credential:
-    username:
-    password:
-    source: "$external"
-    mechanism: MONGODB-OIDC
-    mechanism_properties:
-      PROVIDER_NAME: aws
-- description: should throw an exception if username and password are specified (MONGODB-OIDC)
-  uri: mongodb://user:pass@localhost/?authMechanism=MONGODB-OIDC
-  callback:
-  - oidcRequest
+- description: should throw an exception if username is specified for aws (MONGODB-OIDC)
+  uri: mongodb://principalName@localhost/?authMechanism=MONGODB-OIDC&PROVIDER_NAME:aws
   valid: false
   credential:
-- description: should throw an exception if username and deviceName are specified
-    (MONGODB-OIDC)
-  uri: mongodb://principalName@localhost/?authMechanism=MONGODB-OIDC&PROVIDER_NAME:gcp
+- description: should throw an exception if specified provider is not supported (MONGODB-OIDC)
+  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:invalid
   valid: false
   credential:
-- description: should throw an exception if specified deviceName is not supported
-    (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:unexisted
+- description: should throw an exception custom callback is chosen but no callback is provided (MONGODB-OIDC)
+  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=PROVIDER_NAME:custom
   valid: false
   credential:
-- description: should throw an exception if neither deviceName nor callbacks specified
-    (MONGODB-OIDC)
+- description: should throw an exception if neither provider nor callbacks specified (MONGODB-OIDC)
   uri: mongodb://localhost/?authMechanism=MONGODB-OIDC
   valid: false
   credential:
-- description: should throw an exception when only refresh callback is specified (MONGODB-OIDC)
-  uri: mongodb://localhost/?authMechanism=MONGODB-OIDC
-  callback:
-  - oidcRefresh
-  valid: false
-  credential:
-- description: should throw an exception when unsupported auth property is specified
-    (MONGODB-OIDC)
+- description: should throw an exception when unsupported auth property is specified (MONGODB-OIDC)
   uri: mongodb://localhost/?authMechanism=MONGODB-OIDC&authMechanismProperties=UnsupportedProperty:unexisted
   valid: false
   credential: