Update doc on Parent window handle (Azure#38343)

* Update doc on Parent window handle

* update

* Update sdk/identity/azure-identity-broker/azure/identity/broker/_browser.py

Co-authored-by: Scott Addie <[email protected]>

* update

* update

* update sample

---------

Co-authored-by: Scott Addie <[email protected]>

Author: xiangyan99

sdk/identity/azure-identity-broker/README.md

@@ -23,9 +23,9 @@ pip install azure-identity-broker
 
 This package enables broker support via `InteractiveBrowserBrokerCredential`, which is a subclass of the Azure Identity library's [InteractiveBrowserCredential][ibc].
 
-### Parent window handles
+### Parent window handle
 
-When authenticating interactively via `InteractiveBrowserBrokerCredential`, a parent window handle is required to ensure that the authentication dialog is shown correctly over the requesting window. In the context of graphical user interfaces on devices, a window handle is a unique identifier that the operating system assigns to each window. For the Windows operating system, this handle is an integer value that serves as a reference to a specific window.
+When authenticating interactively via `InteractiveBrowserBrokerCredential`, a parent window handle is required to ensure that the authentication dialog is shown correctly over the requesting window. In the context of graphical user interfaces on devices, a window handle is a unique identifier that the operating system assigns to each window. For the Windows operating system, this handle is an integer value that serves as a reference to a specific window. On macOS, it is an integer-based identifier that represents and identifies a specific window instance.
 
 ## Microsoft account (MSA) passthrough
 
@@ -47,6 +47,7 @@ Microsoft Entra applications rely on redirect URIs to determine where to send th
 This example demonstrates using `InteractiveBrowserBrokerCredential` as a broker-enabled credential for authenticating with the `BlobServiceClient` from the [azure-storage-blob][azure_storage_blob] library. Here, the `win32gui` module from the `pywin32` package is used to get the current window.
 
 ```python
+# On Windows
 import win32gui
 from azure.identity.broker import InteractiveBrowserBrokerCredential
 from azure.storage.blob import BlobServiceClient
@@ -56,6 +57,16 @@ current_window_handle = win32gui.GetForegroundWindow()
 
 credential = InteractiveBrowserBrokerCredential(parent_window_handle=current_window_handle)
 client = BlobServiceClient(account_url, credential=credential)
+
+# On macOS
+import msal
+from azure.identity.broker import InteractiveBrowserBrokerCredential
+from azure.storage.blob import BlobServiceClient
+
+credential = InteractiveBrowserBrokerCredential(
+    parent_window_handle=msal.PublicClientApplication.CONSOLE_WINDOW_HANDLE
+)
+client = BlobServiceClient(account_url, credential=credential)
 ```
 
 To bypass the account selection dialog and use the default broker account, set the `use_default_broker_account` argument to `True`. The credential will attempt to silently use the default broker account. If using the default account fails, the credential will fall back to interactive authentication.

sdk/identity/azure-identity-broker/azure/identity/broker/_browser.py

@@ -52,8 +52,9 @@ class InteractiveBrowserBrokerCredential(_InteractiveBrowserCredential):
         may still log in with a different username.
     :paramtype cache_persistence_options: ~azure.identity.TokenCachePersistenceOptions
     :keyword int timeout: seconds to wait for the user to complete authentication. Defaults to 300 (5 minutes).
-    :keyword int parent_window_handle: If your app is a GUI app running on a modern Windows system, you are required to
-        also provide its window handle so that the sign in UI window will properly pop up on top of your window.
+    :keyword int parent_window_handle: If your app is a GUI app running on Windows 10+ or macOS, you
+        are required to also provide its window handle, so that the sign in UI window will properly pop up on top
+        of your window.
     :keyword bool use_default_broker_account: Enables automatically using the default broker account for
         authentication instead of prompting the user with an account picker. Defaults to False.
     :keyword bool enable_msa_passthrough: Determines whether Microsoft Account (MSA) passthrough is enabled. Note, this