新万博移动客户端Collibra REST API认证

在本教程中,您将安装Postman(一个API开发环境),并学习如何签入和签出Collibra数据智能云,以及如何验证当前会话是否经过身份验证。新万博移动客户端

几乎所有的Collibra API调新万博移动客户端用都需要身份验证。

curl -X POST \ https:///rest/2.0/auth/sessions \ -H 'Content-Type: application/json' \ -d '{"username": "", "password": ""}'

邮递员

如果您更喜欢使用其他应用程序,则可以跳过此步骤。

有些引用可能特定于Postman应用程序。

尽管REST API调用不一定需要一个特定的程序,而且可以直接从Collibra API文档中进行尝试,但是Postman可以充当HTTP客户端来发送请求和接收响应。新万博移动客户端

要尝试Collibra API文档中的API调用,请新万博移动客户端访问https:///docs/index.html。

安装邮差:

  1. 下载邮差对应于您的操作系统。
  2. 安装邮差应用程序:
    • 窗口:
      • 运行安装程序。
    • MacOS:
      • 解压缩应用程序。
      • 将应用程序移动到应用程序文件夹中。
    • Linux:
      • 将应用程序解压缩到首选文件夹中。

有关其他安装说明,请参见邮差文档

您可以使用邮差没有帐户。为此,单击跳过登录,直接带我进入应用程序链接在启动屏幕底部。

创建帐户将允许您跨设备和web客户端访问您的通话记录和保存的数据。

对于简单的API操作,我们将重点关注以下几个方面:

元素

的名字

描述

1

方法

API方法的下拉列表。

2

URL

API调用URL。

3.

参数个数

请求的路径参数。

4

身体

请求的主体参数。

5

代码

请求的代码生成器。

邮差上门

给邮差打电话:

  1. 选择方法
  2. 输入URL
  3. 输入所需参数
  4. 点击发送
得到https:// < your_dgc_environment_url > /休息/ 2.0 /应用程序/信息

您将在屏幕下半部分的response区域和状态代码中看到响应。

要了解有关状态代码的更多信息,请将指针悬停在状态上。

身份验证会话和REST安全性

新万博移动客户端Collibra为所有已登录的用户创建身份验证会话。您可以在Collibra Console中的Collibra配置的14.7节中配置会话空闲超时。新万博移动客户端首次登录后,aJSESSIONIDCookie与用户相关联。它用于在会话期间识别用户。

打包的会话空闲超时是API调用之间的30分钟。

根据您所连接的Collibra数据智能云的REST安全设置,您可能需要在请求头中提供额外的信息新万博移动客户端,例如CSRF令牌或引用URL。当您使用API身份验证资源

要配置REST安全选项,请转到Collibra Console中Collibra配置的14.3节新万博移动客户端

新万博移动客户端Collibra API认证会话

curl -X POST \ https:///rest/2.0/auth/sessions \ -H 'Content-Type: application/json' \ -d '{"username": "", "password": ""}'

来对用户进行身份验证JSESSIONIDcookie,在服务器上创建会话并获得CSRF令牌,使用身份验证资源。

文章https:// < your_dgc_environment_url > / rest / 2.0 /认证/会话

你必须提供用户名密码在JSON主体中。

{"username": "…","password": "…"}

回复包括:

  • 响应体中JSON格式的CSRF令牌。
  • {"csrfToken": "3d13555d-f5e5-460c-85f4-6707cd5a0af0"}
  • 一个Set-Cookie头,保存一个JSESSIONID饼干。

响应代码:

代码 意义
200 当前用户已通过认证。
401 用户名或密码错误。

要检查当前用户是否通过身份验证,请使用得到方法和/认证/会议/电流的端点身份验证资源。

得到https:// < your_dgc_environment_url > /休息/ 2.0 /认证/会议/电流
curl -X GET \ https:///rest/2.0/auth/sessions/current . curl -X GET \ https:///rest/2.0/auth/sessions/current . curl

响应代码:

代码 意义
200 当前用户认证成功。
401 当前用户没有进行认证。

要注销当前用户,请使用删除方法和/认证/会议/电流的端点身份验证资源。

删除https:// < your_dgc_environment_url > /休息/ 2.0 /认证/会议/电流
curl -X DELETE \ https:///rest/2.0/auth/sessions/current . curl -X DELETE \ https:///rest/2.0/auth/sessions/current . curl

响应代码:

代码 意义
204 当前用户已注销。
401 当前用户没有进行认证。

基本身份验证

您可以使用基本身份验证来执行一次性API调用。

这不是推荐的身份验证方法。使用身份验证资源。

邮差:

  1. 授权选项卡。
  2. 类型下拉菜单,选择基本认证
  3. 进入用户名而且密码

Postman将自动对值进行编码并创建一个头以包含授权关键。

要在代码中传递此信息,请包含一个头键授权用值基本的< Base64_encoded_values >.编码后的值为<用户名>:<密码>

curl -H '授权:基本QWRtaW46YWRtaW4='

下一个步骤

现在,您可以签入和签出Collibra数据智能云,接下来的教程将学习如何新万博移动客户端创建社区、域、资产以及如何通过Collibra REST API添加定义。

额外的资源狗万新闻c