--- title: "Create eShare Migration Entra ID App Registration" slug: "create-eshare-migration-entra-id-app-registration" tags: ["eShare Migration"] updated: 2026-10-21T17:11:43Z published: 2026-10-21T17:11:43Z canonical: "docs.eshare.com/create-eshare-migration-entra-id-app-registration" stale: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.eshare.com/llms.txt > Use this file to discover all available pages before exploring further. # Create eShare Migration Entra ID App Registration This document describes the steps to create a custom eSHARE application in the Microsoft Entra (Azure AD) portal for the eSHARE Migration Service. The following steps will be reviewed: - [Register the Application](/collaborate/docs/create-eshare-migration-entra-id-app-registration#register-the-application) - [Modify the Application Manifest (Commercial Cloud)](/collaborate/docs/create-eshare-migration-entra-id-app-registration#modify-the-application-manifest-commercial-cloud) - [Modify the Application Manifest (Government Cloud)](/collaborate/docs/create-eshare-migration-entra-id-app-registration#modify-the-application-manifest-government-cloud) - [Review API Permissions and Grant Admin Consent](/collaborate/docs/create-eshare-migration-entra-id-app-registration#review-api-permissions-and-grant-admin-consent) - [Upload the Application Certificate](/collaborate/docs/create-eshare-migration-entra-id-app-registration#upload-the-application-certificate) - [Collect Items Required for eSHARE Migration Service](/collaborate/docs/create-eshare-migration-entra-id-app-registration#collect-items-required-for-eshare-migration-service) > **REQUIREMENT:** > > The Person performing these steps must have an administrator role assignment of **Application Administrator**, **Cloud Application Administrator**, or **Global Administrator** in the destination M365 tenant. ### **Register the Application** 1. To register the custom app registration for eSHARE Migration Service, login to the Microsoft Entra console ([https://entra.microsoft.com](https://entra.microsoft.com/) or [https://entra.microsoft.us](https://entra.microsoft.us)) and navigate to '**Applications**' > '**App Registrations**'. 2. On the '**App Registrations**' page, click the '**+ New registration**' button in the top menu bar. 3. Input a recognizable unique name for the custom eSHARE app and select the '**Register**' button at the bottom of the page. In a few moments, a shell application is created and ready for further configuration. ### **Modify the Application Manifest (Commercial Cloud)** 1. In the newly registered application page, navigate to the '**Manage**' > '**Manifest**' tab. 2. In the application's manifest, look for '**requiredResourceAccess**'. ![](https://cdn.us.document360.io/c516537f-0d2f-4bf8-930d-3385ca9a11d7/Images/Documentation/CleanShot 2025-11-16 at 11.20.54@2x.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A16%3A52Z&se=2026-11-18T21%3A16%3A52Z&sr=b&sp=r&sig=2GR2RaxqupZ7DxNjjLNtldzW2NWczV6hurkvnjf3JxA%3D) 1. Replace the above '**requiredResourceAccess**' string (including the comma at the end) from line 51 to 61 with the below text. ```json "requiredResourceAccess": [ { "resourceAppId": "00000003-0000-0000-c000-000000000000", "resourceAccess": [ { "id": "7ab1d382-f21e-4acd-a863-ba3e13f7da61", "type": "Role" }, { "id": "75359482-378d-4052-8f01-80520e7db3cd", "type": "Role" }, { "id": "62a82d76-70ea-41e2-9197-370581804d09", "type": "Role" }, { "id": "a82116e5-55eb-4c41-a434-62fe8a61c773", "type": "Role" }, { "id": "df021288-bdef-4463-88db-98f22de89214", "type": "Role" } ] }, { "resourceAppId": "00000003-0000-0ff1-ce00-000000000000", "resourceAccess": [ { "id": "678536fe-1083-478a-9c59-b99265e6b0d3", "type": "Role" }, { "id": "741f803b-c850-494e-b5df-cde7c675a1ca", "type": "Role" } ] } ], ``` 1. Click the '**Save**' button in the top menu bar. ### **Modify the Application Manifest (Government Cloud)** 1. In the same application manifest, look for the '**requiredResourceAccess**' string at line 42 to 52 and replace it with the below text: ```json "requiredResourceAccess": [ { "resourceAppId": "00000003-0000-0ff1-ce00-000000000000", "resourceAccess": [ { "id": "678536fe-1083-478a-9c59-b99265e6b0d3", "type": "Role" }, { "id": "741f803b-c850-494e-b5df-cde7c675a1ca", "type": "Role" } ] }, { "resourceAppId": "00000003-0000-0000-c000-000000000000", "resourceAccess": [ { "id": "7ab1d382-f21e-4acd-a863-ba3e13f7da61", "type": "Role" }, { "id": "75359482-378d-4052-8f01-80520e7db3cd", "type": "Role" }, { "id": "62a82d76-70ea-41e2-9197-370581804d09", "type": "Role" }, { "id": "a82116e5-55eb-4c41-a434-62fe8a61c773", "type": "Role" }, { "id": "df021288-bdef-4463-88db-98f22de89214", "type": "Role" } ] } ], ``` 1. Click the '**Save**' button in the top menu bar. ### **Review API Permissions and Grant Admin Consent** > **REQUIREMENT:** > > Granting admin consent for permissions within an app registration must be performed by a **Global Administrator** in the destination M365 tenant. > [!WARNING] > Important: > > *Please consult your eSHARE Customer Success Manager before removing any API Permissions.* 1. For the saved application, navigate to the '**Manage**' > '**API permissions**' tab. 2. Select '**Grant admin consent for **' at the top of the API permissions table. 3. Confirm when prompted. ![](https://cdn.us.document360.io/c516537f-0d2f-4bf8-930d-3385ca9a11d7/Images/Documentation/CleanShot 2025-12-07 at 02.54.14@2x.png?sv=2026-02-06&spr=https&st=2026-11-18T20%3A16%3A52Z&se=2026-11-18T21%3A16%3A52Z&sr=b&sp=r&sig=Wu9BModIJAF%2FYZrJ3rCEQFtXsrnRUhEc0GKGtwLHh0g%3D) ### **Upload the Application Certificate** - **Option 1**: Purchase a certificate from a well-known certificate authority, extract the private and public portions of the certificate. Upload the public portion in Azure portal for the application and upload the private key in your eSHARE Admin Console (or provide the private key to your eSHARE admin). - **Option 2**: Create a self-signed certificate by following instructions available at [https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-self-signed-certificate](https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-self-signed-certificate). A short summary of the above instructions is below: ```powershell # Create a self-signed certificate in PowerShell $mycert = "eShareApp" $mycert = New-SelfSignedCertificate -DnsName "eShareApp" -Subject "CN=eShareApp" -CertStoreLocation "Cert:\CurrentUser\My" -NotAfter (Get-Date).AddYears(50) -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256 ``` ```powershell # Extract .key file using OpenSSL openssl pkcs12 -in eShareApp.pfx -nocerts -nodes -out eShareApp.key ``` ```powershell # Extract crt from pfx using OpenSSL openssl pkcs12 -in eShareApp.pfx -clcerts -nokeys -out eShareApp.crt ``` ```powershell # Export certificate to .pfx file $mycert | Export-PfxCertificate -FilePath eShareApp.pfx -Password $(ConvertTo-SecureString -String "myp@55W0rd" -AsPlainText -Force) ``` 1. When appropriate certificate portions are available, navigate to '**Manage**' > '**Certificates & secrets**'. 2. In the '**Certificates**' tab, click the '**Upload certificate**' button. 3. Upload the CRT file from the above steps and click '**Add**' at the bottom of the open pane. ### **Collect Items Required for eSHARE Migration Service** - **M365 Tenant ID**: Navigate to the '**Identity**' > '**Overview**' tab of the Entra admin console, copy the '**Tenant ID**' and save it. - **Application ID**: Navigate to the '**Overview**' tab of the application, copy the '**Application (client) ID**' and save it. - **Certificate Thumbprint**: For the certificate used during the application registration process, copy the certificate thumbprint and save it. - **Public Certificate**: The public certificate (.cer, .crt, .pem from above steps) that was uploaded in the Entra portal for the application registration. - **Private Key**: The private key (.key file from above steps) for the certificate uploaded in the Entra portal for the application registration.