Implementar directivas personalizadas con Azure Pipelines

Artículo
01/11/2024

Azure Pipelines admite la integración continua (CI) y la entrega continua (CD) para probar y compilar un código de forma constante y coherente, y enviarlo a cualquier destino. En este artículo se describe cómo automatizar el proceso de implementación de las directivas personalizadas de Azure Active Directory B2C (Azure AD B2C) mediante Azure Pipelines.

Importante

La administración de las directivas personalizadas de Azure AD B2C con Azure Pipelines usa actualmente la vista previa de las operaciones de disponibles en el punto de conexión /beta de Microsoft Graph API. No se admite su uso en aplicaciones de producción. Para obtener más información, consulte Referencia del punto de conexión de la API de REST Microsoft Graph beta.

Prerrequisitos

Siga los pasos de Introducción a las directivas personalizadas en Active Directory B2C.
Si no ha creado una organización de DevOps, hágalo mediante las instrucciones de Registrarse e iniciar sesión en Azure DevOps.

Registrar una aplicación para tareas de administración

Puede usar el script de PowerShell para implementar las directivas de Azure AD B2C. Para que el script de PowerShell pueda interactuar con Microsoft Graph API, cree un registro de aplicación en el inquilino de Azure AD B2C. Si aún no lo ha hecho, registre una aplicación de Microsoft Graph.

Para que el script de PowerShell tenga acceso a los datos de Microsoft Graph, conceda a la aplicación registrada los permisos de aplicación pertinentes. Se ha concedido el permiso Microsoft Graph>Policy>Policy.ReadWrite.TrustFramework dentro de los permisos de API del registro de la aplicación.

Configurar un repositorio de Azure

Una vez registrada la aplicación de Microsoft Graph, está listo para configurar un repositorio para los archivos de directivas.

Inicie sesión en su organización de Azure DevOps.
Cree un nuevo proyecto o seleccione uno existente.
En el proyecto, vaya a Repos y seleccione Archivos.
Seleccione un repositorio existente o cree uno.
En el directorio raíz del repositorio, cree una carpeta denominada B2CAssets. Agregue los archivos de la directiva personalizada de Azure AD B2C a la carpeta B2CAssets.
En el directorio raíz del repositorio, cree una carpeta denominada Scripts. Cree un archivo de PowerShell denominado DeployToB2C.ps1. Pegue el siguiente script de PowerShell en DeployToB2C.ps1.
Confirme e inserte los cambios.

El siguiente script adquiere un token de acceso de Microsoft Entra ID. Con el token, el script llama a Microsoft Graph API para cargar las directivas en la carpeta B2CAssets. También puede cambiar el contenido de la directiva antes de cargarla. Por ejemplo, reemplace tenant-name.onmicrosoft.com por el nombre del inquilino.

[Cmdletbinding()]
Param(
    [Parameter(Mandatory = $true)][string]$ClientID,
    [Parameter(Mandatory = $true)][string]$ClientSecret,
    [Parameter(Mandatory = $true)][string]$TenantId,
    [Parameter(Mandatory = $true)][string]$Folder,
    [Parameter(Mandatory = $true)][string]$Files
)

try {
    $body = @{grant_type = "client_credentials"; scope = "https://graph.microsoft.com/.default"; client_id = $ClientID; client_secret = $ClientSecret }

    $response = Invoke-RestMethod -Uri https://login.microsoftonline.com/$TenantId/oauth2/v2.0/token -Method Post -Body $body
    $token = $response.access_token

    $headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
    $headers.Add("Content-Type", 'application/xml')
    $headers.Add("Authorization", 'Bearer ' + $token)

    # Get the list of files to upload
    $filesArray = $Files.Split(",")

    Foreach ($file in $filesArray) {

        $filePath = $Folder + $file.Trim()

        # Check if file exists
        $FileExists = Test-Path -Path $filePath -PathType Leaf

        if ($FileExists) {
            $policycontent = Get-Content $filePath -Encoding UTF8

            # Optional: Change the content of the policy. For example, replace the tenant-name with your tenant name.
            # $policycontent = $policycontent.Replace("your-tenant.onmicrosoft.com", "contoso.onmicrosoft.com")     
    
    
            # Get the policy name from the XML document
            $match = Select-String -InputObject $policycontent  -Pattern '(?<=\bPolicyId=")[^"]*'
    
            If ($match.matches.groups.count -ge 1) {
                $PolicyId = $match.matches.groups[0].value
    
                Write-Host "Uploading the" $PolicyId "policy..."
    
                $graphuri = 'https://graph.microsoft.com/beta/trustframework/policies/' + $PolicyId + '/$value'
                $content = [System.Text.Encoding]::UTF8.GetBytes($policycontent)
                $response = Invoke-RestMethod -Uri $graphuri -Method Put -Body $content -Headers $headers -ContentType "application/xml; charset=utf-8"
    
                Write-Host "Policy" $PolicyId "uploaded successfully."
            }
        }
        else {
            $warning = "File " + $filePath + " couldn't be not found."
            Write-Warning -Message $warning
        }
    }
}
catch {
    Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__

    $_

    $streamReader = [System.IO.StreamReader]::new($_.Exception.Response.GetResponseStream())
    $streamReader.BaseStream.Position = 0
    $streamReader.DiscardBufferedData()
    $errResp = $streamReader.ReadToEnd()
    $streamReader.Close()

    $ErrResp

    exit 1
}

exit 0

Configuración de Azure Pipelines

Con el repositorio inicializado y rellenado con los archivos de directivas personalizadas, está listo para configurar la canalización de versión. Para crear una canalización, siga estos pasos:

En el proyecto, seleccione Canalizaciones>Versiones>Nueva canalización.
En Seleccionar una plantilla, seleccione Fase vacía y, a continuación, seleccione Aplicar.
Escriba un Nombre de fase, por ejemplo, DeployCustomPolicies, y luego cierre el panel.
Seleccione Agregar un artefacto y, en Tipo de origen, seleccione Azure Repository (Repositorio de Azure).
1. En Proyecto, seleccione el proyecto.
2. Seleccione el origen (repositorio) que contiene la carpeta Scripts.
3. Seleccione una rama predeterminada, por ejemplo, master.
4. Deje la configuración de Versión predeterminada en Más reciente desde la rama predeterminada.
5. Escriba un Alias de origen para el repositorio. Por ejemplo, policyRepo.
Seleccione Agregar.
Cambie el nombre de la canalización para que refleje su intención. Por ejemplo, Implementar la canalización de directivas personalizadas.
Para guardar la configuración de canalización, seleccione Guardar.

Configurar variables de canalización

Las variables de la canalización proporcionan una manera cómoda de obtener los bits clave de los datos en varias partes de la canalización. Las siguientes variables proporcionan información sobre el entorno de Azure AD B2C.

Nombre	Value
`clientId`	Id. de aplicación (cliente) de la aplicación que registró anteriormente.
`clientSecret`	El valor del secreto de cliente que creó anteriormente. Cambie el tipo de variable a secreto (seleccione el icono de candado).
`tenantId`	`your-b2c-tenant.onmicrosoft.com`, donde your-b2c-tenant es el nombre del inquilino de Azure AD B2C.

Para agregar canalizaciones, siga estos pasos:

En la canalización, seleccione la pestaña Variables.
En Variables de canalización, agregue la variable anterior con sus valores.
Seleccione Guardar para guardar las variables.

Agregar tareas de canalización

Una tarea de canalización es un script empaquetado previamente que realiza una acción. Agregue una tarea que llame al script DeployToB2C.ps1 de PowerShell.

En la canalización que creó, seleccione la pestaña Tareas.
Seleccione Trabajo de agente y, a continuación, seleccione el signo más (+) para agregar una tarea al trabajo del agente.
Busque y seleccione PowerShell. No seleccione "Azure PowerShell", "PowerShell en equipos de destino" ni otra entrada de PowerShell.
Seleccione la tarea Script de PowerShell recién agregada.
Escriba los siguientes valores para la tarea Script de PowerShell:
- Versión de la tarea: 2.*
- Nombre para mostrar: El nombre de la directiva que debe cargar esta tarea. Por ejemplo, B2C_1A_TrustFrameworkBase.
- Tipo: Ruta del archivo
- Ruta de acceso del script: seleccione los puntos suspensivos (...), vaya a la carpeta Scripts y, a continuación, seleccione el archivo DeployToB2C.ps1.
- Argumentos: use el siguiente script de PowerShell.
```
-ClientID $(clientId) -ClientSecret $(clientSecret) -TenantId $(tenantId) -Folder $(System.DefaultWorkingDirectory)/policyRepo/B2CAssets/ -Files "TrustFrameworkBase.xml,TrustFrameworkLocalization.xml,TrustFrameworkExtensions.xml,SignUpOrSignin.xml,ProfileEdit.xml,PasswordReset.xml"
```
  El parámetro -Files es una lista de delimitadores de comas de archivos de directiva que se implementarán. Actualice la lista con los archivos de directiva.
  
  Importante
  
  Asegúrese de que las directivas se cargan en el orden correcto. En primer lugar, la directiva base, la directiva de extensiones y, después, las directivas de usuario de confianza. Por ejemplo, TrustFrameworkBase.xml,TrustFrameworkLocalization.xml,TrustFrameworkExtensions.xml,SignUpOrSignin.xml.
Seleccione Guardar para guardar el trabajo de agente.

Prueba de la canalización

Para probar la canalización de versión:

Seleccione Canalizaciones y luego Versiones.
Seleccione la canalización que creó anteriormente, por ejemplo DeployCustomPolicies.
Seleccione Crear versión y, a continuación, seleccione Crear para poner en cola la versión.

Debería ver un banner de notificación que indica que una versión se ha puesto en cola. Para ver su estado, seleccione el vínculo en el banner de notificación o selecciónelo en la lista de la pestaña Versiones.

Pasos siguientes

Más información sobre: