Establecimiento de una página principal personalizada para aplicaciones publicadas mediante el proxy de aplicación de Microsoft Entra
Artículo
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.
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:
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.
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.
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).
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.
Reinicie la aplicación para confirmar que la página principal aparece como la primera pantalla, tal como se espera.
Nota
Los cambios realizados en la aplicación pueden restablecer la dirección URL de la página principal. Si la dirección URL de la página principal se restablece, repita los pasos de esta sección para volver a establecerlo de nuevo.
Planee y ejecute una estrategia de implementación de puntos de conexión mediante elementos esenciales de la administración moderna, los enfoques de administración conjunta y la integración de Microsoft Intune.