Настройка пользовательской домашней страницы для опубликованных приложений с помощью прокси приложения Microsoft Entra

  • Статья

В этой статье описывается настройка приложений для направления пользователей на пользовательскую домашнюю страницу. При публикации приложения с прокси-сервером приложения вы устанавливаете внутренний URL-адрес, но иногда это не страница, которую должен увидеть пользователь. Задайте пользовательскую домашнюю страницу, чтобы пользователь смог перейти на нужную страницу при обращении к приложениям. Пользователь видит настраиваемую домашнюю страницу независимо от того, обращается ли он к приложению из microsoft Entra Мои приложения или средства запуска приложений Microsoft 365.

Пользователь, открывающий это приложение, по умолчанию перенаправляется на URL-адрес корневого домена опубликованного приложения. Обычно целевой страницей считается URL-адрес домашней страницы приложения. Используйте модуль PowerShell Azure AD для определения URL-адреса пользовательской домашней страницы, если вы хотите, чтобы пользователь переходил на определенную страницу в приложении.

Ниже приведен один из сценариев, в котором объясняется, почему ваша компания могла бы задать пользовательскую домашнюю страницу:

  • В корпоративной сети пользователь может перейти по адресу https://ExpenseApp/login/login.aspx, чтобы войти и получить доступ к вашему приложению.
  • Так как у вас есть другие ресурсы (например, изображения), к которым прокси приложения должен получить доступ на верхнем уровне структуры папок, вы публикуете приложение с https://ExpenseApp внутренним URL-адресом.
  • Внешний URL-адрес по умолчанию — https://ExpenseApp-contoso.msappproxy.net. Он не переводит пользователей на страницу входа.
  • Вместо этого в качестве URL-адреса домашней страницы лучше задать https://ExpenseApp-contoso.msappproxy.net/login/login.aspx, чтобы внешний пользователь сначала видел страницу входа.

Примечание.

Когда вы предоставляете пользователям доступ к опубликованным приложениям, они отображаются на странице Мои приложения и в средстве запуска приложений Office 365.

Перед началом работы

Прежде чем указывать URL-адрес домашней страницы, учтите следующие требования:

  • Указанный путь должен быть путем к поддомену URL-адреса корневого домена.

    Например, если URL-адресом корневого домена является https://apps.contoso.com/app1/, то настраиваемый URL-адрес домашней страницы должен начинаться с https://apps.contoso.com/app1/.

  • Когда вы вносите изменения в опубликованное приложение, URL-адрес домашней страницы может вернуться к значению по умолчанию. Поэтому при дальнейшем обновлении приложения следует повторно проверить URL-адрес домашней страницы и изменить его при необходимости.

Url-адрес домашней страницы можно задать в Центре администрирования Microsoft Entra или с помощью PowerShell.

Изменение домашней страницы в Центре администрирования Microsoft Entra

Чтобы изменить URL-адрес домашней страницы приложения через Центр администрирования Microsoft Entra, выполните следующие действия.

  1. Войдите в Центр администрирования Microsoft Entra как минимум приложение Администратор istrator.

  2. В правом верхнем углу выберите свое имя пользователя. Убедитесь, что вы вошли в каталог, использующий прокси приложения. Если необходимо изменить каталоги, выберите "Переключить каталог " и выберите каталог, использующий прокси приложения.

  3. Перейдите к приложениям> удостоверений>Регистрация приложений. Откроется список зарегистрированных приложений.

  4. Выберите приложение из списка. Откроется страница с подробными сведениями о зарегистрированном приложении.

  5. В разделе Управление выберите Фирменная символика.

  6. Укажите новый путь в поле URL-адрес домашней страницы.

    Страница

  7. Выберите Сохранить.

Изменение домашней страницы с помощью PowerShell

Чтобы настроить домашнюю страницу приложения с помощью PowerShell, выполните следующие действия:

  1. Установите модуль Azure AD PowerShell.
  2. Найдите значение ObjectId для приложения.
  3. Обновите URL-адрес домашней страницы приложения с помощью команд PowerShell.

Установка модуля Azure AD PowerShell

Прежде чем настраивать URL-адрес пользовательской домашней страницы с помощью PowerShell, установите модуль Azure AD PowerShell. Этот пакет можно скачать из коллекции PowerShell, в которой используется конечная точка API Graph.

Для установки пакета выполните следующие действия.

  1. Откройте стандартное окно PowerShell и выполните следующую команду.

    Install-Module -Name AzureAD

    Если вы выполняете команду без прав администратора, используйте этот -scope currentuser параметр.

  2. Во время установки выберите ответ Y, чтобы установить два пакета с сайта Nuget.org. Оба пакета являются обязательными.

Поиск ObjectId для приложения

ObjectId для приложения можно получить, выполнив поиск приложения по его отображаемому имени или домашней странице.

  1. В том же окне PowerShell импортируйте модуль Microsoft Entra.

    Import-Module AzureAD

  2. Войдите в модуль Microsoft Entra от имени администратора клиента.

    Connect-AzureAD

  3. Найдите приложение. В этом примере для поиска ObjectId используется PowerShell, где выполняется поиск приложения с отображаемым именем SharePoint.

    Get-AzureADApplication | Where-Object { $_.DisplayName -eq "SharePoint" } | Format-List DisplayName, Homepage, ObjectId

    Вы должны получить результат, похожий на приведенный ниже. Скопируйте GUID ObjectId для использования в следующем разделе.

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

    Кроме того, можно просто извлечь список всех приложений, найти в списке приложение с конкретным отображаемым именем или домашней страницей, а когда приложение будет найдено, скопировать его ObjectId.

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

Изменение URL-адреса домашней страницы

Создайте URL-адрес домашней страницы и обновите приложение, указав это значение. Продолжайте использовать то же окно PowerShell или, если вы используете новое окно PowerShell, войдите в модуль Microsoft Entra еще раз с помощью Connect-AzureAD. Затем выполните следующие шаги:

  1. Создайте переменную для хранения скопированного ObjectId значения.

    $objguid = "<object id>"

  2. Убедитесь в том, что у вас правильное приложение, выполнив приведенную ниже команду. Выходные данные должны быть идентичны тем выходным данным, которые были представлены в предыдущем разделе (Поиск ObjectId приложения).

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

  3. Создайте пустой объект приложения, в котором будут храниться ваши изменения.

    $appnew = New-Object "Microsoft.Open.AzureAD.Model.Application"

  4. Задайте нужное значение для URL-адреса домашней страницы. Это значение должно быть путем к поддомену опубликованного приложения. Например, если изменить URL-адрес домашней страницы с https://sharepoint-iddemo.msappproxy.net/ на https://sharepoint-iddemo.msappproxy.net/hybrid/, пользователи приложения перейдут непосредственно на пользовательскую домашнюю страницу.

    $homepage = "https://sharepoint-iddemo.msappproxy.net/hybrid/"

  5. Обновите домашнюю страницу.

    Set-AzureADApplication -ObjectId $objguid -Homepage $homepage

  6. Чтобы убедиться, что изменение прошло успешно, снова выполните следующую команду из шага 2.

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

    В нашем примере выходные данные должны выглядеть следующим образом:

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

  7. Перезапустите приложение, чтобы убедиться, что домашняя страница отображается в качестве первого экрана, как и ожидалось.

Примечание.

Все изменения, которые вы внесли в приложение, могут сбросить URL-адрес домашней страницы. В случае сброса URL-адреса домашней страницы повторите шаги в этом разделе, чтобы снова задать его.

Следующие шаги