Establecimiento de una página principal personalizada para aplicaciones publicadas mediante el proxy de aplicación de Microsoft Entra

Artículo
02/26/2024

En este artículo se explica cómo configurar una aplicación para que dirija a un usuario a una página principal personalizada. Al publicar una aplicación con el proxy de la aplicación, se establece una dirección URL interna pero, a veces, esa no es la primera página que debe ver un usuario. Establezca una página principal personalizada para que un usuario vaya a la página correcta cuando acceda a la aplicación. Un usuario ve la página principal personalizada que ha establecido, independientemente de si accede a la aplicación desde Aplicaciones de Microsoft Entra o desde el iniciador de aplicaciones de Microsoft 365.

Cuando un usuario inicia la aplicación, se le dirige de manera predeterminada a la dirección URL raíz del dominio raíz de la aplicación publicada. La página de aterrizaje normalmente se establece como la dirección URL de la página principal. Use el módulo de Azure AD PowerShell para definir las direcciones URL de una página principal personalizada cuando desee que un usuario de la aplicación llegue a una página concreta de la aplicación.

En este escenario se explica por qué la empresa establecería una página principal personalizada:

En su red corporativa, un usuario va a https://ExpenseApp/login/login.aspx para iniciar sesión y acceder a su aplicación.
Dado que tiene otros recursos, como imágenes, que el proxy de aplicación necesita para acceder al nivel superior de la estructura de carpetas, publica la aplicación con https://ExpenseApp como dirección URL interna.
La dirección URL externa predeterminada es https://ExpenseApp-contoso.msappproxy.net, que no lleva a un usuario externo a la página de inicio de sesión.
En su lugar, quiere establecer https://ExpenseApp-contoso.msappproxy.net/login/login.aspx como la dirección URL de la página principal para que un usuario externo vea primero la página de inicio de sesión.

Nota:

Al proporcionar a los usuarios acceso a las aplicaciones publicadas, estas aparecen en Aplicaciones y el iniciador de aplicaciones de Office 365.

Antes de comenzar

Antes de establecer la dirección URL de la página principal tenga en cuenta los siguientes requisitos:

La ruta de acceso que especifica debe ser una ruta de acceso de subdominio de la dirección URL del dominio raíz.

Por ejemplo, si la dirección URL del dominio raíz es https://apps.contoso.com/app1/, la dirección URL de la página principal que configure debe empezar con https://apps.contoso.com/app1/.
Si realiza un cambio en la aplicación publicada, este podría restablecer el valor de la dirección URL de la página principal. Si actualiza la aplicación en el futuro, debe volver a comprobar y, si es necesario, actualizar la dirección URL de la página principal.

Puede establecer la dirección URL de la página principal a través del centro de administración de Microsoft Entra o mediante PowerShell.

Cambiar la página principal en el centro de administración de Microsoft Entra

Para cambiar la dirección URL de la página principal de su aplicación a través del centro de administración de Microsoft Entra, siga estos pasos:

Inicie sesión en el Centro de administración de Microsoft Entra al menos como Administrador de aplicaciones.
En la esquina superior derecha, seleccione su nombre de usuario. Compruebe que ha iniciado sesión en el directorio que usa el proxy de aplicación. Si necesita cambiar directorios, seleccione Cambiar directorio y elija un directorio que use el proxy de aplicación.
Vaya aIdentidad>Aplicaciones>Registros de aplicaciones. Aparece la lista de aplicaciones registradas.
Elija la aplicación en la lista. Aparece una página que muestra los detalles de la aplicación registrada.
En Administrar, seleccione Personalización de marca.
Actualice la dirección URL de página principal con la nueva ruta de acceso.
Seleccione Guardar.

Cambio de la página principal con PowerShell

Para configurar la página principal de una aplicación con PowerShell, necesitará lo siguiente:

Instale el módulo de PowerShell de Azure AD.
Busque el valor ObjectId de la aplicación.
Actualice la dirección URL de la página principal de la aplicación con comandos de PowerShell.

Instalación del módulo de PowerShell de Azure AD

Para poder definir la dirección URL de la página principal personalizada mediante PowerShell, instale el módulo de Azure AD PowerShell. Puede descargar este paquete desde la Galería de PowerShell, que utiliza el punto de conexión de Graph API.

Para instalar el paquete, siga estos pasos:

Abra una ventana de PowerShell estándar y luego ejecute el siguiente comando:
```
Install-Module -Name AzureAD
```
Si ejecuta el comando sin derechos administrativos, use la opción -scope currentuser.
Durante la instalación, seleccione Y para instalar dos paquetes de Nuget.org. Se requieren ambos paquetes.

Búsqueda del valor de ObjectID de la aplicación

Puede obtener el valor de ObjectId de la aplicación si busca la aplicación por su nombre para mostrar o su página principal.

En la misma ventana de PowerShell, importe el módulo Microsoft Entra.
```
Import-Module AzureAD
```
Inicie sesión en el módulo Microsoft Entra como administrador de inquilinos.
```
Connect-AzureAD
```
Busque la aplicación. En este ejemplo se usa PowerShell para buscar el valor de ObjectId buscando la aplicación con un nombre para mostrar de SharePoint.
```
Get-AzureADApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, Homepage, ObjectId
```
Debe obtener un resultado similar al que se muestra aquí. Copie el GUID de ObjectId para usarlo en la siguiente sección.
```
DisplayName : SharePoint
Homepage    : https://sharepoint-iddemo.msappproxy.net/
ObjectId    : 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4
```
También podría simplemente extraer la lista de todas las aplicaciones, buscar en ella la aplicación con determinado nombre para mostrar o página principal y copiar el valor de ObjectId de la aplicación una vez que la encuentra.
```
Get-AzureADApplication | Format-List DisplayName, Homepage, ObjectId
```

Actualización de la dirección URL de la página principal

Cree la dirección URL de la página principal y actualice la aplicación con ese valor. Siga usando la misma ventana de PowerShell o, si usa una ventana nueva de PowerShell, vuelva a iniciar sesión en el módulo de Microsoft Entra con Connect-AzureAD. A continuación, siga estos pasos:

Cree una variable que contenga el valor ObjectId que copió.
```
$objguid = "<object id>"
```
Ejecute el comando siguiente para confirmar que tiene la aplicación correcta. La salida debe ser idéntica a la que vio en la sección anterior (Búsqueda del valor de ObjectId de la aplicación).
```
Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId
```
Cree un objeto de aplicación en blanco para que contenga los cambios que desea realizar.
```
$appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"
```
Establezca la dirección URL de la página principal en el valor que quiera. El valor debe ser una ruta de acceso de subdominio de la aplicación publicada. Por ejemplo, si cambia la dirección URL de página principal de https://sharepoint-iddemo.msappproxy.net/ a https://sharepoint-iddemo.msappproxy.net/hybrid/, los usuarios de la aplicación pasan directamente a la página principal personalizada.
```
$homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"
```

Actualice la página principal.

Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

Para confirmar que el cambio se realizó correctamente, vuelva a ejecutar este comando del paso 2.

Get-AzureADApplication -ObjectId $objguid | Format-List DisplayName, Homepage, ObjectId

En nuestro ejemplo, la salida debería aparecer como se muestra a continuación:

DisplayName : SharePoint
Homepage    : https://sharepoint-iddemo.msappproxy.net/hybrid/
ObjectId    : 8af89bfa-eac6-40b0-8a13-c2c4e3ee22a4

Reinicie la aplicación para confirmar que la página principal aparece como la primera pantalla, tal como se espera.