Búsqueda de sitios web

Cómo exportar políticas de acceso condicional

¿Cómo exportar políticas de Acceso Condicional? Un inquilino de Microsoft Entra tiene múltiples políticas de acceso condicional y todas las configuraciones establecidas funcionan perfectamente. Nos gusta crear las mismas políticas de CA en otro inquilino. La creación de políticas de CA llevará tiempo y es posible que se nos escape alguna configuración. Entonces, ¿cómo hacer una copia de seguridad de las políticas de acceso condicional e importarlas a otro inquilino? En este artículo, aprenderá cómo exportar políticas de acceso condicional, incluidas todas las configuraciones, a un archivo JSON con PowerShell.

Verifique las políticas de acceso condicional en el centro de administración de Microsoft Entra

Comprobemos las políticas de acceso condicional y su estado en Microsoft Entra:

  1. Inicie sesión en el centro de administración de Microsoft Entra

  2. Expandir Identidad > Protección

  3. Haga clic enAcceso condicional

  4. Seleccione Ver todas las políticas

En nuestro ejemplo, tenemos dos políticas de CA. Una de las políticas está habilitada y la otra está deshabilitada.

¿Qué pasa si queremos exportar las políticas de Acceso Condicional? El único método para exportar las políticas de acceso condicional es con PowerShell. Es una excelente manera de hacer una copia de seguridad de las políticas de CA para que pueda revisar la configuración si se realizan cambios en el futuro y desea volver a su configuración predeterminada.

En el siguiente paso, le mostraremos cómo hacer una copia de seguridad de todas las políticas de acceso condicional en su computadora.

Instalar Microsoft Graph PowerShell

Antes de que podamos continuar y obtener todas las políticas de acceso condicional del inquilino de Microsoft Entra, debemos instalar Microsoft Graph PowerShell.

Inicie Windows PowerShell como administrador y ejecute los siguientes comandos.

Install-Module Microsoft.Graph -Force
Install-Module Microsoft.Graph.Beta -AllowClobber -Force

Importante: Instale siempre los módulos Microsoft Graph PowerShell y Microsoft Graph Beta PowerShell. Esto se debe a que algunos cmdlets aún no están disponibles en la versión final y no funcionarán. Actualice ambos módulos a la última versión antes de ejecutar un cmdlet o script para evitar errores y resultados incorrectos.

Ahora que tenemos instalado el módulo SDK de Microsoft Graph PowerShell, podemos pasar al siguiente paso.

Preparar el script de PowerShell Export-CAPolicies

Cree dos carpetas en la unidad (C:):

    

  • Temp
    • 

  • Scripts
    •

Descargue y coloque el script de PowerShell Export-CAPolicies.ps1 en la carpeta C:\scripts. El script exportará los archivos JSON a la carpeta C:\temp.

Asegúrese de que el archivo esté desbloqueado para evitar errores al ejecutar el script. Lea más en el artículo Error sin firma digital al ejecutar el script de PowerShell.

Otra opción es copiar y pegar el siguiente código en el Bloc de notas. Asígnele el nombre Export-CAPolicies.ps1 y colóquelo en la carpeta C:\scripts.

<#
    .SYNOPSIS
    Export-CAPolicies.ps1

    .DESCRIPTION
    Export Conditional Access policies to JSON files for backup purposes.

    .LINK
    www.alitajran.com/export-conditional-access-policies/

    .NOTES
    Written by: ALI TAJRAN
    Website:    www.alitajran.com
    LinkedIn:   linkedin.com/in/alitajran

    .CHANGELOG
    V1.00, 11/16/2023 - Initial version
#>

# Connect to Microsoft Graph API
Connect-MgGraph -Scopes 'Policy.Read.All'

# Export path for CA policies
$ExportPath = "C:\temp\"

try {
    # Retrieve all conditional access policies from Microsoft Graph API
    $AllPolicies = Get-MgIdentityConditionalAccessPolicy -All

    if ($AllPolicies.Count -eq 0) {
        Write-Host "There are no CA policies found to export." -ForegroundColor Yellow
    }
    else {
        # Iterate through each policy
        foreach ($Policy in $AllPolicies) {
            try {
                # Get the display name of the policy
                $PolicyName = $Policy.DisplayName
            
                # Convert the policy object to JSON with a depth of 6
                $PolicyJSON = $Policy | ConvertTo-Json -Depth 6
            
                # Write the JSON to a file in the export path
                $PolicyJSON | Out-File "$ExportPath\$PolicyName.json" -Force
            
                # Print a success message for the policy backup
                Write-Host "Successfully backed up CA policy: $($PolicyName)" -ForegroundColor Green
            }
            catch {
                # Print an error message for the policy backup
                Write-Host "Error occurred while backing up CA policy: $($Policy.DisplayName). $($_.Exception.Message)" -ForegroundColor Red
            }
        }
    }
}
catch {
    # Print a generic error message
    Write-Host "Error occurred: $($_.Exception.Message)" -ForegroundColor Red
}

Así es como se ve.

Ejecute el script de PowerShell para exportar políticas de acceso condicional

Ejecute el script de PowerShell Export-CAPolicies.ps1 para obtener todas las políticas y exportarlas en archivos JSON en la carpeta temporal.

C:\scripts\Export-CAPolicies.ps1

El resultado muestra:

Successfully backed up CA policy: Block legacy authentication
Successfully backed up CA policy: Require multifactor authentication for all users

Es posible que no se pueda exportar la política de CA si hay caracteres especiales en el nombre de la política. Recomendamos no utilizar caracteres especiales en el nombre de la póliza y mantener los nombres lo más simples posible.

Abrir el archivo JSON de la política de acceso condicional

El script de PowerShell Export-CAPolicies.ps1 exportará todas las políticas a archivos JSON. Busque los archivos JSON en la ruta C:\temp.

Abra el archivo JSON de la política de CA con su aplicación favorita. Por ejemplo, Bloc de notas, Notepad++ o Visual Studio Code.

El archivo JSON de políticas de CA se ve excelente.

¿Le ayudó esto a realizar una copia de seguridad de las políticas de acceso condicional a archivos JSON?

Leer más: Configurar la autenticación multifactor de Azure AD »

Conclusión

Aprendió a exportar políticas de acceso condicional con PowerShell. Primero, conéctese a Microsoft Graph PowerShell y ejecute el script Export-CAPolicies PowerShell. Después de eso, todas las configuraciones de las políticas de acceso condicional están disponibles en archivos JSON por motivos de copia de seguridad. También es una excelente manera de importar políticas de acceso condicional a otro inquilino de Microsoft Entra.

Disfrutaste este artículo? También te puede interesar Pasar de MFA por usuario a MFA de acceso condicional. No olvides seguirnos y compartir este artículo.

Artículos relacionados