M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions m365con.net

Blog · Mirko Peters

Service principals in Entra ID: best practices en veelvoorkomende problemen

By ·

Wat een service principal is, hoe die verschilt van een app-registratie, en de beveiligingspraktijken die Microsoft documenteert: beheerde identiteiten, certificaten, minimale rechten, eigenaars, plus bekende valkuilen.

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

Een service principal is de identiteit die een applicatie gebruikt binnen één Microsoft Entra-tenant. Hij bepaalt wat de app daar mag openen. De beveiligingspraktijken die Microsoft documenteert zijn kort: geef de voorkeur aan beheerde identiteiten, vermijd geheimen, geef minimale rechten, beperk het aantal eigenaars en controleer dit alles volgens een vast schema.

Belangrijkste punten

  • Het applicatieobject is de globale blauwdruk in de thuistenant. De service principal is de lokale instantie in elke tenant die bepaalt wat de app daar kan doen.
  • Microsoft rangschikt referenties van voorkeur naar minst gewenst: beheerde identiteit, federated credentials, certificaten. Er staat dat je geen geheimen (wachtwoorden) moet gebruiken.
  • Vraag alleen de minst ruime machtiging aan, geef de voorkeur aan gedelegeerde toegang boven app-only toegang, en verwijder machtigingen die de app niet meer nodig heeft.
  • Houd het aantal eigenaars beperkt, controleer de lijst met eigenaars om de paar maanden en zorg dat er per service principal minstens twee eigenaars zijn.
  • Verwijderde apps en service principals kunnen tot 30 dagen worden hersteld. Gebruikers zonder beheerdersrol kunnen maximaal 250 app- en service principal-objecten maken, verwijderde meegerekend.

Dit artikel volgt de Microsoft Learn-pagina's over applicatie- en service principal-objecten, beveiliging van app-registraties, en het verwijderen en herstellen van apps. Waar die pagina's elkaar tegenspreken of niets zeggen, wordt dat expliciet vermeld.

Applicatieobject versus service principal

Microsoft beschrijft twee objecten:

  • Applicatieobject. De globale representatie van de app. Het staat in de tenant waarin de app is geregistreerd, de thuistenant genoemd. Het werkt als een sjabloon voor de service principals die ervan worden gemaakt.
  • Service principal. De lokale representatie van de app in één tenant. Het is de beveiligingsprincipal die het toegangsbeleid en de machtigingen van de app in die tenant bepaalt.

Een app met één tenant heeft één service principal, in de thuistenant. Een app met meerdere tenants heeft er één in de thuistenant plus één in elke tenant waar iemand toestemming heeft gegeven. Een app registreren in de portal maakt beide objecten aan. Als je registreert via Microsoft Graph, is het aanmaken van de service principal een aparte stap.

Wijzigingen aan het applicatieobject worden alleen in de thuistenant doorgevoerd naar de service principal. Ze worden niet doorgegeven aan service principals in andere tenants.

De drie typen service principal

| Type | Gekoppeld app-object | Kun je het bewerken? | |---|---|---| | Application | Ja | Wordt beheerd via het app-object, met tenantspecifieke instellingen | | Managed identity | Nee | Kan toegang krijgen, maar wordt niet rechtstreeks gewijzigd | | Legacy | Nee | Heeft bewerkbare eigenschappen, zoals referenties en reply-URL's |

Legacy service principals worden alleen gebruikt in de tenant waarin ze zijn aangemaakt. In Microsoft Graph verschijnt het type als de eigenschap servicePrincipalType. De referentie vermeldt meer waarden dan deze drie, waaronder ServiceIdentity (een agent-identiteit) en SocialIdp (voor intern gebruik). Microsoft Graph documenteert dat een Application service principal waarvan de app-registratie ontbreekt, geen tokens meer uitgegeven krijgt.

Maak er een aan op de gedocumenteerde manier

  1. Meld je aan bij het Microsoft Entra-beheercentrum als minimaal Cloud Application Administrator.
  2. Ga naar Entra ID > App-registraties en selecteer Nieuwe registratie.
  3. Voer een naam in en kies Alleen accounts in deze organisatiemap als de app single tenant is.
  4. Selecteer Registreren. De service principal wordt automatisch aangemaakt.

Gebruik daarna Enterprise-toepassingen om machtigingen, toestemming en aanmeldingsinformatie te beheren. Voor Azure-toegang beschrijft dezelfde pagina hoe je een rol toewijst op abonnements-, resourcegroep- of resourcescope, waarbij machtigingen worden overgeërfd door lagere scopes. Het kiezen van de smalst mogelijke scope die werkt, is algemene least-privilege-praktijk en geen vereiste die op die pagina wordt genoemd.

Best practices van Microsoft

Kies het juiste identiteitstype

Overweeg een managed identity in plaats van een app-registratie wanneer de service in Azure draait, geen gebruikers aanmeldt, geen web-API is en geen meerdere tenants nodig heeft.

Rangschik je referenties

Microsoft zet de opties van meest naar minst gewenst. De pagina noemt dit geen formele rangschikking:

  1. Een managed identity als referentie. Microsoft noemt dit sterk aanbevolen, omdat er geen referenties hoeven te worden beheerd.
  2. Federated credentials van een platform dat je vertrouwt. Microsoft adviseert voorzichtigheid en zegt dat je federated credentials alleen mag configureren voor platforms die je vertrouwt.
  3. Een certificaat. Bewaar het in een key vault, zoals Azure Key Vault, en gebruik bij voorkeur een certificaat van een betrouwbare certificeringsinstantie.
  4. Een geheim. De pagina zegt: "Gebruik geen wachtwoordreferenties."

Aanvullende regels van dezelfde pagina: gebruik toepassingsbeheerbeleid om de levensduur van geheimen te beperken of geheimen te blokkeren, plaats geen referenties in publieke of geïnstalleerde clients, roteer referenties regelmatig, deel referenties nooit tussen apps en vermijd veel referenties op één app. Ook raadt de pagina een credential scanner in build-pipelines aan, zodat referenties niet in repositories terechtkomen. De pagina geeft geen vast roteerinterval.

Houd redirect-URI's onder controle

Zorg dat je elke redirect-URI beheert, let op de DNS-records erachter, vermijd wildcards en onveilige schema's zoals http, en houd de lijst kort. De pagina zegt dat een verloren eigenaarschap van één URI kan leiden tot compromittering van de app.

Beperk machtigingen

Vraag alleen de minst permissieve machtiging aan, controleer machtigingen periodiek en verwijder machtigingen die de app niet meer nodig heeft. Geef waar mogelijk de voorkeur aan gedelegeerde toegang boven app-only toegang.

Vergrendel de instantie en beperk de eigenaren

Een tenantbeheerder kan de service principal in elke tenant aanpassen, wat onverwachte wijzigingen kan toevoegen, zoals referenties die de app-eigenaar zelf zou moeten beheren. Microsoft raadt aan de vergrendeling van de app-instantie-eigenschap in te stellen en elke gevoelige eigenschap die beschikbaar is te vergrendelen. Dit is vooral kritiek voor multitenant-apps.

Houd het eigenaarschap van applicaties beperkt tot een kleine groep personen. Een beheerder moet de lijst met eigenaren eens in de paar maanden controleren. Microsoft Entra access reviews kunnen dat automatiseren. In de Microsoft Graph-referentie staat daarnaast de aanbeveling om minimaal twee eigenaren per service principal te hebben.

Gebruik identifier-URI's correct

Voor apps die v1.0-tokens ontvangen, gebruik je alleen de standaard-URI's, api://<appId> en api://<tenantId>/<appId>. Voor v2.0-tokens is api://<appId> het aanbevolen formaat. De waarde moet uniek zijn in de tenant en mag niet eindigen op een schuine streep. Resource-apps met aangepaste identifier-URI's moeten het v2.0-toegangstokenformaat gebruiken.

Veelvoorkomende problemen en wat de documentatie zegt

Aanmeldingen zijn moeilijk te traceren. Entra heeft aparte aanmeldingslogboeken voor service principals en beheerde identiteiten, los van gebruikersaanmeldingen. Open het Microsoft Entra-beheercentrum als minstens Reports Reader en ga naar Entra ID > Bewaking en status > Aanmeldingslogboeken. De pagina die ik las vermeldt niet welk tabblad de aanmeldingen van service principals toont.

Een app krijgt geen tokens meer. Controleer of de app-registratie nog bestaat. Controleer ook de eigenschappen accountEnabled en appRoleAssignmentRequired op de service principal. Als accountEnabled op false staat, kan geen enkele gebruiker zich aanmelden, zelfs niet als die is toegewezen. Als appRoleAssignmentRequired op true staat, is eerst een app-roltoewijzing nodig.

Quotafout bij het aanmaken. Een niet-beheerder kan samen niet meer dan 250 apps en service principals aanmaken. Zowel actieve objecten als herstelbare verwijderde objecten tellen mee. Quota komt pas vrij als je objecten definitief verwijdert uit de container met verwijderde items.

Herstellen bracht niet alles terug. Microsoft Learn doet twee uitspraken. De pagina over app-objecten zegt dat het herstellen van een app-object in de gebruikersinterface van App-registraties de bijbehorende service principal niet herstelt. De veelgestelde vragen over verwijderen en herstellen zeggen dat als beide zijn verwijderd, het herstellen van de registratie ook de service principal herstelt. Controleer het resultaat na elk herstel. De FAQ zegt ook dat beleid voor service principals niet kan worden hersteld en opnieuw moet worden ingesteld, en dat het 40 minuten tot 1 dag kan duren voordat provisioningsgegevens weer verschijnen.

Je wilt een app pauzeren, niet verwijderen. Microsoft Learn beschrijft het deactiveren van een toepassing. Daarbij stopt het uitgeven van nieuwe tokens en blijven de objecten behouden voor onderzoek of later opnieuw activeren.

Een korte controleroutine

  1. Lijst apps met secrets op en zet ze om naar certificaten of beheerde identiteiten.
  2. Verwijder machtigingen die niemand gebruikt.
  3. Controleer eigenaren en vervaldatums.
  4. Controleer of de domeinen van de redirect-URI's nog van jou zijn.
  5. Bekijk de aanmeldingslogboeken van service principals op ongebruikte apps.

Gerelateerd

Bronnen

Volg de podcastApple PodcastsSpotify

Veelgestelde vragen

Wat is het verschil tussen een app-registratie en een service principal?

Volgens Microsoft Learn is het applicatieobject (de app-registratie) de globale representatie van een app en staat het in de thuistenant. De service principal is de lokale representatie in een specifieke tenant en bepaalt daar het toegangsbeleid en de machtigingen. Een app registreren in de portal maakt in de thuistenant beide objecten aan.

Moet ik een clientgeheim of een certificaat gebruiken voor een service principal?

De beveiligingsrichtlijnen van Microsoft noemen een beheerde identiteit als sterk aanbevolen, daarna federated credentials, maar alleen van platforms die je vertrouwt, en daarna certificaatreferenties als geen van beide mogelijk is. Er staat duidelijk bij dat je geen wachtwoordreferenties moet gebruiken, ook wel geheimen genoemd.

Wanneer moet ik een beheerde identiteit gebruiken in plaats van een service principal?

Microsoft Learn noemt vier voorwaarden: de service draait in Azure, meldt geen gebruikers aan, fungeert niet als webAPI-resource en hoeft niet in meerdere tenants te draaien. Als alle vier waar zijn, overweeg dan een beheerde identiteit. Een beheerde identiteit is zelf een type service principal dat je niet rechtstreeks kunt bewerken.

Kan ik een verwijderde service principal herstellen?

Volgens de veelgestelde vragen over verwijderen en herstellen op Microsoft Learn kunnen voorlopig verwijderde applicaties en service principals tot 30 dagen worden hersteld. Daarna worden ze permanent verwijderd. App-registraties herstel je in het Microsoft Entra-beheercentrum. Service principals herstel je met PowerShell of Microsoft Graph, omdat verwijderde service principals niet in het beheercentrum worden getoond.

Waarom krijg ik de fout Directory_QuotaExceeded bij het maken van apps?

De veelgestelde vragen op Learn melden dat een gebruiker zonder beheerdersrol maximaal 250 applicaties en service principals kan maken, en dat zowel actieve als herstelbare verwijderde objecten meetellen. Objecten verwijderen geeft op zichzelf geen quota vrij. Je moet ze permanent verwijderen uit de container met verwijderde items.

Entities in this article

Onderwerpen van dit artikel:

Service principal – Concept Microsoft Entra ID – Identiteits- en beveiligingstool van Microsoft Application registration – Subonderwerp van Microsoft Entra ID Beheerde identiteit – Concept

Related articles

Meer artikelen over Service principal:

RSS