通过

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

使用访问密钥在工作区中进行身份验证

  • 项目

访问密钥用于对 Azure Quantum 工作区的访问权限进行身份验证和授权。 可以使用访问密钥通过连接字符串连接和授予对工作区的访问权限。

本文介绍如何启用或禁用 Azure Quantum 工作区的访问密钥。 还可以重新生成新密钥，以确保工作区的安全性。

警告

以明文形式存储帐户访问密钥或连接字符串会带来安全风险，不建议这样做。 以加密格式存储帐户密钥，或迁移应用程序以使用 Microsoft Entra 授权访问 Azure Quantum 工作区。

先决条件

使用连接字符串连接到 Azure Quantum 工作区

该 azure-quantum 包提供表示 Workspace Azure Quantum 工作区的类 。 若要连接到 Azure Quantum 工作区，请使用连接字符串作为验证器创建Workspace对象。 有关详细信息，请参阅如何复制连接字符串。

创建 Workspace 对象时，有两个选项用于标识 Azure Quantum 工作区。

  • 可以通过调用from_connection_string创建对象Workspace。

    # Creating a new Workspace object from a connection string 
from azure.quantum import Workspace 

connection_string = "[Copy connection string]" 
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • 如果不想在代码中复制连接字符串，还可以将连接字符串存储在环境变量中并使用Workspace()。

    # Using environment variable to connect with  connection string

connection_string = "[Copy connection string]" 

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

from azure.quantum import Workspace 

workspace = Workspace() 
print(workspace.get_targets())

管理访问密钥和连接字符串

提示

每个 Azure Quantum 工作区都有主密钥和辅助密钥及其相应的连接字符串。 如果希望允许他人访问工作区，可以共享辅助密钥，并将主密钥用于自己的服务。 这样，就可以根据需要替换辅助密钥，而无需在自己的服务中停机。 有关共享工作区访问权限的详细信息，请参阅 “共享工作区访问权限”。

可以在Azure 门户中管理 Azure Quantum 工作区的访问密钥和连接字符串。

启用和禁用访问密钥

  1. 登录到 Azure 门户并选择你的 Azure Quantum 工作区。

  2. 在左侧面板中，导航到 “操作 > 访问”键。

  3. 将“访问密钥”下的开关切换为“启用或禁用”。

  4. 单击 “保存” 保存更改。

    显示如何启用访问密钥以使用连接字符串的Azure 门户的屏幕截图。

重要

禁用访问密钥后，使用连接字符串或访问密钥的所有请求均未经授权。 你仍然可以使用工作区参数连接到工作区。

重新生成新的访问密钥

如果怀疑访问密钥已泄露，或者想要停止与他人共享工作区访问权限，则可以重新生成主访问密钥或辅助访问密钥，以确保工作区的安全性。

  1. 登录到 Azure 门户并选择你的 Azure Quantum 工作区。

  2. 在左侧面板中，导航到 “操作 > 访问”键。

  3. 必须启用访问密钥 才能重新生成新密钥。 如果禁用访问密钥，则需要先启用它们。

  4. 单击圆形箭头图标以重新生成主密钥或辅助密钥。

    显示如何重新生成主访问密钥和辅助访问密钥的Azure 门户屏幕截图。