microsoft-agents-authentication-msal 1.5.0.dev11__tar.gz → 1.6.1.dev1__tar.gz

{microsoft_agents_authentication_msal-1.5.0.dev11/microsoft_agents_authentication_msal.egg-info → microsoft_agents_authentication_msal-1.6.1.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-authentication-msal
-Version: 1.5.0.dev11
+Version: 1.6.1.dev1
 Summary: A msal-based authentication library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,8 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==1.5.0.dev11
+Requires-Dist: microsoft-agents-hosting-core==1.6.1.dev1
+Requires-Dist: azure-core
 Requires-Dist: msal>=1.34.0
 Requires-Dist: requests>=2.32.3
 Dynamic: license-file
@@ -38,6 +39,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.5.0</td>
+    <td>2026-08-26</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v150">
+        1.5.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
    <td>1.4.0</td>
    <td>2026-08-18</td>
@@ -231,6 +241,7 @@ class AuthTypes(str, Enum):
 
 - **`MsalAuth`** - Core authentication provider using MSAL
 - **`MsalConnectionManager`** - Manages multiple authentication connections
+- **`MsalTokenCredential`** - Asynchronous Azure Core token credential backed by MSAL
 
 ## Features
 

microsoft_agents_authentication_msal-1.6.1.dev1/VERSION.txt

@@ -0,0 +1 @@
+1.6.1.dev1

microsoft_agents_authentication_msal-1.6.1.dev1/microsoft_agents/authentication/msal/__init__.py

@@ -0,0 +1,12 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .msal_auth import MsalAuth
+from .msal_connection_manager import MsalConnectionManager
+from .msal_token_credential import MsalTokenCredential
+
+__all__ = [
+    "MsalAuth",
+    "MsalConnectionManager",
+    "MsalTokenCredential",
+]

{microsoft_agents_authentication_msal-1.5.0.dev11 → microsoft_agents_authentication_msal-1.6.1.dev1}/microsoft_agents/authentication/msal/msal_auth.py

@@ -6,6 +6,7 @@ from __future__ import annotations
 import re
 import asyncio
 import logging
+import time
 import jwt
 from typing import Optional
 from urllib.parse import urlparse, ParseResult as URI
@@ -16,6 +17,7 @@ from msal import (
     SystemAssignedManagedIdentity,
     TokenCache,
 )
+from azure.core.credentials import AccessToken
 from requests import Session
 
 from microsoft_agents.activity._utils import _DeferredString
@@ -73,6 +75,28 @@ class MsalAuth(AccessTokenProviderBase):
     async def get_access_token(
         self, resource_url: str, scopes: list[str], force_refresh: bool = False
     ) -> str:
+        """Gets an access token for the specified resource URL and scopes.
+
+        :param resource_url: The resource URL for which to acquire the access token.
+        :param scopes: The scopes for which the access token is requested.
+        :param force_refresh: Whether to force a refresh of the access token.
+        :return: The acquired access token as a string.
+        :rtype: str
+        """
+        access_token = await self._get_access_token(resource_url, scopes, force_refresh)
+        return access_token.token
+
+    async def _get_access_token(
+        self, resource_url: str, scopes: list[str], force_refresh: bool = False
+    ) -> AccessToken:
+        """Internal method to get an access token for the specified resource URL and scopes.
+
+        :param resource_url: The resource URL for which to acquire the access token.
+        :param scopes: The scopes for which the access token is requested.
+        :param force_refresh: Whether to force a refresh of the access token.
+        :return: The acquired access token as an AccessToken object.
+        :rtype: AccessToken
+        """
         with spans.GetAccessToken(
             scopes,
             self._msal_configuration.AUTH_TYPE,
@@ -99,7 +123,7 @@ class MsalAuth(AccessTokenProviderBase):
                     msal_auth_client, scopes=local_scopes
                 )
             else:
-                auth_result_payload = None
+                auth_result_payload = {}
 
             res = (
                 auth_result_payload.get("access_token") if auth_result_payload else None
@@ -114,7 +138,15 @@ class MsalAuth(AccessTokenProviderBase):
                     )
                 )
 
-            return res
+            expires_on = auth_result_payload.get("expires_on")
+            if expires_on is not None:
+                return AccessToken(res, int(expires_on))
+
+            expires_in = auth_result_payload.get("expires_in")
+            if expires_in is None:
+                raise ValueError("Token response does not include an expiration.")
+
+            return AccessToken(res, int(time.time()) + int(expires_in))
 
     async def acquire_token_on_behalf_of(
         self, scopes: list[str], user_assertion: str
@@ -186,6 +218,11 @@ class MsalAuth(AccessTokenProviderBase):
     def _resolve_azure_region(config: AgentAuthConfiguration) -> str | None:
         """Resolves the Azure regional token service (ESTS-R) to use, if configured.
 
+        :param config: The agent authentication configuration.
+        :type config: :class:`microsoft_agents.hosting.core.AgentAuthConfiguration`
+        :return: The resolved Azure region or None if not configured.
+        :rtype: str | None
+
         Returns the configured region only when it is populated and non-whitespace,
         otherwise None so that MSAL falls back to the global token service.
         """

microsoft_agents_authentication_msal-1.6.1.dev1/microsoft_agents/authentication/msal/msal_token_credential.py

@@ -0,0 +1,58 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+import logging
+
+from azure.core.credentials import AccessToken
+from azure.core.credentials_async import AsyncTokenCredential
+
+from microsoft_agents.hosting.core import AgentAuthConfiguration
+
+from .msal_auth import MsalAuth
+
+logger = logging.getLogger(__name__)
+
+
+def _get_resource(scope: str) -> str:
+    """Extracts the resource by removing a trailing '/.default' from the scope.
+
+    :param scope: The scope string.
+    :return: The extracted resource string.
+    :rtype: str
+    """
+    return scope.removesuffix("/.default")
+
+
+class MsalTokenCredential(AsyncTokenCredential):
+    """Provides an asynchronous Azure Core token credential using MSAL."""
+
+    def __init__(self, config: AgentAuthConfiguration):
+        """Initializes the MsalTokenCredential with the given configuration.
+
+        :param config: The agent authentication configuration.
+        :type config: :class:`microsoft_agents.hosting.core.AgentAuthConfiguration`
+        """
+        self._config = config
+        self._provider: MsalAuth | None = None
+
+    async def get_token(self, *scopes: str, **kwargs) -> AccessToken:
+        """Acquire an access token for the specified scopes.
+
+        :param scopes: The scopes for which the access token is requested.
+        :param kwargs: Additional keyword arguments.
+
+        :return: The acquired access token.
+        :rtype: AccessToken
+        """
+
+        logger.debug("get_token scope=%s", scopes)
+
+        if not scopes:
+            raise ValueError("At least one scope must be provided.")
+
+        if not self._provider:
+            self._provider = MsalAuth(self._config)
+
+        resource = _get_resource(scopes[0])
+
+        return await self._provider._get_access_token(resource, list(scopes))

{microsoft_agents_authentication_msal-1.5.0.dev11 → microsoft_agents_authentication_msal-1.6.1.dev1/microsoft_agents_authentication_msal.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-authentication-msal
-Version: 1.5.0.dev11
+Version: 1.6.1.dev1
 Summary: A msal-based authentication library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,8 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==1.5.0.dev11
+Requires-Dist: microsoft-agents-hosting-core==1.6.1.dev1
+Requires-Dist: azure-core
 Requires-Dist: msal>=1.34.0
 Requires-Dist: requests>=2.32.3
 Dynamic: license-file
@@ -38,6 +39,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.5.0</td>
+    <td>2026-08-26</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v150">
+        1.5.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
    <td>1.4.0</td>
    <td>2026-08-18</td>
@@ -231,6 +241,7 @@ class AuthTypes(str, Enum):
 
 - **`MsalAuth`** - Core authentication provider using MSAL
 - **`MsalConnectionManager`** - Manages multiple authentication connections
+- **`MsalTokenCredential`** - Asynchronous Azure Core token credential backed by MSAL
 
 ## Features
 

{microsoft_agents_authentication_msal-1.5.0.dev11 → microsoft_agents_authentication_msal-1.6.1.dev1}/microsoft_agents_authentication_msal.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ setup.py
 microsoft_agents/authentication/msal/__init__.py
 microsoft_agents/authentication/msal/msal_auth.py
 microsoft_agents/authentication/msal/msal_connection_manager.py
+microsoft_agents/authentication/msal/msal_token_credential.py
 microsoft_agents/authentication/msal/py.typed
 microsoft_agents/authentication/msal/errors/__init__.py
 microsoft_agents/authentication/msal/errors/error_resources.py

microsoft_agents_authentication_msal-1.6.1.dev1/microsoft_agents_authentication_msal.egg-info/requires.txt

@@ -0,0 +1,4 @@
+microsoft-agents-hosting-core==1.6.1.dev1
+azure-core
+msal>=1.34.0
+requests>=2.32.3

{microsoft_agents_authentication_msal-1.5.0.dev11 → microsoft_agents_authentication_msal-1.6.1.dev1}/readme.md

@@ -15,6 +15,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.5.0</td>
+    <td>2026-08-26</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v150">
+        1.5.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
    <td>1.4.0</td>
    <td>2026-08-18</td>
@@ -208,6 +217,7 @@ class AuthTypes(str, Enum):
 
 - **`MsalAuth`** - Core authentication provider using MSAL
 - **`MsalConnectionManager`** - Manages multiple authentication connections
+- **`MsalTokenCredential`** - Asynchronous Azure Core token credential backed by MSAL
 
 ## Features
 

{microsoft_agents_authentication_msal-1.5.0.dev11 → microsoft_agents_authentication_msal-1.6.1.dev1}/setup.py

@@ -13,6 +13,7 @@ setup(
     version=package_version,
     install_requires=[
         f"microsoft-agents-hosting-core=={package_version}",
+        "azure-core",
         "msal>=1.34.0",
         "requests>=2.32.3",
     ],

microsoft_agents_authentication_msal-1.5.0.dev11/VERSION.txt

@@ -1 +0,0 @@
-1.5.0.dev11

microsoft_agents_authentication_msal-1.5.0.dev11/microsoft_agents/authentication/msal/__init__.py

@@ -1,7 +0,0 @@
-from .msal_auth import MsalAuth
-from .msal_connection_manager import MsalConnectionManager
-
-__all__ = [
-    "MsalAuth",
-    "MsalConnectionManager",
-]

microsoft_agents_authentication_msal-1.5.0.dev11/microsoft_agents_authentication_msal.egg-info/requires.txt

@@ -1,3 +0,0 @@
-microsoft-agents-hosting-core==1.5.0.dev11
-msal>=1.34.0
-requests>=2.32.3