ZCSPM
Onboarding a Microsoft 365 Account
You can onboard your Microsoft M365 cloud account onto ZCSPM. Once onboarded, ZCSPM provides you with your account's security posture. ZCSPM runs your M365 cloud account deployment against all the security policies we offer. To view the security policies, see Microsoft 365 Security Policies. To onboard an M365 account with ZCSPM:
- 1. Ensure the prerequisites are met.
- You need to be a ZCSPM License Admin to onboard an Azure cloud account onto ZCSPM.
- You need to be a Global Administrator at Microsoft 365.
- You need to be an Azure Global AD Administrator and a Subscription Owner to register the ZCSPM app and grant access permissions to ZCSPM.
- 2. Create a New Azure App Registration.
You can create a new Azure app registration either manually or by running an automation script on the Cloud Shell. To register a new M365 app manually:
- a. Get the Application ID and Client Secret
- Log in to the Azure Portal
- In the left-pane menu, click Azure Active Directory.
- Select App registrations, then click New Registration.
- Enter the Name and select Accounts in this organizational directory only button.
- Click Register.
- Copy the Application ID to the clipboard and store it. You need to submit this information at ZCSPM.
- In the left-pane menu, click Certificates & secrets, then click New client secret.
- Enter a Description and select an expiry time, then click Add.
- Copy the Client secret Value to the clipboard and store it. You need to submit this information at ZCSPM.
You cannot copy the Client secret later. If you do not copy the Client secret now, you will have to create a new Client secret to submit at ZCSPM.
Close - b. Grant admin consent for Microsoft API permissions.
- Log in to the Azure Portal
- In the left-pane menu, click Azure Active Directory.
- Select App registrations, then select the ZCSPM application which you want to onboard.
- In the left-pane menu, click API permissions.
- Click Add a permission, then select Microsoft Graph.
- Click Application permissions, then select the following permissions:
- SecurityEvents.Read.All
- DeviceManagementConfiguration.Read.All
- Organization.Read.All
- Application.Read.All
- User.Read.All
- DeviceManagementApps.Read.All
- Policy.Read.All
Make sure you are granting Application permissions and not Delegated permissions.
- Click Add permissions.
- Click Grant admin consent for <your zcspm app>.
- c. Get the Azure Tenant ID and Domain Name
- Log in to the Azure Portal
- In the left-pane menu, click Azure Active Directory.
- Copy the Tenant ID and the Primary Domain to the clipboard and store it. You need to submit this information at ZCSPM.
Alternatively, you can register a new Azure app by running a script on the Cloud Shell. The script registers a new Azure application and grant the application the subscription reader role.
- a. Run the registration script on the Cloud Shell
- Ensure you have PowerShell version v5 or higher. Verify your PowerShell version using the following command:
$PSVersionTable.PSVersion
- Ensure there are no restrictions on PowerShell to run the agent installation script. Remove restrictions on PowerShell using the following command:
Set-ExecutionPolicy ` -Scope Process ` -ExecutionPolicy Bypass
- Download the PowerShell script files from ZCSPM Github.
- Install Azure modules by using the following command:
Install-Module ` -Name AzureAD ` -MinimumVersion 2.0.0.131
- Open PowerShell as an administrator.
- Navigate to the directory where the script was downloaded.
- Run the following command to create a new Azure app registration:
.\Create-ServicePrincipal-AzureOnboarding.ps1 ` -azureActiveDirectoryId <active_directory_id> ` -servicePrincipalName <data_collector_name> ` -expirationPeriod 1year
- Enter the Global AD Administrator credentials.
- Copy the following information and store them:
- Tenant Id
- Domain Name
- Application Id
- Password Key
In case you do not want to provide Microsoft Graph permissions, use the following command instead:
Close.\Create-ServicePrincipal-AzureOnboarding.ps1 ` -azureActiveDirectoryId <active_directory_id> ` -servicePrincipalName <data_collector_name> ` -expirationPeriod 1year -disableADPolicies
- b. Grant admin consent for Microsoft API permissions.
- Log in to the Azure Portal
- In the left-pane menu, click Azure Active Directory.
- Select App registrations, then select the ZCSPM application which you want to offboard.
- In the left-pane menu, click API permissions.
- Click Add a permission, then select Microsoft Graph.
Make sure you are granting Application permissions and not Delegated permissions.
- Click Application permissions, then select the following permissions:
- SecurityEvents.Read.All
- DeviceManagementConfiguration.Read.All
- Organization.Read.All
- Application.Read.All
- User.Read.All
- DeviceManagementApps.Read.All
- Click Add permissions.
- Click Grant admin consent for <your zcspm app>.
- a. Get the Application ID and Client Secret
- 3. Add your Microsoft 365 subscription on ZCSPM.
- Log in into ZCSPM as a License Admin.
- Click Activate License.
- Select Office 365, then click Continue.
- Select New Azure AD Tenant.
- Enter the following information:
- Cloud Account Name
- Domain Name
- Office365 Directory Id
- Office365 Application Id
- Office365 Application Secret
- Click Add Account.
In addition to onboarding your Azure account on to ZCSPM, you can enable advanced security configurations for your Microsoft 365 account.
If you'd like to offboard your Microsoft 365 account, see Offboarding a Microsoft Azure Account.