Skip to content

Commit 8ea6240

Browse files
committed
Postman fixes for ADF
1 parent 6b2f9da commit 8ea6240

File tree

6 files changed

+22
-20
lines changed

6 files changed

+22
-20
lines changed

articles/data-factory/connector-http.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ You can use this HTTP connector to:
4242
- Copy the HTTP response as-is or parse it by using [supported file formats and compression codecs](supported-file-formats-and-compression-codecs.md).
4343

4444
> [!TIP]
45-
> To test an HTTP request for data retrieval before you configure the HTTP connector, learn about the API specification for header and body requirements. You can use tools like Postman or a web browser to validate.
45+
> To test an HTTP request for data retrieval before you configure the HTTP connector, learn about the API specification for header and body requirements. You can use tools like Visual Studio, PowerShell's Invoke-RestMethod, or a web browser to validate.
4646
4747
## Prerequisites
4848

articles/data-factory/connector-odata.md

Lines changed: 17 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -358,21 +358,23 @@ Project Online requires user-based OAuth, which is not supported by Azure Data F
358358
359359
1. Use **Postman** to get the access token:
360360

361-
1. Navigate to **Authorization** tab on the Postman Website.
362-
1. In the **Type** box, select **OAuth 2.0**, and in the **Add authorization data to** box, select **Request Headers**.
363-
1. Fill the following information in the **Configure New Token** page to get a new access token:
364-
- **Grant type**: Select **Authorization Code**.
365-
- **Callback URL**: Enter `https://www.localhost.com/`
366-
- **Auth URL**: Enter `https://login.microsoftonline.com/common/oauth2/authorize?resource=https://<your tenant name>.sharepoint.com`. Replace `<your tenant name>` with your own tenant name.
367-
- **Access Token URL**: Enter `https://login.microsoftonline.com/common/oauth2/token`.
368-
- **Client ID**: Enter your Microsoft Entra service principal ID.
369-
- **Client Secret**: Enter your service principal secret.
370-
- **Client Authentication**: Select **Send as Basic Auth header**.
371-
372-
1. You will be asked to sign in with your username and password.
373-
1. Once you get your access token, please copy and save it for the next step.
374-
375-
:::image type="content" source="./media/connector-odata/odata-project-online-postman-access-token-inline.png" alt-text="Screenshot of using Postman to get the access token." lightbox="./media/connector-odata/odata-project-online-postman-access-token-expanded.png":::
361+
> [!NOTE]
362+
> Postman is a widely used applicatoin among developers for testing remote web APIs. However, there are some security and privacy risks associated with its usage. This article does not endorse the use of Postman for production environments. Please use it at your own risk.
363+
364+
1. Navigate to **Authorization** tab on the Postman Website.
365+
1. In the **Type** box, select **OAuth 2.0**, and in the **Add authorization data to** box, select **Request Headers**.
366+
1. Fill the following information in the **Configure New Token** page to get a new access token:
367+
- **Grant type**: Select **Authorization Code**.
368+
- **Callback URL**: Enter `https://www.localhost.com/`.
369+
- **Auth URL**: Enter `https://login.microsoftonline.com/common/oauth2/authorize?resource=https://<your tenant name>.sharepoint.com`. Replace `<your tenant name>` with your own tenant name.
370+
- **Access Token URL**: Enter `https://login.microsoftonline.com/common/oauth2/token`.
371+
- **Client ID**: Enter your Microsoft Entra service principal ID.
372+
- **Client Secret**: Enter your service principal secret.
373+
- **Client Authentication**: Select **Send as Basic Auth header**.
374+
1. You will be asked to sign in with your username and password.
375+
1. Once you get your access token, please copy and save it for the next step.
376+
377+
:::image type="content" source="./media/connector-odata/odata-project-online-postman-access-token-inline.png" alt-text="Screenshot of using Postman to get the access token." lightbox="./media/connector-odata/odata-project-online-postman-access-token-expanded.png":::
376378

377379
1. Create the OData linked service:
378380
- **Service URL**: Enter `https://<your tenant name>.sharepoint.com/sites/pwa/_api/Projectdata`. Replace `<your tenant name>` with your own tenant name.

articles/data-factory/connector-rest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ Specifically, this generic REST connector supports:
4343
- For REST as source, copying the REST JSON response [as-is](#export-json-response-as-is) or parse it by using [schema mapping](copy-activity-schema-and-type-mapping.md#schema-mapping). Only response payload in **JSON** is supported.
4444

4545
> [!TIP]
46-
> To test a request for data retrieval before you configure the REST connector in Data Factory, learn about the API specification for header and body requirements. You can use tools like Postman or a web browser to validate.
46+
> To test a request for data retrieval before you configure the REST connector in Data Factory, learn about the API specification for header and body requirements. You can use tools like Visual Studio, PowerShell's Invoke-RestMethod or a web browser to validate.
4747
4848
## Prerequisites
4949

articles/data-factory/connector-troubleshoot-rest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ This article provides suggestions to troubleshoot common problems with the REST
5858

5959
- Note that 'curl' might not be suitable to reproduce an SSL certificate validation issue. In some scenarios, the 'curl' command was executed successfully without encountering any SSL certificate validation issues. But when the same URL is executed in a browser, no SSL certificate is actually returned for the client to establish trust with server.
6060

61-
Tools like **Postman** and **Fiddler** are recommended for the preceding case.
61+
Tools like **Fiddler** are recommended for the preceding case.
6262

6363
## Related content
6464

articles/data-factory/data-factory-troubleshoot-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1076,7 +1076,7 @@ If the HDI activity is stuck in preparing for cluster, follow the guidelines bel
10761076
10771077
- **Cause**: The request failed due to an underlying issue such as network connectivity, a DNS failure, a server certificate validation, or a timeout.
10781078
1079-
- **Recommendation**: Use Fiddler/Postman/Netmon/Wireshark to validate the request.
1079+
- **Recommendation**: Use Fiddler/Netmon/Wireshark to validate the request.
10801080
10811081
**Using Fiddler**
10821082

articles/data-factory/security-and-access-control-troubleshoot-guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -227,7 +227,7 @@ CMK in the service should have "Soft Delete" enabled and "Purge Protect" enabled
227227
Please review [Recover deleted Key](../key-vault/general/key-vault-recovery.md?tabs=azure-portal#list-recover-or-purge-soft-deleted-secrets-keys-and-certificates) and [Deleted Key Value](../key-vault/general/key-vault-recovery.md?tabs=azure-portal#list-recover-or-purge-a-soft-deleted-key-vault)
228228
229229
* User Assigned Managed Identity (UA-MI) was deleted before the service.
230-
You can recover from this by using REST API calls, you can do this in an http client of your choice in any programming language. If you have not anything already set up for REST API calls with Azure authentication, the easiest way to do this would be by using POSTMAN/Fiddler. Please follow following steps.
230+
You can recover from this by using REST API calls, you can do this in an http client of your choice in any programming language. If you have not anything already set up for REST API calls with Azure authentication, the easiest way to do this would be by using Fiddler. Please follow following steps.
231231
232232
1. Make a GET call using Method: GET Url like `https://management.azure.com/subscriptions/YourSubscription/resourcegroups/YourResourceGroup/providers/Microsoft.DataFactory/factories/YourFactoryName?api-version=2018-06-01`
233233

0 commit comments

Comments
 (0)