管理个人访问令牌

需求

此功能需要优质及以上计划．

为工作区启用或禁用基于令牌的身份验证

对于2018年或以后创建的所有Databricks工作区，默认情况下启用了基于令牌的身份验证。您可以在管理控制台中更改此设置。要指定允许哪些用户使用令牌，请参见控制谁可以使用或创建令牌．

禁用为工作空间创建个人访问令牌的功能:

1. 去管理控制台．

2. 单击工作空间设置选项卡。

3. 单击个人访问令牌切换。

4. 点击确认．此更改可能需要几秒钟才能生效。

若要对REST API请求使用基于令牌的身份验证，请参见使用Databricks个人访问令牌进行身份验证．

在为工作区禁用基于令牌的身份验证时，不会删除任何令牌。如果稍后重新启用令牌，则任何未过期的令牌都可以立即使用。

如果您希望禁用用户子集的令牌访问，您可以为工作区保持启用基于令牌的身份验证，然后为用户和组设置细粒度的权限。看到控制谁可以使用或创建令牌．

您还可以使用REST API来进行此更改。要为工作区启用或禁用令牌管理特性，请调用令牌API的工作区配置（补丁/ workspace-conf)．在JSON请求体中，指定enableTokensConfig作为真正的(使)或假(禁用)。

例如，要启用该特性:

curl -X PATCH -n＼https:// < databricks-instance > / api / 2.0 / workspace-conf＼- d”{“enableTokensConfig”:“真正的”,} '

控制谁可以使用或创建令牌

用户可以拥有以下令牌权限之一:

• 没有权限

• 可以使用—用户是否可以使用个人访问令牌。对于Databricks平台3.28版本(2020年9月9日至15日)发布后创建的工作区，默认没有非adminbob体育客户端下载用户或组被授予Can Use权限。管理员必须显式地将“可以使用”权限授予用户、组或所有用户用户组。

  重要的

  在3.28发布之前创建的工作区维护已经存在的权限。之前的默认设置是所有用户都具有“Can Use”权限。管理员可以撤销该组权限，并将其授予其他组或个别非管理员用户。看到删除权限．

• 可以管理—用户或组是否可以管理个人访问令牌和权限。用户管理员组默认具有此权限，且不能撤销。没有其他组可以被授予此权限。API执行这些规则。

下表列出了每个令牌相关任务所需的权限:

标记为**的操作需要令牌管理API 2.0．

标记为***的操作可以在管理控制台中执行或使用权限API 2.0．看到控制谁可以使用或创建令牌．

curl -n -X GET“https:// < databricks-instance > / api / 2.0 /预览/权限/授权/令牌”

｛“object_id”：“授权/令牌”，“object_type”：“令牌”，“access_control_list”：［｛“user_name”：“jsmith@example.com”，“all_permissions”：［｛“permission_level”：“CAN_USE”，“继承”：假｝］｝］｝

curl -n -X PATCH“https:// < databricks-instance > / api / 2.0 /预览/权限/授权/令牌”- d”{“access_control_list”:(｛“user_name”:“jsmith@example.com”,:“permission_level CAN_USE”,}，｛组:“group_name mygroup”,:“permission_level CAN_USE”,｝］} '

｛“access_control_list”：［｛“user_name”：“jsmith@example.com”，“all_permissions”：［｛“permission_level”：“CAN_USE”，“继承”：假｝］}，｛“group_name”：组“mygroup”，“all_permissions”：［｛“permission_level”：“CAN_USE”，“继承”：假｝］｝］｝

curl -n -X PUT“https:// < databricks-instance > / api / 2.0 /预览/权限/授权/令牌”- d”{“access_control_list”:(｛:“group_name field-automation-group”,:“permission_level CAN_USE”,}，｛“group_name”:“管理员”,:“permission_level CAN_MANAGE”,}，］} '

设置新令牌的最大生存期(仅限REST API)

使用令牌api的工作区配置要管理此工作区中新令牌的最大生命周期。

要设置新令牌的最大生存期，请调用为新令牌API设置最大令牌生存期（补丁/ workspace-conf)．集maxTokenLifetimeDays到新令牌的最大令牌生命周期(以天为单位)，以整数形式表示。如果将其设置为0，则允许新的令牌没有生命期限制。

例如:

curl -n -X PATCH“https:// < databricks-instance > / api / 2.0 / workspace-conf”- d”{“maxTokenLifetimeDays”:“90”} '

要获得新令牌的工作空间的最大生存期，请调用令牌API的工作区配置（得到/ workspace-conf)和通过键= maxTokenLifetimeDays作为查询参数。响应包括maxTokenLifetimeDays属性，该属性是新令牌的最大令牌生命周期(以天为单位)，以整数表示。如果它为零，则允许新的令牌没有生命期限制。

例如:

curl -n -X GET“https:// < databricks-instance > / api / 2.0 / workspace-conf吗?键= maxTokenLifetimeDays”

示例响应:

｛“maxTokenLifetimeDays”：“90”｝

监视和撤销令牌(仅限REST API)

使用令牌管理api来管理工作区中的现有令牌。

curl -n -X GET“https:// < databricks-instance > / api / 2.0 /令牌管理/令牌”- d”{“created_by_id”:“1234567890”} '

｛“token_infos”：［｛“token_id”：“< token-id >”，“creation_time”：1580265020299，“expiry_time”：1580265020299，“评论”：“这是ABC部门的自动化脚本。”，“created_by_id”：1234567890，“created_by_username”：“jsmith@example.com”｝］｝

curl -n -X DELETE“https:// < databricks-instance > / api / 2.0 /令牌管理/令牌/ < token-id >”

起程拓殖集成

您可以在完全自动化的设置中使用Databricks Terraform提供商而且databricks_permissions如下。

资源"databricks_group" "auto" {display_name = "Automation"}资源"databricks_group" "eng" {display_name = "Engineering"}资源"databricks_permissions" "token_usage" {authorization = "tokens" access_control {group_name = "databricks_group .auto "。display_name permission_level = "CAN_USE"} access_control {group_name = databricks_group.eng. display_name permission_level = "CAN_USE"}display_name permission_level = "CAN_USE"}}