forked from MicrosoftDocs/azure-docs
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
5,459 changed files
with
540,760 additions
and
601,827 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,11 +1,9 @@ | ||
| # Azure Technical Documentation Contributor Guide | ||
|
|
||
| You've found the GitHub repository that houses the source for the Azure technical documentation that is published on [http://docs.microsoft.com/azure](http://docs.microsoft.com/azure). | ||
|
|
||
| This repository also contains guidance to help you contribute to our technical documentation. For a list of the articles in the contributors' guide, see [the index](./contributor-guide/contributor-guide-index.md). | ||
| This repository also contains guidance to help you contribute to our technical documentation. For a list of the articles in the contributors' guide, see [the index](contributor-guide/contributor-guide-index.md). | ||
|
|
||
| ## Contribute to Azure documentation | ||
|
|
||
| Thank you for your interest in Azure documentation! | ||
|
|
||
| * [Ways to contribute](#ways-to-contribute) | ||
|
|
@@ -16,91 +14,74 @@ Thank you for your interest in Azure documentation! | |
| * [How to use markdown to format your topic](#how-to-use-markdown-to-format-your-topic) | ||
| * [Feedback, comments, and support](./contributor-guide/feedback-and-comments.md) | ||
| * [More resources](#more-resources) | ||
| * [Index of all contributors' guide articles](./contributor-guide/contributor-guide-index.md) (opens new page) | ||
|
|
||
| ## Ways to contribute | ||
| * [Index of all contributors' guide articles](contributor-guide/contributor-guide-index.md) (opens new page) | ||
|
|
||
| ## Ways to contribute | ||
| You can submit updates to the [Azure documentation](http://docs.microsoft.com/azure) as follows: | ||
|
|
||
| * You can easily contribute to technical articles in the GitHub user interface. Either find the article in this repository, or visit the article on [http://docs.microsoft.com/azur](http://docs.microsoft.com/azur) and click the link in the article that goes to the GitHub source for the article. | ||
| * If you are making substantial changes to an existing article, adding or changing images, or contributing a new article, you need to fork this repository, install Git Bash, Markdown Pad, and learn some git commands. | ||
|
|
||
| ##Code of conduct | ||
|
|
||
| ## Code of conduct | ||
| This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments. | ||
|
|
||
| ##About your contributions to Azure content | ||
|
|
||
| ###Minor corrections | ||
|
|
||
| ## About your contributions to Azure content | ||
| ### Minor corrections | ||
| Minor corrections or clarifications you submit for documentation and code examples in this repo are covered by the [docs.microsoft.com Terms of Use](https://docs.microsoft.com/en-us/enterprise-mobility-security/termsofuse). | ||
|
|
||
|
|
||
| ###Larger submissions | ||
|
|
||
| ### Larger submissions | ||
| If you submit a pull request with new or significant changes to documentation and code examples, we'll send a comment in GitHub asking you to submit an online Contribution License Agreement (CLA) if you are not an employee of Microsoft. We need you to complete the online form before we can accept your pull request. | ||
|
|
||
| ## Repository organization | ||
|
|
||
| The content in the azure-docs repository follows the organization of documentation on http://docs.microsoft.com/azure. This repository contains two root folders: | ||
|
|
||
| ### \articles | ||
|
|
||
| The *\articles* folder contains the documentation articles formatted as markdown files with an *.md* extension. Articles are typically grouped by Azure service. | ||
|
|
||
| Articles need to follow strict file naming guidelines - for details, see [our file naming guidance](./contributor-guide/file-names-and-locations.md). | ||
| Articles need to follow strict file naming guidelines - for details, see [our file naming guidance](contributor-guide/file-names-and-locations.md). | ||
|
|
||
| The *\articles* folder contains the *\media* folder for root directory article media files, inside which are subfolders with the images for each article. The service folders contain a separate media folder for the articles within each service folder. The article image folders are named identically to the article file, minus the *.md* file extension. | ||
|
|
||
| ### \includes | ||
|
|
||
| You can create reusable content sections to be included in one or more articles. See [Custom extensions used in our technical content](./contributor-guide/custom-markdown-extensions.md). | ||
| You can create reusable content sections to be included in one or more articles. See [Custom extensions used in our technical content](contributor-guide/custom-markdown-extensions.md). | ||
|
|
||
| ### \markdown templates | ||
|
|
||
| This folder contains our standard markdown template with the basic markdown formatting you need for an article. | ||
|
|
||
| ### \contributor-guide | ||
|
|
||
| This folder contains articles that are part of our contributors' guide. | ||
|
|
||
| ## Use GitHub, Git, and this repository | ||
| For information about how to contribute, how to use the GitHub UI to contribute small changes, and how to fork and clone the repository for more significant contributions, see [Install and set up tools for authoring in GitHub](contributor-guide/tools-and-setup.md). | ||
|
|
||
| For information about how to contribute, how to use the GitHub UI to contribute small changes, and how to fork and clone the repository for more significant contributions, see [Install and set up tools for authoring in GitHub](./contributor-guide/tools-and-setup.md). | ||
|
|
||
| If you install GitBash and choose to work locally, the steps for creating a new local working branch, making changes, and submitting the changes back to the main branch are listed in [Git commands for creating a new article or updating an existing article](./contributor-guide/git-commands-for-master.md) | ||
| If you install GitBash and choose to work locally, the steps for creating a new local working branch, making changes, and submitting the changes back to the main branch are listed in [Git commands for creating a new article or updating an existing article](contributor-guide/git-commands-for-master.md) | ||
|
|
||
| ### Branches | ||
|
|
||
| We recommend that you create local working branches that target a specific scope of change. Each branch should be limited to a single concept/article both to streamline work flow and reduce the possibility of merge conflicts. The following efforts are of the appropriate scope for a new branch: | ||
|
|
||
| * A new article (and associated images) | ||
| * Spelling and grammar edits on an article. | ||
| * Applying a single formatting change across a large set of articles (e.g. new copyright footer). | ||
|
|
||
| ## How to use markdown to format your topic | ||
|
|
||
| All the articles in this repository use GitHub flavored markdown. Here's a list of resources. | ||
|
|
||
| - [Markdown basics](https://help.github.com/articles/markdown-basics/) | ||
|
|
||
| - [Printable markdown cheatsheet](./contributor-guide/media/documents/markdown-cheatsheet.pdf?raw=true) | ||
| * [Markdown basics](https://help.github.com/articles/markdown-basics/) | ||
| * [Printable markdown cheatsheet](./contributor-guide/media/documents/markdown-cheatsheet.pdf?raw=true) | ||
|
|
||
| ## Article metadata | ||
|
|
||
| Article metadata enables certain functionalities, such as author attribution, contributor attribution, breadcrumbs, article descriptions, and SEO optimizations as well as reporting Microsoft uses to evaluate the performance of the content. So, the metadata is important! [Here's the guidance for making sure your metadata is done right](./contributor-guide/article-metadata.md). | ||
| Article metadata enables certain functionalities, such as author attribution, contributor attribution, breadcrumbs, article descriptions, and SEO optimizations as well as reporting Microsoft uses to evaluate the performance of the content. So, the metadata is important! [Here's the guidance for making sure your metadata is done right](contributor-guide/article-metadata.md). | ||
|
|
||
| ### Labels | ||
|
|
||
| Automated labels are assigned to pull requests to help us manage the pull request workflow and to help let you know what's going on with your pull request: | ||
|
|
||
| * Contribution License Agreement related | ||
| * cla-not-required: The change is relatively minor and does not require that you sign a CLA. | ||
| * cla-required: The scope of the change is relatively large and requires that you sign a CLA. | ||
| * cla-signed: The contributor signed the CLA, so the pull request can now move forward for review. | ||
| * cla-not-required: The change is relatively minor and does not require that you sign a CLA. | ||
| * cla-required: The scope of the change is relatively large and requires that you sign a CLA. | ||
| * cla-signed: The contributor signed the CLA, so the pull request can now move forward for review. | ||
| * Pillar labels: Labels such as PnP, Modern Apps, and TDC help categorize the pull requests by the internal organization that needs to review the pull request. | ||
| * Change sent to author: The author has been notified of the pending pull request. | ||
|
|
||
| ## More resources | ||
| See the [index of our contributor's guide](contributor-guide/contributor-guide-index.md) for all our guidance topics. | ||
|
|
||
| See the [index of our contributor's guide](./contributor-guide/contributor-guide-index.md) for all our guidance topics. | ||
65 changes: 34 additions & 31 deletions
65
articles/active-directory-b2c/active-directory-b2c-app-registration.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,55 +1,58 @@ | ||
| <properties | ||
| pageTitle="Azure Active Directory B2C: Application registration | Microsoft Azure" | ||
| description="How to register your application with Azure Active Directory B2C" | ||
| services="active-directory-b2c" | ||
| documentationCenter="" | ||
| authors="swkrish" | ||
| manager="mbaldwin" | ||
| editor="bryanla"/> | ||
|
|
||
| <tags | ||
| ms.service="active-directory-b2c" | ||
| ms.workload="identity" | ||
| ms.tgt_pltfrm="na" | ||
| ms.devlang="na" | ||
| ms.topic="get-started-article" | ||
| ms.date="08/30/2016" | ||
| ms.author="swkrish"/> | ||
|
|
||
|
|
||
| --- | ||
| title: 'Azure Active Directory B2C: Application registration | Microsoft Docs' | ||
| description: How to register your application with Azure Active Directory B2C | ||
| services: active-directory-b2c | ||
| documentationcenter: '' | ||
| author: swkrish | ||
| manager: mbaldwin | ||
| editor: bryanla | ||
|
|
||
| ms.service: active-directory-b2c | ||
| ms.workload: identity | ||
| ms.tgt_pltfrm: na | ||
| ms.devlang: na | ||
| ms.topic: get-started-article | ||
| ms.date: 08/30/2016 | ||
| ms.author: swkrish | ||
|
|
||
| --- | ||
| # Azure Active Directory B2C: Register your application | ||
|
|
||
| ## Prerequisite | ||
|
|
||
| To build an application that accepts consumer sign-up and sign-in, you first need to register the application with an Azure Active Directory B2C tenant. Get your own tenant by using the steps outlined in [Create an Azure AD B2C tenant](active-directory-b2c-get-started.md). After you follow all the steps in that article, you will have the B2C features blade pinned to your Startboard. | ||
|
|
||
| [AZURE.INCLUDE [active-directory-b2c-devquickstarts-v2-apps](../../includes/active-directory-b2c-devquickstarts-v2-apps.md)] | ||
| [!INCLUDE [active-directory-b2c-devquickstarts-v2-apps](../../includes/active-directory-b2c-devquickstarts-v2-apps.md)] | ||
|
|
||
| ## Navigate to the B2C features blade | ||
|
|
||
| If you have the B2C features blade pinned to your Startboard, you will see the blade as soon as you sign in to the [Azure portal](https://portal.azure.com/) as the Global Administrator of the B2C tenant. | ||
|
|
||
| You can also access the blade by clicking **Browse** and then **Azure AD B2C** in the left navigation pane on the [Azure portal](https://portal.azure.com/). | ||
|
|
||
| > [AZURE.IMPORTANT] You need to be a Global Administrator of the B2C tenant to be able to access the B2C features blade. A Global Administrator from any other tenant or a user from any tenant cannot access it. You can switch to your B2C tenant by using the tenant switcher in the top right corner of the Azure Portal. | ||
| > [!IMPORTANT] | ||
| > You need to be a Global Administrator of the B2C tenant to be able to access the B2C features blade. A Global Administrator from any other tenant or a user from any tenant cannot access it. You can switch to your B2C tenant by using the tenant switcher in the top right corner of the Azure Portal. | ||
| > | ||
| > | ||
| ## Register an application | ||
|
|
||
| 1. On the B2C features blade on the Azure portal, click **Applications**. | ||
| 2. Click **+Add** at the top of the blade. | ||
| 3. Enter a **Name** for the application that will describe your application to consumers. For example, you could enter "Contoso B2C app". | ||
| 4. If you are writing a web-based application, toggle the **Include web app / web API** switch to **Yes**. The **Reply URLs** are endpoints where Azure AD B2C will return any tokens that your application requests. For example, enter `https://localhost:44321/`. If your web application will also be calling some web API secured by Azure AD B2C, you'll want to create an **Application Secret** as well by clicking the **Generate Key** button. | ||
|
|
||
| > [AZURE.NOTE] An **Application Secret** is an important security credential, and should be secured appropriately. | ||
|
|
||
| > [!NOTE] | ||
| > An **Application Secret** is an important security credential, and should be secured appropriately. | ||
| > | ||
| > | ||
| 5. If you are writing a mobile application, toggle the **Include native client** switch to **Yes**. Copy down the default **Redirect URI** that is automatically created for you. | ||
| 6. Click **Create** to register your application. | ||
| 7. Click the application that you just created and copy down the globally unique **Application Client ID** that you'll use later in your code. | ||
|
|
||
| > [AZURE.IMPORTANT] Applications created in the B2C features blade have to managed in the same location. If you edit B2C applications using PowerShell or another portal, they become unsupported and will likely not work with Azure AD B2C. | ||
| > [!IMPORTANT] | ||
| > Applications created in the B2C features blade have to managed in the same location. If you edit B2C applications using PowerShell or another portal, they become unsupported and will likely not work with Azure AD B2C. | ||
| > | ||
| > | ||
| ## Build a Quick Start Application | ||
|
|
||
| Now that you have an application registered with Azure AD B2C, you can complete one of our quick-start tutorials to get up and running. Here are a few recommendations: | ||
|
|
||
| [AZURE.INCLUDE [active-directory-v2-quickstart-table](../../includes/active-directory-b2c-quickstart-table.md)] | ||
| [!INCLUDE [active-directory-v2-quickstart-table](../../includes/active-directory-b2c-quickstart-table.md)] | ||
|
|
Oops, something went wrong.