ความช่วยเหลือ 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 สำหรับ 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 และ Databricks OAuth แบบกำหนดเองสำหรับไซต์ได้