Skip to content

Commit 7ea82c9

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents d4ca80b + b8a61c9 commit 7ea82c9

File tree

244 files changed

+2839
-2556
lines changed

Some content is hidden

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

244 files changed

+2839
-2556
lines changed

articles/active-directory/app-provisioning/check-status-user-account-provisioning.md

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.service: active-directory
88
ms.subservice: app-provisioning
99
ms.workload: identity
1010
ms.topic: how-to
11-
ms.date: 05/11/2021
11+
ms.date: 05/30/2022
1212
ms.author: kenwith
1313
ms.reviewer: arvinh
1414
---
@@ -21,10 +21,15 @@ This article describes how to check the status of provisioning jobs after they h
2121

2222
## Overview
2323

24-
Provisioning connectors are set up and configured using the [Azure portal](https://portal.azure.com), by following the [provided documentation](../saas-apps/tutorial-list.md) for the supported application. Once configured and running, provisioning jobs can be reported on using one of two methods:
24+
Provisioning connectors are set up and configured using the [Azure portal](https://portal.azure.com), by following the [provided documentation](../saas-apps/tutorial-list.md) for the supported application. Once configured and running, provisioning jobs can be reported on using the following methods:
2525

26-
* **Azure portal** - This article primarily describes retrieving report information from the [Azure portal](https://portal.azure.com), which provides both a provisioning summary report as well as detailed provisioning audit logs for a given application.
27-
* **Audit API** - Azure Active Directory also provides an Audit API that enables programmatic retrieval of the detailed provisioning audit logs. See [Azure Active Directory audit API reference](/graph/api/resources/directoryaudit) for documentation specific to using this API. While this article does not specifically cover how to use the API, it does detail the types of provisioning events that are recorded in the audit log.
26+
- The [Azure portal](https://portal.azure.com)
27+
28+
- Streaming the provisioning logs into [Azure Monitor](../app-provisioning/application-provisioning-log-analytics.md). This method allows for extended data retention and building custom dashboards, alerts, and queries.
29+
30+
- Querying the [Microsoft Graph API](/graph/api/resources/provisioningobjectsummary) for the provisioning logs.
31+
32+
- Downloading the provisioning logs as a CSV or JSON file.
2833

2934
### Definitions
3035

@@ -35,7 +40,7 @@ This article uses the following terms, defined below:
3540

3641
## Getting provisioning reports from the Azure portal
3742

38-
To get provisioning report information for a given application, start by launching the [Azure portal](https://portal.azure.com) and **Azure Active Directory** > **Enterprise Apps** > **Provisioning logs (preview)** in the **Activity** section. You can also browse to the Enterprise Application for which provisioning is configured. For example, if you are provisioning users to LinkedIn Elevate, the navigation path to the application details is:
43+
To get provisioning report information for a given application, start by launching the [Azure portal](https://portal.azure.com) and **Azure Active Directory** > **Enterprise Apps** > **Provisioning logs** in the **Activity** section. You can also browse to the Enterprise Application for which provisioning is configured. For example, if you are provisioning users to LinkedIn Elevate, the navigation path to the application details is:
3944

4045
**Azure Active Directory > Enterprise Applications > All applications > LinkedIn Elevate**
4146

@@ -54,10 +59,10 @@ The **Current Status** should be the first place admins look to check on the ope
5459

5560
 ![Summary report](./media/check-status-user-account-provisioning/provisioning-progress-bar-section.png)
5661

57-
## Provisioning logs (preview)
62+
## Provisioning logs
63+
64+
All activities performed by the provisioning service are recorded in the Azure AD [provisioning logs](../reports-monitoring/concept-provisioning-logs.md?context=azure/active-directory/manage-apps/context/manage-apps-context). You can access the provisioning logs in the Azure portal by selecting **Azure Active Directory** > **Enterprise Apps** > **Provisioning logs ** in the **Activity** section. You can search the provisioning data based on the name of the user or the identifier in either the source system or the target system. For details, see [Provisioning logs](../reports-monitoring/concept-provisioning-logs.md?context=azure/active-directory/manage-apps/context/manage-apps-context).
5865

59-
All activities performed by the provisioning service are recorded in the Azure AD [provisioning logs](../reports-monitoring/concept-provisioning-logs.md?context=azure/active-directory/manage-apps/context/manage-apps-context). You can access the provisioning logs in the Azure portal by selecting **Azure Active Directory** > **Enterprise Apps** > **Provisioning logs (preview)** in the **Activity** section. You can search the provisioning data based on the name of the user or the identifier in either the source system or the target system. For details, see [Provisioning logs (preview)](../reports-monitoring/concept-provisioning-logs.md?context=azure/active-directory/manage-apps/context/manage-apps-context).
60-
Logged activity event types include:
6166

6267
## Troubleshooting
6368

@@ -68,4 +73,4 @@ For scenario-based guidance on how to troubleshoot automatic user provisioning,
6873
## Additional Resources
6974

7075
* [Managing user account provisioning for Enterprise Apps](configure-automatic-user-provisioning-portal.md)
71-
* [What is application access and single sign-on with Azure Active Directory?](../manage-apps/what-is-single-sign-on.md)
76+
* [What is application access and single sign-on with Azure Active Directory?](../manage-apps/what-is-single-sign-on.md)

articles/active-directory/app-provisioning/plan-auto-user-provisioning.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -237,7 +237,7 @@ It's common for a security review to be required as part of a deployment. If you
237237

238238
If the automatic user provisioning implementation fails to work as desired in the production environment, the following rollback steps below can assist you in reverting to a previous known good state:
239239

240-
1. Review the [provisioning summary report](../app-provisioning/check-status-user-account-provisioning.md) and [provisioning logs](../app-provisioning/check-status-user-account-provisioning.md#provisioning-logs-preview) to determine what incorrect operations occurred on the affected users and/or groups.
240+
1. Review the [provisioning logs](../app-provisioning/check-status-user-account-provisioning.md) to determine what incorrect operations occurred on the affected users and/or groups.
241241

242242
1. Use provisioning audit logs to determine the last known good state of the users and/or groups affected. Also review the source systems (Azure AD or AD).
243243

@@ -324,4 +324,4 @@ Refer to the following links to troubleshoot any issues that may turn up during
324324

325325
* [Export or import your provisioning configuration by using Microsoft Graph API](../app-provisioning/export-import-provisioning-configuration.md)
326326

327-
* [Writing expressions for attribute mappings in Azure Active directory](../app-provisioning/functions-for-customizing-application-data.md)
327+
* [Writing expressions for attribute mappings in Azure Active directory](../app-provisioning/functions-for-customizing-application-data.md)

articles/active-directory/app-provisioning/plan-cloud-hr-provision.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -463,7 +463,7 @@ It's common for a security review to be required as part of the deployment of a
463463

464464
The cloud HR user provisioning implementation might fail to work as desired in the production environment. If so, the following rollback steps can assist you in reverting to a previous known good state.
465465

466-
1. Review the [provisioning summary report](../app-provisioning/check-status-user-account-provisioning.md#getting-provisioning-reports-from-the-azure-portal) and [provisioning logs](../app-provisioning/check-status-user-account-provisioning.md#provisioning-logs-preview) to determine what incorrect operations were performed on the affected users or groups. For more information on the provisioning summary report and logs, see [Manage cloud HR app user provisioning](#manage-your-configuration).
466+
1. Review the [provisioning logs](../app-provisioning/check-status-user-account-provisioning.md#provisioning-logs) to determine what incorrect operations were performed on the affected users or groups. For more information on the provisioning summary report and logs, see [Manage cloud HR app user provisioning](#manage-your-configuration).
467467
2. The last known good state of the users or groups affected can be determined through the provisioning audit logs or by reviewing the target systems (Azure AD or Active Directory).
468468
3. Work with the app owner to update the users or groups affected directly in the app by using the last known good state values.
469469

articles/active-directory/develop/includes/web-app/quickstart-aspnet-core.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ See [How the sample works](#how-the-sample-works) for an illustration.
3232
1. Search for and select **Azure Active Directory**.
3333
1. Under **Manage**, select **App registrations** > **New registration**.
3434
1. For **Name**, enter a name for your application. For example, enter **AspNetCore-Quickstart**. Users of your app will see this name, and you can change it later.
35-
1. For **Redirect URI**, enter **https://localhost:44321/signin-oidc**.
35+
1. Set the **Redirect URI** type to **Web** and value to `https://localhost:44321/signin-oidc`.
3636
1. Select **Register**.
3737
1. Under **Manage**, select **Authentication**.
3838
1. For **Front-channel logout URL**, enter **https://localhost:44321/signout-oidc**.

articles/active-directory/develop/includes/web-app/quickstart-aspnet.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,8 @@ If you want to manually configure your application and code sample, use the foll
4545
1. Search for and select **Azure Active Directory**.
4646
1. Under **Manage**, select **App registrations** > **New registration**.
4747
1. For **Name**, enter a name for your application. For example, enter **ASPNET-Quickstart**. Users of your app will see this name, and you can change it later.
48-
1. Add **https://localhost:44368/** in **Redirect URI**, and select **Register**.
48+
1. Set the **Redirect URI** type to **Web** and value to `https://localhost:44368/`.
49+
1. Select **Register**.
4950
1. Under **Manage**, select **Authentication**.
5051
1. In the **Implicit grant and hybrid flows** section, select **ID tokens**.
5152
1. Select **Save**.

articles/active-directory/develop/includes/web-app/quickstart-nodejs-msal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ This quickstart uses the Microsoft Authentication Library for Node.js (MSAL Node
3737
1. Under **Manage**, select **App registrations** > **New registration**.
3838
1. Enter a **Name** for your application. Users of your app might see this name, and you can change it later.
3939
1. Under **Supported account types**, select **Accounts in this organizational directory only**.
40-
1. Set the **Redirect URI** value to `http://localhost:3000/auth/redirect`.
40+
1. Set the **Redirect URI** type to **Web** and value to `http://localhost:3000/auth/redirect`.
4141
1. Select **Register**.
4242
1. On the app **Overview** page, note the **Application (client) ID** value for later use.
4343
1. Under **Manage**, select **Certificates & secrets** > **Client secrets** > **New client secret**. Leave the description blank and default expiration, and then select **Add**.

articles/api-management/set-edit-policies.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -187,7 +187,7 @@ If you configure policy definitions at more than one scope, multiple policies co
187187
In API Management, determine the policy evaluation order by placement of the `base` element in each section in the policy definition at each scope. The `base` element inherits the policies configured in that section at the next broader (parent) scope. The `base` element is included by default in each policy section.
188188

189189
> [!NOTE]
190-
> To view the effective policies at the current scope, select **Recalculate effective policy** in the policy editor.
190+
> To view the effective policies at the current scope, select **Calculate effective policy** in the policy editor.
191191

192192
To modify the policy evaluation order using the policy editor:
193193

articles/api-management/validation-policies.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,15 @@ documentationcenter: ''
66
author: dlepow
77
ms.service: api-management
88
ms.topic: reference
9-
ms.date: 03/07/2022
9+
ms.date: 06/07/2022
1010
ms.author: danlep
1111
---
1212

1313
# API Management policies to validate requests and responses
1414

15-
This article provides a reference for API Management policies to validate REST or SOAP API requests and responses against schemas defined in the API definition or supplementary JSON or XML schemas. Validation policies protect from vulnerabilities such as injection of headers or payload or leaking sensitive data.
15+
This article provides a reference for API Management policies to validate REST or SOAP API requests and responses against schemas defined in the API definition or supplementary JSON or XML schemas. Validation policies protect from vulnerabilities such as injection of headers or payload or leaking sensitive data. Learn more about common [API vulnerabilites](mitigate-owasp-api-threats.md).
1616

17-
While not a replacement for a Web Application Firewall, validation policies provide flexibility to respond to an additional class of threats that aren’t covered by security products that rely on static, predefined rules.
17+
While not a replacement for a Web Application Firewall, validation policies provide flexibility to respond to an additional class of threats that aren’t covered by security products that rely on static, predefined rules.
1818

1919
[!INCLUDE [api-management-policy-intro-links](../../includes/api-management-policy-intro-links.md)]
2020

@@ -66,14 +66,26 @@ The `validate-content` policy validates the size or content of a request or resp
6666

6767
[!INCLUDE [api-management-policy-form-alert](../../includes/api-management-policy-form-alert.md)]
6868

69-
The following table shows the schema formats and request or response content types that the policy supports. Content type values are case insensitive.
69+
The following table shows the schema formats and request or response content types that the policy supports. Content type values are case insensitive.
7070

7171
| Format | Content types |
7272
|---------|---------|
7373
|JSON | Examples: `application/json`<br/>`application/hal+json` |
7474
|XML | Example: `application/xml` |
7575
|SOAP | Allowed values: `application/soap+xml` for SOAP 1.2 APIs<br/>`text/xml` for SOAP 1.1 APIs|
7676

77+
### What content is validated
78+
79+
The policy validates the following content in the request or response against the schema:
80+
81+
* Presence of all required properties.
82+
* Absence of additional properties, if the schema has the `additionalProperties` field set to `false`.
83+
* Types of all properties. For example, if a schema specifies a property as an integer, the request (or response) must include an integer and not another type, such as a string.
84+
* The format of the properties, if specified in the schema - for example, regex (if the `pattern` keyword is specified), `minimum` for integers, and so on.
85+
86+
> [!TIP]
87+
> For examples of regex pattern constraints that can be used in schemas, see [OWASP Validation Regex Repository](https://owasp.org/www-community/OWASP_Validation_Regex_Repository).
88+
7789
### Policy statement
7890

7991
```xml
@@ -166,7 +178,6 @@ After the schema is created, it appears in the list on the **Schemas** page. Sel
166178
> * A schema may cross-reference another schema that is added to the API Management instance.
167179
> * Open-source tools to resolve WSDL and XSD schema references and to batch-import generated schemas to API Management are available on [GitHub](https://github.com/Azure-Samples/api-management-schema-import).
168180
169-
170181
### Usage
171182

172183
This policy can be used in the following policy [sections](./api-management-howto-policies.md#sections) and [scopes](./api-management-howto-policies.md#scopes).

articles/azure-cache-for-redis/cache-how-to-premium-vnet.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -48,9 +48,7 @@ Virtual network support is configured on the **New Azure Cache for Redis** pane
4848
1. On the **Networking** tab, select **Virtual Networks** as your connectivity method. To use a new virtual network, create it first by following the steps in [Create a virtual network using the Azure portal](../virtual-network/manage-virtual-network.md#create-a-virtual-network) or [Create a virtual network (classic) by using the Azure portal](/previous-versions/azure/virtual-network/virtual-networks-create-vnet-classic-pportal). Then return to the **New Azure Cache for Redis** pane to create and configure your Premium-tier cache.
4949

5050
> [!IMPORTANT]
51-
> When you deploy Azure Cache for Redis to a Resource Manager virtual network, the cache must be in a dedicated subnet that contains no other resources except for Azure Cache for Redis instances. If you attempt to deploy an Azure Cache for Redis instance to a Resource Manager virtual network subnet that contains other resources, or has a NAT Gateway assigned, the deployment fails.
52-
>
53-
>
51+
> When you deploy Azure Cache for Redis to a Resource Manager virtual network, the cache must be in a dedicated subnet that contains no other resources except for Azure Cache for Redis instances. If you attempt to deploy an Azure Cache for Redis instance to a Resource Manager virtual network subnet that contains other resources, or has a NAT Gateway assigned, the deployment fails. The failure is because Azure Cache for Redis uses a basic load balancer that is not compatible with a NAT Gateway.
5452
5553
| Setting | Suggested value | Description |
5654
| ------------ | ------- | -------------------------------------------------- |
@@ -186,7 +184,7 @@ After the port requirements are configured as described in the previous section,
186184

187185
- [Reboot](cache-administration.md#reboot) all of the cache nodes. The cache won't be able to restart successfully if all of the required cache dependencies can't be reached---as documented in [Inbound port requirements](cache-how-to-premium-vnet.md#inbound-port-requirements) and [Outbound port requirements](cache-how-to-premium-vnet.md#outbound-port-requirements).
188186
- After the cache nodes have restarted, as reported by the cache status in the Azure portal, you can do the following tests:
189-
- Ping the cache endpoint by using port 6380 from a machine that's within the same virtual network as the cache, using [tcping](https://www.elifulkerson.com/projects/tcping.php). For example:
187+
- Ping the cache endpoint by using port 6380 from a machine that's within the same virtual network as the cache, using [`tcping`](https://www.elifulkerson.com/projects/tcping.php). For example:
190188

191189
`tcping.exe contosocache.redis.cache.windows.net 6380`
192190

articles/azure-functions/functions-create-your-first-function-visual-studio.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,10 +72,18 @@ The `FunctionName` method attribute sets the name of the function, which by defa
7272

7373
1. In the `HttpTrigger` method named `Run`, rename the `FunctionName` method attribute to `HttpExample`.
7474

75-
Your function definition should now look like the following code:
75+
Your function definition should now look like the following code, depending on mode:
76+
77+
# [In-process](#tab/in-process)
7678

7779
:::code language="csharp" source="~/functions-docs-csharp/http-trigger-template/HttpExample.cs" range="15-18":::
7880

81+
# [Isolated process](#tab/isolated-process)
82+
83+
:::code language="csharp" source="~/functions-docs-csharp/http-trigger-isolated/HttpExample.cs" range="11-13":::
84+
85+
---
86+
7987
Now that you've renamed the function, you can test it on your local computer.
8088

8189
## Run the function locally

0 commit comments

Comments
 (0)