登录

社交服务的认证流程涉及与 Matrix 服务器，它在底层用于私聊子系统。用户必须使用自己的地址登录 Matrix，并对一次获取操作进行签名以获得身份验证令牌。随后该令牌用于授权与社交服务的交互。

HTTP 请求

要获取身份验证令牌，如 Matrix 文档所述，需要向以下 URL 发起 POST 请求： https://social.decentraland.org/_matrix/client/r0/login 如下例所示。

要登录 Matrix，你需要使用 AuthChain 创建并签名一条消息。

请求体

{
  "auth_chain": authChain,
  "identifier": {
    "type": "m.id.user",
    "user": address
  },
  "timestamp": timestamp.toString(),
  "type": "m.login.decentraland"
}

响应体

{
  "user_id": "@0x123abC:decentraland.org",
  "social_user_id": "0x123abC",
  "access_token": "syt_SomETokEN",
  "device_id": "FRFREGRG",
  "home_server": "decentraland.org",
  "well_known": {
      "m.homeserver": {
          "base_url": "https://synapse.decentraland.org/"
      }
  }
}

位于 access_token 字段中的身份验证令牌，是后续与社交服务交互所必需的。

JS 代码示例

import fetch from 'cross-fetch'
import { AuthIdentity, Authenticator } from '@dcl/crypto'

export async function getMatrixToken(matrixUrl: string, address: string, identity: AuthIdentity): Promise<string> {
  const timestamp = Date.now()
  const authChain = Authenticator.signPayload(identity, timestamp.toString())

  try {
    const response = await fetch(`${matrixUrl}/_matrix/client/r0/login`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        auth_chain: authChain,
        identifier: {
          type: 'm.id.user',
          user: address
        },
        timestamp: timestamp.toString(),
        type: 'm.login.decentraland'
      })
    })

    if (response.ok) {
      const responseBody = await response.json()
      return responseBody.access_token
    } else {
      throw new Error(`Matrix server responded with a ${response.status} status code`)
    }
  } catch (error) {
    throw new MatrixLoginError(isErrorWithMessage(error) ? error.message : 'Unknown error')
  }
}

来自 social-rpc-client-js