If your organization uses a GCC or GCC High Azure tenant, you cannot use the pre-configured Kudzu Desktop app registration. You can also use this option if you would like to use an existing app registration in your Azure tenant that grants the same delegated permissions that the Kudzu Desktop application requires.
Create a New App Registration
A user with tenant administration privileges will need to follow these steps:
Go to the App Registrations blade in Azure Entra ID.
Click +New Registration.
On the Register an application page:
- In the Name box enter Migrator Desktop (or whatever you wish).
- Make sure Single tenant only is selected for Supported account types.
- Select Public client/native in the Select a platform dropdown under Redirect URI, and enter http://localhost.
Click Register.
You'll be taken to the Application page. Copy the Application (client) ID and Directory (tenant) ID to Notepad or similar. You will need them later.
Under the Manage node for your new Application, select API Permissions.
Click +Add a permission.
From the Request API permissions drawer, select SharePoint.
Select Delegated permissions, expand AllSites, check the box next to AllSites.Manage, and click Add permissions.
NOTE: if you are using Lightning Forms or skybow, the Form Migrator will require AllSites.FullControl permissions to wire up (publish) the new form to the SharePoint list.
Configure Migrator Desktop to use your App Registration
In the Lightning Tools Form Migrator Desktop installation folder (c:\Program Files\Forms Desktop by default), open Lightning Forms Migrator.dll.config in your editor of choice.
In the AppSettings node, update the following settings:
<add key="AppRegistrationTenantId" value=" Directory (tenant) ID copied from the Azure Application page" />
<add key="AppRegistrationId" value="Application (client) ID copied from the Azure Application page"/>
The config file should look something like this after adding these settings:
These new settings will be used after restarting the Form Migrator desktop application.