New-AzSftpCertificate

New-AzSftpCertificate
    [-CertificatePath <String>]
    [-PrivateKeyFile <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -PublicKeyFile <String>
    [-CertificatePath <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -PrivateKeyFile <String>
    [-CertificatePath <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

New-AzSftpCertificate
    -LocalUser <String>
    [-CertificatePath <String>]
    [-PrivateKeyFile <String>]
    [-SshClientFolder <String>]
    [-Force]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet New-AzSftpCertificate genera certificados SSH para la autenticación SFTP mediante las credenciales de Microsoft Entra actuales. Este cmdlet proporciona los mismos métodos de autenticación y conjuntos de parámetros que el módulo Az.Ssh, lo que garantiza la coherencia entre los módulos de Azure PowerShell.

El cmdlet admite cuatro modos de autenticación que se alinean con el módulo SSH:

Default Mode (autenticación Microsoft Entra): cuando no se proporciona ningún archivo de clave específico, el cmdlet genera automáticamente un nuevo par de claves SSH y crea un certificado firmado por la ENTIDAD de certificación de confianza de Microsoft Entra. Este es el enfoque más sencillo para empezar a trabajar con la autenticación SFTP.

FromPublicKey Mode: cuando se proporciona un archivo de clave pública, el cmdlet genera un certificado para esa clave específica mediante credenciales de Microsoft Entra. Esto resulta útil cuando ya tiene claves públicas SSH y quiere usarlas para Azure Storage acceso SFTP.

FromPrivateKey Mode: Cuando se proporciona un archivo de clave privada, el cmdlet genera la clave pública correspondiente y crea un certificado con credenciales de Microsoft Entra. Esto resulta útil cuando tiene claves privadas existentes y desea crear certificados para ellas.

Modo LocalUser: cuando se especifica un usuario local, el cmdlet genera un certificado adecuado para la autenticación de usuario local en cuentas de almacenamiento. Esto se puede combinar con claves privadas existentes o generar nuevas, que coincidan con las funcionalidades de certificado de usuario local del módulo SSH.

Los certificados generados suelen ser válidos durante 1 hora y se pueden usar con cualquier cliente SFTP que admita la autenticación de certificados SSH. La entidad de certificación de confianza de Microsoft Entra firma los certificados y las aceptarán Azure Storage cuentas en las que la identidad de Microsoft Entra tenga los permisos adecuados.

Debe iniciar sesión en Azure con una cuenta que tenga los permisos de RBAC adecuados (como Colaborador de datos de Storage Blob o Propietario de datos de Storage Blob) en las cuentas de almacenamiento de destino.

New-AzSftpCertificate

Este comando genera un nuevo par de claves SSH y crea un certificado firmado por Microsoft Entra. El par de claves y el certificado se guardan en el directorio temporal del sistema con nombres de archivo generados automáticamente. Esta es la manera más sencilla de empezar a trabajar con la autenticación SFTP.

New-AzSftpCertificate -CertificatePath "C:\certs\azure-sftp.cert"

Este comando genera un nuevo par de claves SSH y crea un certificado, guardando el certificado en la ruta de acceso especificada. Las claves privadas y públicas se guardarán en el mismo directorio con los nombres correspondientes (azure-sftp y azure-sftp.pub).

New-AzSftpCertificate -PrivateKeyFile "C:\keys\id_rsa" -CertificatePath "C:\certs\id_rsa.cert"

Este comando genera un certificado a partir de una clave privada SSH existente. El cmdlet derivará automáticamente la clave pública de la clave privada y creará un certificado firmado por Microsoft Entra. Esto resulta útil cuando tiene claves privadas existentes y quiere crear certificados para ellas.

New-AzSftpCertificate -PublicKeyFile "C:\keys\id_rsa.pub" -CertificatePath "C:\certs\id_rsa.cert"

Este comando genera un certificado a partir de una clave pública SSH existente. Esto resulta útil cuando desea crear certificados para las claves públicas existentes que ya están configuradas en las cuentas de almacenamiento.

New-AzSftpCertificate -LocalUser "sftpuser" -CertificatePath "C:\certs\localuser.cert"

Este comando genera un certificado adecuado para la autenticación de usuario local en cuentas de almacenamiento. Se genera un nuevo par de claves y el certificado se configura para el usuario local especificado. Esto se alinea con las funcionalidades de autenticación de usuario local del módulo SSH.

New-AzSftpCertificate -LocalUser "sftpuser" -PrivateKeyFile "C:\keys\existing_key" -CertificatePath "C:\certs\localuser.cert"

Este comando genera un certificado para la autenticación de usuario local mediante una clave privada existente. Esto resulta útil cuando desea usar claves específicas para la autenticación de usuario local en cuentas de almacenamiento.

$cert = New-AzSftpCertificate
Write-Host "Certificate: $($cert.CertificatePath)"
Write-Host "Private Key: $($cert.PrivateKeyPath)"
Write-Host "Valid Until: $($cert.ValidUntil)"

Este comando genera un certificado con la generación automática de claves y rutas de acceso de archivo temporales. El objeto devuelto contiene todas las rutas de acceso de archivo y la información del certificado, lo que facilita el uso mediante programación.

# Generate certificate for local user
$cert = New-AzSftpCertificate -LocalUser "sftpuser" -CertificatePath "C:\certs\sftp-auth.cert"

# Use the certificate to connect to storage account
$process = Connect-AzSftp -StorageAccount "mystorageaccount" -LocalUser "sftpuser" -PrivateKeyFile $cert.PrivateKeyPath

# Display connection info
Write-Host "SFTP connection established using certificate: $($cert.CertificatePath)"
Write-Host "Process ID: $($process.Id)"

En este ejemplo se muestra el flujo de trabajo completo de generar un certificado y usarlo inmediatamente para la conexión SFTP, que muestra la integración entre los dos cmdlets.

New-AzSftpCertificate -CertificatePath "C:\certs\custom-cert.pub" -SshClientFolder "C:\Program Files\OpenSSH"

Este comando genera un certificado mediante ejecutables SSH desde una ubicación específica. Esto resulta útil cuando tiene varias implementaciones ssh instaladas o cuando ssh-keygen no está en la ruta de acceso predeterminada.

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.