NetVault Plug-in for Microsoft 365 13.3

Plug-in for Microsoft 365 supports the auto-configuration of the application on the Azure portal. This feature automatically adds API permission, provide grant admin consent, and enable public client flow to the generated application without human intervention.

To auto configure the application

In the Navigation Pane, click Create Backup Job, and click

next to the Selections list.

In the selection tree, open the applicable client node.

Click Plug‑in for Microsoft 365, and select Add Tenant from the context menu.

On the Add Tenant page, select Auto Config Application from the Configuration Method.

Enter the following details for Auto Config:

•

Application Name

•

Global Admin Username

•

Global Admin Password

Click OK to automatically configure the application.


	NOTE: Auto Config application feature works with AzureAD version 2.0.2.140. If you have a higher version of AzureAD (2.0.2.180) already installed on your system, the feature will fail to grant the admin consent to delegated permissions.


	NOTE: To perform SharePoint Online backup and restore using an application created with the auto-config requires assigning permission to SharePoint Online CSOM API. Refer procedure mentioned in the section Preparing SharePoint Online for backup and restore.

Adding a certificate for configuration

Plug‑in for Microsoft 365 supports certificate-based authentication. NetVault uses certificate thumbprint to fetch the private key from the Windows Certificate Manager.

Microsoft recommends certificate-based authentication over the domain, key, and access key method. Reasons for using a certificate to authenticate include:

•

Credential rotation is prone to human error.

•

Certificates last longer than credentials (mostly more than one year).

•

Using a certificate shares responsibility with Microsoft Credential Manager (Windows OS), Certificate Authority, and Azure AD.

•

It is the highest level of security for Microsoft Graph Client.

•

It has reliable credential encryption for compliance.

Before you add the certificate to your configuration as a means for authenticating, complete the following processes.

To add a certificate for configuration

Creating a self-signed certificate using PowerShell

Adding a certificate in the Azure AD admin portal

Importing a self-signed certificate to the local machine certificate store

Creating a self-signed certificate using PowerShell

To create a self-signed certificate using PowerShell

Run the following script as an administrator:

# --- config start

$dnsName = "mytenant.sharepoint.com" # Your DNS name

$password = "Come up with something secure!" # Certificate password

$folderPath = "C:\temp" # Where do you want the files to get saved to? The folder needs to exist.

$fileName = "mycert" # What do you want to call the cert files? without the file extension

$yearsValid = 10 # Number of years until you need to renew the certificate

# --- config end

$certStoreLocation = "cert:\LocalMachine\My"

$expirationDate = (Get-Date).AddYears($yearsValid)

$certificate = New-SelfSignedCertificate -DnsName $dnsName -CertStoreLocation $certStoreLocation -NotAfter $expirationDate -KeyExportPolicy Exportable -KeySpec Signature

$certificatePath = $certStoreLocation + '\' + $certificate.Thumbprint

$filePath = $folderPath + '\' + $fileName

$securePassword = ConvertTo-SecureString -String $password -Force -AsPlainText

Export-Certificate -Cert $certificatePath -FilePath ($filePath + '.cer')

Export-PfxCertificate -Cert $certificatePath -FilePath ($filePath + '.pfx') -Password $securePassword

Adding a certificate in the Azure AD admin portal

To add a certificate in the Azure AD admin portal

Go to Certificates & secrets.

Click Upload certificate.

Select the .cer file you generated with the PowerShell script, and click Add.

Note the thumbprint that appears. You will need it for Entering the configuration details in the plug-in.

Importing a self-signed certificate to the local machine certificate store

To import a self-signed certificate to the local machine certificate store

In Windows, run MMC.

Click File,

Click Add/Remove Snap-in.

In the Add or Remove Snap-ins window, select Certificates and then click Add.

When prompted, select the computer account and then click Next.

Select Local computer (selected by default) and then click Finish.

In the Add or Remove Snap-ins window, click OK.

In the MMC main console, expand the certificate snap-in by clicking the plus (+) symbol.

Navigate to the Personal | Certificates pane.

Open the Certificate Import Wizard by right-clicking within the Certificates panel and clicking All Tasks | Import.

To import the private key alone with a password, follow the Certificate Import Wizard.


	NOTE: For SharePoint Online backup and restore, the private key should reside in the Personal folder with certificates managed on the local computer.

Using the Microsoft 365 admin portal to obtain configuration details

Alternatively, you can obtain configuration information from your Microsoft 365 admin portal, and enter the information in the configuration section for the plug-in.

To use the Microsoft 365 admin portal obtain configuration details

Go to admin.microsoft.com.

In the navigation pane on the left, click Show All and then select Azure Active Directory from the list.

In the Azure Active Directory admin center, under All services, click Azure Active Directory.

In the MANAGE section, click App registrations, and then click New registration.

Complete the following fields:

•

Name: Enter a name for the NetVault plug-in, such as PluginMicrosoft365.

•

Supported account types: To specify who can use this application or access this API, select Account in any organizational directory (Any Azure AD directory - Multitenant).

•

Redirect URI: Enter the URI that you use for interacting with NetVault, such as https://<machineName>:8443.

Click Register, and note the Application ID listed on the page that appears.

Quest strongly recommends that you record this information, for example by copying it to a text file and saving that file.

On the Overview page, under Manage, click Authentication.

In the Advanced settings section, next to Allow public client flows, select Yes.

In the Manage section, click API permissions.

In API permissions, click Add a permission.

Choose one of the following options:

•

Select an API: To use this method, select Microsoft Graph or SharePoint, and then click Select.

•

Select permissions: To use this option, complete the following steps:

Select Application Permissions, and then select the following items:

•

Calendars.Read

•

Calendars.ReadWrite

•

ChannelMember.ReadWrite.All

•

ChannelMessage.Read.All

•

Directory.ReadWrite.All

•

•

•

•

•

•

•

•

MailboxSettings.ReadWrite

•

Reports.Read.All

•

Sites.FullControl.All

•

•

•

•

•

TeamMember.ReadWrite.All

•

TeamSettings.Read.All

•

TeamSettings.ReadWrite.All

•

User.Read.All

•

User.ReadWrite.All

Select Delegated Permissions, and then select the following items:

•

ChannelMessage.Read.All

•

Group.ReadWrite.All

•

User.Read (this permission is added by default for the registered App)

Click Add permissions.

To assign permissions to the Plug‑in for Microsoft 365 after the plug-in is configured, click Grant permissions on the Required permissions tab, and click Yes when the confirmation message appears.


	NOTE: To back up and restore Azure AD service principals, the registered application used for the configuration of the plug-in must be the Global Administrator and the Application Administrator. NOTE: Lack of ‘Team’ permission results in inaccessible and partial backup of Microsoft Teams application.

On the Manage tab, in the Certificates & secrets section, click New client secret to create passwords for the plug-in to use.

Enter a description and select a time period option.

Optionally, you can determine a specific time for when the password is active by selecting a start date and an end date.

Click Add and note the information in the VALUE box.

Quest strongly recommends that you record this information, for example by copying it to the same text file that you created and saved earlier.


	IMPORTANT: You cannot retrieve this key at a later time. If you do not record it for reference when you configure the plug-in, you have to generate a new key.

To identify the domain name used for Microsoft 365, click Azure Active Directory again in the navigation pane on the left.

Click Overview, and note the domain name.


	NOTE: Quest recommends that you record this information, for example by copying it to a text file and saving that file.

Preparing SharePoint Online for backup and restore

Before you can protect your SharePoint Online data with Plug‑in for Microsoft 365, you must assign permission for the SharePoint Online CSOM API.

To prepare SharePoint Online for backup and restore

Open the SharePoint Online Tenant site with the Tenant Administrator account. For example: https://<tenant>-admin.sharepoint.com/_layouts/15/appinv.aspx.

In the App Id text box, enter the Client ID generated from Azure Active Directory.

Click Lookup.

Under App Domain, enter www.localhost.com.

Under Redirect URL, enter https://www.locahost.com.

Under Permission Request XML, enter the following XML script:

Click Create.

In the dialog, click Trust It.

Seleziona il prodotto:

Per una maggiore efficacia, compilare l'Obiettivo della chat:

Soluzioni consigliate per il problema

NetVault Plug-in for Microsoft 365 13.3 - User Guide

Auto configuration of Azure application

Adding a certificate for configuration

Using the Microsoft 365 admin portal to obtain configuration details

Preparing SharePoint Online for backup and restore