-
Notifications
You must be signed in to change notification settings - Fork 2.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Separate modules for client credential types (#11496)
- Loading branch information
Showing
8 changed files
with
123 additions
and
94 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
52 changes: 52 additions & 0 deletions
52
sdk/identity/azure-identity/azure/identity/_credentials/certificate.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,52 @@ | ||
# ------------------------------------ | ||
# Copyright (c) Microsoft Corporation. | ||
# Licensed under the MIT License. | ||
# ------------------------------------ | ||
from typing import TYPE_CHECKING | ||
|
||
from .._authn_client import AuthnClient | ||
from .._base import CertificateCredentialBase | ||
|
||
if TYPE_CHECKING: | ||
from azure.core.credentials import AccessToken | ||
from typing import Any | ||
|
||
|
||
class CertificateCredential(CertificateCredentialBase): | ||
"""Authenticates as a service principal using a certificate. | ||
:param str tenant_id: ID of the service principal's tenant. Also called its 'directory' ID. | ||
:param str client_id: the service principal's client ID | ||
:param str certificate_path: path to a PEM-encoded certificate file including the private key. | ||
:keyword str authority: Authority of an Azure Active Directory endpoint, for example 'login.microsoftonline.com', | ||
the authority for Azure Public Cloud (which is the default). :class:`~azure.identity.KnownAuthorities` | ||
defines authorities for other clouds. | ||
:keyword password: The certificate's password. If a unicode string, it will be encoded as UTF-8. If the certificate | ||
requires a different encoding, pass appropriately encoded bytes instead. | ||
:paramtype password: str or bytes | ||
""" | ||
|
||
def get_token(self, *scopes, **kwargs): # pylint:disable=unused-argument | ||
# type: (*str, **Any) -> AccessToken | ||
"""Request an access token for `scopes`. | ||
.. note:: This method is called by Azure SDK clients. It isn't intended for use in application code. | ||
:param str scopes: desired scopes for the access token. This method requires at least one scope. | ||
:rtype: :class:`azure.core.credentials.AccessToken` | ||
:raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The error's ``message`` | ||
attribute gives a reason. Any error response from Azure Active Directory is available as the error's | ||
``response`` attribute. | ||
""" | ||
if not scopes: | ||
raise ValueError("'get_token' requires at least one scope") | ||
|
||
token = self._client.get_cached_token(scopes) | ||
if not token: | ||
data = self._get_request_data(*scopes) | ||
token = self._client.request_token(scopes, form_data=data) | ||
return token | ||
|
||
def _get_auth_client(self, tenant_id, **kwargs): | ||
return AuthnClient(tenant=tenant_id, **kwargs) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
59 changes: 59 additions & 0 deletions
59
sdk/identity/azure-identity/azure/identity/aio/_credentials/client_secret.py
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
# ------------------------------------ | ||
# Copyright (c) Microsoft Corporation. | ||
# Licensed under the MIT License. | ||
# ------------------------------------ | ||
from typing import TYPE_CHECKING | ||
|
||
from .base import AsyncCredentialBase | ||
from .._authn_client import AsyncAuthnClient | ||
from ..._base import ClientSecretCredentialBase | ||
|
||
if TYPE_CHECKING: | ||
from typing import Any | ||
from azure.core.credentials import AccessToken | ||
|
||
|
||
class ClientSecretCredential(ClientSecretCredentialBase, AsyncCredentialBase): | ||
"""Authenticates as a service principal using a client ID and client secret. | ||
:param str tenant_id: ID of the service principal's tenant. Also called its 'directory' ID. | ||
:param str client_id: the service principal's client ID | ||
:param str client_secret: one of the service principal's client secrets | ||
:keyword str authority: Authority of an Azure Active Directory endpoint, for example 'login.microsoftonline.com', | ||
the authority for Azure Public Cloud (which is the default). :class:`~azure.identity.KnownAuthorities` | ||
defines authorities for other clouds. | ||
""" | ||
|
||
def __init__(self, tenant_id: str, client_id: str, client_secret: str, **kwargs: "Any") -> None: | ||
super(ClientSecretCredential, self).__init__(tenant_id, client_id, client_secret, **kwargs) | ||
self._client = AsyncAuthnClient(tenant=tenant_id, **kwargs) | ||
|
||
async def __aenter__(self): | ||
await self._client.__aenter__() | ||
return self | ||
|
||
async def close(self): | ||
"""Close the credential's transport session.""" | ||
|
||
await self._client.__aexit__() | ||
|
||
async def get_token(self, *scopes: str, **kwargs: "Any") -> "AccessToken": # pylint:disable=unused-argument | ||
"""Asynchronously request an access token for `scopes`. | ||
.. note:: This method is called by Azure SDK clients. It isn't intended for use in application code. | ||
:param str scopes: desired scopes for the access token. This method requires at least one scope. | ||
:rtype: :class:`azure.core.credentials.AccessToken` | ||
:raises ~azure.core.exceptions.ClientAuthenticationError: authentication failed. The error's ``message`` | ||
attribute gives a reason. Any error response from Azure Active Directory is available as the error's | ||
``response`` attribute. | ||
""" | ||
if not scopes: | ||
raise ValueError("'get_token' requires at least one scope") | ||
|
||
token = self._client.get_cached_token(scopes) | ||
if not token: | ||
data = dict(self._form_data, scope=" ".join(scopes)) | ||
token = await self._client.request_token(scopes, form_data=data) | ||
return token # type: ignore |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters