로그인

소셜 서비스의 인증 과정은 다음과 상호작용하는 것을 포함합니다 Matrix 서버 , 내부적으로 비공개 채팅 하위 시스템에서 사용됩니다. 사용자는 자신의 주소를 사용해 Matrix에 로그인하고, 인증 토큰을 얻기 위해 fetch 작업에 서명해야 합니다. 이 토큰은 이후 소셜 서비스와의 상호작용을 승인하는 데 사용됩니다.

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