用户账号OA SDK

更新时间：2020-03-13 10:13:54

OA SDK基于Oauth2.0协议，提供快速对接自有账号体系的能力，满足开发者在web应用开发中的账号对接需求。

名词

接入

下载SDK

下载地址

准备环境

在接入账号前，请先设置好环境信息。
参考自有账号体系配置。

前置依赖

1. 在pom.xml中添加依赖：

<dependency>
    <groupId>com.aliyun.api.gateway</groupId>
    <artifactId>sdk-core-java</artifactId>
    <version>1.1.0</version>
</dependency>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.52</version>
</dependency>

1. 引入API接口调用类

把工程中所有的api类OpenAccount_https_serviceApi.java文件复制到您的项目文件夹中；

1. 初始化通信通道类

要提交请求至阿里云API网关，您首选要将所有的通道类初始化。您可以参考工程中 OAuthDemo.java中的示例代码，使用对应的ClientBuilderParams类来初始化所有通道

接入总体流程

其中第3步的配置信息依赖开发者注册到IoT平台的配置，具体说明：自有账号体系配置。

流程说明

1. 三方账号自己登陆自己的服务器，拿到自己服务器签发的authcode；
2. 调用loginByOauth，通过授权方式去isv服务器做校验，并拿到用户的信息；
3. loginByOauth成功后会颁发token， 拿token再调用createSessionByAuthCode获得IoT平台的登录态信息。

loginByOauth调用说明

参考工程中OAuthDemo.java中的示例代码testALoginByOauthSync。
loginByOauthRequest参数的是JSON格式转义为字符串的形式，如下：

"{

\"authCode\":\"2c7360fa72f**9527testtest\",

\"oauthAppKey\":\"501709*11922\",

\"oauthPlateform\":23,

\"riskControlInfo\":{

\"signType\":\"RSA2\",

\"createAccountIfNotExist\":\"true\"

}

}"

参数说明

• authCode：服务器签发的一次性校验码

• oauthAppKey：阿里云IoT平台颁发的appkey

• oauthPlateform：固定填23

• riskControlInfo：风险控制信息，固定signType=RSA2, createAccountIfNotExist=true

响应示例

其中"token":"d1AryxFPSH6r*-test"为签发的token数据，1分钟有效，用于createSessionByAuthCode

{
    "code":1,
    "data":{
        "loginSuccessResult":{
            "oauthOtherInfo":{
                "platformType":23,
                "gender":"1",
                "iotOauthPlatform":23
            },
            "openAccount":{
                "createAppKey":"2582**232",
                "displayName":"陈**",
                "domainId":809***2100,
                "enableDevice":true,
                "gmtCreate":1552960125000,
                "gmtModified":1552960125000,
                "hasPassword":false,
                "id":4***37,
                "mobileConflictAccount":false,
                "mobileLocationCode":"86",
                "oauthPlateform":23,
                "openId":"5259**10-ac3f-448c-2***2-2233",
                "pwdVersion":0,
                "status":1,
                "subAccount":false,
                "type":0,
                "version":1
            },
            "token":"d1AryxFPSH6r*****-test"
        },
        "mobileBindRequired":false
    },
    "message":"SUCCESS",
    "subCode":0,
    "successful":true,
    "traceId":"0a98a36815538270858451413e78a1",
    "vid":"null"
}

服务器端错误（调用 API）

以下为API服务端错误，如果频繁错误，可联系服务商。

错误码

createSessionByAuthCode调用说明

调用示例：

//1. 拿到oa的token
String token = "loginByOAuth返回的token";
//2.通过oa的token去获取iottoken
IoTApiRequest request = new IoTApiRequest();
//设置api的版本
request.setApiVer("1.0.5");
JSONObject jsonObject = new JSONObject();
jsonObject.put("authCode", token);
jsonObject.put("appKey",this.appKey);

jsonObject.put("loginSource","openAccount");
jsonObject.put("accountType","OA_TOKEN");

request.putParam("request",jsonObject);
String path =  "/account/createSessionByAuthCode";

//请求参数域名、path、request
ApiResponse response = syncApiClient.postBody("api.link.aliyun.com", path, request, true);

返回值

{
    "id":"a2845614-7156-42ff-94f7-9bc8db03bfa1",
    "code":200,
    "data":{
        "identityId":"50f2op52a61e7d********aac900fd071323",
        "iotToken":"267f8002434befa7*******dde18a8",
        "refreshToken":"4DF38E239EA0********5262D9C15F",
        "iotTokenExpire":72000,
        "refreshTokenExpire":720000
    }
}