Autenticar em seu workspace usando uma chave de acesso

Artigo
10/24/2024

As chaves de acesso são usadas para autenticar e autorizar o acesso ao workspace do Azure Quantum. Você pode usar chaves de acesso para conectar e conceder acesso ao seu workspace usando cadeias de conexão.

Neste artigo, você aprenderá a habilitar ou desabilitar as chaves de acesso para seu workspace do Azure Quantum. Você também pode regenerar novas chaves para garantir a segurança do seu espaço de trabalho.

Aviso

Armazenar as chaves de acesso à conta ou a cadeia de conexão em texto simples apresenta um risco de segurança e não é recomendado. Armazene suas chaves de conta em um formato criptografado ou migre seus aplicativos para usar a autorização do Microsoft Entra para acessar seu workspace do Azure Quantum.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Se você não tiver uma conta do Azure, registre-se gratuitamente e inscreva-se para uma assinatura paga conforme o uso.
Um workspace do Azure Quantum. Consulte Criar um espaço de trabalho do Azure Quantum.
A versão mais recente do pacote do Azure Quantum azure-quantum .
```
!pip install --upgrade azure-quantum
```
Se você usar CLI do Azure, precisará ter a versão mais recente. Para obter as instruções de instalação, confira:

Conectar-se ao workspace do Azure Quantum com uma cadeia de conexão

O azure-quantum pacote fornece uma Workspace classe que representa um workspace do Azure Quantum. Para se conectar ao workspace do Azure Quantum, crie Workspace um objeto usando a cadeia de conexão como autenticador. Para obter mais informações, consulte como copiar uma cadeia de conexão.

Ao criar um Workspace objeto, você tem duas opções para identificar seu workspace do Azure Quantum.

Você pode criar um Workspace objeto chamando 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())

Se você não quiser copiar sua cadeia de conexão no código, também poderá armazenar sua cadeia de conexão em uma variável de ambiente e usar 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())

Gerenciar suas chaves de acesso e cadeias de conexão

Dica

Cada workspace do Azure Quantum tem chaves primárias e secundárias e suas cadeias de conexão correspondentes. Se você quiser permitir o acesso ao seu espaço de trabalho para outras pessoas, poderá compartilhar sua chave secundária e usá-la primária para seus próprios serviços. Dessa forma, você pode substituir a chave secundária conforme necessário sem ter tempo de inatividade em seus próprios serviços. Para obter mais informações sobre como compartilhar o acesso ao workspace, consulte Compartilhar seu acesso ao workspace.

Portal do Azure
CLI do Azure

Você pode gerenciar as chaves de acesso e as cadeias de conexão para seu workspace do Azure Quantum no portal do Azure.

Habilitar e desabilitar chaves de acesso

Entre no portal do Azure e selecione seu workspace do Azure Quantum.
No painel esquerdo, navegue até Teclas de acesso de operações>.
Alterne a alternância em Teclas de acesso para Habilitado ou Desabilitado.
Clique em Salvar para salvar as alterações.

Importante

Quando as Chaves de Acesso estão desabilitadas, todas as solicitações usando cadeias de conexão ou chaves de acesso não são autorizadas. Você ainda pode usar os parâmetros do espaço de trabalho para se conectar ao seu espaço de trabalho.

Regenerar novas chaves de acesso

Se você suspeitar que suas chaves de acesso foram comprometidas ou quiser parar de compartilhar o acesso ao workspace com outras pessoas, poderá regenerar as chaves de acesso primárias ou secundárias, ou ambas, para garantir a segurança do workspace.

Entre no portal do Azure e selecione seu workspace do Azure Quantum.
No painel esquerdo, navegue até Teclas de acesso de operações>.
As chaves de acesso devem ser habilitadas para regenerar novas chaves. Se as Teclas de Acesso estiverem desativadas, você precisará ativá-las primeiro.
Clique no ícone de seta circular para regenerar a chave primária ou secundária.

Você pode usar a CLI do Azure (Interface de Linha de Comando do Azure) para gerenciar chaves de acesso. Para obter mais informações, confira Gerenciar workspaces do quantum com a CLI do Azure.

Mostre as teclas de acesso para o espaço de trabalho.
```
az quantum workspace keys list 
```
Se você suspeitar que suas chaves de acesso foram comprometidas ou quiser parar de compartilhar o acesso ao workspace com outras pessoas, poderá regenerar as chaves de acesso primárias ou secundárias, ou ambas, para garantir a segurança do workspace.
```
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 
```
Você pode habilitar e desabilitar as teclas de acesso para o espaço de trabalho.
```
az quantum workspace update --enable-api-key true 
az quantum workspace update --enable-api-key false 
```
Importante

Quando as Chaves de Acesso estão desabilitadas, todas as solicitações que usam cadeias de conexão ou chaves de acesso não são autorizadas. Você ainda pode usar os parâmetros do espaço de trabalho para se conectar ao seu espaço de trabalho.

Compartilhar via