Administración de credenciales en Azure Automation
Un recurso de credencial de Automation incluye un objeto que contiene credenciales de seguridad, como un nombre de usuario y una contraseña. Los runbooks y las configuraciones de DSC usan cmdlets que aceptan un objeto PSCredential para la autenticación. Como alternativa, pueden extraer el nombre de usuario y la contraseña del objeto PSCredential para proporcionarlos a alguna aplicación o servicio que requiera autenticación.
Nota:
Los recursos protegidos en Azure Automation incluyen credenciales, certificados, conexiones y variables cifradas. Estos recursos se cifran y se almacenan en Azure Automation con una clave única que se genera para cada cuenta de Automation. Azure Automation almacena la clave en la instancia de Key Vault administrada por el sistema. Antes de almacenar un recurso seguro, Azure Automation carga la clave desde Key Vault y después la usa para cifrar el recurso.
Nota:
Para obtener información sobre cómo ver o eliminar datos personales, consulte Solicitudes generales de interesados para el RGPD, Solicitudes de los interesados de Azure para el RGPDo Solicitudes de los interesados de Windows para el RGPD, en función de sus necesidades y áreas específicas. Para más información sobre RGPD, consulte Información sobre los procedimientos recomendados para el cumplimiento del RGPD y la sección RGPD del portal de confianza de servicios.
Cmdlets de PowerShell usados para acceder a credenciales
Los cmdlets de la tabla siguiente permiten crear y administrar credenciales de Automation con PowerShell. Se suministran como un componente de los módulos Az.
| Cmdlet | Descripción |
|---|---|
| Get-AzAutomationCredential | Recupera un objeto CredentialInfo que contiene metadatos sobre la credencial. El cmdlet no recupera el objeto PSCredential mismo. |
| New-AzAutomationCredential | Crea una nueva credencial de Automation. |
| Remove-AzAutomationCredential | Quita una credencial de Automation. |
| Set-AzAutomationCredential | Establece las propiedades para una credencial de Automatización existente. |
Otros cmdlets usados para acceder a credenciales
Los cmdlets de la tabla siguiente se usan para acceder a las credenciales en los runbook y las configuraciones de DSC.
| Cmdlet | Descripción |
|---|---|
Get-AutomationPSCredential |
Obtiene un objeto PSCredential para usarlo en un runbook o una configuración de DSC. La mayoría de las veces debe usar este cmdlet interno en lugar del cmdlet Get-AzAutomationCredential, ya que este último solo recupera la información de credenciales. Esta información no suele ser útil para pasar a otro cmdlet. |
| Get-Credential | Obtiene una credencia con una solicitud de nombre de usuario y contraseña. Este cmdlet forma parte del módulo Microsoft.PowerShell.Security predeterminado. Consulte Módulos predeterminados. |
| New-AzureAutomationCredential | Crea un recurso de credencial. Este cmdlet forma parte del módulo de Azure predeterminado. Consulte Módulos predeterminados. |
Para recuperar objetos PSCredential en el código, debe importar el módulo Orchestrator.AssetManagement.Cmdlets. Para más información, consulte Administración de módulos en Azure Automation.
Import-Module Orchestrator.AssetManagement.Cmdlets -ErrorAction SilentlyContinue
Nota:
Debe evitar el uso de variables en el parámetro Name de Get-AutomationPSCredential. Su uso puede complicar la detección de dependencias entre runbooks o configuraciones de DSC y recursos de credenciales durante el tiempo de diseño.
Funciones de Python que acceden a las credenciales
La función de la tabla siguiente se usa para acceder a las credenciales de un runbook de Python 2 y 3. Actualmente, los runbooks de Python 3 están en versión preliminar.
| Función | Descripción |
|---|---|
automationassets.get_automation_credential |
Recupera información acerca de un recurso de credencial. |
Nota:
Para acceder a las funciones del recurso, importe el módulo automationassets en la parte superior del runbook de Python.
Creación de un nuevo recurso de credencial
Puede crear un recurso de credencial mediante Azure Portal o Windows PowerShell.
Creación de un nuevo recurso de credencial con Azure Portal
En la cuenta de Automation, en el panel izquierdo, seleccione Credenciales en Recursos compartidos.
En la página Credenciales, seleccione Agregar una credencial.
En el panel Nueva credencial, escriba un nombre de credencial adecuado que siga los estándares de nomenclatura.
Escriba el identificador de acceso en el campo Nombre de usuario.
En ambos campos de contraseña, escriba la clave de acceso secreta.
Si la casilla de autenticación multifactor está activada, desactívela.
Haga clic en Crear para guardar el nuevo recurso de credencial.
Nota:
Azure Automation no admite cuentas de usuario que usen la autenticación multifactor.
Creación de un nuevo recurso de credencial con Windows PowerShell
En el ejemplo siguiente se muestra cómo crear un recurso de credencial de Automation. Primero se crea un objeto PSCredential con el nombre y la contraseña y, luego, se usa para crear el recurso de credencial. En su lugar, puede usar el cmdlet Get-Credential para solicitar al usuario que escriba un nombre y una contraseña.
$user = "MyDomain\MyUser"
$pw = ConvertTo-SecureString "PassWord!" -AsPlainText -Force
$cred = New-Object –TypeName System.Management.Automation.PSCredential –ArgumentList $user, $pw
New-AzureAutomationCredential -AutomationAccountName "MyAutomationAccount" -Name "MyCredential" -Value $cred
Obtención de un recurso de credencial
Un runbook o una configuración de DSC recupera un recurso de credencial con el cmdlet Get-AutomationPSCredential interno. Este cmdlet recupera un objeto PSCredential que puede usar con un cmdlet que requiere una credencial. También puede recuperar las propiedades del objeto de credencial para usarlas individualmente. El objeto tiene propiedades para el nombre de usuario y la contraseña segura.
Nota:
El cmdlet Get-AzAutomationCredential no recupera ningún objeto PSCredential que se pueda usar para la autenticación. Solo proporciona información acerca de la credencial. Si necesita usar una credencial en un runbook, debe recuperarla como un objeto PSCredential mediante Get-AutomationPSCredential.
Como alternativa, puede usar el método GetNetworkCredential para recuperar un objeto NetworkCredential que representa una versión no segura de la contraseña.
Ejemplo de un runbook textual
En el ejemplo siguiente se muestra cómo usar una credencial de PowerShell en un runbook. Se recupera la credencial y se asigna su nombre de usuario y contraseña a las variables.
$myCredential = Get-AutomationPSCredential -Name 'MyCredential'
$userName = $myCredential.UserName
$securePassword = $myCredential.Password
$password = $myCredential.GetNetworkCredential().Password
También puede usar una credencial para autenticarse en Azure con Connect-AzAccount después de conectarse primero a una identidad administrada. En ese ejemplo se usa una identidad administrada asignada por el sistema.
# Ensures you do not inherit an AzContext in your runbook
Disable-AzContextAutosave -Scope Process
# Connect to Azure with system-assigned managed identity
$AzureContext = (Connect-AzAccount -Identity).context
# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription -DefaultProfile $AzureContext
# Get credential
$myCred = Get-AutomationPSCredential -Name "MyCredential"
$userName = $myCred.UserName
$securePassword = $myCred.Password
$password = $myCred.GetNetworkCredential().Password
$myPsCred = New-Object System.Management.Automation.PSCredential ($userName,$securePassword)
# Connect to Azure with credential
$AzureContext = (Connect-AzAccount -Credential $myPsCred -TenantId $AzureContext.Subscription.TenantId).context
# set and store context
$AzureContext = Set-AzContext -SubscriptionName $AzureContext.Subscription `
-TenantId $AzureContext.Subscription.TenantId `
-DefaultProfile $AzureContext
Ejemplos de un runbook gráfico
Para agregar una actividad para el cmdlet Get-AutomationPSCredential interno a un runbook gráfico, haga clic con el botón derecho en la credencial en el panel Biblioteca del editor gráfico y, después, seleccione Agregar al lienzo.
La imagen siguiente muestra un ejemplo de cómo usar una credencial en un runbook gráfico. En este caso, la credencial proporciona la autenticación de un runbook en los recursos de Azure, como se describe en Uso de Microsoft Entra ID en Azure Automation para autenticarse en Azure. La primera actividad recupera la credencial que tiene acceso a la suscripción de Azure. A continuación, la actividad de conexión de la cuenta usa esta credencial para proporcionar autenticación para cualquier actividad que venga después. Aquí se usa un vínculo de canalización, debido a que Get-AutomationPSCredential espera un solo objeto.
Uso de credenciales en una configuración de DSC
Aunque las configuraciones de DSC en Azure Automation pueden funcionar con recursos de credenciales mediante Get-AutomationPSCredential, también los pueden pasar a través de parámetros. Para obtener más información, consulte Compilación de configuraciones en DSC de Azure Automation.
Pasos siguientes
- Para más información sobre los cmdlets que se usan para acceder a los certificados, consulte Administración de módulos en Azure Automation.
- Para obtener información general sobre los runbooks, consulte Ejecución de un runbook en Azure Automation.
- Para más información sobre las configuraciones DSC, vea Introducción a State Configuration de Azure Automation.