你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ClientAssertionCredential 类

  • 参考

使用 JWT 断言对服务主体进行身份验证。

此凭据适用于高级方案。 CertificateCredential 对于最常见的断言方案，具有更方便的 API，使用证书对服务主体进行身份验证。

继承
azure.identity.aio._internal.AsyncContextManager
ClientAssertionCredential
azure.identity.aio._internal.get_token_mixin.GetTokenMixin
ClientAssertionCredential

构造函数

ClientAssertionCredential(tenant_id: str, client_id: str, func: Callable[[], str], **kwargs: Any)

参数

tenant_id
str
必需

主体租户的 ID。 也称为其“目录”ID。

client_id
str
必需

主体的客户端 ID

func
必需

返回字符串断言的可调用项。 每次获取新令牌时，凭据都会调用它。

authority
str

Azure Active Directory 终结点的颁发机构，例如“login.microsoftonline.com”，即 Azure 公有云 (的颁发机构，这是默认) 。 AzureAuthorityHosts 定义其他云的颁发机构。

additionally_allowed_tenants
List[str]

除了指定凭据可能为其获取令牌的指定“tenant_id”之外，还指定租户。 添加通配符值“*”以允许凭据为应用程序可以访问的任何租户获取令牌。

示例

创建 ClientAssertionCredential。


   from azure.identity.aio import ClientAssertionCredential

   def get_assertion():
       return "<client-assertion>"

   credential = ClientAssertionCredential(
       tenant_id="<tenant_id>",
       client_id="<client_id>",
       func=get_assertion,
   )

方法

close

关闭凭据的传输会话。
get_token

请求 范围的访问令牌。

此方法由 Azure SDK 客户端自动调用。

close

关闭凭据的传输会话。

async close() -> None

get_token

请求 范围的访问令牌。

此方法由 Azure SDK 客户端自动调用。

async get_token(*scopes: str, claims: str | None = None, tenant_id: str | None = None, **kwargs: Any) -> AccessToken

参数

scopes
str
必需

访问令牌的所需范围。 此方法至少需要一个范围。 有关范围的详细信息，请参阅 https://learn.microsoft.com/azure/active-directory/develop/scopes-oidc。

claims
str

令牌中所需的其他声明，例如授权失败后资源提供程序的声明质询中返回的声明。

tenant_id
str

要包含在令牌请求中的可选租户。

enable_cae
bool

指示是否为请求的令牌启用持续访问评估 (CAE) 。 默认为 False。

返回

具有所需范围的访问令牌。

返回类型

AccessToken

例外

CredentialUnavailableError

凭据无法尝试身份验证，因为它缺少所需的数据、状态或平台支持

ClientAuthenticationError

身份验证失败。 错误的 message 属性提供了一个原因。