You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Revise Azure article for Entra content and structure
Updated structure and content for Microsoft Entra section, including details on single-tenant vs multi-tenant, App Registrations, and Service Principals.
Copy file name to clipboardExpand all lines: _articles/azure.md
+29-7Lines changed: 29 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,25 +3,47 @@ layout: page
3
3
title: Azure
4
4
---
5
5
6
-
## Entra: Tenancy
6
+
## Entra
7
+
8
+
### Single-tenant vs multi-tenant
7
9
8
10
-**Single-tenant Entra**
9
11
-**Multi-tenant Entra**
10
12
11
-
##Entra: Identity management
13
+
### App Registrations and Service Principals
12
14
13
15
In Microsoft Entra (formerly Azure AD):
14
16
15
17
-**App registration** defines an application (client secrets, API permissions, redirect URIs, etc.). It is _"a template or blueprint to create one or more service principal objects."_
16
-
-**Service principal** (also called**Enterprise Application** in the UI) is like an instance of the application. It defines the access policy and permissions for the user/application in the Microsoft Entra tenant. There can be many service principals linked to 1 app registration.
18
+
-**Service principal** (appears in**Enterprise Application** in the UI) is like an instance of the application. It defines the access policy and permissions for the user/application in the Microsoft Entra tenant. There can be many service principals linked to 1 app registration.
17
19
18
20
To authenticate as a service principal, you need:
19
21
-`client_id` (from App Registration)
20
22
-`client_secret` or certificate (from App Registration)
21
23
-`tenant_id` (your Entra tenant)
22
24
23
-
Some nuggets of info from the docs - https://learn.microsoft.com/en-us/entra/identity-platform/app-objects-and-service-principals?tabs=browser#application-object :
25
+
#### Key differences between App Registrations, Service Principals, Enterprise Applications
26
+
27
+
-**Credentials live on App Registrations, not Service Principals.** Client secrets and certificates are stored on the App Registration, and all Service Principals linked to that registration share the same credentials.
28
+
-**"Enterprise Applications" is just a UI view of Service Principals.** Despite the confusing name, it's not a separate object type - it's simply where Azure Portal displays Service Principal identities, including those linked to App Registrations and standalone ones like Managed Identities.
29
+
-**"If you register an application, an application object and a service principal object are automatically created in your home tenant"** - In other words, creating an App Registration **in the UI** will also create a Service Principal, in your current Microsoft Entra tenant. However when creating via API/Terraform, you may need to explicitly create the Service Principal separately, **and you will need specific permissions in Entra to be able to do that.**
30
+
-**"A service principal is created in every tenant where the application is used"** -- In other words, you just need to create 1 service principal, unless you are working with many Entra tenants.
#### Working with App Registrations and Service Principals
42
+
43
+
```sh
44
+
# Fetch an App Registration
45
+
az ad app list --display-name "my-client-app"
24
46
25
-
-_"If you register an application, an application object and a service principal object are automatically created in your home tenant"_ - In other words, creating an App Registration **in the UI** will also create a Service Principal, in your current Microsoft Entra tenant. However when creating via API/Terraform, you may need to explicitly create the Service Principal separately.
26
-
-_"A single-tenant application has only one service principal (in its home tenant), created and consented for use during application registration"_ - this says the same thing.
27
-
-_"A service principal is created in every tenant where the application is used ... A multitenant application also has a service principal created in each tenant where a user from that tenant has consented to its use."_ -- In other words, you should just need to create 1 of these service principals, unless you have many Entra tenants.
0 commit comments