Skip to content

Latest commit

 

History

History
74 lines (53 loc) · 5.36 KB

quickstart-v1-add-azure-ad-app.md

File metadata and controls

74 lines (53 loc) · 5.36 KB
title description services documentationcenter author manager editor ms.service ms.component ms.devlang ms.topic ms.tgt_pltfrm ms.workload ms.date ms.author ms.custom ms.reviewer
Register an app with the Azure Active Directory v1.0 endpoint
Learn how to add and register an application with the Azure Active Directory (Azure AD) v1.0 endpoint.
active-directory
CelesteDG
mtillman
active-directory
develop
na
quickstart
na
identity
09/24/2018
celested
aaddev
lenalepa, sureshja

Quickstart: Register an app with the Azure Active Directory v1.0 endpoint

[!INCLUDE active-directory-develop-applies-v1]

Enterprise developers and software-as-a-service (SaaS) providers can develop commercial cloud services or line-of-business applications, that can be integrated with Azure Active Directory (Azure AD) to provide secure sign-in and authorization for their services. To integrate an application or service with Azure AD, a developer must first register the application with Azure AD.

Any application that wants to use the capabilities of Azure AD must first be registered in an Azure AD tenant. This registration process involves giving Azure AD details about your application, such as the URL where it’s located, the URL to send replies after a user is authenticated, the URI that identifies the app, and so on.

This quickstart shows you how to add and register an application in Azure AD using the existing App registrations experience in the Azure portal.

Note

Registering a new app? Try out the new App registrations (Preview) experience in the Azure portal. See Register an app (Preview) to get started.

Prerequisites

To get started, make sure have an Azure AD tenant that you can use to register your apps to. If you don't already have a tenant, learn how to get one.

Register a new application using the Azure portal

  1. Sign in to the Azure portal.

  2. If your account gives you access to more than one, select your account in the top right corner, and set your portal session to the desired Azure AD tenant.

  3. In the left-hand navigation pane, select the Azure Active Directory service.

  4. Select App registrations and then select New application registration.

    Register a new application

  5. When the Create page appears, enter your application's registration information:

    • Name: Enter a meaningful application name

    • Application type:

    • Sign-On URL: For "Web app / API" applications, provide the base URL of your app. For example, http://localhost:31544 might be the URL for a web app running on your local machine. Users would use this URL to sign in to a web client application.

    • Redirect URI: For "Native" applications, provide the URI used by Azure AD to return token responses. Enter a value specific to your application, for example http://MyFirstAADApp

      Register a new application - create

    If you'd like specific examples for web applications or native applications, check out the Quickstarts in our documentation.

  6. When finished, select Create.

    Azure AD assigns a unique Application ID to your application, and you're taken to your application's main registration page. Depending on whether your application is a web or native application, different options are provided to add additional capabilities to your application.

    [!NOTE] By default, a newly registered web application is configured to allow only users from the same tenant to sign in to your application.

Next steps