Azure AD B2C extension

The Azure AD B2C extension for VS Code lets you quickly navigate through Azure AD B2C custom policies . Create elements like technical profiles and claim definitions. For more information, see Get started with custom policies .

Get started

To start working with your custom policy, open Visual Studio Code, and then open the folder that contains your custom policy XML files. Or, open the policy XML files directly from any folder.

Azure AD B2C custom policy features

Policy upload

You can now upload your policy directly from VS Code .

Autocomplete

[!NOTE] Starting August 2021, if the XML , or the XML Tools XML extensions are installed and activated, the XML extension handles the XML completion. For more information, see Troubleshoot policy validity .

With the autocomplete feature, you can save time when customizing a B2C policy. The B2C extension provides you with a list of the policy settings, claims, technical profiles, and claims transformations aggregated from your policy files. Select one of the following attributes and press Ctrl+Space ( Cmd+Space ), or start typing:

Custom policy explorer

From the Custom policy explorer , click the XML element type and select the element you want to open. The Custom policy explorer shows elements from the selected file only.

Go to definition and find all references

To go to any XML element definition. Ctrl+click , press F12 , or right-click and select Go to Definition or Peek Definition . Go to definition navigates you to the source element in the selected file only.

To search for references in the opened folder XML files or any XML file you open with VS Code, select Find All References , or press Shift+F12 .

Adding XML elements

You can add following elements to your policy. Make sure your cursor is located in the correct location.

Orchestration steps renumbering

The B2C Renumber policy ( Shift+Ctrl+r ) command renumbers all of the user journeys and sub journeys orchestration steps.

Smart Copy & Paste

When you customize an XML element in the extension policy, Smart Copy allows you to copy the entire element with its parent's elements from the base policy. For example, when you copy the AAD-UserWriteUsingAlternativeSecurityId technical profile, Smart Copy generates an XML snippet containing the following elements so you don't need to search for the parent's element, such as the claim provider.

<ClaimsProviders>
  <ClaimsProvider>
    <DisplayName>Azure Active Directory</DisplayName>
    <TechnicalProfiles>
      <TechnicalProfile Id="AAD-UserWriteUsingAlternativeSecurityId">
      </TechnicalProfile>
    </TechnicalProfiles>
  </ClaimsProvider>
<ClaimsProviders>
By contrast, the Smart Paste feature pastes from the clipboard only the necessary elements. Given the above XML and assuming your extension policy already has a claims provider named Azure Active Directory, Smart Paste will paste only the technical profile without the claims provider. However, if there is no such claims provider, Smart Paste will paste the entire XML (including the claims provider and the technical profile).
Note: In this version, Smart Copy and Paste is limited to a single XML node.
Help and more information
After you run the commands, the B2C extension shows you an informational message with a link to relevant article.
XML Schema quick help
Hover your mouse cursor over any XML tag name to see its description.
Application Insights
Collect logs from Azure AD B2C and diagnose problems with the Azure AD B2C VS Code extension. Read more here. The logs are organized by the policy name, correlation Id (the application insights presents the first digit of the correlation Id), and the log timestamp. This allows you to find the relevant log based on the local timestamp and see the user journey as executed by Azure AD B2C.
Policy settings
Allows you to manage the values of your Azure AD B2C environments. When you execute the B2C Policy build command, the VS Code extension finds and replaces the values of your settings with the ones configured in the policy file, and creates a directory that contains all of your policy files (after the replacement). In the following example, the extension replaces the keys with the values configured in the appsettings.json file:
{Settings:Tenant}
{Settings:IdentityExperienceFramework}
{Settings:ProxyIdentityExperienceFrameworkAppId}
{Settings:FacebookAppId}
The configuration appsettings.json file contains the keys with their values for each environment.
Name contains the environment name that VS Code extension uses to create the environment folder (under the environments parent folder). Use your operating system's legal characters only.
Tenant specifies the tenant name, such as contoso.onmicrosoft.com. In the policy file, use the format of Settings:Tenant, for example {Settings:Tenant}.
Production  (boolean) is preserved for future use, indicating whether the environment is a production one.
PolicySettings contains a collection of key-value pairs with your settings. In the policy file, use the format of Settings: and the key name, for example {Settings:FacebookAppId}.
To build your policy, type Ctrl+Shift+P, which brings up the Command Palette. From here, type B2C and select B2C Policy Build. You have access to all of the B2C functionality of VS Code, including keyboard shortcuts like Ctrl+Shift+5.
In your policy, you can use one of the following settings: