アクセス キーを使用した認証
アクセス キーは、Azure Quantum ワークスペースへのアクセスを認証および承認するために使用されます。 アクセス キーを使用して、接続文字列を使用してワークスペースに接続し、アクセス権を付与できます。
この記事では、Azure Quantum ワークスペースのアクセス キーを有効または無効にする方法について説明します。 新しいキーを再生成して、ワークスペースのセキュリティを確保することもできます。
警告
アカウント アクセス キーまたは接続文字列をクリア テキストに格納すると、セキュリティ上のリスクが発生するためお勧めしません。 暗号化された形式でアカウント キーを格納するか、Azure Quantum ワークスペースへのアクセスにMicrosoft Entra承認を使用するようにアプリケーションを移行します。
前提条件
アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントをお持ちでない場合は、無料で登録し、 従量課金制サブスクリプションにサインアップします。
Azure Quantum ワークスペース。 「Azure Quantum ワークスペースを作成する」をご覧ください。
Azure Quantum
azure-quantum
パッケージの最新バージョン。python -m pip install --upgrade azure-quantum
Azure CLI を使用する場合は、最新バージョンが必要です。 インストール手順については、以下を参照してください。
接続文字列を使用して接続する
パッケージにはazure-quantum
、Workspace
Azure 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 ワークスペースのアクセス キーと接続文字列を管理できます。
アクセス キーを有効または無効にする
Azure portal にログインし、Azure Quantum ワークスペースを選択します。
左側のパネルで、[操作アクセス キー] >に移動します。
[アクセス キー] のトグルを [有効] または [無効] に切り替えます。
[ 保存 ] をクリックして変更を保存します。
重要
アクセス キーが 無効になっている場合、接続文字列またはアクセス キーを使用するすべての要求は承認されていません。 引き続きワークスペース パラメーターを使用して、ワークスペースに接続できます。
新しいアクセス キーを再生成する
アクセス キーが侵害されたと思われる場合、または他のユーザーとワークスペースアクセスの共有を停止したい場合は、プライマリまたはセカンダリのアクセス キー、またはその両方を再生成して、ワークスペースのセキュリティを確保できます。
Azure portal にログインし、Azure Quantum ワークスペースを選択します。
左側のパネルで、[操作アクセス キー] >に移動します。
新しいキーを再生成するには、アクセス キーを有効にする必要があります。 アクセス キーが無効になっている場合は、まずそれらを有効にする必要があります。
循環矢印アイコンをクリックして、主キーまたはセカンダリ キーを再生成します。
ヒント
すべての Azure Quantum ワークスペースには、 プライマリ キーとセカンダリ キーとそれに対応する接続文字列があります。 ワークスペースへの他のユーザーへのアクセスを許可する場合は、セカンダリ キーを共有し、独自のサービスにプライマリを使用できます。 これにより、必要に応じて、独自のサービスでダウンタイムを発生させることなく、セカンダリ キーを置き換えることができます。 ワークスペース アクセスの共有の詳細については、「ワークスペース アクセス を共有する」を参照してください。