ความช่วยเหลือ Tableau Server บน Linux

ตัวเชื่อมต่อ Azure Synapse, Azure SQL Database, Azure Databricks, Azure Data Lake Gen2, OneDrive และ SharePoint Online และ SharePoint Lists (JDBC) รองรับการตรวจสอบสิทธิ์ผ่าน Azure AD โดยการกำหนดค่าไคลเอ็นต์ OAuth สำหรับ Tableau Server

หมายเหตุ: ไม่รองรับโทเค็นการรีเฟรชแบบใช้ครั้งเดียว (บางครั้งเรียกว่าโทเค็นการรีเฟรชแบบหมุนเวียนหรือการหมุนเวียนโทเค็นการรีเฟรช) สำหรับการเชื่อมต่อ OAuth กับ Tableau ในขณะนี้ มีการวางแผนที่จะรองรับโทเค็นเหล่านี้สำหรับการเปิดตัวในอนาคต

หมายเหตุ: การรองรับ OAuth สำหรับ Azure AD จะรองรับกับ Microsoft SQLServer driver 17.3(ลิงก์จะเปิดในหน้าต่างใหม่) และใหม่กว่าเท่านั้น

ขั้นตอนที่ 1: ลงทะเบียนไคลเอ็นต์ OAuth สำหรับ Azure

ทำตามขั้นตอนด้านล่างเพื่อลงทะเบียนและกำหนดค่าแอปพลิเคชัน OAuth สำหรับ Azure ภายใต้ผู้เช่า Azure เฉพาะ

1. เข้าสู่ระบบพอร์ทัล Microsoft Azure
2. หากคุณมีสิทธิ์เข้าถึงผู้เช่าหลายราย เลือกผู้เช่าที่คุณต้องการลงทะเบียนแอปพลิเคชัน
3. ค้นหาและเลือก Azure Active Directory
4. ภายใต้จัดการ เลือกการลงทะเบียนแอป จากนั้นเลือกการลงทะเบียนใหม่
5. ป้อน “Tableau Server OAuth” หรือค่าที่คล้ายกันเป็นชื่อ
6. ภายใต้ฟิลด์ประเภทบัญชีที่รองรับในหน้าการลงทะเบียนแอป ให้เลือกผู้ที่สามารถใช้แอปพลิเคชันนี้ได้

หมายเหตุ: หากคุณต้องการใช้ ID ไคลเอ็นต์และข้อมูลลับไคลเอ็นต์ของแอปพลิเคชันของคุณสำหรับบัญชีภายใต้กลุ่มผู้ใช้อื่น เลือกตัวเลือกที่สอง (หลายกลุ่มผู้ใช้)

7. ภายใต้ฟิลด์เปลี่ยนเส้นทาง URI (ไม่บังคับ) ให้เลือกเว็บ จากนั้นป้อนที่อยู่อินเทอร์เน็ตของเซิร์ฟเวอร์ของคุณซึ่งต่อท้ายด้วยสตริง /auth/add_oauth_token

ตัวอย่าง: https://your_server_url.com/auth/add_oauth_token

8. เลือกลงทะเบียน หลังจากการลงทะเบียนเสร็จสิ้น พอร์ทัล Azure จะแสดงแผงภาพรวมของการลงทะเบียนแอป ซึ่งรวมถึง ID แอปพลิเคชัน (ไคลเอ็นต์) เรียกอีกอย่างว่า ID ไคลเอ็นต์ ค่านี้จะระบุแอปพลิเคชันของคุณในแพลตฟอร์มข้อมูลประจำตัวของ Microsoft โดยไม่ซ้ำกัน
9. คัดลอกค่า โดยจะใช้เป็นฟิลด์ [your_client_id] ในขั้นตอนต่อไปนี้
10. เลือกใบรับรองและข้อมูลลับบนแถบด้านซ้าย จากนั้นเลือกข้อมูลลับใหม่ของไคลเอ็นต์
11. เพิ่มคำอธิบายของไคลเอ็นต์
12. เลือกอายุตลอดการใช้งานข้อมูลลับของไคลเอ็นต์
13. เลือกเพิ่ม แล้วคัดลอกข้อมูลลับ ข้อมูลลับจะถูกใช้เป็น [your_client_secret] ในขั้นตอนต่อไปนี้
14. เลือกสิทธิ์ API บนแถบด้านซ้าย
15. เลือกเพิ่มสิทธิ์
16. เลือก Microsoft Graph
17. เลือกสิทธิ์ที่ได้รับมอบ
18. ภายใต้เลือกสิทธิ์ ให้เลือกสิทธิ์ OpenId ทั้งหมด (email, offline_access, openid และ profile)
19. เลือกเพิ่มสิทธิ์
20. เพิ่มสิทธิ์เพิ่มเติม ทำตามขั้นตอนด้านล่างสำหรับตัวเชื่อมต่อที่คุณเปิดใช้งาน:
    • ฐานข้อมูล Azure SQL
      1. คลิกเพิ่มสิทธิ์
      2. เลือก API ของฉัน
      3. คลิกฐานข้อมูล Azure SQL จากนั้นเลือกสิทธิ์ที่ได้รับมอบ
      4. เลือก user_impersonation แล้วคลิกเพิ่มสิทธิ์
    • OneDrive และ SharePoint Online
    1. คลิกเพิ่มสิทธิ์
    2. เลือก Microsoft Graph
    3. คลิกสิทธิ์ที่ได้รับมอบ
    4. ภายใต้เลือกสิทธิ์ ในช่องค้นหาตัวกรอง ให้ป้อนแล้วเพิ่มสิทธิ์ต่อไปนี้
    • Files.Read.All
    • Sites.Read.All
    • User.Read
    • รายการ SharePoint (JDBC)
    1. คลิกเพิ่มสิทธิ์
    2. เลือก Microsoft Graph
    3. คลิกสิทธิ์ที่ได้รับมอบ
    4. ภายใต้เลือกสิทธิ์ ในช่องค้นหาตัวกรอง ให้ป้อนแล้วเพิ่มสิทธิ์ User.Read
    5. คลิกเพิ่มสิทธิ์อีกครั้ง
    6. เลือก SharePoint
    7. คลิกสิทธิ์ที่ได้รับมอบ
    8. ขยายส่วน AllSites จากนั้นเลือกและเพิ่มสิทธิ์ AllSites.Manage

ขั้นตอนที่ 2: กำหนดค่า Tableau Server สำหรับ Azure

การกำหนดค่า Tableau Server ต้องเรียกใช้คำสั่ง Tableau Server Manager (TSM) Azure Data Lake Storage Gen2 ต้องเรียกใช้ชุดคำสั่งที่แตกต่างจากคำสั่งทั่วไปที่เรียกใช้สำหรับ Azure Synapse, ฐานข้อมูล Azure SQL หรือ Databricks

กำหนดค่าไคลเอ็นต์ OAuth เริ่มต้นสำหรับ Azure Data Lake Storage Gen2

ในการกำหนดค่า Tableau Server สำหรับ Data Lake Storage Gen2 คุณต้องมีพารามิเตอร์การกำหนดค่าต่อไปนี้:

• ID ไคลเอ็นต์ Azure OAuth: ID ไคลเอ็นต์สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [your_client_id] ในคำสั่ง tsm รายการแรก
• ข้อมูลลับไคลเอ็นต์Azure Oauth: ข้อมูลลับไคลเอ็นต์สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [your_client_secret] ในคำสั่ง tsm รายการที่สอง
• URL ของ Tableau Server: ป้อน URL ของ Tableau Server ของคุณ เช่น https://myco.com คัดลอกค่านี้สำหรับ [your_server_url] ในคำสั่ง tsm รายการที่สาม

เรียกใช้คำสั่ง tsm ต่อไปนี้เพื่อกำหนดค่า OAuth ของ Tableau Server สำหรับ Azure Data Lake Storage Gen2:

• tsm configuration set -k oauth.azuredatalake_storage_gen2.client_id -v [your_client_id] --force-keys
• tsm configuration set -k oauth.azuredatalake_storage_gen2.client_secret -v [your_client_secret] --force-keys
• tsm configuration set -k oauth.azuredatalake_storage_gen2.redirect_uri -v http://[your_server_url]/auth/add_oauth_token --force-keys
• tsm pending-changes apply

กำหนดค่าไคลเอ็นต์เริ่มต้นสำหรับ Azure Synapse, ฐานข้อมูล Azure SQL หรือ Databricks

ในการกำหนดค่า Tableau Server คุณต้องมีพารามิเตอร์การกำหนดค่าต่อไปนี้:

• ID ไคลเอ็นต์ Azure OAuth: สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [your_client_id] ในคำสั่ง tsm
• ข้อมูลลับ Azure OAuthClient: สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [your_client_secret] ในคำสั่ง tsm รายการที่สอง
• URL ของ Tableau Server: นี่คือ URL ของ Tableau Server เช่น https://myserver.com คัดลอกค่านี้สำหรับ [your_server_url] ในคำสั่ง tsm รายการที่สาม
• ID การกำหนดค่า: ค่าสำหรับพารามิเตอร์ oauth.config.id ในคำสั่ง tsm ต่อไปนี้ ค่าที่ถูกต้อง:
  • Azure Synapse: azure_sql_dw
  • ฐานข้อมูล Azure SQL: azure_sqldb
  • Databricks: databricks

เรียกใช้คำสั่ง tsm ต่อไปนี้เพื่อกำหนดค่า Azure AD สำหรับ Azure Synapse, ฐานข้อมูล Azure SQL หรือ Databricks ตัวอย่างเช่น ในการตั้งค่า Azure Synapse:

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

กำหนดค่าไคลเอ็นต์ OAuth เริ่มต้นสำหรับ OneDrive (เลิกใช้งานแล้ว)

หากต้องการกำหนดค่า Tableau Server สำหรับ OneDrive (เลิกใช้งานแล้ว) คุณต้องมีพารามิเตอร์การกำหนดค่าต่อไปนี้:

• ID ไคลเอ็นต์ Azure OAuth: ID ไคลเอ็นต์สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [ID_ไคลเอ็นต์_ของคุณ] ในคำสั่ง command รายการแรก
• ข้อมูลลับไคลเอ็นต์Azure Oauth: ข้อมูลลับไคลเอ็นต์สร้างขึ้นจากขั้นตอนในขั้นตอนที่ 1 คัดลอกค่านี้สำหรับ [ข้อมูลลับ_ไคลเอ็นต์_ของคุณ] ในคำสั่ง tsm รายการที่สอง
• URL ของ Tableau Server: นี่คือ URL ของ Tableau Server เช่น https://myco.com คัดลอกค่านี้สำหรับ [URL_เซิร์ฟเวอร์_ของคุณ] ในคำสั่ง command รายการที่สาม

วิธีในการเรียกใช้คำสั่ง tsm ต่อไปนี้เพื่อกำหนดค่า Tableau Server OAuth สำหรับ OneDrive (เลิกใช้งานแล้ว):

• tsm configuration set -k oauth.onedrive.client_id -v [your_client_id] --force-keys
• tsm configuration set -k oauth.onedrive.client_secret -v [your_client_secret] --force-keys
• tsm configuration set -k oauth.onedrive.redirect_uri -v http://[your_server_url]/auth/add_oauth_token --force-keys
• tsm pending-changes apply

สถานการณ์การรีสตาร์ทเซิร์ฟเวอร์

หลังจากที่คุณกำหนดค่าไคลเอ็นต์ OAuth เริ่มต้น สถานการณ์ต่อไปนี้อาจเกิดขึ้นได้

• ข้อความแจ้งการรีสตาร์ทจะปรากฏขึ้นหากการเปลี่ยนแปลงที่รอดำเนินการจำเป็นต้องรีสตาร์ทเซิร์ฟเวอร์
• คุณสามารถระงับข้อความแจ้งได้โดยใช้ตัวเลือก --ignore-prompt แต่การดำเนินการนี้จะไม่หยุดการรีสตาร์ท
• หากการเปลี่ยนแปลงไม่จำเป็นต้องใช้การรีสตาร์ท ระบบจะปรับใช้การเปลี่ยนแปลงนั้นโดยไม่มีข้อความแจ้ง หากต้องการข้อมูลเพิ่มเติม โปรดดู tsm pending-changes apply

การตั้งค่าตัวเชื่อมต่อหลายตัว

หากมีตัวเชื่อมต่อหลายตัวที่จะตั้งค่า คุณต้องรวมตัวเชื่อมต่อทั้งหมดไว้ในคำสั่งเดียว ตัวอย่าง:

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"databricks\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

กำหนดค่า OAuth แบบกำหนดเองสำหรับไซต์

คุณสามารถกำหนดค่าไคลเอ็นต์ Azure Data Lake Storage Gen2, Azure Synapse, Azure SQL Database, Databricks OAuth, OneDrive และ Sharepoint online และรายการ Sharepoint (JDBC) สำหรับไซต์ได้

โปรดพิจารณาการกำหนดค่าไคลเอ็นต์ OAuth แบบกำหนดเองให้เป็น 1) เขียนทับไคลเอนต์ OAuth หากกำหนดค่าให้กับเซิร์ฟเวอร์ หรือ 2) เปิดใช้งานการสนับสนุนเพื่อการเชื่อมต่อกับข้อมูลที่จำเป็นต้องมีไคลเอ็นต์ OAuth ที่ไม่ซ้ำกันอย่างปลอดภัย

เมื่อกำหนดค่าไคลเอนต์ OAuth แล้วนั้น การกำหนดค่าระดับไซต์จะมีความสำคัญเหนือการกำหนดค่าฝั่งเซิร์ฟเวอร์ใดๆ และข้อมูลเข้าสู่ระบบ OAuth ใหม่ทั้งหมดที่สร้างจะใช้ไคลเอ็นต์ OAuth ตามค่าเริ่มต้น ไม่จำเป็นต้องรีสตาร์ท Tableau Server เพื่อให้การกำหนดค่าทำงาน

สำคัญ: ข้อมูลเข้าสู่ระบบ OAuth ที่มีอยู่ที่สร้างก่อนที่จะกำหนดค่าไคลเอ็นต์ OAuth นั้นจะใช้ได้ชั่วคราว แต่ทั้งผู้ดูแลระบบเซิร์ฟเวอร์และผู้ใช้จะต้องอัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้เพื่อไม่ให้เกิดการเข้าถึงข้อมูลที่ถูกรบกวน

1: เตรียม ID ไคลเอ็นต์ของ OAuth, ข้อมูลลับของไคลเอ็นต์ และ URL การเปลี่ยนเส้นทาง

ก่อนที่คุณจะสามารถกำหนดค่าไคลเอ็นต์ OAuth แบบกำหนดเองได้ คุณจะต้องมีข้อมูลที่ระบุตามด้านล่างนี้ หลังจากที่คุณเตรียมข้อมูลเหล่านี้แล้ว คุณสามารถลงทะเบียนไคลเอ็นต์ OAuth แบบกำหนดเองสำหรับไซต์ได้

• ID ไคลเอ็นต์ OAuth และข้อมูลลับของไคลเอ็นต์: ก่อนอื่น ให้ลงทะเบียนไคลเอ็นต์ OAuth กับผู้ให้ข้อมูล (ตัวเชื่อมต่อ) เพื่อรับ ID ไคลเอ็นต์และข้อมูลความลับที่สร้างสำหรับ Tableau Server

• URL เปลี่ยนเส้นทาง โปรดตรวจสอบ URL เปลี่ยนเส้นทางที่ถูกต้อง คุณจะต้องใช้สิ่งนี้ระหว่างกระบวนการลงทะเบียนในขั้นตอนที่ 2 ด้านล่าง

  https://<your_server_name>.com/auth/add_oauth_token

  ตัวอย่างเช่น https://example.com/auth/add_oauth_token

2: ลงทะเบียน ID ไคลเอ็นต์ของ OAuth และข้อมูลลับของไคลเอ็นต์

ปฏิบัติตามขั้นตอนที่อธิบายด้านล่างเพื่อลงทะเบียนไคลเอ็นต์ OAuth ไปยังไซต์

1. ลงชื่อเข้าใช้ Tableau Server ของคุณโดยใช้ข้อมูลเข้าสู่ระบบในฐานะผู้ดูแลและไปยังหน้าการตั้งค่า

2. ภายใต้ "รีจิสทรีไคลเอ็นต์ OAuth" ให้คลิกปุ่ม เพิ่มไคลเอ็นต์ OAuth

3. ป้อนข้อมูลที่จำเป็น รวมถึงข้อมูลจาก ขั้นตอนที่ 1 ด้านบน:

   1. สำหรับประเภทการเชื่อมต่อ ให้เลือกตัวเชื่อมต่อที่มีไคลเอ็นต์ OAuth แบบกำหนดเองที่คุณต้องการกำหนดค่า

   2. URL อินสแตนซ์ OAuth จำเป็นต้องมีหากมีการลงทะเบียนไคลเอ็นต์ OAuth หลายรายการ หากไม่เช่นนั้นก็เป็นทางเลือก

   3. สำหรับ ID ไคลเอ็นต์ ข้อมูลลับของไคลเอ็นต์ และ URL การเปลี่ยนเส้นทาง ให้ป้อนข้อมูลที่คุณเตรียมไว้ใน ขั้นตอนที่ 1 ด้านบน

   4. คลิกปุ่ม เพิ่มไคลเอ็นต์ OAuth เพื่อทำขั้นตอนการลงทะเบียนให้เสร็จสิ้น

   

4. (ไม่บังคับ) ดำเนินการขั้นตอนที่ 3 อีกครั้งสำหรับตัวเชื่อมต่อที่รองรับทั้งหมด

5. คลิกปุ่ม บันทึก ที่ด้านล่างหรือด้านบนของหน้าการตั้งค่าเพื่อบันทึกการเปลี่ยนแปลง

3: ยืนยันความถูกต้องและอัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้

เพื่อให้แน่ใจว่าจะเป็นการเข้าถึงข้อมูลที่ไม่ถูกรบกวน คุณ (และผู้ใช้ไซต์ของคุณ) จะต้องลบข้อมูลเข้าสู่ระบบที่บันทึกไว้ก่อนหน้าและเพิ่มข้อมูลเข้ามาอีกครั้งเพื่อใช้ไคลเอ็นต์ OAuth แบบกำหนดเองสำหรับไซต์

1. ไปยังหน้าการตั้งค่าบัญชีของฉัน

2. ภายใต้ ข้อมูลเข้าสู่ระบบที่บันทึกไว้สำหรับแหล่งข้อมูล ให้ทำดังต่อไปนี้:

   1. คลิก ลบ ถัดจากข้อมูลเข้าสู่ระบบที่บันทึกไว้สำหรับตัวเชื่อมต่อที่มีไคลเอ็นต์ OAuth ที่กำหนดเองซึ่งคุณกำหนดค่าไว้ใน ขั้นตอนที่ 2 ด้านบน

   2. ถัดจากชื่อของตัวเชื่อมต่อ ให้คลิกเพิ่ม และไปตามการแจ้งเตือนไปยัง 1) เชื่อมต่อกับไคลเอ็นต์ OAuth แบบกำหนดเองที่กำหนดค่าไว้ในขั้นตอนที่ 2 ด้านบนและ 2) บ้นทึกข้อมูลเข้าสู่ระบบล่าสุด

4: แจ้งเตือนผู้ใช้เพื่ออัปเดตข้อมูลเข้าสู่ระบบที่บันทึกไว้

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