Merge pull request #276131 from gourdsay/main

Security update

Author: Jill Grant

articles/data-manager-for-agri/how-to-set-up-isv-solution.md

@@ -1,11 +1,11 @@
 ---
 title: Use ISV solutions with Data Manager for Agriculture.
-description: Learn how to use APIs from a third-party solution
+description: Learn how to use APIs from an industry solution provider.
 author: gourdsay
 ms.author: angour
 ms.service: data-manager-for-agri
 ms.topic: how-to
-ms.date: 09/01/2023
+ms.date: 05/23/2024
 ms.custom: template-how-to
 ---
 
@@ -15,44 +15,44 @@ Follow the following guidelines to install and use an ISV solution.
 
 ## Install an ISV solution
 
-1. Once you've installed an instance of Azure Data Manager for Agriculture from Azure portal, navigate to Settings ->Solutions tab on the left hand side in your instance. Ensure you have application admin permission. 
-2. Click on **Add** to view the list of Solutions available for installation. Select the solution of your choice and click on **Add** button against it.
+1. Once you install an instance of Azure Data Manager for Agriculture from Azure portal, navigate to Settings ->Solutions tab on the left hand side in your instance. Ensure you have application admin permission. 
+2. Select **Add** to view the list of Solutions available for installation. Select the solution of your choice and select on **Add** button against it.
 > [!NOTE]
 >
 >If a Solution has only private plans, you will see **Contact Us** button which will take you to Marketplace page for Solution.
 >
-3. You are navigated to the plan selection pane where you have to give the following inputs:
-    1. Click on **Authorize** button to give consent to the Solution Provider to create app needed for Solution installation.
+3. You're navigated to the plan selection pane where you have to give the following inputs:
+    1. Select **Authorize** button to give consent to the Solution Provider to create app needed for Solution installation.
     2. Object ID. See [here](#identify-object-id-of-the-solution) to find your Object ID
     3. Select plan of your choice
-4. Select the Terms and Conditions checkbox and click on Add.
-5. The Solution is deployed on your ADMA instance and role assignment will be handled from the backend. 
+4. Select the Terms and Conditions checkbox and select on Add.
+5. The solution is deployed on your Data Manager for Agriculture instance and role assignment is handled at  the backend. 
 
 ## Edit an installed Solution
 
- To edit an installed Solution, click on the edit icon against the Solution in Solutions page. You are redirected to plan selection pane to modify your plan. If it's a solution with private plans, you are redirected to Azure Marketplace from where you can contact the ISV partner by clicking on **Contact Me**.
+ To edit an installed Solution, select on the edit icon against the Solution in Solutions page. You're redirected to plan selection pane to modify your plan. If it's a solution with private plans, you're redirected to Azure Marketplace from where you can contact the ISV partner by clicking on **Contact Me**.
 
 ## Delete an installed Solution
 
- To delete an installed Solution, click on the delete icon against the Solution in Solutions page and confirm the same on the popup. If it's a Solution with private plans, you'll be redirected to Azure Marketplace from where you can Contact the ISV partner by clicking on Contact Me.
+ To delete an installed Solution, select on the delete icon against the solution in solutions page and confirm the same on the popup. If it's a Solution with private plans, you're redirected to Azure Marketplace from where you can Contact the ISV partner by clicking on Contact Me.
 
 ## Use an ISV solution
 
-Once you've installed an ISV solution, use the below steps to understand how to make API calls from your application. Integration (request/response) is done through APIs asynchronously.
+Once you install an ISV solution, use the below steps to understand how to make API calls from your application. Integration (request/response) is done through APIs asynchronously.
 
 A high level view of how you can create a new request and get responses from the ISV partners solution:
 
 :::image type="content" source="./media/3p-solutions-new.png" alt-text="Screenshot showing access flow for ISV API.":::
 
 1. You make an API call for a PUT request with the required parameters (for example Job ID, Farm details)
-    * The Data Manager API receives this request and authenticates it.  If the request is invalid, you get an error code back.
+    * The Data Manager API receives this request and authenticates it. If the request is invalid, you get an error code back.
 2. If the request is valid, the Data Manager creates a PUT request to ISV Partners solution API.
 3. The ISV solution then makes a GET request to the weather service in data manager that is required for processing.
 4. The ISV solution completes the processing the request and submits a response back to the Data Manager.
-    * If there's any error when this request is submitted, then you may have to verify the configuration and parameters. If you're unable to resolve the issue then contact us at [email protected]
+    * If there's any error when this request is submitted, then you might have to verify the configuration and parameters. In case you're unable to resolve the issue then reach out to us by creating a [support ticket](how-to-create-azure-support-request.md).
 5. Now you make a call to Data Manager using the Job ID to get the final response.
     *  If the request processing is completed by the ISV Solution, you get the insight response back.  
-    * If the request processing is still in progress, you get the  message “Processing in progress”
+    * If the request processing is still in progress, you get the  message 'Processing in progress'
 
 Once all the request/responses are successfully processed, the status of the request is closed. This final output of the request is stored in Data Manager for Agriculture. You must ensure that you're submitting requests within the predefined thresholds.  
 

articles/data-manager-for-agri/how-to-set-up-sensors-partner.md

@@ -5,7 +5,7 @@ author: gourdsay
 ms.author: angour
 ms.service: data-manager-for-agri
 ms.topic: how-to
-ms.date: 06/19/2023
+ms.date: 05/23/2024
 ms.custom: template-how-to
 ---
 
@@ -50,7 +50,7 @@ Follow the steps provided in [Add a client secret](/azure/active-directory/devel
 
 ### Registration
 
-Once the partner has created a multi-tenant Microsoft Entra app successfully, partners manually share the APP ID and Partner ID with Data Manager for Agriculture by emailing [email protected] alias. Using this information Data Manager for Agriculture validates if it’s an authentic partner and creating a partner identity (sensorPartnerId) using the internal APIs. As part of the registration process, partners are enabled to use their partner ID (sensorPartnerId) while creating the sensor/devices object and also as part of the sensor data that they push.
+Once the partner has created a multi-tenant Microsoft Entra app successfully, partners manually share the APP ID and Partner ID with Data Manager for Agriculture team by creating a [support ticket](how-to-create-azure-support-request.md). Using this information Data Manager for Agriculture validates if it’s an authentic partner and creating a partner identity (sensorPartnerId) using the internal APIs. As part of the registration process, partners are enabled to use their partner ID (sensorPartnerId) while creating the sensor/devices object and also as part of the sensor data that they push.
 
 Getting the partner ID marks the completion of partner-Data Manager for Agriculture integration. Now, the partner waits for input from any of their sensor customers to initiate their data ingestion into Data Manager for Agriculture.