Làm cách nào để kiểm tra yêu cầu URI của tôi?

Giá trị

//10ay.online.tableau.com/api/3.18/auth/signin

5 trong URI đăng nhập là URL cơ sở cho Máy chủ Tableau của bạn. Đối với Tableau Cloud, địa chỉ máy chủ trong URI phải chứa tên nhóm, chẳng hạn như

//10ay.online.tableau.com/api/3.18/auth/signin

6,

//10ay.online.tableau.com/api/3.18/auth/signin

7 hoặc

//10ay.online.tableau.com/api/3.18/auth/signin

8. Ví dụ: URI để đăng nhập vào một trang web trong nhóm 10 ngày sẽ là

//10ay.online.tableau.com/api/3.18/auth/signin

Thực hiện yêu cầu đăng nhập bằng mã thông báo truy cập cá nhân

Mã thông báo truy cập cá nhân [PAT] xác thực rằng người dùng được phép đăng nhập vào một trang web. Đăng nhập bằng PAT trả về thông tin giống như tên người dùng và mật khẩu đăng nhập [mã thông báo xác thực, LUID trang web và LUID người dùng], nhưng không có rủi ro bảo mật khi để lộ tên người dùng và mật khẩu được mã hóa cứng hoặc trải nghiệm đăng nhập tương tác. PAT tồn tại lâu dài và có thể bị thu hồi mà không vô hiệu hóa người dùng Tableau mà chúng được đính kèm. Một người dùng có thể có nhiều PAT, cho phép giám sát chi tiết và thu hồi quyền truy cập. Chẳng hạn, quản trị viên có thể nhóm các tập lệnh của họ thành các khu vực chức năng [như quyền, đăng ký và làm mới nguồn dữ liệu] và sử dụng một PAT khác cho từng khu vực. Để biết thêm thông tin, hãy xem một trong các chủ đề sau.  

• Đối với Máy chủ Tableau, Mã thông báo truy cập cá nhân [Liên kết mở trong cửa sổ mới] .
• Đối với Tableau Cloud, Mã truy cập cá nhân [Liên kết mở trong cửa sổ mới] .

Khi bạn tạo Mã thông báo truy cập cá nhân [Liên kết mở trong cửa sổ mới] , Tableau sẽ hiển thị hộp thoại hiển thị token name and token secret. There is no way to retrieve a token secret from the server after that dialog is dismissed. Copy those values to use in your sign in request body

Mã thông báo truy cập cá nhân sẽ hết hạn nếu chúng không được sử dụng trong 15 ngày liên tiếp. Nếu chúng được sử dụng thường xuyên hơn 15 ngày một lần, thì mã thông báo truy cập sẽ hết hạn sau 1 năm và cần được thay thế bằng mã mới tạo

Nội dung yêu cầu XML [tải tin nhắn] sử dụng Mã thông báo truy cập cá nhân giống như ví dụ sau. Tiêu đề của yêu cầu phải chứa cặp giá trị khóa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

0, hoặc

//10ay.online.tableau.com/api/3.18/auth/signin

9.

2

Nội dung yêu cầu tương tự sử dụng JSON trông giống như sau. Tiêu đề của nó phải chứa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

4

//10ay.online.tableau.com/api/3.18/auth/signin

2

Thực hiện yêu cầu đăng nhập bằng tên người dùng và mật khẩu

Nội dung yêu cầu XML [tải tin nhắn] cho yêu cầu đăng nhập bằng tên người dùng và mật khẩu giống như ví dụ sau. Tiêu đề của yêu cầu phải chứa cặp giá trị khóa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

0, hoặc

//10ay.online.tableau.com/api/3.18/auth/signin

9.

2

//10ay.online.tableau.com/api/3.18/auth/signin

7

Nội dung yêu cầu tương tự sử dụng JSON trông giống như sau. Tiêu đề của nó phải chứa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

4

//10ay.online.tableau.com/api/3.18/auth/signin

0

Thực hiện yêu cầu đăng nhập bằng Mã thông báo web JSON [JWT]

JWT là phương thức xác thực tiêu chuẩn ngành cho phép ứng dụng tạo thông tin xác thực cho người dùng được ủy quyền. JWT thường được sử dụng trong các trường hợp xác thực được cung cấp bởi một dịch vụ cho phép ủy quyền của dịch vụ khác. Chẳng hạn, người dùng đăng nhập vào ứng dụng bằng thông tin đăng nhập Google của họ, sau đó ứng dụng tạo JWT để ủy quyền cho người dùng thông tin đăng nhập Tableau

Thông thường, JWT được tạo bởi ứng dụng được kết nối với Tableau [Liên kết mở trong cửa sổ mới] như một phần của lời kêu gọi đăng ký của ứng dụng . Trong trường hợp này, JWT cũng phải chứa phạm vi truy cập [Liên kết mở trong cửa sổ mới] để xác định phương thức mà ứng dụng có thể gọi. Phạm vi truy cập được khai báo trong một phần của ứng dụng được kết nối để tạo JWT.

Nội dung yêu cầu XML [tải tin nhắn] cho yêu cầu đăng nhập bằng JWT giống như ví dụ sau. Tiêu đề của yêu cầu phải chứa cặp giá trị khóa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

0, hoặc

//10ay.online.tableau.com/api/3.18/auth/signin

9.

2

//10ay.online.tableau.com/api/3.18/auth/signin

5

Nội dung yêu cầu tương tự sử dụng JSON trông giống như sau. Tiêu đề của nó phải chứa

//10ay.online.tableau.com/api/3.18/auth/signin

9.

4

//10ay.online.tableau.com/api/3.18/auth/signin

8

Thuộc tính trang web

Phần tử

//10ay.online.tableau.com/api/3.18/auth/signin

27 của yêu cầu đăng nhập cho phép bạn chỉ định trang web để đăng nhập bằng cách đặt giá trị của thuộc tính

//10ay.online.tableau.com/api/3.18/auth/signin

28. URL nội dung là đường dẫn phụ của URL đầy đủ của trang web. Trong môi trường máy chủ, nó được gọi là ID trang web . Khi bạn đăng nhập vào Tableau Server hoặc Tableau Cloud theo cách thủ công,

//10ay.online.tableau.com/api/3.18/auth/signin

28 là giá trị xuất hiện sau

//10ay.online.tableau.com/api/3.18/auth/signin

70 trong thanh địa chỉ Trình duyệt. Ví dụ: trong các URL sau, URL nội dung là

//10ay.online.tableau.com/api/3.18/auth/signin

71.

[Máy chủ Tableau]

//10ay.online.tableau.com/api/3.18/auth/signin

72

[Đám mây Tableau]

//10ay.online.tableau.com/api/3.18/auth/signin

73

Đối với Tableau Server, để chỉ định trang web mặc định, hãy bỏ qua

//10ay.online.tableau.com/api/3.18/auth/signin

28 khỏi phần tử

//10ay.online.tableau.com/api/3.18/auth/signin

27 hoặc biến giá trị

//10ay.online.tableau.com/api/3.18/auth/signin

28 thành một chuỗi trống [

//10ay.online.tableau.com/api/3.18/auth/signin

77]

Đối với Tableau Cloud, yêu cầu đăng nhập phải có phần tử

//10ay.online.tableau.com/api/3.18/auth/signin

27 chứa

//10ay.online.tableau.com/api/3.18/auth/signin

28 với giá trị của một trang web hiện có. Nếu thiếu những thứ này, yêu cầu Đăng nhập sẽ không thành công.

Phản hồi cho thao tác đăng nhập thành công

Nếu lệnh gọi Đăng nhập thành công, phần thân của phản hồi chứa mã thông báo xác thực, ID trang web mà bạn đang truy cập. . Ví dụ sau đây cho thấy phản hồi bằng XML [khi tiêu đề Loại nội dung được đặt thành

0 hoặc

2 hoặc khi . header is set to

2].

//10ay.online.tableau.com/api/3.18/auth/signin

5

Trong JSON, phản hồi sẽ giống như sau [khi Loại nội dung hoặc Chấp nhận header is set to

4],

//10ay.online.tableau.com/api/3.18/auth/signin

7

Thuộc tính

//10ay.online.tableau.com/api/3.18/auth/signin

04 là LUID hoặc mã định danh duy nhất cục bộ cho trang web. Trong ví dụ trước, trang LUID là

//10ay.online.tableau.com/api/3.18/auth/signin

05. Nhiều phương thức API REST yêu cầu LUID của trang chỉ định trang trong URI của chúng. Để biết thêm thông tin, hãy xem Xác định tài nguyên bằng mã định danh duy nhất cục bộ [LUID]

Sử dụng mã thông báo xác thực trong các cuộc gọi tiếp theo

Khi bạn nhận được phản hồi, bạn phân tích mã thông báo ra khỏi phản hồi và lưu trữ nó trong ứng dụng của mình. Theo mặc định, mã thông báo có hiệu lực trong 240 phút. [Bạn có thể chỉ định một giá trị thời gian chờ khác cho mã thông báo bằng cách gọi lệnh thiết lập cấu hình tsm để thay đổi wgserver. phiên họp. cài đặt idle_limit . ] Nếu ứng dụng của bạn cần có thể thực hiện thêm lệnh gọi sau khi mã thông báo hết hạn, bạn có thể gọi lại Đăng nhập và nhận mã thông báo xác thực mới.

Bạn bao gồm mã thông báo xác thực làm giá trị của tiêu đề X-Tableau-Auth cho tất cả lệnh gọi API REST khác. Ví dụ.

//10ay.online.tableau.com/api/3.18/auth/signin

0

Ghi chú. Mã thông báo hợp lệ cho các lệnh gọi API REST và truy vấn Tableau Metadata API [GraphQL]. Bạn không thể sử dụng mã thông báo làm xác thực cho các hoạt động khác với Tableau Server. Ngoài ra, mã thông báo chỉ tốt cho các hoạt động trong trang web mà bạn đã đăng nhập. Bạn không thể đăng nhập vào một trang web và sau đó sử dụng mã thông báo bạn nhận được để gửi yêu cầu đến một trang web khác. Nếu bạn làm như vậy, máy chủ sẽ trả về lỗi HTTP 403 [Bị cấm] .

Khi kết thúc một phiên, bạn gọi Đăng xuất . Điều này làm mất hiệu lực mã thông báo, điều này đảm bảo rằng không ai khác có thể sử dụng mã thông báo xác thực để thực hiện lệnh gọi tới API REST.

Mạo danh người dùng

Nếu bạn là quản trị viên hệ thống, bạn có thể đăng nhập bằng thông tin đăng nhập tên người dùng và mật khẩu của mình cho vai trò đó, sau đó mạo danh bất kỳ người dùng nào trên hệ thống. Điều này có thể hữu ích nếu quá trình đăng nhập đang được quản lý bởi một quy trình chạy với tư cách là một người dùng cụ thể [quản trị viên] nhưng cần có thể truy cập Máy chủ Tableau bằng các danh tính người dùng khác nhau

Khi bạn đăng nhập mạo danh người dùng, bạn sẽ có quyền của người dùng đó. Nếu người dùng không phải là quản trị viên, quyền của họ sẽ hạn chế khả năng thực hiện một số cuộc gọi REST của bạn

Để đăng nhập bằng cách mạo danh, bạn bao gồm phần tử người dùng trong phần thân yêu cầu và chỉ định ID người dùng Tableau Server [không phải tên] của .

//10ay.online.tableau.com/api/3.18/auth/signin

1

Hoặc trong JSON

//10ay.online.tableau.com/api/3.18/auth/signin

2

Bạn có thể lấy ID người dùng bằng cách sử dụng một trong các phương pháp sau

• Thêm người dùng vào trang web
• Nhận người dùng trên trang web
• Nhận người dùng trong nhóm

Ví dụ về Python để Đăng nhập và Đăng xuất [XML]

Ví dụ sau trong Python cho thấy cách sử dụng API REST để đăng nhập vào Tableau Server và lấy lại mã thông báo xác thực. Lưu ý những điều sau đây về ví dụ này

• Mã minh họa yêu cầu Đăng nhập và yêu cầu Đăng xuất

• Theo mặc định, đăng nhập của bạn sẽ sử dụng mã thông báo truy cập cá nhân cho thông tin đăng nhập xác thực. Bạn phải đặt

  //10ay.online.tableau.com/api/3.18/auth/signin

  06 thành

  //10ay.online.tableau.com/api/3.18/auth/signin

  07 để sử dụng tên người dùng và mật khẩu làm thông tin đăng nhập

• Bạn phải thay thế tên máy chủ của riêng bạn cho trình giữ chỗ

  //10ay.online.tableau.com/api/3.18/auth/signin

  08

• Bạn phải thay thế số phiên bản API của máy chủ của riêng bạn cho trình giữ chỗ

  //10ay.online.tableau.com/api/3.18/auth/signin

  09. Để tìm số phiên bản API của máy chủ của bạn, hãy xem REST API và Phiên bản tài nguyên

• Bạn phải thay thế các giá trị thông tin xác thực của riêng mình trong phần giữ chỗ

  //10ay.online.tableau.com/api/3.18/auth/signin

  50 và

  //10ay.online.tableau.com/api/3.18/auth/signin

  51 hoặc

  //10ay.online.tableau.com/api/3.18/auth/signin

  52 và

  //10ay.online.tableau.com/api/3.18/auth/signin

  53

• Mã tạo các yêu cầu HTTP bằng thư viện urllib2 được tích hợp trong Python. Sử dụng các yêu cầu HTTPS khi làm việc với Tableau Cloud hoặc Máy chủ Tableau được định cấu hình để sử dụng SSL

• Mã tạo và phân tích cú pháp khối JSON trong nội dung phản hồi bằng thư viện Yêu cầu và JSON. Để biết chi tiết, hãy xem tài liệu trên trang web Python

  URI của yêu cầu GET là gì?

  URI yêu cầu là mã định danh tài nguyên thống nhất của tài nguyên áp dụng yêu cầu . Mặc dù về mặt lý thuyết, URI có thể đề cập đến bộ định vị tài nguyên thống nhất [URL] hoặc tên tài nguyên thống nhất [URN], nhưng tại thời điểm hiện tại, URI hầu như luôn là URL HTTP tuân theo quy tắc cú pháp tiêu chuẩn của URL Web.

  Làm cách nào bạn có thể xác định xem hai URL khác nhau có tham chiếu đến cùng một tài nguyên hay không?

  Tùy chọn tốt nhất là tải xuống tài nguyên từ cả hai URL và xem liệu đó có phải là cùng một tài nguyên hay không bằng cách kiểm tra sự bằng nhau và giả sử rằng hai tài nguyên là cùng một tài nguyên nếu chúng giống nhau . .

  Tài nguyên trong một URL là gì?

  Đích của yêu cầu HTTP được gọi là "tài nguyên" mà bản chất của nó không được xác định thêm; . Mỗi tài nguyên được xác định bởi Mã định danh tài nguyên thống nhất [URI] được sử dụng trong HTTP để xác định tài nguyên.