Skip to main content
版本:Next(1.7.0)

登录文档

1.对接LDAP服务

进入/conf目录,执行命令:

    vim linkis-mg-gateway.properties

添加LDAP相关配置:

wds.linkis.ldap.proxy.url=ldap://127.0.0.1:1389/ # 您的LDAP服务URL
wds.linkis.ldap.proxy.baseDN=dc=webank,dc=com # 您的LDAP服务的配置

2.免登录配置

如何打开测试模式,实现免登录?进入/conf目录,执行命令:

     vim linkis-mg-gateway.properties

将测试模式打开,参数如下:

    wds.linkis.test.mode=true   # 打开测试模式
wds.linkis.test.user=hadoop # 指定测试模式下,所有请求都代理给哪个用户

3.登录接口汇总

我们提供以下几个与登录相关的接口:

  • 登录
  • 登出
  • 心跳

4.接口详解

  • Linkis Restful接口的返回,都遵循以下的标准返回格式:
{
"method": "",
"status": 0,
"message": "",
"data": {}
}

约定

  • method:返回请求的Restful API URI,主要是 WebSocket 模式需要使用。
  • status:返回状态信息,其中:-1表示没有登录,0表示成功,1表示错误,2表示验证失败,3表示没该接口的访问权限。
  • data:返回具体的数据。
  • message:返回请求的提示信息。如果status非0时,message返回的是错误信息,其中data有可能存在stack字段,返回具体的堆栈信息。

更多关于 Linkis Restful 接口的规范,请参考:Linkis Restful 接口规范

4.1 登录

  • 接口 /api/rest_j/v1/user/login

  • 提交方式 POST

      {
"userName": "",
"password": ""
}
  • 返回示例
    {
"method": null,
"status": 0,
"message": "login successful(登录成功)!",
"data": {
"isAdmin": false,
"userName": ""
}
}

其中:

  • isAdmin: Linkis只有admin用户和非admin用户,admin用户的唯一特权,就是支持在Linkis管理台查看所有用户的历史任务。

4.2 登出

  • 接口 /api/rest_j/v1/user/logout

  • 提交方式 POST

    无参数

  • 返回示例

    {
"method": "/api/rest_j/v1/user/logout",
"status": 0,
"message": "退出登录成功!"
}

4.3 心跳

  • 接口 /api/rest_j/v1/user/heartbeat

  • 提交方式 POST

    无参数

  • 返回示例

    {
"method": "/api/rest_j/v1/user/heartbeat",
"status": 0,
"message": "维系心跳成功!"
}