M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions m365con.net

Блог · Mirko Peters

Service Principals в Entra ID: лучшие практики и типичные проблемы

By ·

Что такое service principal, чем он отличается от регистрации приложения и какие практики безопасности документирует Microsoft: управляемые удостоверения, сертификаты, наименьшие привилегии, владельцы, а также известные подводные камни.

Automatically translated with AI from the original post. Read the English original

Service principal — это удостоверение, которое использует приложение внутри одного клиента Microsoft Entra. Оно определяет, к каким ресурсам приложение может обращаться в этом клиенте. Практики безопасности, которые документирует Microsoft, просты: отдавайте предпочтение управляемым удостоверениям, избегайте секретов, предоставляйте наименьшие привилегии, ограничивайте число владельцев и регулярно всё пересматривайте.

Ключевые выводы

  • Объект приложения — это глобальный шаблон в домашнем клиенте. Service principal — это локальный экземпляр в каждом клиенте, который определяет, что приложение может делать в этом клиенте.
  • Microsoft упорядочивает учётные данные от наиболее к наименее предпочтительным: управляемое удостоверение, федеративные учётные данные, сертификаты. Microsoft советует не использовать секреты (пароли).
  • Запрашивайте только минимально необходимое разрешение, отдавайте предпочтение делегированному доступу перед доступом только для приложения и удаляйте разрешения, которые приложению больше не нужны.
  • Держите минимальный набор владельцев, пересматривайте список владельцев каждые несколько месяцев и оставляйте не менее двух владельцев у каждого service principal.
  • Удалённые приложения и service principal можно восстановить в течение 30 дней. Пользователи без прав администратора могут создать не более 250 объектов приложений и service principal, включая удалённые.

Эта статья опирается на страницы Microsoft Learn об объектах приложения и service principal, о безопасности регистрации приложений и об удалении и восстановлении приложений. Там, где эти страницы расходятся или ничего не говорят, это отмечено.

Объект приложения и service principal

Microsoft описывает два объекта:

  • Объект приложения. Глобальное представление приложения. Он находится в клиенте, где было зарегистрировано приложение, — в домашнем клиенте. Он работает как шаблон для service principal, которые создаются на его основе.
  • Service principal. Локальное представление приложения в одном клиенте. Это субъект безопасности, который определяет политику доступа и разрешения приложения в этом клиенте.

Однотенантное приложение имеет один service principal в своём домашнем клиенте. Многотенантное приложение имеет один service principal в домашнем клиенте и по одному в каждом клиенте, где кто-то дал согласие на его использование. Регистрация приложения на портале создаёт оба объекта. Если вы регистрируете приложение через Microsoft Graph, создание service principal — отдельный шаг.

Изменения объекта приложения отражаются на его service principal только в домашнем клиенте. На service principal в других клиентах они не распространяются.

Три типа service principal

| Тип | Объект приложения | Можно ли его изменять? | |---|---|---| | Application | Да | Управляется объектом приложения, с настройками, специфичными для клиента | | Managed identity | Нет | Ей можно предоставить доступ, но напрямую изменить нельзя | | Legacy | Нет | Имеет изменяемые свойства, такие как учетные данные и URL-адреса для ответа |

Legacy-субъекты-службы используются только в клиенте, где они были созданы. В Microsoft Graph тип отображается в свойстве servicePrincipalType. В справочнике перечислено больше значений, чем эти три, в том числе ServiceIdentity (удостоверение агента) и SocialIdp (для внутреннего использования). Microsoft Graph документирует, что субъекту-службе типа Application, у которого отсутствует регистрация приложения, токены не выдаются.

Создайте его документированным способом

  1. Войдите в центр администрирования Microsoft Entra как минимум с ролью Cloud Application Administrator.
  2. Перейдите в Entra ID > App registrations и выберите New registration.
  3. Введите имя и выберите Accounts in this organizational directory only, если приложение является однотенантным.
  4. Выберите Register. Субъект-служба создается автоматически.

Для управления разрешениями, согласием и сведениями о входе используйте Enterprise applications. Для доступа к Azure на той же странице описано назначение роли на уровне подписки, группы ресурсов или ресурса, при этом разрешения наследуются нижестоящими областями. Выбор самой узкой области, которая подходит для задачи, — общая практика принципа наименьших привилегий, а не требование, указанное на этой странице.

Рекомендации Microsoft

Выберите правильный тип удостоверения

Рассмотрите managed identity вместо регистрации приложения, если служба работает в Azure, не выполняет вход пользователей, не является веб-API и не требует нескольких клиентов.

Расставьте учетные данные по приоритету

Microsoft перечисляет варианты от наиболее предпочтительного к наименее предпочтительному. На странице это не называется официальным рейтингом:

  1. Managed identity в качестве учетных данных. Microsoft называет этот вариант настоятельно рекомендуемым, поскольку он не требует управления учетными данными.
  2. Федеративные учетные данные от доверенной платформы. Microsoft советует соблюдать осторожность и настраивать федеративные учетные данные только для доверенных платформ.
  3. Сертификат. Храните его в хранилище ключей, например Azure Key Vault, и предпочитайте сертификат от доверенного центра сертификации.
  4. Секрет. На странице сказано: «Don't use password credentials.»

Связанные правила с той же страницы: используйте политики управления приложениями, чтобы ограничить срок действия секретов или запретить их, не размещайте учетные данные в публичных или установленных клиентах, часто обновляйте учетные данные, никогда не делитесь ими между приложениями и избегайте большого количества учетных данных у одного приложения. Также рекомендуется использовать сканер учетных данных в конвейерах сборки, чтобы учетные данные не попадали в репозитории. На странице не указан фиксированный интервал ротации.

Контролируйте URI перенаправления

Владейте каждым URI перенаправления, следите за DNS-записями, стоящими за ними, избегайте подстановочных знаков и небезопасных схем, таких как http, и сокращайте список. На странице сказано, что утрата контроля над одним из URI может привести к компрометации приложения.

Ограничивайте разрешения

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

Заблокируйте экземпляр и ограничьте число владельцев

Администратор клиента может настроить субъект-службу в любом клиенте, что может привести к непредвиденным изменениям, например к добавлению учетных данных, которыми должен управлять владелец приложения. Microsoft рекомендует настроить блокировку свойства экземпляра приложения и заблокировать все доступные чувствительные свойства. Это особенно критично для многотенантных приложений.

Держите владение приложением в минимальном кругу лиц. Администратор должен проверять список владельцев раз в несколько месяцев. Этот процесс можно автоматизировать с помощью проверок доступа Microsoft Entra. В справочнике Microsoft Graph добавлена рекомендация иметь не менее двух владельцев на каждый субъект-службу.

Правильно используйте URI идентификаторов

Для приложений, которые получают токены v1.0, используйте только URI по умолчанию: api://<appId> и api://<tenantId>/<appId>. Для токенов v2.0 рекомендуемый формат — api://<appId>. Значение должно быть уникальным в клиенте и не должно заканчиваться косой чертой. Ресурсным приложениям с пользовательскими URI идентификаторов следует использовать формат токенов доступа v2.0.

Частые проблемы и что говорит документация

Входы трудно отследить. В Entra есть отдельные журналы входа для субъектов-служб и управляемых удостоверений, помимо входов пользователей. Откройте центр администрирования Microsoft Entra с ролью не ниже «Читатель отчетов» и перейдите: Entra ID > Мониторинг и работоспособность > Журналы входа. На странице, которую я читал, не сказано, на какой вкладке показываются входы субъектов-служб.

Приложение перестает получать токены. Проверьте, что регистрация приложения еще существует. Также проверьте свойства accountEnabled и appRoleAssignmentRequired у субъекта-службы. Если accountEnabled имеет значение false, никто не сможет войти, даже при назначении. Если appRoleAssignmentRequired имеет значение true, сначала нужно назначить роль приложения.

Ошибка квоты при создании. Пользователь без прав администратора может создать не более 250 приложений и субъектов-служб в сумме. Учитываются и активные объекты, и удаленные объекты, которые еще можно восстановить. Квота освобождается только при окончательном удалении из контейнера удаленных элементов.

Восстановление вернуло не всё. В Learn есть два утверждения. На странице об объектах приложений сказано, что восстановление объекта приложения в интерфейсе «Регистрации приложений» не восстанавливает его субъект-службу. В FAQ по удалению и восстановлению сказано, что если удалены оба объекта, восстановление регистрации также восстанавливает субъект-службу. Проверяйте результат после любого восстановления. Там же сказано, что политики субъектов-служб восстановить нельзя, их нужно настроить заново, а данные о подготовке могут появиться через период от 40 минут до 1 дня.

Нужно приостановить приложение, а не удалять его. В Learn описано деактивирование приложения. Оно останавливает выдачу новых токенов и сохраняет объекты для расследования или последующей реактивации.

Краткая процедура проверки

  1. Найдите приложения с секретами и перейдите на сертификаты или управляемые удостоверения.
  2. Удалите разрешения, которыми никто не пользуется.
  3. Проверьте владельцев и даты истечения срока действия.
  4. Проверьте, что домены URI перенаправления по-прежнему принадлежат вам.
  5. Просмотрите журналы входа субъектов-служб для неиспользуемых приложений.

Связанное

Источники

Подписаться на подкастApple PodcastsSpotify

FAQ

В чём разница между регистрацией приложения и service principal?

По данным Microsoft Learn, объект приложения (регистрация приложения) — это глобальное представление приложения, которое находится в его домашнем клиенте. Service principal — это локальное представление в конкретном клиенте, которое определяет там политику доступа и разрешения. Регистрация приложения на портале создаёт оба объекта в домашнем клиенте.

Что использовать для service principal: клиентский секрет или сертификат?

Рекомендации Microsoft по безопасности ставят управляемое удостоверение на первое место как настоятельно рекомендуемый вариант, затем федеративные учётные данные — только с платформ, которым вы доверяете, и, если ни один из этих вариантов невозможен, учётные данные в виде сертификата. Microsoft советует не использовать учётные данные на основе пароля, то есть секреты.

Когда следует использовать управляемое удостоверение вместо service principal?

Microsoft Learn называет четыре условия: сервис работает в Azure, он не выполняет вход от имени пользователей, он не выступает в роли ресурса веб-API и ему не нужно работать в нескольких клиентах. Если все четыре условия выполняются, рассмотрите управляемое удостоверение. Управляемое удостоверение — это тоже разновидность service principal, но напрямую его редактировать нельзя.

Можно ли восстановить удалённый service principal?

Согласно FAQ Microsoft Learn по удалению и восстановлению, удалённые мягким способом приложения и service principal можно восстановить в течение 30 дней, после чего они удаляются окончательно. Регистрации приложений восстанавливаются в центре администрирования Microsoft Entra. Service principal восстанавливаются с помощью PowerShell или Microsoft Graph, поскольку удалённые service principal в центре администрирования не отображаются.

Почему при создании приложений появляется ошибка Directory_QuotaExceeded?

В FAQ Learn сказано, что пользователь без прав администратора может создать не более 250 приложений и service principal, при этом учитываются как активные объекты, так и удалённые, но ещё подлежащие восстановлению. Само по себе удаление объектов квоту не освобождает. Их нужно окончательно удалить из контейнера удалённых элементов.

Entities in this article

Темы этой статьи:

Service principal – Понятие Microsoft Entra ID – Инструмент идентификации и безопасности от Microsoft Application registration – Подтема в рамках темы «Microsoft Entra ID» Управляемое удостоверение – Понятие

Related articles

Другие статьи на тему Service principal:

RSS