Skip to content

Commit 3ce5a4e

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into articles-about-de-identification-service
2 parents c1aba20 + 160fe14 commit 3ce5a4e

127 files changed

Lines changed: 2225 additions & 1008 deletions

File tree

Some content is hidden

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

articles/active-directory-b2c/customize-ui-with-html.md

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: kengaderdus
66
manager: CelesteDG
77
ms.service: azure-active-directory
88
ms.topic: how-to
9-
ms.date: 02/17/2025
9+
ms.date: 03/04/2026
1010
ms.author: kengaderdus
1111
ms.subservice: b2c
1212
zone_pivot_groups: b2c-policy-type
@@ -440,6 +440,34 @@ To use the sample:
440440
1. Now modify the policy, pointing to your HTML file, as mentioned previously.
441441
1. If you see missing fonts, images, or CSS, check your references in the extensions policy and the `\*.html` files.
442442

443+
444+
### Bootstrap dependency in sample templates
445+
446+
The [sample templates](https://github.com/azure-ad-b2c/html-templates) use **Bootstrap 3.3.5**, sourced from the official Bootstrap CDN. This version has been validated and tested with Azure AD B2C.
447+
448+
The templates reference the following CDN URL for Bootstrap CSS:
449+
450+
```
451+
https://cdn.jsdelivr.net/npm/bootstrap@3.3.5/dist/css/bootstrap.min.css
452+
```
453+
454+
The default configuration in the template HTML files includes a link element similar to the following example:
455+
456+
```xml
457+
<link href="https://cdn.jsdelivr.net/npm/bootstrap@3.3.5/dist/css/bootstrap.min.css" rel="stylesheet" type="text/css" />
458+
```
459+
460+
For the official Bootstrap 3.3.5 download and CDN details, see [Bootstrap 3.3 Getting Started](https://getbootstrap.com/docs/3.3/getting-started/#download-cdn).
461+
462+
#### Replace the CDN reference
463+
464+
You can replace the CDN reference with your organization's internal CDN or a locally hosted copy to meet reliability, security, or compliance requirements.
465+
466+
> [!IMPORTANT]
467+
> The templates are validated specifically against Bootstrap 3.3.5. Upgrading, downgrading, or otherwise modifying the Bootstrap version might introduce styling, layout, or component compatibility issues.
468+
469+
If you change the Bootstrap version, you're responsible for completing regression testing to validate that your customized templates work correctly with Azure AD B2C. Retain the validated version unless you've completed appropriate testing.
470+
443471
## Use company branding assets in custom HTML
444472

445473
To use [company branding](customize-ui.md#configure-company-branding) assets in a custom HTML, add the following tags outside the `<div id="api">` tag. The image source is replaced with that of the background image and banner logo.

articles/api-management/api-management-get-started-publish-versions.md

Lines changed: 24 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
2-
title: Tutorial - Publish versions of an API using Azure API Management
2+
title: "Tutorial: Publish Multiple Versions of your API"
33
description: Learn how to publish multiple API versions in API Management.
44
author: dlepow
55

66
ms.service: azure-api-management
77
ms.custom: mvc, devx-track-azurecli
88
ms.topic: tutorial
9-
ms.date: 03/26/2025
9+
ms.date: 03/04/2026
1010
ms.author: danlep
1111

1212
#customer intent: As a developer, I want to publish multiple versions of an API so that all callers to the API don't need to use the same version.
@@ -18,7 +18,7 @@ ms.author: danlep
1818

1919
There are situations where it's impractical for all API consumers to use the same version. When consumers are ready to upgrade to a newer version, they prefer a simple and understandable approach. As demonstrated in this tutorial, Azure API Management supports exposing multiple API versions to meet this need.
2020

21-
For background, see [Versions](api-management-versions.md) and [Revisions](api-management-revisions.md).
21+
For background information, see [Versions](api-management-versions.md) and [Revisions](api-management-revisions.md).
2222

2323
[!INCLUDE [api-management-workspace-try-it](../../includes/api-management-workspace-try-it.md)]
2424

@@ -34,17 +34,19 @@ In this tutorial, you learn how to:
3434

3535
## Prerequisites
3636

37-
+ Learn [Azure API Management terminology](api-management-terminology.md).
37+
+ Learn [Azure API Management terminology](api-management-terminology.md).
3838
+ Complete the quickstart [Create an Azure API Management instance](get-started-create-service-instance.md).
3939
+ Complete the tutorial [Import and publish your first API](import-and-publish.md).
4040

4141
## Add a new version
4242

4343
1. In the [Azure portal](https://portal.azure.com), navigate to your API Management instance.
44-
1. In the left menu, in the **APIs** section, select **APIs**.
44+
45+
1. Under **APIs** in the sidebar menu, select **APIs**.
46+
4547
1. Locate **Swagger Petstore - OpenAPI 3.0** in the API list. Select the ellipsis (**...**) next to **Swagger Petstore - OpenAPI 3.0** and then select **Add version**. You'll add values to the resulting window in the next section.
4648

47-
:::image type="content" source="media/api-management-get-started-publish-versions/add-version-menu.png" alt-text="Screenshot showing the steps for adding a version." lightbox="media/api-management-get-started-publish-versions/add-version-menu.png":::
49+
:::image type="content" source="media/api-management-get-started-publish-versions/add-version-menu.png" alt-text="Screenshot showing the steps to add a version." lightbox="media/api-management-get-started-publish-versions/add-version-menu.png":::
4850

4951
> [!TIP]
5052
> You can also enable versions when you create a new API. On the **Add API** screen, select **Version this API?**.
@@ -82,13 +84,18 @@ For callers to see the new version, it must be added to a *product*. If you didn
8284
To add the version to a product:
8385

8486
1. In the Azure portal, navigate to your API Management instance.
85-
1. Under **APIs** in the left pane, select **Products**.
86-
1. Select the product, and then select **APIs** in the left pane.
87+
88+
1. Under **APIs** in the sidebar menu, select **Products**.
89+
90+
1. Select the product, and then select **APIs**.
91+
8792
1. Select **+ Add**.
93+
8894
1. Select the API.
89-
1. Click **Select**.
9095

91-
:::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the APIs - Product window." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
96+
1. Choose **Select**.
97+
98+
:::image type="content" source="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png" alt-text="Screenshot that shows the APIs Product window." lightbox="media/api-management-get-started-publish-versions/08-add-multiple-versions-03-add-version-product.png":::
9299

93100
## Use version sets
94101

@@ -102,7 +109,7 @@ To see all your version sets, run the [az apim api versionset list](/cli/azure/a
102109

103110
```azurecli
104111
az apim api versionset list --resource-group <resource-group-name> \
105-
--service-name <API-Management-service-name> --output table
112+
--service-name <API-management-service-name> --output table
106113
```
107114

108115
When the Azure portal creates a version set for you, it assigns an alphanumeric name, which appears in the **Name** column of the list. Use this name in other Azure CLI commands.
@@ -111,7 +118,7 @@ To see details about a version set, run the [az apim api versionset show](/cli/a
111118

112119
```azurecli
113120
az apim api versionset show --resource-group <resource-group-name> \
114-
--service-name <API-Management-service-name> --version-set-id <ID from the Name column>
121+
--service-name <API-management-service-name> --version-set-id <ID-from-the-name-column>
115122
```
116123

117124
For more information about version sets, see [Versions in Azure API Management](api-management-versions.md#how-versions-are-represented).
@@ -121,14 +128,16 @@ For more information about version sets, see [Versions in Azure API Management](
121128
If you use the [developer portal](api-management-howto-developer-portal-customize.md), you can see API versions there.
122129

123130
1. Select **Developer portal** at the top of the window.
131+
124132
1. Select **APIs**, and then select **Swagger Petstore**.
133+
125134
1. You should see a dropdown that lists multiple versions next to the API name.
135+
126136
1. Select **v1**.
137+
127138
1. Notice the **Request URL** of the first operation in the list. It shows that the API URL path includes **v1**.
128139

129140
## Next step
130141

131-
Go to the next tutorial:
132-
133142
> [!div class="nextstepaction"]
134-
> [Customize the style of the Developer portal pages](api-management-howto-developer-portal-customize.md)
143+
> [Access and customize the developer portal](api-management-howto-developer-portal-customize.md)

0 commit comments

Comments
 (0)