Autenticar em seu espaço de trabalho usando uma chave de acesso

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

Neste artigo, você aprenderá a habilitar ou desabilitar as chaves de acesso para seu espaço de trabalho 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 da sua conta ou a cadeia de conexão em texto não criptografado representa 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 acesso ao seu espaço de trabalho do Azure Quantum.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta do Azure, registe-se gratuitamente e inscreva-se numa subscrição pré-paga.
Um espaço de trabalho do Azure Quantum. Consulte Criar um espaço de trabalho do Azure Quantum.
A versão mais recente da qdk biblioteca Python com o azure extra.
```
pip install --upgrade "qdk[azure]"
```

Se usar o Azure CLI, então deve ter a versão mais recente. Para instruções de instalação, veja:

Conectar-se ao seu espaço de trabalho do Azure Quantum com uma cadeia de conexão

O qdk.azure módulo fornece uma Workspace classe que representa um espaço de trabalho Azure Quantum. Para se ligar ao seu espaço de trabalho Azure Quantum, crie Workspace um objeto usando a string de ligação como autenticador. Para obter mais informações, consulte como copiar uma cadeia de conexão.

Quando crias um Workspace objeto, tens duas opções para identificar o teu espaço de trabalho Azure Quantum.

Crie um Workspace objeto chamando from_connection_string.

# Creating a new Workspace object from a connection string 
from qdk.azure import Workspace 

connection_string = "[Copy connection string]" 
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

Se não quiseres copiar a tua string de ligação no código, então armazena a tua string numa variável de ambiente e usa 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 qdk.azure import Workspace 

workspace = Workspace() 
print(workspace.get_targets())

Gerencie suas chaves de acesso e cadeias de conexão

Gorjeta

Cada espaço de trabalho do Azure Quantum tem chaves primárias e secundárias e suas cadeias de conexão correspondentes. Se quiser permitir o acesso ao seu espaço de trabalho a outras pessoas, pode partilhar a sua chave secundária e utilizar a sua chave principal para os seus próprios serviços. Desta forma, podes substituir a chave secundária conforme necessário, sem ter tempo de inatividade nos teus próprios serviços. Para obter mais informações sobre como compartilhar o acesso ao espaço de trabalho, consulte Compartilhar o acesso ao espaço de trabalho.

Portal do Azure
CLI do Azure

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

Ativar e desativar chaves de acesso

Faça logon no portal do Azure e selecione seu espaço de trabalho do Azure Quantum.
No painel esquerdo, navegue até Operaçōes > Chaves de acesso.
Mude a alternância em Teclas de Acesso para Ativado ou Desativado.
Clique em Salvar para salvar as alterações.

Importante

Quando as Chaves de Acesso estão desativadas, 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 suspeitar que as Chaves de Acesso foram comprometidas ou quiser parar de compartilhar o acesso ao espaço de trabalho com outras pessoas, você poderá regenerar as chaves de acesso primária ou secundária, ou ambas, para garantir a segurança do espaço de trabalho.

Faça logon no portal do Azure e selecione seu espaço de trabalho do Azure Quantum.
No painel esquerdo, navegue até Operaçōes > Chaves de acesso.
As Chaves de Acesso têm de estar ativadas para regenerar novas chaves. Se as Chaves 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 Interface de Linha de Comando do Azure (CLI do Azure) para gerenciar chaves de acesso. Para obter mais informações, consulte Gerenciar espaços de trabalho quânticos com a CLI do Azure.

Mostrar as chaves 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 seu acesso ao espaço de trabalho com outras pessoas, poderá regenerar as chaves de acesso primária ou secundária, ou ambas, para garantir a segurança do espaço de trabalho.
```
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 chaves 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 desativadas, 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.

Feedback

Esta página foi útil?

Last updated on 2025-12-24