Boxafe User Guide v1.5

Datum poslední úpravy: 2023-08-10

About Boxafe

Boxafe is a NAS-based backup solution for cloud services such as Google Workspace and Microsoft 365. You can back up data for email, contacts, calendars, Drive, Shared Drives, OneDrive, as well as SharePoint site accounts. Boxafe allows you to configure domain backups, restore data to the cloud, and view backup details at any time.

Getting Started

Install Boxafe on your NAS.

For details, see Installing Boxafe.
Create a Google service key or a Microsoft 365 authentication.
For details, see the following topics:
- Obtaining a Google Workspace Service Key
- Obtaining Microsoft 365 Authentication for Boxafe
Add a domain.
For details, see the following topics:
- Adding a Google Workspace Domain to Boxafe
- Adding a Microsoft 365 Domain to Boxafe
Create or add a user.

For details, see Managing Domain Users.

Installation

Availability and Requirements

Requirement type	Details
Hardware	Boxafe is compatible with 64-bit Intel-based NAS, 64-bit AMD-based NAS, or 64-bit ARM-based NAS. Minimum available memory of 2 GB and minimum total memory of 4 GB.
Software	QTS 4.4.2 (or later) QuTS hero h4.5.0 (or later) QuTS Cloud c4.5.1 (or later)
Application	Boxafe is available in the QNAP App Center.

Installing Boxafe

Log on to QTS as administrator.
Go to App Center, and then click .

A search box appears.
Type Boxafe, and then press ENTER.

The Boxafe application appears in the search results.
Click Install.

The installation window appears.
Select the volume where you want to install Boxafe.
Click OK.

QTS installs Boxafe.

Toolbar

No.	Description	User Actions
1	Background tasks	Shows all running tasks.
2	Event notifications	Shows all notifications including errors, warnings, and info. Click More to view notification details in Logs.
3	User account	Shows current username. Click to view log in details or log out of Boxafe.
4	Settings	Click . The settings drop-down menu appears. You can perform any of the following actions: Click to view Boxafe Quick Start. Click to contact QNAP customer service. Click to change the language settings. Click to download the debug log. Click to go to QNAP Customer Service. Click to view QNAP's data privacy policy. Click to view Boxafe app version details.

Dashboard

The Dashboard screen displays the protection status, data consumption, scheduled tasks, and task reports.

Domain Management

The Domain Management screen displays the domains, domain health status, domain administrators, domain users, and service health status. You can also edit domain settings, view domain logs, and delete domains.

No.	Description	User Actions
1	Domain health	View domain health status.
2	Add Domain	Add a Microsoft 365 or Google Workspace domain to Boxafe for backup. For details, see the following topics: Adding a Google Workspace Domain Adding a Microsoft 365 Domain
3	Domains	Displays the domain name.
4	Admin	Displays administrator name and email account.
5	Users	Displays the number of users.
6	Added By	Displays the user, who added the domain.
7	Service Health	Displays the domain account health status.
8	Search bar	You can set advanced search parameters in Boxafe search bars to quickly find emails, contacts, calendar, drives, OneDrives, Shared Drives, and SharePoint sites. For details, see Using Advanced Search to Find Domain Data.
9	Refresh	Refresh domain information.
10	Edit domain information	Edit the domain information. For details, see Editing Domain Data.
11	Logs	View the domain log status. For details, see Managing Logs.
12	Delete	Delete the domain account. For details, see Managing Domain Data.

Adding a Domain Requirements

To add a Microsoft 365 or Google Workspace domain to Boxafe, you must acquire the required authentication and credentials from the respective service providers. For details, see the following topics:

Obtaining a Google Workspace Service Key

Boxafe for Google Workspace leverages Google’s OAuth 2.0 for authorization, ensuring security by allowing you to grant permissions to your service accounts. To add a Google Workspace domain to Boxafe for backup, you must create a Google Workspace service key (also known as a private key) to access Google Drive with the Drive SDK API. For details, see the following topics:

Granting Users Google Drive Access Using Drive SDK API

Go to Google Admin.
Log in to Google Admin.

Note:
Log in with the user credentials of the Google Workspace domain you want to backup with Boxafe.
Click Apps.

The Apps window appears.
Click Google Workspace.

The Google Workspace window appears.
Click Drive and Docs.

The Settings for Drive and Docs window appears.
Click Features and Application.
Go to Drive SDK.
Click .
Select Allow users to access Google Drive with the Drive SDK API.
Click Save.

Enabling Google API and Services

Go to Google API Console.
Log in to the Google API Console.

Note:
You must log in using the credentials of a domain super administrator.
Go to Dashboard.

The Dashboard window appears.
Click Select a project.

The Select from window appears.
Click New project.
Specify the project name.
Click Create.

A confirmation message appears.
Select the created project.
Click Enable APIs and Services.

The Google API page appears.
Enable the following APIs:
- Google Drive
- Google Calendar API
- Gmail API
- Admin SDK
- Google People API
Go to the API Library.
Enter the API name in the search bar.
Click the API.
Click Enable.

Creating a Google Service Key

Go to Google API Console.
Log in to the Google API Console.

Note:
You must log in using the credentials of a domain super administrator.
Click .
Go to IAM & admin > Service Accounts.
Click Create Service Account.
Specify the service account name.
Click Create.

The Create service account window appears.
Click Select a Role.

The Service account permissions page appears.
Go to Project > Owner.
Click Continue.

The Create service account window appears.
Click Done.

The service key is downloaded to your computer.

Enabling Google Workspace Domain-Wide-Delegation

Go to IAM & admin > Service Accounts.
Click .
Click Edit.

The Service account status window appears.
Click Show Domain-wide Delegation.
Select Enable Domain-wide Delegation.
Go to Product name for the consent screen.
Enter the product name.

For example, Boxafe.
Click Add Key.
Click Create new key.

The Create private key for Boxafe window appears.
Select JSON.
Click Create.

The private key is created.
Click Save.

Important:
QNAP recommends keeping the generated private key safe. You will need the key for consecutive operations.
- The private key is saved to your computer.
- The Service accounts page appears.
Go to the Domain wide delegation column.
Click View Client ID.

A side panel with the client ID appears.
Copy the Client ID to the clipboard.

Important:
The Client ID is used to delegate domain-wide authority to your service account. QNAP recommends saving the ID on your computer.
Go to Admin Console.
Go to Security > Settings.

The security settings window appears.
Click API controls.

The App access control page appears.
Click MANAGE THIRD-PARTY APP ACCESS.
Click OAuth App Name Or Client ID.
Paste the Client ID into the search bar.
Click Search.

The app shows up in the search results.
Select the app.
Click Select.
Return to API controls.
Click MANAGE DOMAIN WIDE DELEGATION.
Click Add new.

The Add a new client ID window appears.
Paste the client ID into the Client ID.
Copy and paste the following list into OAuth scopes (comma-delimited):

https://www.googleapis.com/auth/admin.directory.user.readonly,

https://www.googleapis.com/auth/admin.directory.domain.readonly,

https://www.googleapis.com/auth/calendar,

https://www.googleapis.com/auth/calendar.events,

https://www.googleapis.com/auth/drive,

https://mail.google.com/,

https://www.google.com/m8/feeds,

https://www.googleapis.com/auth/userinfo.email,

https://www.googleapis.com/auth/userinfo.profile,

https://www.googleapis.com/auth/plus.me
Click Authorize.

Obtaining Microsoft 365 Domain Authentication Credentials

Boxafe for Microsoft 365 leverages Microsoft Azure account authentication to ensure security and allows you to grant permissions to service accounts. To add a Microsoft 365 to Boxafe for backup, you must generate a client (application) ID and tenant (directory) ID and add API permissions. For details, see the following topics:

To add a SharePoint site to Boxafe, you must grant Microsoft 365 tenant administrative permissions. For details, see Granting Microsoft 365 Tenant Administrative Permissions for SharePoint Sites.

Generating a Microsoft Azure Client ID and Tenant ID

Important:

If you already registered an app, go to the app registration overview page, click on the registered app, and then follow the steps for registering an application.

Log in to the Azure admin portal.

Note:
You must have Global admin credentials to log in to the Microsoft 365 domain.

The Microsoft Azure portal homepage appears.
Click Azure Activity Directory.

The Azure Activity Directory page appears.
Note:
You must be a global administrator.
Click App registrations.

The App registrations page appears.
Click +New registration.

The Register an application page appears.
Specify the following application information:
- Display name
- Supported account type
Click Register.

The client ID and tenant ID will appear on the Overview page.
Copy the client ID and tenant ID.
Save the client ID and tenant ID.
Go to Boxafe > Domains.
Click Add New Domain.

The Add New Domain window appears.
Enter the saved values.

Obtaining a Microsoft Azure Client Secret Key

Important:

You must copy the generated Microsoft Azure client secret key immediately, or the key will disappear permanently.

Log in to the Azure admin portal.

Note:
You must have Global admin credentials to log in to the Microsoft 365 domain.

The Microsoft Azure portal homepage appears.
Click Certificates & secrets.

The Certificates & secrets window appears.
Click +New client secret.

The Add a client secret window appears.
Specify the following information:
- Client secret description
- Expiration period
Click Add.

The new client secret key is generated.
Copy the client secret.
Save the client secret.
Go to Boxafe > Domains.
Click Add New Domain.

The Add New Domain window appears.
Enter the saved values.

Adding Microsoft 365 API Permissions to Boxafe

Log in to the Azure admin portal.

Note:
You must have Global admin credentials to log in to the Microsoft 365 domain.

The Microsoft Azure portal homepage appears.
Go to Azure Active Directory > App Registration > Registered application page.
Click +Add a permission.

The right panel appears.
Enable the API permissions.
1. Go to Request API permissions panel.
  
  Tip:
  The APIs for Microsoft Graph, OneNote, and SharePoint are all shown under Commonly used Microsoft APIs.
  
  For details, see image below.
2. Go to Supported legacy APIs section.
  
  For details, see the image below.
3. Select Azure Active Directory Graph.
4. Click APIs my organization users.
5. Enter Office 365 Exchange Online in the search bar.
  
  The Office 365 Exchange Online API appears.
6. Select the API.
7. Select a permission type for each API.
  
  For details, see the type column in the API Permissions Table.
  
  The list of available APIs appears.
8. Select the checkbox of the required APIs.
9. Click Add permissions.
10. Select an API or permissions name.
  
  For details, see the API/ Permission Name column in the API Permissions Table.
  
  The API permission page appears.
  
  Note:
  Repeat steps for requesting API permission and adding permissions for each API.
Click Grant admin consent for QNAP.
- The permission is added.
- A green checkmark appears next to each status that is successfully added.

API Permissions Table

You must specify the API type and permission in the Microsoft Azure admin portal to add a new Microsoft 365 domain to Boxafe. For details, see the Microsoft Azure API permission table below:

API/ Permission Name	Type	Description	Admin Consent Required
Azure Active Directory Graph (1)
User.Read	Delegated	Sign in and read user profile	No
Office 365 Exchange Online (7)
EWS.AccessAsUser.All	Delegated	Access mailboxes as the signed-in user via Exchange Web Services	-
full_access_as_app	Application	Use Exchange Web Services with full access to all mailboxes	Yes
Calendars.ReadWrite.All	Application	Read and write calendars in all mailboxes	Yes
Contacts.ReadWrite	Application	Read and write contacts in all mailboxes	Yes
MailboxSettings.ReadWrite	Application	Read and write all user mailbox settings	Yes
Mail.ReadWrite	Application	Read and write mail in all mailboxes	Yes
Tasks.ReadWrite	Application	Read and write mail in all mailboxes	Yes
Microsoft Graph (14)
openid	Delegated	Sign users in	No
Group.ReadWrite.All	Delegated	Read and write all groups	Yes
User.Read	Delegated	Sign in and read user profile	No
User.ReadWrite.All	Delegated	Read and write all users' full profiles	Yes
Calendars.ReadWrite	Application	Read and write calendars in all mailboxes	Yes
Contacts.ReadWrite	Application	Read and write contacts in all mailboxes	Yes
Directory.ReadWrite.All	Application	Read and write directory data	Yes
Files.ReadWrite.All	Application	Read and write files in all site collections	Yes
Group.ReadWrite.All	Application	Read and write all groups	Yes
MailboxSettings.ReadWrite	Application	Read and write all user mailbox settings	Yes
Mail.ReadWrite	Application	Read and write mail in all mailboxes	Yes
Notes.ReadWrite.All	Application	Read and write all OneNote notebooks	Yes
Sites.FullControl.All	Application	Have full control of all site collections	Yes
User.ReadWrite.All	Application	Read and write all users' full profiles	Yes
OneNote (1)
Notes.ReadWrite.All	Application	View and modify notes for all users	Yes
SharePoint (3)
Sites.FullControl.All	Application	Have full control of all site collections	Yes
TermStore.ReadWrite.All	Application	Read and write managed metadata	Yes
User.ReadWrite.All	Application	Read and write user profiles	Yes

Granting Microsoft 365 Tenant Administrative Permissions for SharePoint Sites

Important:

You must obtain the Microsoft Azure Client ID and Tenant ID before adding a Microsoft 365 SharePoint site. For details, see Generating a Microsoft Azure Client ID and Tenant ID.
The Microsoft 365 tenant administrative permissions are only required when adding a SharePoint site to Boxafe for backup. The permissions are not required when adding Microsoft 365 domains to Boxafe.

Add the tenant name in the following link: https://[tenant]-admin.sharepoint.com/_layouts/15/appinv.aspx.

Note:
The [tenant] name is the subdomain of your SharePoint Site. For example cloudqnap.sharepoint.com is the URL of your SharePoint and cloudqnap is the tenant name.
Open the link in the browser.
Log in to the Azure admin portal.

Note:
You must have Global admin credentials to log in to the Microsoft 365 domain.
Go to Overview.
Copy the client ID.
Paste the ID into the Client (Application) ID.
Click Lookup.

The app title is generated.

Enter the following information in the related fields:

Fields	Information
App Domain:	localhost
Redirect URL:	https://localhost
Permission Request XML:	<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/> </AppPermissionRequests>

Fields

Information

App Domain:

localhost

Redirect URL:

https://localhost

Permission Request XML:

</AppPermissionRequests>

Click Create.

A confirmation message appears.
Click Trust It.

The tenant administrative permissions are granted to the SharePoint site.

Adding a Domain

Boxafe currently supports adding Google Workspace or Microsoft 365 domains for data backup.

Adding a Google Workspace Domain

Important:

You must obtain the service key to add a Google Workspace domain to Boxafe. For details, see Obtaining a Google Workspace Service Key.

Open Boxafe.
Go to Domains.
Click Add New Domain.
Specify the domain name.
Specify the administrator email address.
Upload the Google Workspace service key.
Click Authorize.
Optional: Select the services for backup.
Click Next.

Select a backup schedule policy.

Option	Description
All applications	This includes the following services that will be selected for backup: Gmail Contacts Calendar Drive Shared Drives
Individual applications	This includes the selected services for backup.

Specify the following information.

Backup Type	User Actions
One Time	Specify the backup time. Select the number of months to retain the backed-up data. Note: This option is not available when backing up email.
Manual	Select the number of months to retain the backed-up data. Note: This option is not available when backing up email.
Auto	Select the frequency. Optional: Select the number of months to retain the backed-up data. Note: This option is not available when backing up email. Optional: Specify the stop time.

Click Next.

Select the users to add.

Option	Description
Select all users (default option)	Select this option to select all users registered on the selected domain.
Select all users on this page	Select this option to select all users shown on the displayed page.

Optional: Click Initiate backup after adding a user.
Click Add.

Adding a Microsoft 365 Domain

Open Boxafe.
Go to Domains.
Click Add New Domain.
Obtain a Microsoft 365 authentication.

For details, see Obtaining Microsoft 365 Domain Authentication.
Specify the domain name.
Specify the administrator email address.
Specify the client (application) ID.
Specify the client secret.
Specify the tenant (directory) ID.
Click Authorize.
Optional: Select services for backup.
Click Next.

Select a backup schedule policy.

Option	Description
All applications	This includes the following services: Emails Contacts Calendar OneDrive SharePoint
Individual applications	This includes the selected services from the above list.

Specify the following information.

Backup Type	User Actions
One Time	Specify the backup time. Select the number of months to retain the backed-up data. Note: This option is not available when backing up email.
Manual	Select the number of months to retain the backed-up data. Note: This option is not available when backing up email.
Auto	Select the frequency. Select the number of months to retain the backed-up data. Note: This option is not available when backing up email. Specify the stop time.

Click Next.

Select the users to add.

Option	Description
Select all users (default option)	Select this option to select all users registered on the selected domain.
Select all users on this page	Select this option to select all users shown on the displayed page.

Optional: Click Initiate backup after adding a user.
Click Add.

Editing Domain Data

You can edit the Google Workspace or Microsoft 365 domain information and configure the domain backup schedule policy.

Editing Domain Information

Open Boxafe.
Go to Domains.
Select a domain.
Go to the Action column.
Click .

The Edit Domain window appears.

You can edit the following domain information:

Domain Type	Information
Google Workspace	Service key Enable or disable the following domain services: Gmail Contacts Calendar Drive Shared Drives Note: You must go to Domain Settings to add or remove Shared Drives for data backup or data restoration.
Microsoft 365	Client (Application) ID Client secret Tenant (Directory) ID Enable or disable the following domain services: Email Calendar Contacts OneDrive SharePoint Note: You must go to Domain Settings to add or remove SharePoint sites for data backup or data restoration.

Click Update.

The domain information is updated.

Configuring the Backup Schedule Policy

Open Boxafe.
Go to Domains.
Select a domain.
Click .

The Edit Domain window appears.
Click Backup Schedule.

Specify the following:

Fields	User Actions
Define backup schedule policy for	You can select a backup policy for All applications or Individual applications.
Backup type	You can select one of the following backup types: One Time: Back up applications only once during the specified time based on the selected backup policy. Manual: Back up applications manually based on the selected backup policy. Auto: Back up applications automatically based on the selected backup policy.
Delete older versions of backed up data after	Specify the expiration period for older backup data versions. You can select an expiration period option from the drop-down menu.

Fields

User Actions

Define backup schedule policy for

You can select a backup policy for All applications or Individual applications.

Backup type

You can select one of the following backup types:

One Time: Back up applications only once during the specified time based on the selected backup policy.
Manual: Back up applications manually based on the selected backup policy.
Auto: Back up applications automatically based on the selected backup policy.

Delete older versions of backed up data after

Specify the expiration period for older backup data versions. You can select an expiration period option from the drop-down menu.

Click Update.

Using Advanced Search to Find Domain Data

You can set advanced search parameters in the Boxafe search bar to quickly find emails, contacts, calendar, drives, OneDrives, Shared Drives, and SharePoint sites.

Using Advanced Search to Find Emails

Open Boxafe.
Go to Domains.
Select a domain.

Select one of the following:

Domain Type	User Actions
Google Workspace	Click Gmail.
Microsoft 365	Click Email.

Go to the search bar.
Click .

The Advanced Search window appears.

Specify the following search parameters:

Search Parameter Category	Parameters
Email content	Subject: Search by email subject. From: Search by email sender. To: Search by email recipient. Cc: Search by Cc recipient. Bcc: Search by Bcc recipient.
Email location	Current folder: Search in the current folder. This folder and subfolders: Search in the current folders and its subfolders. All Mail: Search all emails.
Additional conditions	Include deleted emails: Search results will include deleted emails. Only show emails with attachments: Search results only include emails with attachments.

Optional: Click Reset to clear search parameters.
Click Search.

All entries that meet the specified search parameters are listed.

Using Advanced Search to Find Contacts

Open Boxafe.
Go to Domains.
Select a domain.
Click Contacts.
Go to the search bar.
Click .
Specify the following parameters:
- Name: Search by contact name.
- Email: Search by email name.
- Nickname: Search by contact nickname.
- Occupations: Search by contact occupation.
- Phone numbers: Search by contact phone number.
Optional: Click Reset to clear search parameters.
Click Search.

All entries that meet the specified search parameters are listed.

Using Advanced Search to Find Calendar

Open Boxafe.
Go to Domains.
Select a domain.
Click Calendar.
Go to the search bar.
Click .

The Advanced Search window appears.
Specify the following search parameters:
- Calendar: Search by calendar name.
- Organizer: Search by calendar organizer.
- Title: Search by calendar event title.
- Event location: Search by event location.
Optional: Select Include attachments.
Optional: Click Reset to clear search parameters.
Click Search.

All entries that meet the specified search parameters are listed.

Using Advanced Search to Find a File in a Drive or OneDrive

Open Boxafe.
Go to Domains.

Select one of the following domains:

Domain Type	User Actions
Microsoft 365	Click OneDrive.
Google Workspace	Click Drive.

Click Drive.
Go to the search bar.
Click .

The Advanced Search window appears.

Specify the following search parameters:

Domain Types	Drive Types	Search Parameters
Microsoft 365	OneDrive	File type: Specify the file type on the drive. Owner: Specify an owner or select Anyone. Date modified: Specify the date range for when the file was modified. Item name: Selet the file name or folder name.
Google Workspace	Drive

Optional: Click Reset to clear search parameters.
Click Search.

All entries that meet the specified search parameters are listed.

Using Advanced Search to Find a File in a Shared Drive or a SharePoint Site

Open Boxafe.
Go to Domains.
Click Shared Drives.

Select one of the following domains:

Domain Type	User Actions
Microsoft 365	Click SharePoint Site.
Google Workspace	Click Shared Drives.

Specify the following search parameters:
- File type: Search by file type.
- Date modified: Search by date modified.
- Item name: Search by item name.
Optional: Click Reset to clear search parameters.
Click Search.

All entries that meet the specified search parameters are listed.

Managing Domain Data

You can manage various Google Workspace and Microsoft 365 domain services data in Boxafe, including email, contacts, calendar, drive, Shared Drives, OneDrive, and SharePoint sites. You can back up data, restore data, or refresh domain data.

Open Boxafe.
Go to Domains.
Click a domain.

Select one of the following options:

Service Types	Options	User Actions
Google Workspace	Gmail	Click Gmail.
	Drive	Click Drive. Select the drive version.
	Shared Drives	Click Shared Drives. Select a Shared Drives version.
Microsoft 365	Email	Click Email. Select an email.
	OneDrive	Click OneDrive. Select a OneDrive backup version.
	SharePoint	Click SharePoint. Select the SharePoint backup version.
Common services	Contacts	Click Contacts. Select a contacts version.
Common services	Calendar	Click Calendar. Select the calendar version. Select the calendar date.

Select one of the following options:

Options	User Actions
Back Up Now	Click Back Up Now. Click OK.
Restore	Click Restore. Click OK.
Refresh list	Click .

Exporting Domain Data to a Computer

You can export backed-up Google Workspace or Microsoft 365 domain data in Boxafe to your local computer.

Open Boxafe.
Go to Domains.
Click a domain.

Select one of the following options:

Service Types	Options	User Actions
Google Workspace	Gmail	Click Gmail. Select an email.
	Drive	Click Drive. Select a drive backup file version.
	Shared Drives	Click Shared Drives. Select a backup file version. Select a file.
Microsoft 365	Email	Click Email. Select an email.
Microsoft 365	OneDrive	Click OneDrive. Select a OneDrive backup file version.
Common services	Contacts	Click Contacts. Select a contact.
Common services	Calendar	Click Calendar. Select a calendar version. Select a date range. Select a calendar event.

Click Export.

The export drop-down menu appears.
Select Computer.

The export file window appears.

Choose one of the following options:

Option	User Actions
Open with	Click Open with. Select an application. Select Do this automatically for files like this from now on. Click OK. The How do you want to open this file? window appears. Select an application. Follow the instructions displayed in the application setup wizard.
Save file	Click Save File. Select Do this automatically for files like this from now on. Click OK.

The selected file is downloaded to your computer.

Exporting Domain Data to a NAS

You can export the backed-up Google Workspace or Microsoft 365 domain data in Boxafe to the Shared Folders on your QNAP NAS.

Open Boxafe.
Go to Domains.
Click a domain.

Select one of the following options:

Service Types	Options	User Actions
Google Workspace	Gmail	Click Gmail. Select an email.
	Drive	Click Drive. Select a drive backup file version.
	Shared Drives	Select a backup file version. Select a file.
Microsoft 365	Email	Select an email.
Microsoft 365	OneDrive	Click OneDrive. Select a drive backup file version.
Common services	Contacts	Select a contact.
Common services	Calendar	Click Calendar. Select a calendar version. Select a date range. Select a calendar event.

Click Export.

The export drop-down menu appears.
Select NAS.

The Select NAS Folder appears.
Optional: Click .

Boxafe refreshes the shared folder list.
Select a shared folder.
Click Export.

The Background Tasks window appears.
Select the same name file policy.
Click OK.

The selected file is exported to the NAS shared folder.

Domain Settings

Domain Settings allows you to add and modify Google Workspace or Microsoft 365 domain users and services including Shared Drives and SharePoint sites.

Managing Domain Users

Open Boxafe.
Go to Domains.
Click a domain.
Go to Domain Settings.

Select one of the following actions:

No.	Options	User Actions
1	Add a domain user	For details, see the following topics: Adding a Microsoft 365 Domain Adding a Google Workspace Domain
2	Backup users	Select one or multiple users. Click Backup. A confirmation message window appears. Click OK. The selected domain user data is backed-up.
3	Delete user	Select one or multiple users. Click Delete User or . A confirmation message appears. Click Delete.
4	Search users	Enter keywords to search for users.
5	Refresh list	Click .
6	Sort list by last added	Click or . Boxafe organizes the list by date in ascending order. Click . Boxafe organizes the list by date in descending order.
7	Filter schedule	Click . The schedule filter drop-down menu appears. Select a filter. Click Reset. Click OK.
8	Apply schedule	Select one or multiple users. Enable Applied ().
9	Sort list by domain user	Click or . Boxafe organizes the list by domain username in ascending alphabetical order. Click . Boxafe organizes the list by the domain username in descending alphabetical order.

Managing Shared Drives

Open Boxafe.
Go to Domains.
Select a Google Workspace domain.
Go to Domain Settings.
Click Shared Drives.
Select one or multiple shared drives.

You can perform one of the following actions:

No.	Options	User Actions
1	Add shared drives	Click + Add Shared Drives. Click Sync Shared Drives. The user list data is updated. Select a user. Select Initiate backup after adding a user. Click Add. The shared drive is added to the backup list.
2	Back up shared drives	Click Backup. A confirmation message appears. Click OK.
3	Delete shared drives	Click Delete or . A confirmation message appears. Click Delete.
4	Search shared drives	Enter keywords to search for shared drives.
5	Refresh list	Click .
6	Sort list by added by	Click or . Boxafe organizes the list by date in ascending order. Click . Boxafe organizes the list by date in descending order.
7	Filter schedule	Click . The schedule filter drop-down menu appears. Select a filter. Click Reset. Click OK. A list of shared drives that meet the specified schedule filter are displayed.
8	Apply schedule	Enable Applied ().
9	Sort list by last backup	Click or . Boxafe organizes the list by last backup date in ascending order. Click . Boxafe organizes the list by last backup date in descending order.
10	Sort list by shared drive name	Click or . Boxafe organizes the list by shared drive name in ascending alphabetical order. Click . Boxafe organizes the list by the shared drive name in descending alphabetical order.

Managing SharePoint Sites

Go to Boxafe > Domains.
Select a Microsoft 365 domain.

Important:
A SharePoint site has to be registered under the selected Microsoft 365 domain.
Click Domain Settings.

You can perform the following actions:

No.	Options	User Actions
1	Add a SharePoint site	Click +Add SharePoint Site. Select the SharePoint site you want to add to Boxafe. Select Start back up after adding a SharePoint site. Click Add. The SharePoint site is added to Boxafe.
2	Back up a SharePoint site	Click Backup. A confirmation message appears. Click OK.
3	Delete a SharePoint site	Click Delete or . A confirmation message appears. Click Delete.
4	Search bar	Enter keywords to search SharePoint sites.
5	Refresh list	Click .
6	Sort list by added by	Click or . Boxafe organizes the list by date in ascending order. Click . Boxafe organizes the list by date in descending order.
7	Filter schedule	Click . The schedule filter drop-down menu appears. Select a filter. Click Reset. Click OK. The selected filter results are listed.
8	Apply schedule	Enable Applied ().
9	Sort list by last backup	Click or . Boxafe organizes the list by last backup date in ascending order. Click . Boxafe organizes the list by last backup date in descending order.
10	Sort list by shared drive name	Click or . Boxafe organizes the list by SharePoint site name in ascending alphabetical order. Click . Boxafe organizes the list by the SharePoint site name in descending alphabetical order.

Managing Boxafe Users

The Settings screen displays QTS users, user roles, domain access, domain access email, and last login time. You can also add Boxafe users and edit user settings.

Open Boxafe.
Click Settings.

Note:
Only an administrator can modify Boxafe user settings.

Select one of the following actions:

No.	Options	User Actions
1	Add a Boxafe user	Click +Add User. Specify the following information: User Role Domain Email address Click Apply.
2	Search Boxafe users	Go to search bar. Enter keywords. A list of users that meet the search results is displayed.
3	Refresh list	Click . The user list is refreshed.
4	Delete a Boxafe user	Click . A confirmation message appears. Click Delete.
5	Edit a Boxafe user	Click . The Edit User window appears. Specify the following: Role Domain Email-ID Click Apply.
6	Sort list by last login time	Click or . Boxafe organizes the list by last login time in ascending order. Click . Boxafe organizes the list by last login time in descending order.
7	Sort list by domain access email	Click or . Boxafe organizes the list by domain access email in ascending alphabetical order. Click . Boxafe organizes the list by domain access email in descending alphabetical order.
8	Sort list by domain access	Click or . Boxafe organizes the list by domain access name in ascending alphabetical order. Click . Boxafe organizes the list by domain access name in descending alphabetical order.
9	Sort list by role	Click or . Boxafe organizes the list by role name in ascending alphabetical order. Click . Boxafe organizes the list by role name in descending alphabetical order.
10	Sort list by QTS users	Click or . Boxafe organizes the list by QTS username in ascending alphabetical order. Click . Boxafe organizes the list by QTS username in descending alphabetical order.

Managing Tasks

The Tasks screen displays all running, scheduled, and completed tasks. You can also view detailed task statuses and canceled tasks. For additional user actions, see the table below for details.

No.	Descriptions	User Actions
1	Sort list by task status	Click or . Boxafe organizes the list by task status in ascending alphabetical order. Click . Boxafe organizes the list by task status in descending alphabetical order.
2	Sort list by domain name	Click or . Boxafe organizes the list by domain name in ascending alphabetical order. Click . Boxafe organizes the list by domain name in descending alphabetical order.
3	Sort list by task type	Click or . Boxafe organizes the list by task type in ascending alphabetical order. Click . Boxafe organizes the list by task type in descending alphabetical order.
4	Sort list by task schedule	Click or . Boxafe organizes the list by task schedule in ascending alphabetical order. Click . Boxafe organizes the list by task schedule in descending alphabetical order.
5	Sort list by task completion time	Click or . Boxafe organizes the list by task completion time in ascending order. Click . Boxafe organizes the list by task completion time in descending order.
6	Sort list by task elapsed time	Click or . Boxafe organizes the list by task elapsed time in ascending order. Click . Boxafe organizes the list by task elapsed time in descending order.
7	Filter tasks	For details, see Filtering Tasks.
8	Refresh task list	Click .
9	View task status	For details, see Viewing Task Status.

Viewing Task Status

Open Boxafe.
Click Tasks.

Select one of the options:

Options	User Actions
Running Tasks	Click Running Tasks.
Scheduled Tasks	Click Scheduled Tasks.
Completed Tasks	Click Completed Tasks.

Click .

The Detailed Task Status window appears.
Optional: Click .

The task status is refreshed.
Click Status.

The task status appears.
Optional: Click Subtasks.

The subtask status appears.

Filtering Tasks

Open Boxafe.
Click Tasks.

Select one of the options:

Options	User Actions
Running Tasks	Click Running Tasks.
Scheduled Tasks	Click Scheduled Tasks.
Completed Tasks	Click Completed Tasks.

Specify a date range.
Select a domain.
Optional: Click Clear All Filters.

All filters are removed.
Click Apply.

Only tasks that meet the filtered conditions are displayed.

Managing Logs

The Logs screen displays the severity, date and time, description, and domain associated with each event. You can export or delete all logs.

No.	Description	User Actions
1	Export logs	Exports all logs to your computer. For details, see Exporting Logs.
2	Delete all logs	Click Delete All. A confirmation message appears. Click Delete. All logs are deleted.
3	Search logs	Enter keywords in the search bar. Press `Enter`.
4	Filter logs	Filters logs based on specified conditions. For details, see Filtering Logs.
5	Refresh logs	Click .
6	View logs	Click . The Detailed Task Status window appears. Click Status. The task status appears. Click Subtasks. The subtask status appears.
7	Sort by domain name	Click or . Boxafe organizes the list by the domain name in ascending alphabetical order. Click . Boxafe organizes the list by the domain name in descending alphabetical order.
8	Sort by description	Click or . Boxafe organizes the list by the description in ascending alphabetical order. Click . Boxafe organizes the list by the description in descending alphabetical order.
9	Sort by date and time	Click or . Boxafe organizes the list by the date and time in ascending order. Click . Boxafe organizes the list by the date and time in descending order.
10	Sort by severity level	Click or . Boxafe organizes the list by the severity level in ascending order. Click . Boxafe organizes the list by the severity level in descending order.

Exporting Logs

Open Boxafe.
Click Logs.
Click Export.

A confirmation message for exporting all logs appears.
Click Export.

The Opening boxafe-logs.csv window appears.

Select one of the following options:

Options	User Actions
Open with	Click Open with. Select an application.
Save File	Click Save File.

Optional: Select Do this automatically for files like this from now on.
Click OK.

All logs are downloaded to your computer.

Filtering Logs

Open Boxafe.
Click Logs.

A confirmation message for exporting all logs appears.
Click .

The filter conditions drop-down menu appears.

Specify the following conditions:

Filter Parameters	User Actions
Severity level	Click . The severity level drop-down menu appears. Select a severity level.
Date	Click the date bar. Select a start date. Select an end date.
Domain	Click . Select a domain name.

Optional: Click Clear All Filters.

All filter conditions are removed.
Click Apply.

Byl tento článek užitečný?

Ano. Ne.

33% lidí si myslí, že to pomáhá.

Sdělte nám prosím, jak lze tento článek vylepšit:

Článek postrádá důležité informace
Řešení v článku nefungují
Článek je příliš složitý
Článek obsahuje nesprávné informace
Článek je zastaralý

Pokud chcete poskytnout další zpětnou vazbu, uveďte ji níže.

Úložiště

Sítě

Příslušenství pro rozšíření

Dozorování

NAS

Sítě

Dozorování

About Boxafe

Getting Started

Installation

Availability and Requirements

Installing Boxafe

Toolbar

Dashboard

Domain Management

Adding a Domain Requirements

Obtaining a Google Workspace Service Key

Granting Users Google Drive Access Using Drive SDK API

Enabling Google API and Services

Creating a Google Service Key

Enabling Google Workspace Domain-Wide-Delegation

Obtaining Microsoft 365 Domain Authentication Credentials

Generating a Microsoft Azure Client ID and Tenant ID

Obtaining a Microsoft Azure Client Secret Key