通过

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

使用访问密钥进行身份验证

  • 项目

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

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

警告

以明文形式存储帐户访问密钥或连接字符串会带来安全风险，不建议这样做。 以加密格式存储帐户密钥，或迁移应用程序以使用Microsoft Entra授权访问 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 门户中管理 Azure Quantum 工作区的访问密钥和连接字符串。

启用和禁用访问密钥

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

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

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

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

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

重要

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

重新生成新的访问密钥

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

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

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

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

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

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

    提示

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