钱包授权 #

准备工作 #

iNF 钱包登录是基于OAuth2.0 协议标准构建的 OAuth2.0 授权登录系统。 在进行 OAuth2.0 授权登录接入之前，在盯链平台注册开发者帐号，并拥有一个已审核通过的应用，并获得相应的 AppID 和 AppSecret，可开始接入流程。

授权流程说明 #

OAuth2.0 授权登录让用户使用 iNF 钱包上的区块链身份安全登录第三方应用或网站，在用户授权登录已接入 iNF 钱包 OAuth2.0 的第三方应用后，第三方可以获取到用户的接口调用凭证access_token，通过access_token可以进行盯链开放平台授权关系接口调用，从而可实现获取 iNF 钱包 用户基本开放信息和帮助用户实现基础开放功能等。

iNF 钱包 OAuth2.0 授权登录目前支持 authorization_code 模式，适用于拥有 server 端的应用授权。该模式整体流程为：

1. 第三方应用发起钱包授权登录请求，根据授权请求参数跳转至 iNF 授权页面
2. iNF 钱包用户允许授权第三方应用后，会重定向到第三方网站，并且带上授权临时票据code参数
3. 通过 code 获取 access_token
4. 通过 access_token 进行接口调用，获取用户基本数据资源或帮助用户实现基本操作

获取 access_token 时序图：

获取 code #

H5 网页授权 #

在 H5 网页端进行重定向，跳转至以下地址：

https://redirect.inf.cool/loading?appid=APPID&chain_id=CHAINID&scope=SCOPE&redirect_uri=REDIRECT_URI&type=oauth&state=STATE&phone_number=PHONE_NUMBER&restricted=RESTRICTED

参数说明 #

返回说明 #

用户允许授权后，将会重定向到 redirect_uri 的网址上，并且带上 code 和 state 参数

redirect_uri?code=CODE&state=STATE

若用户禁止授权，则不会发生重定向。

PC 端网页授权 #

PC 授权需接入 SDK, 使用 iNF App 扫码授权

引入JS SDK

<script src="https://h5.inf.cool/inf.min%401.0.0.js"></script>

在合适位置放置页面容器

<div id="inf-oauth"></div>

调用 SDK 方法初始化

inf.authorize({
  selector: "#inf-oauth",
  width: "300px",
  height: "400px",
  background_color: "#fff",
  type: "oauth",
  color: "#000",
  appid: "APPID",
  redirect_uri: "REDIRECT_URI",
  state: "STATE",
  restricted: "RESTRICTED",
  scope: "SCOPE",
  chain_id: "CHAIN_ID",
  phone_number: "PHONE_NUMBER",
});

参数说明 #

仅列出 PC 端 授权 独有参数，其他参数与 H5 网页授权相同

返回说明 #

用户允许授权后，将会重定向到 redirect_uri 的网址上，并且带上 code 和 state 参数

redirect_uri?code=CODE&state=STATE

若用户禁止授权，则不会发生重定向。

小程序授权 #

打开 iNF 小程序授权

wx.openEmbeddedMiniProgram({
  appId: "wx5fbc0f1bcdc0193a",
  path: "pages/oauth/index?appid=APPID&chain_id=CHAINID&scope=SCOPE&redirect_uri=REDIRECT_URI&type=oauth&state=STATE&phone_number=PHONE_NUMBER&restricted=RESTRICTED",
});

参数说明 #

与 H5 网页授权相同

返回说明 #

授权后在 App onShow 生命周期回调 中可获取 code 及 state

onShow(e){
  const { code, state } = e?.referrerInfo?.extraData || {}
  console.log(code, state)
}

通过 code 获取 access_token #

• 请求 #

通过 code 获取 access_token:

https://inf-api.dingblock.tech/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE

参数说明 #

• 响应 #

{
  "res": {
    "access_token": "ACCESS_TOKEN",
    "expires_in": 7200,
    "refresh_token": "REFRESH_TOKEN",
    "openid": "OPENID",
    "scope": "SCOPE"
  },
  "code": 200
}

参数说明 #

错误返回样例：

{
  "msg": "invalid scope",
  "code": 500 // 错误码
}

通过 access_token 获取用户信息 #

获取 access_token 后，进行接口调用，有以下前提：

1. access_token 有效且未超时；
2. 用户已授权给第三方应用帐号相应作用域（scope）。

此接口用于获取用户个人信息。开发者可通过 openid 来获取用户基本信息。

• 请求 GET #

https://inf-api.dingblock.tech/oauth2/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&scope=SCOPE

参数说明 #

• 响应 #

  响应的数据由用户对第三方应用授权时的 scope 参数和请求参数中的 scope 决定，scope 作用域详见授权 scope )。

其中，identity和contact分别对应用户实名信息和用户手机号信息敏感字段，返回结果会进行 AES 加密，AES 密钥在盯链开放平台中获取。

{
  "res": {
    // scope含baseInfo时返回
    "baseInfo": {
      "openid": "OPENID",
      "walletAddress": "0x111111111111111111",
      "chainId": "conflux",
      "nickName": "昵称",
      "authLevel": 0
    },
    // scope含identity时返回
    "identity": {
      "name": "AES(姓名)",
      "idCard": "AES(身份证号)"
    },
    // scope含contact时返回
    "contact": {
      "phoneNumber": "AES(手机号)"
    }
  },
  "code": 200
}

刷新 access_token #

access_token 是调用授权关系接口的调用凭证，由于 access_token 有效期（目前为 2 个小时）较短，当 access_token 超时后，可以使用 refresh_token 进行刷新。

• 请求 #

  请求以下链接进行 refresh_token：

https://inf-api.dingblock.tech/oauth2/refresh_token?appid=APPID&refresh_token=REFRESH_TOKEN

参数说明 #

• 响应 #

{
  "access_token": "ACCESS_TOKEN",
  "expires_in": 7200,
  "refresh_token": "REFRESH_TOKEN",
  "openid": "OPENID",
  "scope": "SCOPE"
}

响应参数及错误情况同上

授权 Scope #

baseInfo #

identity #

contact #