Decision log of Identity

.vscode/cspell.json

@@ -355,6 +355,7 @@
     "nbytes",
     "Nify",
     "noarch",
+    "nocae",
     "NOPERM",
     "norecursedirs",
     "northcentralus",
@@ -431,6 +432,7 @@
     "Rohit",
     "rohitganguly",
     "rollup",
+    "ROPC",
     "RSNULL",
     "rtsp",
     "rtype",

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

@@ -0,0 +1,31 @@
+```py
+namespace azure.identity.broker
+
+    class azure.identity.broker.InteractiveBrowserBrokerCredential(_InteractiveBrowserCredential):
+
+        def __init__(
+                self, 
+                *, 
+                authority: Optional[str] = ..., 
+                cache_persistence_options: TokenCachePersistenceOptions = ..., 
+                client_id: Optional[str] = ..., 
+                disable_instance_discovery: Optional[bool] = ..., 
+                enable_msa_passthrough: Optional[bool] = ..., 
+                enable_support_logging: Optional[bool] = ..., 
+                login_hint: Optional[str] = ..., 
+                parent_window_handle: Optional[int] = ..., 
+                tenant_id: Optional[str] = ..., 
+                timeout: Optional[int] = ..., 
+                use_default_broker_account: Optional[bool] = ..., 
+                **kwargs: Any
+            ) -> None: ...
+
+
+    class azure.identity.broker.PopTokenRequestOptions(TokenRequestOptions):
+        key "claims": str
+        key "enable_cae": bool
+        key "pop": Union[bool, Mapping[str, str]]
+        key "tenant_id": str
+
+
+```

sdk/identity/azure-identity-broker/api.metadata.yml

@@ -0,0 +1,3 @@
+apiMdSha256: 9cca2af14c2e083cfbafcab35f48dba2c747cfc91f23a7fa4e8cc3c729694a61
+parserVersion: 0.3.30
+pythonVersion: 3.10.18

sdk/identity/azure-identity/README.md

@@ -256,6 +256,8 @@ If you encounter bugs or have suggestions, [open an issue](https://github.com/Az
 
 ## Contributing
 
+For deeper context on why the library is designed the way it is, see the [architecture decision log](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/identity/azure-identity/design-decisions.md), a chronological record of key design decisions and the reasoning behind them.
+
 This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit [https://cla.microsoft.com](https://cla.microsoft.com).
 
 When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You'll only need to do this once across all repos using our CLA.