已连接应用的访问范围

相关文章推荐

留胡子的汤圆 · SharePoint 搜索 REST ...· 2 月前 ·

强悍的创口贴 · 使用 Java 管理 Blob ...· 2 周前 ·

耍酷的啄木鸟 · Imports - Post Import ...· 2 周前 ·

路过的皮带 · 原创｜最美红叶将在巫山定格（点文末H5赢神女 ...· 8 月前 ·

求醉的杯子 · 沈阳地铁二号线南延线最新进展来了！_施工_区 ...· 1 年前 ·

憨厚的长颈鹿 · “星辰”闪耀 ...· 1 年前 ·

焦虑的灯泡 · 电动皮卡来了，江铃域虎EV补贴前售24.8万 ...· 1 年前 ·

坚韧的开心果 · 「没有未来的未来不是我想要的未来」境界的彼方 ...· 1 年前 ·

</noscript><div id="app" class="wrapper"><header id="tableau-help-article-header" class="container--full-width quick-help-header"><div class="container--centered"><div class="header__back-button"><back-button title="Go back"/></div><div class="header__mobile-menu quick-help-hidden"><menu-tree-toggle/></div><div class="header__logo quick-help-hidden"><a href="https://www.tableau.com/zh-cn/"><img src="./Resources/tableau-logo.png" class="header__logo__img" alt="Tableau"/></a></div><div class="header__search"><search-header-help placeholder="搜索"/></div><div class="header__home-button"><home-button title="Go home"/></div></div></header><div class="container--navigation-top quick-help-hidden content-only-hidden"><div id="help-subheader" class="subheader print-hidden"><div class="container--centered"><h4 class="heading--subheader">Windows 版 Tableau Server 帮助</h4></div></div><div class="container--top-links"><div class="container--centered container--breadcrumbs"><div><breadcrumb-links-help/></div></div><div id="help-container-menu-headings" class="container--menu-headings"><nav class="nav-medium-screen"><menu-heading-links-static-help menu-title="本文内容" :disabled="false" :headings="pageHeadings"/></nav></div></div></div><div class="section--main container--full-width"><div class="container--centered"><nav class="nav-side nav-side--left" role="navigation"><menu-tree-help menu-title="内容"/></nav><article role="main"><h1 id="contentH1"/><div class="caption article__tags content-only-hidden quick-help-hidden"><span class="article__tags--applies-to">适用于： Tableau Cloud, Tableau Server</span><br/><span class="article__tags--role"> </span></div><div xmlns:madcap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" id="content-body">&#13; <div role="main" id="mc-main-content"><p><conditionaltext data-mc-conditions="Product.serverserver">从 <span class="VariablesTabsProductServer">Tableau Server</span> 版本 2022.3</conditionaltext> 开始，使用 Tableau 已连接应用，您可以代表 <span class="VariablesProductName">Tableau Server</span> 用户，通过自定义应用程序以编程方式调用和访问 Tableau REST API。对 REST API 的访问由定义为初始登录请求的一部分的 JSON Web 令牌 (JWT) 启用。JWT 必须包含对自定义应用程序及其用户可通过已连接应用使用的 REST API 方法进行定义的范围。</p><p>授权使用已连接应用访问 REST API 以：</p><ul><li value="1" data-mc-conditions="Product.serverserver">增强安全性 - 使用 JWT 作为不记名令牌本质上比通过 .env 文件在保管库中存储和管理管理员用户密码更安全</li><li value="2">提高效率 — 使用 JWT 作为持有者令牌，只需向登录端点发出一个请求（而不是两个请求），从而可以简化模拟</li><li value="3">扩展和自动完成复杂的 Tableau 集成和后端查询，例如动态内容检索和高级筛选</li></ul><p><b>范围操作</b></p><p>已连接应用使用范围通过<a href="#scopes" class="MCXref xref">支持 JWT 授权的 REST API 方法</a>（见下文）授予对内容或管理操作的访问权限。范围是一个以冒号分隔的字符串，以命名空间 <code>tableau</code> 开头，后跟被授予访问权限的 Tableau 资源，例如 <code>datasources</code>,并以允许对资源执行的操作结尾，例如 <code>update</code>。</p><p>范围可进行的操作包括：</p><ul><li value="1"><code>create</code></li><li value="2"><code>read</code></li><li value="3"><code>run</code></li><li value="4"><code>update</code></li><li value="5"><code>download</code></li><li value="6"><code>delete</code></li></ul><p>例如，允许您的自定义应用程序调用<a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_data_sources.htm#update_data_source" target="_blank">更新数据源<span class="sr-only">(链接在新窗口中打开)</span></a>方法的范围如下所示：</p><p><code>tableau:datasources:update</code></p><p><a name="type"/><b>范围类型</b></p><p>您使用的范围类型取决于您要启用的内容或管理操作。范围通常属于以下类型之一：内容读取、个人、通配符和跨类别。</p><ul><li value="1"><p><b>内容读取范围：</b>内容读取范围 <code>tableau:content:read</code> 为 Tableau 内容启用受支持的 GET 方法。使用此范围时，您可以跨 REST API 类别启用操作。更具体地说，使用此范围可以为数据源、指标、视图、工作簿、项目和站点启用 GET 方法。</p><p><b>注意：</b>若要为用户和组等管理操作启用 GET 方法，您可以使用它们的单独范围。</p></li><li value="2"><p><b>单独范围：</b>若要启用受支持的内容和管理操作，您可以使用它们的单独范围。单独范围通常与单个方法和 REST API 类别相关联。</p><p>示例：</p><ul><li value="1">若要启用发布或更新数据源操作，您可以分别使用单独的 <code>tableau:datasources:create</code> 或 <code>tableau:datasources:update</code> 范围。</li><li value="2">对于添加或移除用户等管理操作，您可以分别使用单独的 <code>tableau:users:create</code> 或<code>tableau:users:delete</code> 范围。</li></ul><p><b>注意：</b>有一些单独的范围可以跨 REST API 类别启用操作。例如，<code>tableau:views:download</code>在视图数据和工作簿 REST API 类别中启用操作。</p></li><li value="3"><p><b>通配符范围：</b>对于某些范围，您可以将操作替换为通配符 (*)，以启用特定 REST API 类别中支持的操作。</p><p>示例：</p><ul><li value="1">您可以使用 <code>tableau:projects:*</code> 通配符范围，用于在项目 REST API 类别中启用创建、删除和更新操作。</li><li value="2">您可以使用 <code>tableau:users:*</code>通配符范围启用用户 REST API 类别中的查询、添加、删除、更新操作。</li></ul></li><li value="4"><p><b>跨类别范围：</b>除了内容读取范围之外，还有一些额外的范围，如果使用它们，则支持跨不同 REST API 类别的操作。</p><p>示例：</p><ul><li value="1">如果使用 <code>tableau:tasks:run</code> 范围，您可以在数据源和工作簿 REST API 类别中启用操作。</li><li value="2">同样，如果使用 <code>tableau:views:download</code> 范围，您可以在视图数据和工作簿 REST API 类别中启用操作。</li><li value="3">如果使用权限范围 <code>tableau:permissions:update</code> 或 <code>tableau:permissions:delete</code>，您在数据源、工作簿和项目 REST API 类别中启用操作。</li></ul></li></ul><h2 is="heading-item" :level="2" id="有关如何授权-rest-api-访问的摘要">有关如何授权 REST API 访问的摘要</h2><p>以下列表总结了通过 JWT 请求访问 REST API 的步骤：</p><ol><li value="1">使用以下方法之一<b>创建已连接应用</b>：<ul><li value="1" data-mc-conditions="Product.serverserver"><a href="connected_apps.htm" class="MCXref xref">配置 Tableau 已连接应用以启用嵌入内容的 SSO</a></li><li value="2"><a href="connected_apps_eas.htm" class="MCXref xref">注册 EAS 以启用嵌入内容的 SSO</a></li></ul></li><li value="2"><b>生成有效的 JWT</b> — 在运行时，您的自定义应用程序将生成一个有效的 JWT，并使用您包含的范围进行配置</li><li value="3"><b>发出<a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_ref_authentication.htm#sign_in" target="_blank" style="font-weight: bold;">登录<span class="sr-only">(链接在新窗口中打开)</span></a>请求</b> — 您的自定义应用程序将使用 JWT 发出登录请求以返回 Tableau 访问令牌和站点 ID (LUID)</li><li value="4"><b>在后续请求中使用 Tableau 访问令牌</b> — 在后续 REST API 调用中，使用 1) Tableau 访问令牌作为 <a href="https://help.tableau.com/current/api/rest_api/zh-cn/REST/rest_api_concepts_auth.htm#using_auth_token" target="_blank"><code>X-Tableau-Auth</code><span class="sr-only">(链接在新窗口中打开)</span></a> 标头值，以及 2) 使用请求 URI 中的站点 ID (LUID)</li></ol><h3 is="heading-item" :level="3" id="示例">示例</h3><p>例如，假设您使用直接信任创建已连接应用。使用直接信任，调用 REST API 的自定义应用程序使用已连接应用生成的客户端 ID 和客户端密文生成有效的 JWT。</p><p><b>JWT 中的范围</b></p><p>若要成功授权对 REST API 的访问，JWT 还必须包含定义 REST API 能力的范围。例如，若要启用各种与数据源相关的方法，您可能会在 JWT 中包含以下范围：</p><p><code>"tableau:content:read","tableau:datasources:create","tableau:datasources:update","tableau:datasources:download","tableau:tasks:run"</code></p><p>或者</p><p><code>"tableau:content:read","tableau:datasources:*","tableau:tasks:run"</code></p><p><b>注意：</b>范围值必须以列表类型方式传递。</p><p><b>登录请求 URI</b></p><p>若要调用 REST API，自定义应用程序必须首先发出登录请求以生成 Tableau 访问令牌。</p><pre xml:space="preserve" data-mc-conditions="Product.serverserver"><code>POST https://myco/api/3.17/auth/signin</code></pre><p><b>请求正文</b></p><p>若要使用 JWT 授权 REST API 访问，登录请求正文必须包含有效的 JWT，如下例所示。</p><pre><code>&lt;tsRequest&gt;&#13; &lt;credentials jwt="eyJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJhbGciOiJIUzI1NiIsImtpZCI6ImIwMTE1YmY5LTNhNGItNGM5MS1iMDA5LWNmMGMxNzBiMWE1NiJ9.eyJhdWQiOiJ0YWJsZWF1Iiwic3ViIjoicm1vaGFuQHRhYmxlYXUuY29tIiwic2NwIjpbInRhYmxlYXU6c2l0ZXM6cmVhZCJdLCJpc3MiOiI4ZTFiNzE3Mi0zOWMzLTRhMzItODg3ZS1mYzJiNDExOWY1NmQiLCJleHAiOjE2NDg2Njg0MzksImp0aSI6IjY1ZWFmMmYxLTNmZTgtNDc5Ny1hZmRiLTMyODMzZDVmZGJkYSJ9.mUv2o4gtBTrMVLEXY5XTpzDQTGvfE2LGi-3O2vdGfT8"&gt;&#13; &lt;site contentUrl="mycodotcom"/&gt;&#13; &lt;/credentials&gt;&#13; &lt;/tsRequest&gt;&#13; </code></pre><p><b>响应正文</b></p><p>登录请求会生成以下响应正文，其中包括 Tableau 访问令牌。</p><pre><code>&lt;tsResponse&gt;&#13;