Een toegangssleutel gebruiken om te verifiëren

Artikel
03/14/2024

Toegangssleutels worden gebruikt voor het verifiëren en autoriseren van toegang tot uw Azure Quantum-werkruimte. U kunt toegangssleutels gebruiken om verbinding te maken en toegang te verlenen tot uw werkruimte met behulp van verbindingsreeksen.

In dit artikel leert u hoe u de toegangssleutels voor uw Azure Quantum-werkruimte in- of uitschakelt. U kunt ook nieuwe sleutels opnieuw genereren om de beveiliging van uw werkruimte te garanderen.

Waarschuwing

Het opslaan van uw accounttoegangssleutels of verbindingsreeks in duidelijke tekst vormt een beveiligingsrisico en wordt afgeraden. Sla uw accountsleutels op in een versleutelde indeling of migreer uw toepassingen om Microsoft Entra autorisatie te gebruiken voor toegang tot uw Azure Quantum-werkruimte.

Vereisten

Een Azure-account met een actief abonnement. Als u geen Azure-account hebt, registreert u zich gratis en meldt u zich aan voor een abonnement op basis van betalen per gebruik.
Een Azure Quantum-werkruimte. Zie Een Azure Quantum-werkruimte maken.
De nieuwste versie van het Azure Quantum-pakket azure-quantum .
```
python -m pip install --upgrade azure-quantum
```
Als u Azure CLI gebruikt, moet u de nieuwste versie hebben. Zie voor installatie-instructies:

Verbinding maken met een verbindingsreeks

Het azure-quantum pakket biedt een Workspace klasse die een Azure Quantum-werkruimte vertegenwoordigt. Als u verbinding wilt maken met uw Azure Quantum-werkruimte, maakt Workspace u een object met behulp van de verbindingsreeks als verificator. Zie Een verbindingsreeks kopiëren voor meer informatie.

Wanneer u een Workspace object maakt, hebt u twee opties voor het identificeren van uw Azure Quantum-werkruimte.

U kunt een Workspace -object maken door aan te roepen 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())

Als u uw verbindingsreeks niet in de code wilt kopiëren, kunt u uw verbindingsreeks ook opslaan in een omgevingsvariabele en gebruikenWorkspace().

# 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())

Uw sleutels en verbindingsreeksen beheren

Azure-portal
Azure-CLI

U kunt toegangssleutels en verbindingsreeksen voor uw Azure Quantum-werkruimte beheren in de Azure Portal.

Toegangssleutels in- en uitschakelen

Meld u aan bij de Azure Portal en selecteer uw Azure Quantum-werkruimte.
Navigeer in het linkerdeelvenster naar Bewerkingen > Toegangssleutels.
Zet de wisselknop onder Toegangssleutels op Ingeschakeld of Uitgeschakeld.
Klik op Opslaan om de wijzigingen op te slaan.

Belangrijk

Wanneer toegangssleutels zijn uitgeschakeld, zijn alle aanvragen met behulp van verbindingsreeksen of toegangssleutels niet gemachtigd. U kunt nog steeds de werkruimteparameters gebruiken om verbinding te maken met uw werkruimte.

Nieuwe toegangssleutels opnieuw genereren

Als u vermoedt dat uw toegangssleutels zijn aangetast of als u het delen van uw werkruimtetoegang met anderen wilt stoppen, kunt u de primaire of secundaire toegangssleutel of beide opnieuw genereren om de beveiliging van uw werkruimte te garanderen.

Meld u aan bij de Azure Portal en selecteer uw Azure Quantum-werkruimte.
Navigeer in het linkerdeelvenster naar Bewerkingen > Toegangssleutels.
Toegangssleutels moeten zijn ingeschakeld om nieuwe sleutels opnieuw te genereren. Als toegangssleutels zijn uitgeschakeld, moet u deze eerst inschakelen.
Klik op het cirkelvormige pijlpictogram om de primaire of secundaire sleutel opnieuw te genereren.

Tip

Elke Azure Quantum-werkruimte heeft primaire en secundaire sleutels en de bijbehorende verbindingsreeksen. Als u anderen toegang wilt geven tot uw werkruimte, kunt u uw secundaire sleutel delen en uw primaire sleutel gebruiken voor uw eigen services. Op deze manier kunt u de secundaire sleutel indien nodig vervangen zonder downtime in uw eigen services. Zie Uw werkruimtetoegang delen voor meer informatie over het delen van de toegang tot uw werkruimte.

U kunt de Azure Command-Line Interface (Azure CLI) gebruiken om toegangssleutels te beheren. Zie Kwantumwerkruimten beheren met de Azure CLI voor meer informatie.

De toegangssleutels voor de werkruimte weergeven.
```
az quantum workspace keys list 
```
Als u vermoedt dat uw toegangssleutels zijn aangetast of als u het delen van uw werkruimtetoegang met anderen wilt beëindigen, kunt u de primaire of secundaire toegangssleutel of beide opnieuw genereren om de beveiliging van uw werkruimte te garanderen.
```
az quantum workspace keys regenerate --key-type Primary 
az quantum workspace keys regenerate --key-type Secondary 
az quantum workspace keys regenerate --key-type Primary,Secondary 
```
Tip

Elke Azure Quantum-werkruimte heeft primaire en secundaire sleutels en de bijbehorende verbindingsreeksen. Als u anderen toegang wilt geven tot uw werkruimte, kunt u uw secundaire sleutel delen en uw primaire sleutel gebruiken voor uw eigen services. Op deze manier kunt u de secundaire sleutel indien nodig vervangen zonder downtime in uw eigen services. Zie Uw werkruimtetoegang delen voor meer informatie over het delen van de toegang tot uw werkruimte.
U kunt de toegangssleutels voor de werkruimte in- en uitschakelen .
```
az quantum workspace update --enable-api-key true 
az quantum workspace update --enable-api-key false 
```
Belangrijk

Wanneer toegangssleutels is uitgeschakeld, zijn alle aanvragen met behulp van verbindingsreeksen of toegangssleutels niet gemachtigd. U kunt nog steeds de werkruimteparameters gebruiken om verbinding te maken met uw werkruimte.

Delen via