Service Principals в Entra ID: найкращі практики та типові проблеми
By Mirko Peters ·
Що таке 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
| Тип | Об'єкт застосунку | Чи можна його редагувати? | |---|---|---| | Застосунок | Так | Керується об'єктом застосунку, з параметрами, специфічними для клієнта | | Керована ідентичність | Ні | Їй можна надати доступ, але безпосередньо змінити її не можна | | Застарілий | Ні | Має редаговані властивості, зокрема облікові дані та URL-адреси відповіді |
Застарілі субʼєкти-служби використовуються лише в клієнті, де їх було створено. У Microsoft Graph тип відображається у властивості servicePrincipalType. У довідці наведено більше значень, ніж ці три, зокрема ServiceIdentity (ідентичність агента) та SocialIdp (для внутрішнього використання). Microsoft Graph документує, що субʼєкт-служба застосунку, для якого відсутня реєстрація застосунку, не отримує видані токени.
Створіть один задокументованим способом
- Увійдіть до центру адміністрування Microsoft Entra щонайменше з роллю Адміністратор хмарних застосунків.
- Перейдіть до Entra ID > Реєстрації застосунків і виберіть Нова реєстрація.
- Введіть назву та виберіть Облікові записи лише в цьому організаційному каталозі, якщо застосунок є однокліснтним.
- Виберіть Зареєструвати. Субʼєкт-служба створюється автоматично.
Щоб згодом керувати дозволами, згодою та інформацією про вхід, використовуйте Корпоративні застосунки. Для доступу до Azure на цій самій сторінці описано призначення ролі на рівні підписки, групи ресурсів або ресурсу, а дозволи успадковуються нижчими рівнями. Вибір найвужчої області, яка працює, є загальною практикою найменших привілеїв, а не вимогою, викладеною на сторінці.
Найкращі практики від Microsoft
Оберіть правильний тип ідентичності
Розгляньте керовану ідентичність замість реєстрації застосунку, якщо служба працює в Azure, не виконує вхід користувачів, не є веб-API і не потребує кількох клієнтів.
Розташуйте облікові дані за пріоритетом
Microsoft перелічує варіанти від найбажанішого до найменш бажаного. На сторінці це не названо формальним рейтингом:
- Керована ідентичність як облікові дані. Microsoft називає це настійно рекомендованим, оскільки воно не потребує керування обліковими даними.
- Федеративні облікові дані з довіреної платформи. Microsoft радить бути обережними та налаштовувати федеративні облікові дані лише з довірених платформ.
- Сертифікат. Зберігайте його в сховищі ключів, наприклад Azure Key Vault, і надавайте перевагу сертифікату від довіреного центру сертифікації.
- Секрет. На сторінці сказано: "Не використовуйте облікові дані на основі пароля."
Пов'язані правила з тієї самої сторінки: використовуйте політики керування застосунками, щоб обмежити строки дії секретів або заблокувати їх, не розміщуйте облікові дані на публічних або встановлених клієнтах, часто оновлюйте облікові дані, ніколи не діліться ними між застосунками та уникайте великої кількості облікових даних в одному застосунку. Також рекомендовано використовувати сканер облікових даних у конвеєрах збирання, щоб облікові дані не потрапляли до репозиторіїв. На сторінці не наведено фіксованого інтервалу ротації.
Контролюйте URI перенаправлення
Володійте кожним URI перенаправлення, стежте за записами DNS, що стоять за ними, уникайте шаблонів (wildcard) і небезпечних схем, таких як http, та регулярно очищуйте список. На сторінці сказано, що втрата контролю над одним URI може призвести до компрометації застосунку.
Обмежуйте дозволи
Запитуйте лише найменш надальні дозволи, періодично переглядайте дозволи та видаляйте ті, які застосунку більше не потрібні. За можливості надавайте перевагу делегованому доступу перед доступом лише для застосунку.
Заблокуйте екземпляр і обмежте коло власників
Адміністратор клієнта може налаштувати субʼєкт-службу в будь-якому клієнті, що може призвести до несподіваних змін, наприклад до облікових даних, якими має керувати власник застосунку. Microsoft рекомендує налаштувати блокування властивостей екземпляра застосунку та заблокувати кожну доступну чутливу властивість. Це особливо важливо для багатоклієнтних застосунків.
Залишайте право власності на застосунок за мінімальною кількістю людей. Адміністратор має переглядати список власників раз на кілька місяців. Цей процес можна автоматизувати за допомогою оглядів доступу Microsoft Entra. У довідці Microsoft Graph додано рекомендацію мати щонайменше двох власників для кожного субʼєкта-служби.
Правильно використовуйте URI ідентифікаторів
Для застосунків, які отримують токени v1.0, використовуйте лише типові URI: api://<appId> та api://<tenantId>/<appId>. Для токенів v2.0 рекомендованим форматом є api://<appId>. Значення має бути унікальним у клієнті та не завершуватися косою рискою. Ресурсні застосунки з нестандартними URI ідентифікаторів мають використовувати формат токенів доступу v2.0.
Типові проблеми та що кажуть документи
Входи важко відстежити. У Entra окремі журнали входів для service principal і керованих ідентичностей, окремо від входів користувачів. Відкрийте Microsoft Entra admin center з роллю щонайменше Reports Reader і перейдіть до Entra ID > Monitoring & health > Sign-in logs. На сторінці, яку я читав, не сказано, на якій вкладці показано входи service principal.
Застосунок перестає отримувати токени. Перевірте, що реєстрація застосунку ще існує. Також перевірте властивості accountEnabled і appRoleAssignmentRequired для service principal. Якщо accountEnabled має значення false, жоден користувач не зможе увійти, навіть якщо йому призначено доступ. Якщо appRoleAssignmentRequired має значення true, спочатку потрібно призначити роль застосунку.
Помилка квоти під час створення. Користувач без ролі адміністратора може створити не більше 250 застосунків і service principal разом. Враховуються як активні об'єкти, так і видалені об'єкти, які можна відновити. Квоту звільняє лише остаточне видалення з контейнера видалених елементів.
Відновлення повернуло не все. У документації Learn є два твердження. На сторінці про об'єкти застосунків сказано, що відновлення об'єкта застосунку в інтерфейсі App registrations не відновлює його service principal. У поширених запитаннях про видалення та відновлення сказано, що якщо видалено обидва об'єкти, відновлення реєстрації також відновлює service principal. Перевіряйте результат після будь-якого відновлення. Там же сказано, що політики service principal відновити не можна, їх потрібно налаштувати знову, а дані про provisioning можуть з'являтися повторно протягом від 40 хвилин до 1 доби.
Потрібно призупинити застосунок, а не видаляти його. У Learn описано деактивацію застосунку. Вона зупиняє видачу нових токенів і зберігає об'єкти для розслідування або подальшої реактивації.
Короткий регламент перевірки
- Складіть список застосунків із секретами та перейдіть на сертифікати або керовані ідентичності.
- Видаліть дозволи, які ніхто не використовує.
- Перевірте власників і дати закінчення строку дії.
- Переконайтеся, що домени URI перенаправлення все ще належать вам.
- Перегляньте журнали входів service principal на предмет невикористовуваних застосунків.
Пов’язане
Джерела
- Microsoft Learn: Найкращі практики безпеки для властивостей застосунків у Microsoft Entra ID
- Microsoft Learn: Об'єкти застосунків і субʼєкти-служби в Microsoft Entra ID
- Microsoft Learn: Реєстрація застосунку Microsoft Entra та створення субʼєкта-служби
- Microsoft Learn: Видалення та відновлення застосунків і субʼєктів-служб
- Microsoft Learn: servicePrincipal resource type (Microsoft Graph)
- Microsoft Learn: журнали входу в Microsoft Entra ID
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, і при цьому враховуються як активні, так і відновлювані видалені об'єкти. Саме лише видалення об'єктів не звільняє квоту. Їх потрібно остаточно видалити з контейнера видалених елементів.