Create Collaboration Attack Surface Report for Email - Entra ID App Registration

Prev Next

This document describes the steps to create a custom eSHARE Collaboration Attack Surface Email Risk Report application in the Microsoft Entra (Azure AD) portal. The following steps will be reviewed:

PREREQUISITES:

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.

Note:

Depending on the size of your organization’s M365 tenant, multiple App Registrations may be required for optimal performance. The recommended number of App Registrations to create and provide to your eSHARE Customer Success Manager is 3 apps.

Register the Application

  1. To register the custom App Registration for the Email Risk Report, log in to the Microsoft Entra console (https://entra.microsoft.com or 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. Enter 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.

Edit 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'.

  1. Replace the above 'requiredResourceAccess' string (including the comma at the end) from line 53 to 63 with the below text.

	"requiredResourceAccess": [
		{
			"resourceAppId": "00000003-0000-0000-c000-000000000000",
			"resourceAccess": [
				{
					"id": "5e1e9171-754d-478c-812c-f1755a9a4c2d",
					"type": "Role"
				},
				{
					"id": "98830695-27a2-44f7-8c18-0c3ebc9698f6",
					"type": "Role"
				},
				{
					"id": "19da66cb-0fb0-4390-b071-ebc76a349482",
					"type": "Role"
				},
				{
					"id": "810c84a8-4a9e-49e6-bf7d-12d183f40d01",
					"type": "Role"
				},
				{
					"id": "332a536c-c7ef-4017-ab91-336970924f0d",
					"type": "Role"
				},
				{
					"id": "df021288-bdef-4463-88db-98f22de89214",
					"type": "Role"
				},
                {
                    "id": "40f97065-369a-49f4-947c-6a255697ae91",
                    "type": "Role"
                }
			]
		}
	],
  1. Click the 'Save' button in the top menu bar.

Edit the Application Manifest (Government Cloud)

  1. In the newly registered application page, navigate to the 'Manage' > 'Manifest' tab.

  2. In the application’s manifest, look for 'requiredResourceAccess'.

  1. Replace the above 'requiredResourceAccess' string (including the comma at the end) from line 42 to 52 with the below text.

	"requiredResourceAccess": [
		{
			"resourceAppId": "00000003-0000-0000-c000-000000000000",
			"resourceAccess": [
				{
					"id": "5e1e9171-754d-478c-812c-f1755a9a4c2d",
					"type": "Role"
				},
				{
					"id": "98830695-27a2-44f7-8c18-0c3ebc9698f6",
					"type": "Role"
				},
				{
					"id": "19da66cb-0fb0-4390-b071-ebc76a349482",
					"type": "Role"
				},
				{
					"id": "810c84a8-4a9e-49e6-bf7d-12d183f40d01",
					"type": "Role"
				},
				{
					"id": "332a536c-c7ef-4017-ab91-336970924f0d",
					"type": "Role"
				},
				{
					"id": "df021288-bdef-4463-88db-98f22de89214",
					"type": "Role"
				},
                {
                    "id": "40f97065-369a-49f4-947c-6a255697ae91",
                    "type": "Role"
                }
			]
		}
	],
  1. Click the 'Save' button in the top menu bar.

Important:

Granting admin consent for permissions within an app registration must be performed by a Global Administrator in the destination M365 tenant. Below is a list of all the API permissions required.

Permission

Display Name

Description

Admin Consent Required

MailboxSettings.Read

Read all user mailbox settings

Allows the app to read user mailbox settings without a signed-in user. Does not include permission to send mail.

Yes

Mail.Read

Read mail in all mailboxes

Allows the app to read mail in all mailboxes without a signed-in user.

Yes

InformationProtectionPolicy.Read.All

Read all published labels and label policies

Allows the app to read published sensitivity labels and label policy settings for the entire organization or a specific user, without a signed-in user.

Yes

GroupMember.Read.All

Read all group memberships

Allows the app to read memberships and basic group properties for all groups without a signed-in user.

Yes

AuditLogsQuery.Read.All

Read audit logs data from all services

Allows the app to read and query audit logs from all services.

Yes

User.Read.All

Read all users' full profiles

Allows the app to read user profiles without a signed-in user.

Yes

Sites.Read.All

Read items in all site collections

Allows the app to read documents and list items in all site collections without a signed-in user.

Yes

  1. For the saved application, navigate to the 'Manage' > 'API permissions' tab.

  2. Select 'Grant admin consent for <tenant name>' at the top of the API permissions table.

  3. Confirm when prompted.

Upload the Application Certificate

Obtain a certificate for the application using one of the following options:

  • Option 1: Purchase a certificate from a well-known certificate authority and extract the private and public portions of the certificate. Upload the public portion in the 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 the instructions available at https://learn.microsoft.com/en-us/azure/active-directory/develop/howto-create-self-signed-certificate. A short summary of these instructions is below:

# 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
# Extract .key file using OpenSSL
openssl pkcs12 -in eShareApp.pfx -nocerts -nodes -out eShareApp.key
# Extract crt from pfx using OpenSSL
openssl pkcs12 -in eShareApp.pfx -clcerts -nokeys -out eShareApp.crt
# Export certificate to .pfx file
$mycert | Export-PfxCertificate -FilePath eShareApp.pfx -Password $(ConvertTo-SecureString -String "myp@55W0rd" -AsPlainText -Force)
  1. When the appropriate certificate portions are available, navigate to 'Manage' > 'Certificates & secrets'.

  2. On 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 the Required Values

Collect and save the following items:

  • 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.

  • Private Key: The private key (.key file from the above steps) for the certificate uploaded in the Entra portal for the application registration.

  • Your Organization’s SharePoint URL: The root URL of your SharePoint tenant, without any site path. Open any SharePoint site, copy the URL, and remove everything after .sharepoint.com. Example: If the site URL is https://yourorganization.sharepoint.com/sites/sitename, enter https://yourorganization.sharepoint.com/

  • External third party tools URL: If your organization uses third-party file sharing or collaboration tools, such as Box, Kiteworks, or Dropbox, enter the base URL of each one. eSHARE uses these URLs to detect those links in email and show where content is shared outside Microsoft 365, which adds to the insights in your report. Example: If your organization uses Box, enter https://yourorganization.box.com/

Please provide this information to your eSHARE Customer Success Manager for finalizing the configuration.