CI Update

 Build.Reason:Schedule
 Build.Url:https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=510570&view=results

Author: [email protected]

python/docs-ref-autogen/msal/msal.application.ClientApplication.yml

@@ -231,14 +231,15 @@ constructor:
   - name: azure_region
     description: "(optional)\nInstructs MSAL to use the Entra regional token service.\
       \ This legacy feature is only available to\nfirst-party applications. Only `acquire_token_for_client()`\
-      \ is supported.\n\nSupports 3 values:\n\n   `azure_region=None` - meaning no\
-      \ region is used. This is the default value.\n   `azure_region=\"some_region\"\
-      ` - meaning the specified region is used.\n   `azure_region=True` - meaning\
-      \ MSAL will try to auto-detect the region. This is not recommended.\n\n\n> [!NOTE]\n\
-      > Region auto-discovery has been tested on VMs and on Azure Functions. It is\
-      \ unreliable.\n>\n> Applications using this option should configure a short\
-      \ timeout.\n>\n> \n>\n> For more details and for the values of the region string\n\
-      >\n> \n>\n> see [https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting](https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting)\n\
+      \ is supported.\n\nSupports 4 values:\n\n1. `azure_region=None` - This default\
+      \ value means no region is configured. MSAL will use the region defined in env\
+      \ var `MSAL_FORCE_REGION`. \n\n2. `azure_region=\"some_region\"` - meaning the\
+      \ specified region is used. \n\n3. `azure_region=True` - meaning MSAL will try\
+      \ to auto-detect the region. This is not recommended. \n\n4. `azure_region=False`\
+      \ - meaning MSAL will use no region. \n\n\n> [!NOTE]\n> Region auto-discovery\
+      \ has been tested on VMs and on Azure Functions. It is unreliable.\n>\n> Applications\
+      \ using this option should configure a short timeout.\n>\n> \n>\n> For more\
+      \ details and for the values of the region string\n>\n> \n>\n> see [https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting](https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting)\n\
       >\n\nNew in version 1.12.0."
     defaultValue: None
     types:
@@ -958,6 +959,9 @@ attributes:
 - uid: msal.application.ClientApplication.ATTEMPT_REGION_DISCOVERY
   name: ATTEMPT_REGION_DISCOVERY
   signature: ATTEMPT_REGION_DISCOVERY = True
+- uid: msal.application.ClientApplication.DISABLE_MSAL_FORCE_REGION
+  name: DISABLE_MSAL_FORCE_REGION
+  signature: DISABLE_MSAL_FORCE_REGION = False
 - uid: msal.application.ClientApplication.GET_ACCOUNTS_ID
   name: GET_ACCOUNTS_ID
   signature: GET_ACCOUNTS_ID = '902'

python/docs-ref-autogen/msal/msal.application.ConfidentialClientApplication.yml

@@ -231,14 +231,15 @@ constructor:
   - name: azure_region
     description: "(optional)\nInstructs MSAL to use the Entra regional token service.\
       \ This legacy feature is only available to\nfirst-party applications. Only `acquire_token_for_client()`\
-      \ is supported.\n\nSupports 3 values:\n\n   `azure_region=None` - meaning no\
-      \ region is used. This is the default value.\n   `azure_region=\"some_region\"\
-      ` - meaning the specified region is used.\n   `azure_region=True` - meaning\
-      \ MSAL will try to auto-detect the region. This is not recommended.\n\n\n> [!NOTE]\n\
-      > Region auto-discovery has been tested on VMs and on Azure Functions. It is\
-      \ unreliable.\n>\n> Applications using this option should configure a short\
-      \ timeout.\n>\n> \n>\n> For more details and for the values of the region string\n\
-      >\n> \n>\n> see [https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting](https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting)\n\
+      \ is supported.\n\nSupports 4 values:\n\n1. `azure_region=None` - This default\
+      \ value means no region is configured. MSAL will use the region defined in env\
+      \ var `MSAL_FORCE_REGION`. \n\n2. `azure_region=\"some_region\"` - meaning the\
+      \ specified region is used. \n\n3. `azure_region=True` - meaning MSAL will try\
+      \ to auto-detect the region. This is not recommended. \n\n4. `azure_region=False`\
+      \ - meaning MSAL will use no region. \n\n\n> [!NOTE]\n> Region auto-discovery\
+      \ has been tested on VMs and on Azure Functions. It is unreliable.\n>\n> Applications\
+      \ using this option should configure a short timeout.\n>\n> \n>\n> For more\
+      \ details and for the values of the region string\n>\n> \n>\n> see [https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting](https://learn.microsoft.com/entra/msal/dotnet/resources/region-discovery-troubleshooting)\n\
       >\n\nNew in version 1.12.0."
     defaultValue: None
     types:

python/docs-ref-autogen/msal/msal.application.PublicClientApplication.yml

@@ -40,7 +40,8 @@ summary: "Same as <xref:ClientApplication.__init__>,\nexcept that `client_creden
   \ when broker is opted in, installed, initialized,\n>\n> but subsequent token request(s)\
   \ failed.\n>"
 constructor:
-  syntax: PublicClientApplication(client_id, client_credential=None, **kwargs)
+  syntax: PublicClientApplication(client_id, client_credential=None, *, enable_broker_on_windows=None,
+    enable_broker_on_mac=None, **kwargs)
   parameters:
   - name: enable_broker_on_windows
     description: 'This setting is only effective if your app is running on Windows
@@ -67,6 +68,11 @@ constructor:
     isRequired: true
   - name: client_credential
     defaultValue: None
+  keywordOnlyParameters:
+  - name: enable_broker_on_windows
+    isRequired: true
+  - name: enable_broker_on_mac
+    isRequired: true
 methods:
 - uid: msal.application.PublicClientApplication.acquire_token_by_device_flow
   name: acquire_token_by_device_flow

python/docs-ref-autogen/msal/msal.managed_identity.ManagedIdentityClient.yml

@@ -22,15 +22,15 @@ summary: "This API encapsulates multiple managed identity back-ends:\nVM, App Se
   Recipe 2: Write once, run everywhere.\nIf you use different managed identity on\
   \ different deployment,\nyou may use an environment variable (such as MY_MANAGED_IDENTITY_CONFIG)\n\
   to store a json blob like\n`{\"ManagedIdentityIdType\": \"ClientId\", \"Id\": \"\
-  foo\"}` or\n`{\"ManagedIdentityIdType\": \"SystemAssignedManagedIdentity\", \"Id\"\
-  : null})`.\nThe following app can load managed identity configuration dynamically:\n\
-  \n<!-- literal_block {\"ids\": [], \"classes\": [], \"names\": [], \"dupnames\"\
-  : [], \"backrefs\": [], \"xml:space\": \"preserve\", \"language\": \"default\",\
-  \ \"force\": false, \"linenos\": false} -->\n\n````default\n\n   import json, os,\
-  \ msal, requests\n   config = os.getenv(\"MY_MANAGED_IDENTITY_CONFIG\")\n   assert\
-  \ config, \"An ENV VAR with value should exist\"\n   client = msal.ManagedIdentityClient(\n\
-  \       json.loads(config),\n       http_client=requests.Session(),\n       )\n\
-  \   token = client.acquire_token_for_client(\"resource\")\n   ````"
+  foo\"}` or\n`{\"ManagedIdentityIdType\": \"SystemAssigned\", \"Id\": null}`.\nThe\
+  \ following app can load managed identity configuration dynamically:\n\n<!-- literal_block\
+  \ {\"ids\": [], \"classes\": [], \"names\": [], \"dupnames\": [], \"backrefs\":\
+  \ [], \"xml:space\": \"preserve\", \"language\": \"default\", \"force\": false,\
+  \ \"linenos\": false} -->\n\n````default\n\n   import json, os, msal, requests\n\
+  \   config = os.getenv(\"MY_MANAGED_IDENTITY_CONFIG\")\n   assert config, \"An ENV\
+  \ VAR with value should exist\"\n   client = msal.ManagedIdentityClient(\n     \
+  \  json.loads(config),\n       http_client=requests.Session(),\n       )\n   token\
+  \ = client.acquire_token_for_client(\"resource\")\n   ````"
 constructor:
   syntax: 'ManagedIdentityClient(managed_identity: dict | ManagedIdentity | SystemAssignedManagedIdentity
     | UserAssignedManagedIdentity, *, http_client, token_cache=None, http_cache=None)'

python/docs-ref-autogen/msal/msal.sku.yml

@@ -0,0 +1,5 @@
+### YamlMime:PythonModule
+uid: msal.sku
+name: sku
+fullName: msal.sku
+summary: This module is from where we recieve the client sku name and version.

python/docs-ref-autogen/msal/msal.token_cache.TokenCache.yml

@@ -26,14 +26,17 @@ methods:
 - uid: msal.token_cache.TokenCache.find
   name: find
   summary: Equivalent to list(search(...)).
-  signature: find(credential_type, target=None, query=None)
+  signature: find(credential_type, target=None, query=None, *, now=None)
   parameters:
   - name: credential_type
     isRequired: true
   - name: target
     defaultValue: None
   - name: query
     defaultValue: None
+  keywordOnlyParameters:
+  - name: now
+    isRequired: true
 - uid: msal.token_cache.TokenCache.modify
   name: modify
   signature: modify(credential_type, old_entry, new_key_value_pairs=None)
@@ -76,14 +79,17 @@ methods:
     It is O(1) for AT hits, and O(n) for other types.
 
     Note that it holds a lock during the entire search.'
-  signature: search(credential_type, target=None, query=None)
+  signature: search(credential_type, target=None, query=None, *, now=None)
   parameters:
   - name: credential_type
     isRequired: true
   - name: target
     defaultValue: None
   - name: query
     defaultValue: None
+  keywordOnlyParameters:
+  - name: now
+    isRequired: true
 - uid: msal.token_cache.TokenCache.update_rt
   name: update_rt
   signature: update_rt(rt_item, new_rt)

python/docs-ref-autogen/msal/msal.yml

@@ -7,4 +7,5 @@ modules:
 - msal.application
 - msal.auth_scheme
 - msal.managed_identity
+- msal.sku
 - msal.token_cache

python/docs-ref-autogen/toc.yml

@@ -33,6 +33,8 @@
     - name: UserAssignedManagedIdentity
       uid: msal.managed_identity.UserAssignedManagedIdentity
     name: managed_identity
+  - name: sku
+    uid: msal.sku
   - items:
     - name: Overview
       uid: msal.token_cache