新万博移动客户端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://
安装邮差:
- 下载邮差对应于您的操作系统。
- 安装邮差应用程序:
- 窗口:
- 运行安装程序。
- MacOS:
- 解压缩应用程序。
- 将应用程序移动到应用程序文件夹中。
- Linux:
- 将应用程序解压缩到首选文件夹中。
- 窗口:
有关其他安装说明,请参见邮差文档.
您可以使用邮差没有帐户。为此,单击跳过登录,直接带我进入应用程序链接在启动屏幕底部。
创建帐户将允许您跨设备和web客户端访问您的通话记录和保存的数据。
对于简单的API操作,我们将重点关注以下几个方面:
元素 |
的名字 |
描述 |
---|---|---|
1 |
方法 |
API方法的下拉列表。 |
2 |
URL |
API调用URL。 |
3. |
参数个数 |
请求的路径参数。 |
4 |
身体 |
请求的主体参数。 |
5 |
代码 |
请求的代码生成器。 |
邮差上门
给邮差打电话:
- 选择方法
- 输入URL
- 输入所需参数
- 点击发送.
得到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令牌。
- 一个Set-Cookie头,保存一个JSESSIONID饼干。
{"csrfToken": "3d13555d-f5e5-460c-85f4-6707cd5a0af0"}
响应代码:
代码 | 意义 |
---|---|
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调用。
这不是推荐的身份验证方法。使用身份验证资源。
邮差:
- 去授权选项卡。
- 从类型下拉菜单,选择基本认证.
- 进入用户名而且密码.
Postman将自动对值进行编码并创建一个头以包含授权关键。
要在代码中传递此信息,请包含一个头键授权
用值基本的< Base64_encoded_values >
.编码后的值为<用户名>:<密码>
.
curl -H '授权:基本QWRtaW46YWRtaW4='
下一个步骤
现在,您可以签入和签出Collibra数据智能云,接下来的教程将学习如何新万博移动客户端创建社区、域、资产以及如何通过Collibra REST API添加定义。
额外的资源狗万新闻c
- 在https://
/docs/index.html上查阅随您的Collib新万博移动客户端ra数据智能云版本提供的REST API文档。 - 读了新万博移动客户端Collibra JSON Web Token认证指南.
- 读了新万博移动客户端Collibra REST API认证与JSON Web令牌教程。
- 读了新万博移动客户端Collibra平台配置部分的文档。