Autenticación en el área de trabajo mediante una clave de acceso

Las claves de acceso se usan para autenticar y autorizar el acceso al área de trabajo de Azure Quantum. Puede usar claves de acceso para conectarse y conceder acceso al área de trabajo mediante cadena de conexión.

En este artículo, aprenderá a habilitar o deshabilitar las claves de acceso para el área de trabajo de Azure Quantum. También puede volver a generar nuevas claves para garantizar la seguridad del área de trabajo.

Advertencia

Almacenar las claves de acceso o la cadena de conexión de su cuenta en texto no cifrado supone un riesgo de seguridad y no se recomienda. Almacene las claves de cuenta en un formato cifrado o migre las aplicaciones para usar la autorización de Microsoft Entra para acceder al área de trabajo de Azure Quantum.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta de Azure, regístrese gratuitamente y regístrese para obtener una suscripción de pago por uso.

• Un área de trabajo de Azure Quantum. Consulte Creación de un área de trabajo de Azure Quantum.

• La versión más reciente del paquete de Azure Quantum azure-quantum .

  !pip install --upgrade azure-quantum
  

• Si usa la CLI de Azure, debe tener la versión más reciente. Para obtener instrucciones de instalación, consulte:

  • Instalación de la CLI de Azure en Windows
  • Instalación de la CLI de Azure en Linux
  • Instalación de la CLI de Azure en macOS

Conexión al área de trabajo de Azure Quantum con un cadena de conexión

El azure-quantum paquete proporciona una Workspace clase que representa un área de trabajo de Azure Quantum. Para conectarse al área de trabajo de Azure Quantum, cree Workspace un objeto mediante el cadena de conexión como autenticador. Para obtener más información, consulte cómo copiar un cadena de conexión.

Al crear un Workspace objeto, tiene dos opciones para identificar el área de trabajo de Azure Quantum.

• Puede crear un Workspace objeto llamando a 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()) 
  

• Si no desea copiar el cadena de conexión en el código, también puede almacenar el cadena de conexión en una variable de entorno y 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()) 
  

Administrar las claves de acceso y los cadena de conexión

Sugerencia

Cada área de trabajo de Azure Quantum tiene claves principales y secundarias y sus cadena de conexión correspondientes. Si desea permitir el acceso al área de trabajo a otros usuarios, puede compartir la clave secundaria y usar la principal para sus propios servicios. De este modo, puede reemplazar la clave secundaria según sea necesario sin tener tiempo de inactividad en sus propios servicios. Para más información sobre cómo compartir el acceso al área de trabajo, consulte Uso compartido del acceso al área de trabajo.

Azure Portal

Puede administrar las claves de acceso y las cadena de conexión para el área de trabajo de Azure Quantum en Azure Portal.

Habilitación y deshabilitación de claves de acceso

1. Inicie sesión en Azure Portal y seleccione el área de trabajo de Azure Quantum.

2. En el panel izquierdo, vaya a Claves de acceso de operaciones>.

3. Cambie el botón de alternancia en Claves de acceso a Habilitado o Deshabilitado.

4. Haga clic en Guardar para guardar los cambios.

   

Importante

Cuando las claves de acceso están deshabilitadas, todas las solicitudes que usan cadena de conexión o claves de acceso no están autorizadas. Todavía puede usar los parámetros del área de trabajo para conectarse al área de trabajo.

Regeneración de nuevas claves de acceso

Si sospecha que las claves de acceso se han puesto en peligro o desea dejar de compartir el acceso del área de trabajo con otros usuarios, puede volver a generar las claves de acceso principal o secundaria, o ambas, para garantizar la seguridad del área de trabajo.

1. Inicie sesión en Azure Portal y seleccione el área de trabajo de Azure Quantum.

2. En el panel izquierdo, vaya a Claves de acceso de operaciones>.

3. Las claves de acceso deben estar habilitadas para volver a generar nuevas claves. Si las claves de acceso están deshabilitadas, primero debe habilitarlas.

4. Haga clic en el icono de flecha circular para volver a generar la clave principal o secundaria.

   

CLI de Azure

Puede usar el Interfaz de la línea de comandos de Azure (CLI de Azure) para administrar las claves de acceso. Para más información, consulte Administración de áreas de trabajo de Azure Quantum con la CLI de Azure.

1. Mostrar las claves de acceso del área de trabajo.

   az quantum workspace keys list 
   

2. Si sospecha que las claves de acceso se han puesto en peligro o desea dejar de compartir el acceso del área de trabajo con otras personas, puede volver a generar las claves de acceso principal o secundaria, o ambas, para garantizar la seguridad del área de trabajo.

   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 
   

3. Puede habilitar y deshabilitar las claves de acceso para el área de trabajo.

   az quantum workspace update --enable-api-key true 
   az quantum workspace update --enable-api-key false 
   

   Importante

   Cuando las claves de acceso están deshabilitadas, todas las solicitudes que usan cadena de conexión s o claves de acceso no están autorizadas. Todavía puede usar los parámetros del área de trabajo para conectarse al área de trabajo.