Skip to content

Commit 30e3834

Browse files
authored
Merge pull request #216875 from MicrosoftDocs/main
Publish to Live, Wednesday 4AM PST, 11/02
2 parents afd0eb3 + 9c2be9f commit 30e3834

File tree

144 files changed

+3759
-1749
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

144 files changed

+3759
-1749
lines changed

.openpublishing.redirection.active-directory.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5541,6 +5541,11 @@
55415541
"redirect_url": "/azure/active-directory/develop/application-consent-experience",
55425542
"redirect_document_id": false
55435543
},
5544+
{
5545+
"source_path_from_root": "/articles/active-directory/develop/v2-permissions-and-consent.md",
5546+
"redirect_url": "/azure/active-directory/develop/permissions-consent-overview",
5547+
"redirect_document_id": false
5548+
},
55445549
{
55455550
"source_path_from_root": "/articles/active-directory/manage-apps/consent-and-permissions-overview.md",
55465551
"redirect_url": "/azure/active-directory/manage-apps/user-admin-consent-overview",

.openpublishing.redirection.azure-monitor.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5511,6 +5511,11 @@
55115511
"source_path_from_root": "/articles/azure-monitor/containers/container-insights-prometheus-metrics-addon.md",
55125512
"redirect_url": "/azure/azure-monitor/essentials/prometheus-metrics-enable",
55135513
"redirect_document_id": false
5514+
},
5515+
{
5516+
"source_path_from_root": "/articles/azure-monitor/containers/container-insights-prometheus-monitoring-addon.md",
5517+
"redirect_url": "/azure/azure-monitor/containers/container-insights-prometheus",
5518+
"redirect_document_id": false
55145519
}
55155520
]
55165521
}
Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
{
2-
"$schema": "https://whatsnewapi.azurewebsites.net/schema",
3-
"docSetProductName": "Azure Active Directory application management",
4-
"rootDirectory": "articles/active-directory/manage-apps/",
5-
"docLinkSettings": {
6-
"linkFormat": "relative",
7-
"relativeLinkPrefix": "/azure/active-directory/manage-apps"
8-
},
9-
"inclusionCriteria": {
10-
"excludePullRequestTitles": true,
11-
"minAdditionsToFile" : 10,
12-
"maxFilesChanged": 50,
13-
"labels": [
14-
"label:active-directory/svc",
15-
"label:app-mgmt/subsvc"
16-
]
17-
},
18-
"areas": [
19-
{
20-
"name": ".",
21-
"heading": "Azure Active Directory application management"
22-
}
23-
]
24-
}
2+
"$schema": "https://whatsnewapi.azurewebsites.net/schema",
3+
"docSetProductName": "Azure Active Directory application management",
4+
"rootDirectory": "articles/active-directory/manage-apps/",
5+
"docLinkSettings": {
6+
"linkFormat": "relative",
7+
"relativeLinkPrefix": "/azure/active-directory/manage-apps"
8+
},
9+
"inclusionCriteria": {
10+
"omitPullRequestTitles": true,
11+
"minAdditionsToFile": 10,
12+
"maxFilesChanged": 50,
13+
"labels": [
14+
"label:active-directory/svc",
15+
"label:app-mgmt/subsvc"
16+
]
17+
},
18+
"areas": [
19+
{
20+
"name": ".",
21+
"heading": "Azure Active Directory application management"
22+
}
23+
]
24+
}

articles/active-directory/develop/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -54,8 +54,6 @@
5454
- name: Conditional Access auth context
5555
href: developer-guide-conditional-access-authentication-context.md
5656
displayName: ca
57-
- name: Permissions and consent framework
58-
href: v2-permissions-and-consent.md
5957
- name: App registrations and workload identities
6058
displayName: App configuration
6159
items:

articles/active-directory/develop/security-tokens.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,31 +9,30 @@ ms.service: active-directory
99
ms.subservice: develop
1010
ms.topic: conceptual
1111
ms.workload: identity
12-
ms.date: 09/27/2021
12+
ms.date: 11/1/2022
1313
ms.author: davidmu
1414
ms.reviewer: jmprieur, saeeda, sureshja, ludwignick
15-
ms.custom: aaddev, identityplatformtop40, scenarios:getting-started
15+
ms.custom: aaddev, identityplatformtop40, scenarios:getting-started, engagement-fy23
1616
#Customer intent: As an application developer, I want to understand the basic concepts of security tokens in the Microsoft identity platform.
1717
---
1818

1919
# Security tokens
2020

21-
A centralized identity provider is especially useful for apps that have users located around the globe who don't necessarily sign in from the enterprise's network. The Microsoft identity platform authenticates users and provides security tokens, such as [access tokens](developer-glossary.md#access-token), [refresh tokens](developer-glossary.md#refresh-token), and [ID tokens](developer-glossary.md#id-token). Security tokens allow a [client application](developer-glossary.md#client-application) to access protected resources on a [resource server](developer-glossary.md#resource-server).
21+
A centralized identity provider is especially useful for apps that have worldwide users who don't necessarily sign in from the enterprise's network. The Microsoft identity platform authenticates users and provides security tokens, such as [access tokens](developer-glossary.md#access-token), [refresh tokens](developer-glossary.md#refresh-token), and [ID tokens](developer-glossary.md#id-token). Security tokens allow a [client application](developer-glossary.md#client-application) to access protected resources on a [resource server](developer-glossary.md#resource-server).
2222

23-
**Access token**: An access token is a security token that's issued by an [authorization server](developer-glossary.md#authorization-server) as part of an [OAuth 2.0](active-directory-v2-protocols.md) flow. It contains information about the user and the resource for which the token is intended. The information can be used to access web APIs and other protected resources. Access tokens are validated by resources to grant access to a client app. To learn more about how the Microsoft identity platform issues access tokens, see [Access tokens](access-tokens.md).
23+
**Access token**: An access token is a security token issued by an [authorization server](developer-glossary.md#authorization-server) as part of an [OAuth 2.0](active-directory-v2-protocols.md) flow. It contains information about the user and the resource for which the token is intended. The information can be used to access web APIs and other protected resources. Access tokens are validated by resources to grant access to a client app. To learn more about how the Microsoft identity platform issues access tokens, see [Access tokens](access-tokens.md).
2424

2525
**Refresh token**: Because access tokens are valid for only a short period of time, authorization servers will sometimes issue a refresh token at the same time the access token is issued. The client application can then exchange this refresh token for a new access token when needed. To learn more about how the Microsoft identity platform uses refresh tokens to revoke permissions, see [Refresh tokens](refresh-tokens.md).
2626

2727
**ID token**: ID tokens are sent to the client application as part of an [OpenID Connect](v2-protocols-oidc.md) flow. They can be sent alongside or instead of an access token. ID tokens are used by the client to authenticate the user. To learn more about how the Microsoft identity platform issues ID tokens, see [ID tokens](id-tokens.md).
2828

29-
> [!NOTE]
30-
> This article discusses security tokens used by the OAuth2 and OpenID Connect protocols. Many enterprise applications use SAML to authenticate users. For information on SAML assertions, see [Azure Active Directory SAML token reference](reference-saml-tokens.md).
29+
Many enterprise applications use SAML to authenticate users. For information on SAML assertions, see [Azure Active Directory SAML token reference](reference-saml-tokens.md).
3130

3231
## Validate security tokens
3332

3433
It's up to the app for which the token was generated, the web app that signed in the user, or the web API being called to validate the token. The token is signed by the authorization server with a private key. The authorization server publishes the corresponding public key. To validate a token, the app verifies the signature by using the authorization server public key to validate that the signature was created using the private key.
3534

36-
Tokens are valid for only a limited amount of time. Usually, the authorization server provides a pair of tokens, such as:
35+
Tokens are valid for only a limited amount of time, so the authorization server frequently provides a pair of tokens;
3736

3837
* An access token, which accesses the application or protected resource.
3938
* A refresh token, which is used to refresh the access token when the access token is close to expiring.
@@ -59,9 +58,9 @@ A claim consists of key-value pairs that provide information such as the:
5958

6059
* Security Token Server that generated the token.
6160
* Date when the token was generated.
62-
* Subject (such as the user--except for daemons).
61+
* Subject (like the user, but not daemons).
6362
* Audience, which is the app for which the token was generated.
64-
* App (the client) that asked for the token. In the case of web apps, this app might be the same as the audience.
63+
* App (the client) that asked for the token. For web apps, this app might be the same as the audience.
6564

6665
To learn more about how the Microsoft identity platform implements tokens and claim information, see [Access tokens](access-tokens.md) and [ID tokens](id-tokens.md).
6766

0 commit comments

Comments
 (0)