凭据指南
Adobe Experience Platform查询服务允许您与外部客户端连接。 您可以使用过期凭据或不过期凭据连接到这些外部客户端。
过期凭据 expiring-credentials
您可以使用过期凭据快速设置与外部客户端的连接。
此 过期凭据 部分提供了以下信息:
- 主机:要将客户端连接到的主机名称。 这会合并您的组织名称,如Platform UI顶部功能区中所示。
- 端口:要连接的主机端口号。
- 数据库:要连接客户端的数据库名称。
- 用户名:用于连接到查询服务的用户名。
- 密码:用于连接到查询服务的密码。 为了安全起见,UI中的密码已进行哈希处理。 选择复制图标( )以将完整的未散列凭据复制到剪贴板。
- PSQL命令:自动插入所有相关信息以供您在命令行中使用PSQL连接到Query Service的命令。
- 过期:过期凭据的过期日期和时间。 令牌的默认有效期为24小时,但可以在Admin Console的高级设置中更改。
未过期的凭据 non-expiring-credentials
您可以使用不会过期的凭据来设置与外部客户端的更永久的连接。
- 用户必须使用由以下组成的用户名和密码登录
{technicalAccountId}:{credential}
. 欲知更多信息,请参见 生成凭据 部分。 - 创建过期凭据后,将创建具有一组基本权限的新角色,该角色允许用户查看架构和数据集。 “管理查询”权限也已分配给此角色,以与查询服务一起使用。
- 当列出查询对象时,第三方客户端可能会执行与预期不同的操作。 例如,某些第三方客户,如 DB Visualizer 不会在左侧面板中显示视图名称。 但是,如果在SELECT查询中调用视图名称,则视图名称可访问。 同样地, PowerUI 可能不会列出通过SQL创建的要选择用于创建功能板的临时视图。
先决条件
在生成不会过期的凭据之前,必须在Adobe Admin Console中完成以下步骤:
- 登录 Adobe Admin Console 并从顶部导航栏中选择相关的组织。
- 选择产品配置文件。
- 配置两者 沙盒 和 管理查询服务集成 权限 用于产品配置文件。
- 将新用户添加到产品配置文件 因此授予了他们配置的权限。
- 将用户添加为产品配置文件管理员 允许为任何活动的产品配置文件创建帐户。
- 将用户添加为产品配置文件开发人员 以创建集成。
要详细了解如何分配权限,请阅读以下文档: 访问控制.
现在,已在Adobe Developer Console中配置了用户使用过期凭据功能所需的所有权限。
生成凭据 generate-credentials
要创建一组不会过期的凭据,请返回到Platform UI并选择 查询 从左侧导航访问 查询 工作区。 接下来,选择 凭据 选项卡,后接 生成凭据.
将出现一个对话框,允许您生成凭据。 要创建不会过期的凭据,必须提供以下详细信息:
- 名称:您生成的凭据的名称。
- 描述:(可选)对您生成的凭据的描述。
- 分派给:凭据将分配给的用户。 此值应为创建凭据的用户的电子邮件地址。
- 密码 (可选)凭据的可选密码。 如果未设置密码,Adobe将自动为您生成密码。
提供所有必需的详细信息后,选择 生成凭据 以生成您的凭据。
配置JSON文件包含技术帐户名称、技术帐户ID和凭据等信息。 提供时采用以下格式。
{"technicalAccountName":"9F0A21EE-B8F3-4165-9871-846D3C8BC49E@TECHACCT.ADOBE.COM","credential":"3d184fa9e0b94f33a7781905c05203ee","technicalAccountId":"4F2611B8613AA3670A495E55"}
保存生成的凭据后,选择 关闭. 您现在可以看到所有未过期的凭据的列表。
您可以编辑或删除未过期的凭据。 要编辑不会过期的凭据,请选择铅笔图标( )。要删除未过期的凭据,请选择删除图标( )。
编辑未过期的凭据时,将显示一个模式窗口。 您可以提供以下详细信息以进行更新:
- 名称:您生成的凭据的名称。
- 描述:(可选)对您生成的凭据的描述。
- 分派给:凭据将分配给的用户。 此值应为创建凭据的用户的电子邮件地址。
提供所有必需的详细信息后,选择 更新帐户 以完成凭据的更新。
使用凭据连接到外部客户端 use-credential-to-connect
您可以使用过期凭据或不过期凭据与外部客户端(例如Aqua Data Studio、Looker或Power BI)连接。 这些凭据的输入方法因外部客户端而异。 有关使用这些凭据的特定说明,请参阅外部客户端的文档。
该图像指示在UI中找到的每个参数的位置,但不会过期的凭据的密码除外。 虽然过期凭据由其JSON配置文件提供,但您可以在以下位置查看过期凭据: 凭据 选项卡。
下表概述了连接到外部客户端通常所需的参数。
输入用户名和密码的格式使用冒号分隔的值,如本示例所示
username:{your_username}
和 password:{password_string}
.要连接的服务器/主机的名称。
- 此值用于过期凭据和非过期凭据,其形式为
server.adobe.io
. 该值位于下 主机 在 过期凭据 部分。
acme.platform.adobe.io
要连接的服务器/主机的端口。
- 此值同时用于过期凭据和不过期凭据,可在以下位置找到 端口 在 过期凭据 部分。
80
要连接的数据库。
- 此值用于过期凭据和不过期凭据,并位于 数据库 在 过期凭据 部分。
prod:all
连接到外部客户端的用户名。
- 此值用于过期凭据和非过期凭据。 它以前采用字母数字字符串的形式
@AdobeOrg
. 此值位于 用户名.
ECBB80245ECFC73E8A095EC9@AdobeOrg
连接到外部客户端的用户的密码。
- 如果您使用的是过期凭据,则可在 密码 内部 过期凭据 部分。
- 如果您使用的是未过期的凭据,此值是来自technicalAccountID的拼接参数和从配置JSON文件获取的凭据。 密码值采用以下形式:
{technicalAccountId}:{credential}
.
- 即将过期的凭据密码包含超过一千个字符的字母数字字符串。 没有给出任何示例。
- 未过期的凭据密码如下:
4F2611B8613DK3670V495N55:3d182fa9e0b54f33a7881305c06203ee
后续步骤
现在,您已了解过期凭据和不过期凭据的工作方式,可以使用这些凭据连接到外部客户端。 有关外部客户端的详细信息,请阅读 连接客户端至查询服务指南.