Merge branch 'main' into 147653-v3-1-rest-api-update

Author: laujan

articles/active-directory/architecture/architecture-icons.md

@@ -0,0 +1,56 @@
+---
+title: Microsoft Entra architecture icons
+description: Learn about the official collection of Microsoft Entra icons that you can use in architectural diagrams, training materials, or documentation.
+author: CelesteDG
+manager: CelesteDG
+ms.service: active-directory
+ms.subservice: fundamentals
+ms.topic: conceptual
+ms.date: 08/15/2023
+ms.author: celested
+ms.reviewer: nicholepet
+
+# Customer intent: As a new or existing customer, I want to learn how I can use the official Microsoft Entra icons in architectural diagrams, training materials, or documentation.
+---
+
+# Microsoft Entra architecture icons
+
+Helping our customers design and architect new solutions is core to the Microsoft Entra mission. Architecture diagrams can help communicate design decisions and the relationships between components of a given workload. This article provides information about the official collection of Microsoft Entra icons that you can use in architectural diagrams, training materials, or documentation.
+
+## General guidelines
+
+### Do's
+
+- Use the icon to illustrate how products can work together.
+- In diagrams, we recommend including the product name somewhere close to the icon.
+
+### Don'ts
+
+- Don't crop, flip, or rotate icons.
+- Don't distort or change the icon shape in any way.
+- Don't use Microsoft product icons to represent your product or service.
+- Don't use Microsoft product icons in marketing communications.
+
+## Icon updates
+
+| Month | Change description |
+|-------|--------------------|
+| August 2023 | Added a downloadable package that contains the Microsoft Entra architecture icons, branding playbook (which contains guidelines about the Microsoft Security visual identity), and terms of use. |
+
+## Icon terms
+
+Microsoft permits the use of these icons in architectural diagrams, training materials, or documentation. You may copy, distribute, and display the icons only for the permitted use unless granted explicit permission by Microsoft. Microsoft reserves all other rights.
+
+<div id="consent-checkbox">
+I agree to the above terms.
+</div>
+
+ > [!div class="button"]
+ > [Download icons](https://download.microsoft.com/download/a/4/2/a4289cad-4eaf-4580-87fd-ce999a601516/Microsoft-Entra-architecture-icons.zip?wt.mc_id=microsoftentraicons_downloadmicrosoftentraicons_content_cnl_csasci)
+
+## More icon sets from Microsoft
+
+- [Azure architecture icons](/azure/architecture/icons)
+- [Microsoft 365 architecture icons and templates](/microsoft-365/solutions/architecture-icons-templates)
+- [Dynamics 365 icons](/dynamics365/get-started/icons)
+- [Microsoft Power Platform icons](/power-platform/guidance/icons)

articles/active-directory/architecture/toc.yml

@@ -7,6 +7,8 @@ items:
     items:
     - name: Azure AD architecture
       href: architecture.md
+    - name: Microsoft Entra architecture icons
+      href: architecture-icons.md
     - name: Road to the cloud
       items:
       - name: Introduction

articles/active-directory/fundamentals/media/new-name/azure-ad-icon-1.png

@@ -12,7 +12,7 @@ ms.author: lajanuar
 ---
 <!-- markdownlint-disable MD025 -->
 
-[Client library](/javascript/api/overview/azure/ai-form-recognizer-readme?view=azure-node-latest&preserve-view=true) | [SDK reference](https://azuresdkdocs.blob.core.windows.net/$web/javascript/azure-ai-form-recognizer/5.0.0/index.html) | [API reference](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2023-07-31/operations/AnalyzeDocument) | [Package (npm)](https://www.npmjs.com/package/@azure/ai-form-recognizer/v/5.0.0) | [Samples](https://github.com/witemple-msft/azure-sdk-for-js/tree/ai-form-recognizer/5.0.0-release/sdk/formrecognizer/ai-form-recognizer/samples/v5) |[Supported REST API versions](../../sdk-overview-v3-1.md)
+[Client library](/javascript/api/overview/azure/ai-form-recognizer-readme?view=azure-node-latest&preserve-view=true) | [SDK reference](https://azuresdkdocs.blob.core.windows.net/$web/javascript/azure-ai-form-recognizer/5.0.0/index.html) | [API reference](https://westus.dev.cognitive.microsoft.com/docs/services/form-recognizer-api-2023-07-31/operations/AnalyzeDocument) | [Package (npm)](https://www.npmjs.com/package/@azure/ai-form-recognizer/v/5.0.0) | [Samples](https://github.com/witemple-msft/azure-sdk-for-js/tree/ai-form-recognizer/5.0.0-release/sdk/formrecognizer/ai-form-recognizer/samples/v5) |[Supported REST API versions](../../sdk-overview.md)
 
 In this quickstart you'll, use the following features to analyze and extract data and values from forms and documents:
 

articles/active-directory/fundamentals/media/new-name/azure-ad-icon-2.png

@@ -48,13 +48,19 @@ The managed developer portal includes a **Custom HTML code** widget where you ca
 
 ## Create and upload custom widget
 
-### Prerequisites 
- 
+For more advanced widget use cases, API Management provides a scaffold and tools to help developers create a widget and upload it to the developer portal.
+
+### Prerequisites
+
 * Install [Node.JS runtime](https://nodejs.org/en/) locally 
 * Basic knowledge of programming and web development
 
 ### Create widget
 
+> [!WARNING]
+> Your custom widget code is stored in public Azure blob storage that's associated with your API Management instance. When you add a custom widget to the developer portal, code is read from this storage via an endpoint that doesn't require authentication, even if the developer portal or a page with the custom widget is only accessible to authenticated users. Don't include sensitive information or secrets in the custom widget code.
+>
+
 1. In the administrative interface for the developer portal, select **Custom widgets** > **Create new custom widget**. 
 1. Enter a widget name and choose a **Technology**. For more information, see [Widget templates](#widget-templates), later in this article.
 1. Select **Create widget**.
@@ -115,7 +121,6 @@ The managed developer portal includes a **Custom HTML code** widget where you ca
 
     If prompted, sign in to your Azure account. 
 
-
 The custom widget is now deployed to your developer portal. Using the portal's administrative interface, you can add it on pages in the developer portal and set values for any custom properties configured in the widget.
 
 ### Publish the developer portal
@@ -143,6 +148,7 @@ The React template contains prepared custom hooks in the `hooks.ts` file and est
 This [npm package](https://www.npmjs.com/package/@azure/api-management-custom-widgets-tools) contains the following functions to help you develop your custom widget and provides features including communication between the developer portal and your widget:
 
 
+
 |Function  |Description  |
 |---------|---------|
 |[getValues](#azureapi-management-custom-widgets-toolsgetvalues) | Returns a JSON object containing values set in the widget editor combined with default values |
@@ -153,6 +159,7 @@ This [npm package](https://www.npmjs.com/package/@azure/api-management-custom-wi
 |[getWidgetData](#azureapi-management-custom-widgets-toolsgetwidgetdata)     | Returns all data passed to your custom widget from the developer portal<br/><br/>Used internally in templates         |
 
 
+
 #### `@azure/api-management-custom-widgets-tools/getValues` 
 
 Function that returns a JSON object containing the values you've set in the widget editor combined with default values, passed as an argument. 
@@ -192,6 +199,7 @@ This function returns a JavaScript promise, which after resolution returns a JSO
 > Manage and use the token carefully. Anyone who has it can access data in your API Management service. 
 
 
+
 #### `@azure/api-management-custom-widgets-tools/deployNodeJs` 
 
 This function deploys your widget to your blob storage. In all templates, it's preconfigured in the `deploy.js` file.  
@@ -247,7 +255,6 @@ To implement your widget using another JavaScript UI framework and libraries, yo
 * For local development, the `config.msapim.json` file must be accessible at the URL `localhost:<port>/config.msapim.json` when the server is running. 
 
 
-
 ## Next steps
 
 Learn more about the developer portal:
@@ -256,3 +263,4 @@ Learn more about the developer portal:
 - [Frequently asked questions](developer-portal-faq.md)
 - [Scaffolder of a custom widget for developer portal of Azure API Management service](https://www.npmjs.com/package/@azure/api-management-custom-widgets-scaffolder)
 - [Tools for working with custom widgets of developer portal of Azure API Management service](https://www.npmjs.com/package/@azure/api-management-custom-widgets-tools)
+

articles/active-directory/fundamentals/media/new-name/microsoft-entra-id-icon.png

@@ -6,7 +6,7 @@ author: cephalin
 ms.topic: article
 ms.date: 07/31/2023
 ms.author: mahender
-ms.custom: seodec18
+ms.custom: seodec18, AppServiceConnectivity
 
 ---
 

articles/active-directory/fundamentals/new-name.md

@@ -5,7 +5,7 @@ ms.assetid: 03c584f1-a93c-4e3d-ac1b-c82b50c75d3e
 ms.devlang: csharp
 ms.topic: tutorial
 ms.date: 01/27/2022
-ms.custom: "devx-track-csharp, mvc, devcenter, vs-azure, seodec18"
+ms.custom: devx-track-csharp, mvc, devcenter, vs-azure, seodec18, AppServiceConnectivity
 ---
 
 # Tutorial: Deploy an ASP.NET app to Azure with Azure SQL Database