Skip to content

Commit 2c08904

Browse files
committed
fixing links and re-adding metadata
1 parent e16ee8b commit 2c08904

File tree

2 files changed

+29
-14
lines changed

2 files changed

+29
-14
lines changed

articles/active-directory/develop/quickstart-register-app.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,18 @@
1+
---
2+
title: "Quickstart: Register an app in the Microsoft identity platform"
3+
description: In this quickstart, you learn how to register an application with the Microsoft identity platform.
4+
services: active-directory
5+
author: cilwerner
6+
manager: CelesteDG
7+
ms.service: active-directory
8+
ms.subservice: develop
9+
ms.topic: quickstart
10+
ms.workload: identity
11+
ms.date: 10/31/2022
12+
ms.author: cwerner
13+
ms.custom: aaddev, identityplatformtop40, contperf-fy21q1, contperf-fy21q2, contperf-fy21q4, mode-other
14+
---
15+
116

217
[!INCLUDE [quickstart-register-app](../../../includes/active-directory-develop-quickstart-register-app.md)]
318

includes/active-directory-develop-quickstart-register-app.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -26,16 +26,16 @@ Get started with the Microsoft identity platform by registering an application i
2626
The Microsoft identity platform performs identity and access management (IAM) only for registered applications. Whether it's a client application like a web or mobile app, or it's a web API that backs a client app, registering it establishes a trust relationship between your application and the identity provider, the Microsoft identity platform.
2727

2828
> [!TIP]
29-
> To register an application for Azure AD B2C, follow the steps in [Tutorial: Register a web application in Azure AD B2C](../articles/active-directory-b2c/tutorial-register-applications).
29+
> To register an application for Azure AD B2C, follow the steps in [Tutorial: Register a web application in Azure AD B2C](/azure/active-directory-b2c/tutorial-register-applications).
3030
3131
## Prerequisites
3232

3333
- An Azure account that has an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
3434
- The Azure account must have permission to manage applications in Azure Active Directory (Azure AD). Any of the following Azure AD roles include the required permissions:
35-
- [Application administrator](../articles/active-directory/roles/permissions-reference#application-administrator)
36-
- [Application developer](../articles/active-directory/roles/permissions-reference#application-developer)
37-
- [Cloud application administrator](../articles/active-directory/roles/permissions-reference.md#cloud-application-administrator)
38-
- Completion of the [Set up a tenant](../articles/active-directory/develop/quickstart-create-new-tenant) quickstart.
35+
- [Application administrator](/azure/active-directory/roles/permissions-reference#application-administrator)
36+
- [Application developer](/azure/active-directory/roles/permissions-reference#application-developer)
37+
- [Cloud application administrator](/azure/active-directory/roles/permissions-reference.md#cloud-application-administrator)
38+
- Completion of the [Set up a tenant](/azure/active-directory/develop/quickstart-create-new-tenant) quickstart.
3939

4040
## Register an application
4141

@@ -105,19 +105,19 @@ To configure application settings based on the platform or device you're targeti
105105

106106
### Redirect URI restrictions
107107

108-
There are some restrictions on the format of the redirect URIs you add to an app registration. For details about these restrictions, see [Redirect URI (reply URL) restrictions and limitations](../articles/active-directory/develop/reply-url).
108+
There are some restrictions on the format of the redirect URIs you add to an app registration. For details about these restrictions, see [Redirect URI (reply URL) restrictions and limitations](/azure/active-directory/develop/reply-url).
109109

110110
## Add credentials
111111

112-
Credentials are used by [confidential client applications](../articles/active-directory/develop/msal-client-applications) that access a web API. Examples of confidential clients are web apps, other web APIs, or service-type and daemon-type applications. Credentials allow your application to authenticate as itself, requiring no interaction from a user at runtime.
112+
Credentials are used by [confidential client applications](/azure/active-directory/develop/msal-client-applications) that access a web API. Examples of confidential clients are web apps, other web APIs, or service-type and daemon-type applications. Credentials allow your application to authenticate as itself, requiring no interaction from a user at runtime.
113113

114114
You can add both certificates and client secrets (a string) as credentials to your confidential client app registration.
115115

116116
:::image type="content" source="../articles/active-directory/develop/media/quickstart-register-app/portal-05-app-reg-04-credentials.png" alt-text="Screenshot of the Azure portal, showing the Certificates and secrets pane in an app registration.":::
117117

118118
### Add a certificate
119119

120-
Sometimes called a _public key_, a certificate is the recommended credential type because they're considered more secure than client secrets. For more information about using a certificate as an authentication method in your application, see [Microsoft identity platform application authentication certificate credentials](../articles/active-directory/develop/active-directory-certificate-credentials).
120+
Sometimes called a _public key_, a certificate is the recommended credential type because they're considered more secure than client secrets. For more information about using a certificate as an authentication method in your application, see [Microsoft identity platform application authentication certificate credentials](/azure/active-directory/develop/active-directory-certificate-credentials).
121121

122122
1. In the Azure portal, in **App registrations**, select your application.
123123
1. Select **Certificates & secrets** > **Certificates** > **Upload certificate**.
@@ -139,12 +139,12 @@ Client secrets are considered less secure than certificate credentials. Applicat
139139
1. Select **Add**.
140140
1. _Record the secret's value_ for use in your client application code. This secret value is _never displayed again_ after you leave this page.
141141

142-
For application security recommendations, see [Microsoft identity platform best practices and recommendations](../articles/active-directory/develop/identity-platform-integration-checklist#security).
142+
For application security recommendations, see [Microsoft identity platform best practices and recommendations](/azure/active-directory/develop/identity-platform-integration-checklist#security).
143143

144144

145145
### Add a federated credential
146146

147-
Federated identity credentials are a type of credential that allows workloads, such as GitHub Actions, workloads running on Kubernetes, or workloads running in compute platforms outside of Azure access Azure AD protected resources without needing to manage secrets using [workload identity federation](../articles/active-directory/develop/workload-identity-federation).
147+
Federated identity credentials are a type of credential that allows workloads, such as GitHub Actions, workloads running on Kubernetes, or workloads running in compute platforms outside of Azure access Azure AD protected resources without needing to manage secrets using [workload identity federation](/azure/active-directory/develop/workload-identity-federation).
148148

149149
To add a federated credential, follow these steps:
150150

@@ -153,9 +153,9 @@ To add a federated credential, follow these steps:
153153
1. In the **Federated credential scenario** drop-down box, select one of the supported scenarios, and follow the corresponding guidance to complete the configuration.
154154

155155
- **Customer managed keys** for encrypt data in your tenant using Azure Key Vault in another tenant.
156-
- **GitHub actions deploying Azure resources** to [configure a GitHub workflow](../articles/active-directory/develop/workload-identity-federation-create-trust#github-actions) to get tokens for your application and deploy assets to Azure.
157-
- **Kubernetes accessing Azure resources** to configure a [Kubernetes service account](../articles/active-directory/develop/workload-identity-federation-create-trust#kubernetes) to get tokens for your application and access Azure resources.
158-
- **Other issuer** to configure an identity managed by an external [OpenID Connect provider](../articles/active-directory/develop/workload-identity-federation-create-trust#other-identity-providers) to get tokens for your application and access Azure resources.
156+
- **GitHub actions deploying Azure resources** to [configure a GitHub workflow](/azure/active-directory/develop/workload-identity-federation-create-trust#github-actions) to get tokens for your application and deploy assets to Azure.
157+
- **Kubernetes accessing Azure resources** to configure a [Kubernetes service account](/azure/active-directory/develop/workload-identity-federation-create-trust#kubernetes) to get tokens for your application and access Azure resources.
158+
- **Other issuer** to configure an identity managed by an external [OpenID Connect provider](/azure/active-directory/develop/workload-identity-federation-create-trust#other-identity-providers) to get tokens for your application and access Azure resources.
159159

160160

161-
For more information, how to get an access token with a federated credential, check out the [Microsoft identity platform and the OAuth 2.0 client credentials flow](../articles/active-directory/develop/v2-oauth2-client-creds-grant-flow#third-case-access-token-request-with-a-federated-credential) article.
161+
For more information, how to get an access token with a federated credential, check out the [Microsoft identity platform and the OAuth 2.0 client credentials flow](/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow#third-case-access-token-request-with-a-federated-credential) article.

0 commit comments

Comments
 (0)