アクセス キーを使用した認証

  • [アーティクル]

アクセス キーは、Azure Quantum ワークスペースへのアクセスを認証および承認するために使用されます。 アクセス キーを使用して、接続文字列を使用してワークスペースに接続し、アクセス権を付与できます。

この記事では、Azure Quantum ワークスペースのアクセス キーを有効または無効にする方法について説明します。 新しいキーを再生成して、ワークスペースのセキュリティを確保することもできます。

警告

アカウント アクセス キーまたは接続文字列をクリア テキストに格納すると、セキュリティ上のリスクが発生するためお勧めしません。 暗号化された形式でアカウント キーを格納するか、Azure Quantum ワークスペースへのアクセスにMicrosoft Entra承認を使用するようにアプリケーションを移行します。

前提条件

接続文字列を使用して接続する

パッケージにはazure-quantum、WorkspaceAzure Quantum ワークスペースを表すクラスが用意されています。 Azure Quantum ワークスペースに接続するには、接続文字列を認証子として使用してオブジェクトを作成Workspaceします。 詳細については、「接続文字列をコピーする方法」を参照してください。

オブジェクトを Workspace 作成するときは、Azure Quantum ワークスペースを識別するための 2 つのオプションがあります。

  • オブジェクトは、 を Workspace 呼び出 from_connection_stringすことで作成できます。

    # 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 portalで Azure Quantum ワークスペースのアクセス キーと接続文字列を管理できます。

アクセス キーを有効または無効にする

  1. Azure portal にログインし、Azure Quantum ワークスペースを選択します。

  2. 左側のパネルで、[操作アクセス キー] >に移動します。

  3. [アクセス キー] のトグルを [有効] または [無効] に切り替えます。

  4. [ 保存 ] をクリックして変更を保存します。

    アクセス キーで接続文字列を使用できるようにする方法を示すAzure portalのスクリーンショット。

重要

アクセス キーが 無効になっている場合、接続文字列またはアクセス キーを使用するすべての要求は承認されていません。 引き続きワークスペース パラメーターを使用して、ワークスペースに接続できます。

新しいアクセス キーを再生成する

アクセス キーが侵害されたと思われる場合、または他のユーザーとワークスペースアクセスの共有を停止したい場合は、プライマリまたはセカンダリのアクセス キー、またはその両方を再生成して、ワークスペースのセキュリティを確保できます。

  1. Azure portal にログインし、Azure Quantum ワークスペースを選択します。

  2. 左側のパネルで、[操作アクセス キー] >に移動します。

  3. 新しいキーを再生成するには、アクセス キーを有効にする必要があります。 アクセス キーが無効になっている場合は、まずそれらを有効にする必要があります。

  4. 循環矢印アイコンをクリックして、主キーまたはセカンダリ キーを再生成します。

    プライマリ アクセス キーとセカンダリ アクセス キーを再生成する方法を示すAzure portalのスクリーンショット。

    ヒント

    すべての Azure Quantum ワークスペースには、 プライマリ キーとセカンダリ キーとそれに対応する接続文字列があります。 ワークスペースへの他のユーザーへのアクセスを許可する場合は、セカンダリ キーを共有し、独自のサービスにプライマリを使用できます。 これにより、必要に応じて、独自のサービスでダウンタイムを発生させることなく、セカンダリ キーを置き換えることができます。 ワークスペース アクセスの共有の詳細については、「ワークスペース アクセス を共有する」を参照してください。