How to get authentication credentials for adding a Microsoft 365 Domain to HDP for SaaS

วิธีการรับข้อมูลรับรองการยืนยันตัวตนสำหรับการเพิ่มโดเมน Microsoft 365 ไปยัง HDP สำหรับ SaaS

This tutorial will guide you through how to register a Microsoft Azure Active Directory (AD) application and generate a certificate for authorizing HDP for SaaS to back up Microsoft 365 domain data. Additional instructions are provided in this tutorial on how to obtain API access permissions to back up Microsoft Teams and SharePoint Sites data in HDP for SaaS.

1. Power on your computer.
2. Log in to Windows.
3. Open PowerShell.
   1. Click Start.
   2. Search for PowerShell.
   3. Choose Windows PowerShell.
      

      Tip:

      Make sure you do not select Windows PowerShell (x86).

   4. Select Run as Administrator.
4. Modify the execution policy by running the following command in PowerShell:
   

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

   Tip

   For details about PowerShell execution policy, see about_Execution_Policies.

   A confirmation message appears.

5. Enter Y or Yes.

   The PowerShell execution policy is modified.

   
6. Download the BoxafeAppGenerator.ps1 PowerShell script and follow the instructions below:
   1. Right-click on the BoxafeAppGenerator.ps1 file.

      A drop-down menu appears.

   2. Select Properties.

      The BoxafeAppGenerator.ps1 Properties page appears.

   3. Go to General.
   4. Copy the file Location details.
      
   5. Paste the file location into the value in the following command: 
      

      cd <file_location>

      For example, if your location is C:\Users\QNAP\Downloads, then the command will become: cd C:\Users\QNAP\Downloads

      Opens the file location folder in PowerShell.

      
   6. Run the PowerShell script based on your Microsoft 365 domain region. For details, see the following table:

      Domain Region	Command
      Microsoft 365 Global	.\BoxafeAppGenerator.ps1 -AzureEnvironmentName AzureCloud
      Microsoft 365 operated by 21 Vianet (China)	.\BoxafeAppGenerator.ps1 -AzureEnvironmentName AzureChinaCloud

      A certificate password configuration message appears.

      
7. Specify a certificate password.
8. Press Enter.

   A new certificate password is configured and the Microsoft Single Sign-On (SSO) window appears.

   
9. Log in to Microsoft 365 as an administrator.
   • HDP for SaaS is registered as a new application in Microsoft Azure AD.
     Warning

     Do not close the window, you will need to return to the window later to complete Microsoft 365 authentication.
   • The Microsoft 365 tenant ID, client ID, and PFX certificate are generated and displayed in the PowerShell window.
     
     
     
     Warning

     Do not close the PowerShell window or log out, you will need to return to the platform later to complete Microsoft 365 authentication.
10. Go to the PowerShell window.
11. Copy and save the Tenant Id, Application Id (Client Id), and PFX Certificate file (Keep securely).
    Tip

    Keep the Microsoft 365 authentication credentials safe. You will need the tenant ID, application ID (client ID), and PFX certificate to add the domain into HDP for SaaS.
12. Copy the generated URL shown at the bottom of the PowerShell window.
    
13. Open the URL in a browser.

    The HDP for SaaS Backup Solution API permissions window appears.

14. Select Grant admin consent for QNAP Systems Inc.
    

    The HDP for SaaS is authorized to access your Microsoft 365 domain data.

1. Log in to the Microsoft Azure admin portal.
   Note

   You must have Global admin credentials to log in to the Microsoft 365 domain.
2. Go to Overview.
3. Copy the Application (client) ID you obtained from Generating a Microsoft 365 Tenant ID, Client ID, and Certificate.
4. Insert the tenant name into 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 site and cloudqnap is the tenant name.

   
5. Open the link in the browser.
6. Paste the ID into the App Id field.
7. Click Lookup.

   The app title is generated.

   
8. Enter the following information in the related fields:

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

9. Click Create.

   A confirmation message appears.

10. Click Trust It.

    The Microsoft 365 tenant administrative permissions are granted to the SharePoint site.

1. Open HDP for SaaS.
2. Go to Domains.
3. Click Add New Domain.
4. Obtain a Microsoft 365 authentication.

   For details, see Generating a Microsoft 365 Tenant ID, Client ID, and Certificate.

5. Specify the following fields: 
   • Microsoft 365 endpoint
   • Domain admin email address
   • Directory (tenant) ID
   • Application (client) ID
   • Certificate file
   • Certificate password
6. Click Authorize.
7. Optional:  Select which Microsoft 365 services to back up.
8. Select the users to add.

   Option	Description
   Auto	Automatically synchronize with Microsoft 365 and add new users to HDP for SaaS.
   Manual	Manually add users to HDP for SaaS.

9. Select the SharePoint sites to add.

   Option	Description
   Auto	Automatically synchronize with Microsoft 365 and add new sites for scheduled backup.
   Manual	Manually add sites for scheduled backup.

10. Select the Microsoft Teams to add.

    Option	Description
    Auto	Automatically synchronize with Microsoft 365 and add new Microsoft Teams for scheduled backup.
    Manual	Manually add Microsoft Teams for scheduled backup.

11. Click Next.
12. Select the scope of the backup schedule.

    Option	Description
    All Applications	The backup schedule will apply to all applications.
    Individual Applications	You can configure a different backup schedule for each application.

13. Configure the backup schedule.
    1. Optional:  Select an application to configure a backup schedule.
       Note:

       This option is only available if you selected Individual Applications in the previous step.

    2. Select a backup schedule policy.

       Backup Type	User Actions
       Continuous	Specify the start date. Select Stop backup on and specify a date. Tip The system automatically creates a backup task for continuous backup.
       Manual	No backup schedule is created. This option is not available when backing up email.
       Scheduled	Specify the backup interval. Specify the start date and time. Select Stop backup after and specify a date.

    3. Optional:  Select Delete older versions of backed up data after, and specify a period.
14. Click Add.

    HDP for SaaS adds the domain with the configured settings and backup schedule.

บทแนะนำนี้จะแนะนำวิธีการลงทะเบียนแอปพลิเคชัน Microsoft Azure Active Directory (AD) และสร้างใบรับรองเพื่ออนุญาตให้ HDP for SaaS สำรองข้อมูลโดเมน Microsoft 365 คำแนะนำเพิ่มเติมมีอยู่ในบทแนะนำนี้เกี่ยวกับวิธีการรับสิทธิ์การเข้าถึง API เพื่อสำรองข้อมูล Microsoft Teams และ SharePoint Sites ใน HDP for SaaS

1. เปิดคอมพิวเตอร์ของคุณ
2. เข้าสู่ระบบ Windows
3. เปิด PowerShell
   1. คลิก เริ่มต้น.
   2. ค้นหา PowerShell.
   3. เลือก Windows PowerShell.
      

      เคล็ดลับ:

      ตรวจสอบให้แน่ใจว่าคุณไม่ได้เลือก Windows PowerShell (x86).

   4. เลือก   เรียกใช้ในฐานะ ผู้ดูแลระบบ.
4. ปรับเปลี่ยนนโยบายการดำเนินการโดยรันคำสั่งต่อไปนี้ใน PowerShell:
   

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process

   เคล็ดลับ

   สำหรับรายละเอียดเกี่ยวกับนโยบายการดำเนินการของ PowerShell ดูที่ เกี่ยวกับ_นโยบาย_การดำเนินการ.

   ข้อความยืนยันปรากฏขึ้น.

5. ป้อน Y หรือ Yes.

   นโยบายการดำเนินการของ PowerShell ถูกปรับเปลี่ยน.

   
6. ดาวน์โหลดสคริปต์ BoxafeAppGenerator.ps1 PowerShell และทำตามคำแนะนำด้านล่าง:
   1. คลิกขวาที่ไฟล์ BoxafeAppGenerator.ps1.

      เมนูแบบเลื่อนลงปรากฏขึ้น.

   2. เลือก คุณสมบัติ.

      หน้าคุณสมบัติ BoxafeAppGenerator.ps1 ปรากฏขึ้น.

   3. ไปที่ ทั่วไป.
   4. คัดลอกรายละเอียด ตำแหน่งที่ตั้ง ของไฟล์.
      
   5. วางตำแหน่งที่ตั้งของไฟล์ลงในค่าในคำสั่งต่อไปนี้: 
      

      cd <file_location>

      ตัวอย่างเช่น หากตำแหน่งที่ตั้งของคุณคือ C:\Users\QNAP\Downloads คำสั่งจะกลายเป็น: cd C:\Users\QNAP\Downloads

      เปิดโฟลเดอร์ตำแหน่งที่ตั้งของไฟล์ใน PowerShell.

      
   6. รันสคริปต์ PowerShell ตามภูมิภาคโดเมน Microsoft 365 ของคุณ สำหรับรายละเอียด ดูตารางต่อไปนี้:

      ภูมิภาคโดเมน	คำสั่ง
      Microsoft 365 ทั่วโลก	.\BoxafeAppGenerator.ps1 -AzureEnvironmentName AzureCloud
      Microsoft 365 ดำเนินการโดย 21 Vianet (จีน)	.\BoxafeAppGenerator.ps1 -AzureEnvironmentName AzureChinaCloud

      มีข้อความกำหนดรหัสผ่านใบรับรองปรากฏขึ้น.

      
7. ระบุรหัสผ่านใบรับรอง.
8. กด Enter.

   รหัสผ่านใบรับรองใหม่ถูกกำหนดค่าและหน้าต่าง Microsoft Single Sign-On (SSO) ปรากฏขึ้น.

   
9. เข้าสู่ระบบ Microsoft 365 ในฐานะ ผู้ดูแลระบบ.
   • HDP for SaaS ถูกลงทะเบียนเป็นแอปพลิเคชันใหม่ใน Microsoft Azure AD.
     คำเตือน

     อย่าปิดหน้าต่างนี้ คุณจะต้องกลับมาที่หน้าต่างนี้ในภายหลังเพื่อทำการยืนยันตัวตน Microsoft 365 ให้เสร็จสมบูรณ์
   • Microsoft 365 tenant ID, client ID และใบรับรอง PFX ถูกสร้างและแสดงในหน้าต่าง PowerShell
     
     
     
     คำเตือน

     อย่าปิดหน้าต่าง PowerShell หรือออกจากระบบ คุณจะต้องกลับมาที่แพลตฟอร์มในภายหลังเพื่อทำการยืนยันตัวตน Microsoft 365 ให้เสร็จสมบูรณ์
10. ไปที่หน้าต่าง PowerShell
11. คัดลอกและบันทึก Tenant Id, Application Id (Client Id) และ ไฟล์ใบรับรอง PFX (เก็บไว้อย่างปลอดภัย)
    เคล็ดลับ

    เก็บข้อมูลยืนยันตัวตน Microsoft 365 ไว้อย่างปลอดภัย คุณจะต้องใช้ tenant ID, application ID (client ID) และใบรับรอง PFX เพื่อเพิ่มโดเมนใน HDP สำหรับ SaaS
12. คัดลอก URL ที่สร้างขึ้นซึ่งแสดงที่ด้านล่างของหน้าต่าง PowerShell
    
13. เปิด URL ในเบราว์เซอร์

    หน้าต่าง HDP for SaaS Backup Solution API permissions ปรากฏขึ้น

14. เลือก Grant admin consent for QNAP Systems Inc
    

    The HDP for SaaS ได้รับอนุญาตให้เข้าถึงข้อมูลโดเมน Microsoft 365 ของคุณ

1. เข้าสู่ระบบที่ พอร์ทัล Microsoft Azure admin
   หมายเหตุ

   คุณต้องมีข้อมูลประจำตัว Global admin เพื่อเข้าสู่ระบบโดเมน Microsoft 365
2. ไปที่ ภาพรวม
3. คัดลอก Application (client) ID ที่คุณได้รับจาก การสร้าง Microsoft 365 Tenant ID, Client ID, และ Certificate
4. ใส่ชื่อผู้เช่าลงในลิงก์ต่อไปนี้: https://[tenant]-admin.sharepoint.com/_layouts/15/appinv.aspx
   หมายเหตุ:

   ชื่อ [tenant] คือซับโดเมนของ SharePoint Site ของคุณ ตัวอย่างเช่น cloudqnap.sharepoint.com คือ URL ของไซต์ SharePoint ของคุณและ cloudqnap คือชื่อผู้เช่า

   
5. เปิดลิงก์ในเบราว์เซอร์
6. วาง ID ลงในช่อง App Id
7. คลิก ค้นหา

   ชื่อแอปถูกสร้างขึ้น

   
8. กรอกข้อมูลต่อไปนี้ในช่องที่เกี่ยวข้อง:

   ช่อง	ข้อมูล
   โดเมนแอป:	localhost
   URL เปลี่ยนเส้นทาง:	https://localhost
   คำขอสิทธิ์ของแอปในรูปแบบ XML:	<AppPermissionRequests AllowAppOnlyPolicy="true"> <AppPermissionRequest Scope="http://sharepoint/content/tenant" Right="FullControl"/> </AppPermissionRequests>

9. คลิก Create.

   มีข้อความยืนยันปรากฏขึ้น

10. คลิก Trust It.

    สิทธิ์การจัดการผู้เช่าของ Microsoft 365 ได้รับการอนุญาตให้กับไซต์ SharePoint

1. เปิด HDP for SaaS.
2. ไปที่ Domains.
3. คลิก Add New Domain.
4. รับการยืนยันตัวตนของ Microsoft 365

   สำหรับรายละเอียด ดูที่ การสร้าง Microsoft 365 Tenant ID, Client ID, และ Certificate.

5. ระบุฟิลด์ต่อไปนี้: 
   • ปลายทาง Microsoft 365
   • ที่อยู่อีเมล admin โดเมน
   • ไดเรกทอรี (ผู้เช่า) ID
   • แอปพลิเคชัน (ลูกค้า) ID
   • ไฟล์ใบรับรอง
   • รหัสผ่านใบรับรอง
6. คลิก Authorize.
7. ตัวเลือก:  เลือกบริการ Microsoft 365 ที่จะสำรองข้อมูล.
8. เลือกผู้ใช้ที่จะเพิ่ม

   ตัวเลือก	คำอธิบาย
   อัตโนมัติ	ซิงโครไนซ์กับ Microsoft 365 โดยอัตโนมัติและเพิ่มผู้ใช้ใหม่ใน HDP for SaaS
   ด้วยตนเอง	เพิ่มผู้ใช้ใน HDP for SaaS ด้วยตนเอง

9. เลือกไซต์ SharePoint ที่จะเพิ่ม

   ตัวเลือก	คำอธิบาย
   อัตโนมัติ	ซิงโครไนซ์กับ Microsoft 365 โดยอัตโนมัติและเพิ่มไซต์ใหม่สำหรับการสำรองข้อมูลตามกำหนดการ
   ด้วยตนเอง	เพิ่มไซต์สำหรับการสำรองข้อมูลตามกำหนดการด้วยตนเอง

10. เลือก Microsoft Teams ที่จะเพิ่ม

    ตัวเลือก	คำอธิบาย
    อัตโนมัติ	ซิงโครไนซ์กับ Microsoft 365 โดยอัตโนมัติและเพิ่ม Microsoft Teams ใหม่สำหรับการสำรองข้อมูลตามกำหนดเวลา
    คู่มือ	เพิ่ม Microsoft Teams ด้วยตนเองสำหรับการสำรองข้อมูลตามกำหนดเวลา

11. คลิก ถัดไป
12. เลือกขอบเขตของตารางเวลาสำรองข้อมูล

    ตัวเลือก	คำอธิบาย
    แอปพลิเคชันทั้งหมด	ตารางเวลาสำรองข้อมูลจะใช้กับแอปพลิเคชันทั้งหมด
    แอปพลิเคชันแต่ละรายการ	คุณสามารถกำหนดตารางเวลาสำรองข้อมูลที่แตกต่างกันสำหรับแต่ละแอปพลิเคชัน

13. กำหนดตารางเวลาสำรองข้อมูล
    1. ตัวเลือก:  เลือกแอปพลิเคชันเพื่อกำหนดตารางเวลาสำรองข้อมูล
       หมายเหตุ:

       ตัวเลือกนี้จะใช้ได้เฉพาะเมื่อคุณเลือก แอปพลิเคชันแต่ละรายการ ในขั้นตอนก่อนหน้า

    2. เลือกนโยบายตารางเวลาสำรองข้อมูล

       ประเภทการสำรองข้อมูล	การกระทำของผู้ใช้
       ต่อเนื่อง	ระบุวันที่เริ่มต้น เลือก หยุดการสำรองข้อมูลใน และระบุวันที่ เคล็ดลับ ระบบจะสร้างงานสำรองข้อมูลสำหรับการสำรองข้อมูลต่อเนื่องโดยอัตโนมัติ
       คู่มือ	ไม่มีการสร้างตารางเวลาสำรองข้อมูล ตัวเลือกนี้ไม่สามารถใช้ได้เมื่อสำรองข้อมูลอีเมล
       ตามกำหนดเวลา	ระบุช่วงเวลาสำรองข้อมูล ระบุวันที่และเวลาที่เริ่มต้น เลือก หยุดการสำรองข้อมูลหลังจาก และระบุวันที่

    3. ตัวเลือก:  เลือก ลบเวอร์ชันเก่าของข้อมูลที่สำรองหลังจาก และระบุระยะเวลา
14. คลิก เพิ่ม

    HDP for SaaS เพิ่มโดเมนด้วยการตั้งค่าและตารางเวลาสำรองข้อมูลที่กำหนดค่าไว้