IA feedback

Author: stephmarie17

source/fundamentals/enterprise-auth.txt

@@ -213,7 +213,7 @@ the values of the ``expires`` and ``refresh_token`` fields.
    :dedent:
    :start-after: start-custom-callback-machine
    :end-before: end-custom-callback-machine
-   :emphasize-lines: 3, 5-10
+   :emphasize-lines: 3, 5-7
 
 When the workforce identity authentication process involves human interaction,
 you must configure the client by setting the ``oidc_callback`` field of your
@@ -227,16 +227,18 @@ following process:
    potential ``refresh_token`` and timeout values, if configured, then returns
    them.
 
-The following example defines a custom callback to handle workforce identity.
-The callback retrieves the IDPInfo for the provided username and negotiates with
-the IDP to obtain the necessary tokens:
+The following example defines a custom callback to handle workforce identity. To
+customize this example for your use case, replace ``<human flow>`` with your own
+custom flow. Refer to `Authorization Code Flow with OIDC
+<https://auth0.com/docs/authenticate/login/oidc-conformant-authentication/oidc-adoption-auth-code-flow>`__
+for more details.
 
 .. literalinclude:: /includes/fundamentals/code-snippets/enterprise-auth.rs
    :language: rust
    :dedent:
    :start-after: start-custom-callback-user
    :end-before: end-custom-callback-user
-   :emphasize-lines: 3-7, 12
+   :emphasize-lines: 3
 
 Additional Information
 ----------------------

source/includes/fundamentals/code-snippets/enterprise-auth.rs

@@ -30,10 +30,9 @@ async fn main() -> mongodb::error::Result<()> {
         .username("<username>".to_owned())
         .mechanism(AuthMechanism::MongoDbOidc)
         .mechanism_properties(
-            doc! {"ENVIRONMENT": "azure", "TOKEN_RESOURCE": "<audience>"}
+            doc! { "ENVIRONMENT": "azure", "TOKEN_RESOURCE": "<audience>" }
         )
-        .build()
-        .into();
+        .build();
 
     client_options.credential = Some(credential);
     let client = Client::with_options(client_options)?;
@@ -48,10 +47,9 @@ async fn main() -> mongodb::error::Result<()> {
     let credential = Credential::builder()
         .mechanism(AuthMechanism::MongoDbOidc)
         .mechanism_properties(
-            doc! {"ENVIRONMENT": "gcp", "TOKEN_RESOURCE": "<audience>"}
+            doc! { "ENVIRONMENT": "gcp", "TOKEN_RESOURCE": "<audience>" }
         )
-        .build()
-        .into();
+        .build();
 
     client_options.credential = Some(credential);
     let client = Client::with_options(client_options)?;
@@ -87,23 +85,25 @@ async fn main() -> mongodb::error::Result<()> {
     // end-custom-callback-machine
 
     // start-custom-callback-user
-    async fn cb(params: CallbackContext) -> mongodb::error::Result<IdpServerResponse> {
-	    let idp_info = params.idp_info.ok_or(Error::NoIDPInfo)?;
-        let (access_token, expires, refresh_token) = negotiate_with_idp(ctx, idpInfo.Issuer).await?;
-	        Ok(IdpServerResponse::builder().access_token(access_token).expires(expires).refresh_token(refresh_token).build())
-    }
-    client_options.credential = Credential::builder()
-            .mechanism(AuthMechanism::MongoDbOidc)
-            .oidc_callback(oidc::Callback::human(move|c| {
-                 async move { cb(c).await }.boxed()
-            }))
-            .build()
-            .into();
+    let callback = Callback::human(move |context| {
+        async move {
+            "<human flow>"
+            todo!()
+        }
+        .boxed()
+    });
+    let credential = Credential::builder()
+        .mechanism(AuthMechanism::MongoDbOidc)
+        .oidc_callback(callback)
+        .build();
+    client_options.credential = Some(credential);
+    let client = Client::with_options(client_options)?;
+    
     let res = client
             .database("test")
             .collection::<Document>("test")
             .find_one(doc! {})
-            .await;
+            .await?;
     // end-custom-callback-user
 
     Ok(())