Integrating with Nerdio Manager for Enterprise

Introduction

You can integrate your Change360 workspace with a Nerdio Manager for Enterprise installation that is in the same Azure Subscription. When integrating with Nerdio Manager any desktop images and Windows Package Manager (WPM) repositories configured in NME will by sync'ed with your Change360 workspace, it is also possible to manually sync your Change360 workspace with NME to pickup any new desktop images or WPM repositories.

Once integrated with NME you will be able to:

• Use desktop images from NME to onboard and test applications in your Change360 workspace
• Export MSIX packages to NME as App Attach images (if an MSIX App Attach Storage Location has been configured)
• Export applications to Unified catalog using the WPM repository configured in NME

Configuring the connection to NME

Get Nerdio REST API Credentials

1. Login to Nerdio Manger.

2. Then on the navigation menu select Settings - Integrations

   

3. Under REST API select show

   

4. The credentials required for the next part will be displayed, leave the page open

   

   Info:

   If you don't know the Secret you might have to regenerate it, however this may affect any other services using the Nerdio REST API.

Configuring your Change360 Workspace

To complete the configuration of Nerdio Manager in your Change360 workspace you will need the details from Step 4 above:

1. Login to your Change360 workspace with an account that has Admin rights

2. Click on Advanced – Integrations to open the Integrations Hub

   

3. Select Configure on the Nerdio card

   

4. On the Nerdio instances card select + Add instance

   

5. On the Add Nerdio Manager instance dialog complete all the fields and click on Save:

   

   • Friendly Name – this is the name that will appear when choosing which Nerdio instance to export to
   • Tenant ID – TenantId from Step 4 above
   • Client ID – ClientId from Step 4 above
   • Client Secret – Secret from Step 4 above
   • Access Token URL – OAuth 2.0 token from Step 4 above
   • Nerdio Manager URL – URL for the Nerdio Manager Instance
   • Scope – Scope from Step 4 above

   Info:

   The Nerdio Manager details are validated before they are saved if any of them are incorrect then they will not be saved and you will have to update the incorrect value(s)

   

6. The configured Nerdio instance will now be listed on the configuration page, and you can start exporting packages to it.

   

7. To review any WPM repositories that have been added from NME refresh the Integrations page and expand Windows Package Manager

   

8. To review any custom images that have been added from NME click on Advanced and Select Custom Images or browse to Custom Images

   

Granting your Change360 workspace rights to export to a WPM repository

After adding a new Nerdio Manger instance or manually syncing with an existing Nerdio Manager instance you will need to grant your Change360 workspace rights to any new WPM repositories before you can export applications to them.

1. In your Change360 workspace browse to Advanced -> Integrations

   

2. On the Integrations Hub page select Configure under Windows Package Manager

   

3. On the Integrations page select the eye icon next to the WPM repository you want to permission, and make a note of the Function App name in the Url field and the Storage Account name in the BlobContainerUri field

   

4. Switch to Azure and browse to the resource group containing the Function App and Storage Account, typically this would be the Nerdio Manager for Enterprise resource group.

5. Open the Function App

   • Select Access Control (IAM), then click on Add and select Add role assignment
   • On the Role tab search for Contributor, then select Logic Apps Standard Contributor (Preview) and click on Next
   • On the Members tab select Managed Identity, then click on + Select members
   • On the fly in select Virtual Machine under Managed Identity, search for and select the Chnage360 Gateway VM, click on Select
   • Click on Review + assign
   • Click on Review + assign again
   • Expand Notifications and ensure the role assignment completes successfully

6. Browse back to the resource group and open the Storage Account

   • Select Access Control (IAM), then click on Add and select Add role assignment
   • On the Role tab search for Contributor, then select Storage Account Contributor and click on Next
   • On the Members tab select Managed Identity, then click on + Select members
   • On the fly in select Virtual Machine under Managed Identity, search for and select the Change360 Gateway VM, click on Select
   • Click on Review + assign
   • Click on Review + assign again
   • Expand Notifications and ensure the role assignment completes successfully

7. The Change360 Gateway now has permission to export apps to the WPM Repository.

Manually syncing with NME

You can manually synchronize any configured Nerdio Manger instance to add any new WPM repositories and/or desktop images from NME.

1. Browse to the integrations page and expand Nerdio Manger

2. Click on the purple sync button and when prompted click OK to start the sync

1. When the sync completes a popup will be displayed confirming what WPM repositories and custom images were added.