OAuth Status Management OAuth 상태 관리

🔄 Overview: WebXcom + DeOAuth Integration 🔄 개요: WebXcom + DeOAuth 통합

DeOAuth is integrated with the WebXcom platform to provide users with access control and authorization tokens based on WEB3.0 philosophy. Users have full control over their DeOAuth authorization tokens, including the ability to transfer access rights to others. DeOAuth는 WEB3.0 철학에 기반한 접근 제어와 인가 토큰을 제공하기 위해 WebXcom 플랫폼과 통합되어 있습니다. 사용자는 자신의 DeOAuth 인가 토큰을 완전히 제어할 수 있으며, 다른 사람에게 접근 권한을 이전할 수도 있습니다.

Key Concepts 핵심 개념

• User-Controlled Tokens: Users own and manage their authentication tokens 사용자 제어 토큰: 사용자가 자신의 인증 토큰을 소유하고 관리합니다
• Transferable Access Rights: OAuth permissions can be sold or transferred to others 이전 가능한 접근 권한: OAuth 권한을 판매하거나 다른 사람에게 이전할 수 있습니다
• Blockchain Verification: All transfers are recorded on the XOTN Network 블록체인 검증: 모든 이전 내역이 XOTN 네트워크에 기록됩니다
• Logout Verification: WebXcom verifies complete logout state before allowing transfers 로그아웃 검증: WebXcom이 이전 허용 전 완전한 로그아웃 상태를 확인합니다

🔐 Why Logout State Matters 🔐 로그아웃 상태가 중요한 이유

DeOAuth emphasizes the logout process more than the login process. When a user wants to transfer their OAuth information to someone else, the WebXcom platform must ensure the OAuth status is in a complete "Logged Out" state. DeOAuth는 로그인 과정보다 로그아웃 과정을 더 강조합니다. 사용자가 OAuth 정보를 다른 사람에게 전송하려면, WebXcom 플랫폼이 OAuth 상태가 완전한 "로그아웃" 상태인지 확인해야 합니다.

Transfer Flow 이전 흐름

API 1 Change Login Status 로그인 상태 변경

Update the user's OAuth status to "Logged In" on the WebXcom platform. This API notifies WebXcom that the user is currently accessing your application. 사용자의 OAuth 상태를 WebXcom 플랫폼에서 '로그인'으로 업데이트합니다. 이 API는 사용자가 현재 애플리케이션에 접근 중임을 WebXcom에 알립니다.

Request Headers 요청 헤더

Request Body 요청 본문

const response = await fetch('http://127.0.0.1:3000/v1/oauth/status/login', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    user_id: 'user-uuid-12345',
    client_id: 'your-client-id'
  })
});

const data = await response.json();
console.log('Login status updated:', data);

curl -X POST http://127.0.0.1:3000/v1/oauth/status/login \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user-uuid-12345",
    "client_id": "your-client-id"
  }'

import requests

response = requests.post(
    'http://127.0.0.1:3000/v1/oauth/status/login',
    headers={
        'Authorization': f'Bearer {access_token}',
        'Content-Type': 'application/json'
    },
    json={
        'user_id': 'user-uuid-12345',
        'client_id': 'your-client-id'
    }
)

data = response.json()
print('Login status updated:', data)

{
  "success": true,
  "message": "Login status updated successfully",
  "user_id": "user-uuid-12345",
  "status": "logged_in",
  "timestamp": "2026-02-05T13:45:30Z"
}

API 2 Change Logout Status 로그아웃 상태 변경

Update the user's OAuth status to "Logged Out" on the WebXcom platform. This is critical for enabling OAuth token transfers, as WebXcom requires verification of complete logout state before allowing marketplace listings. 사용자의 OAuth 상태를 WebXcom 플랫폼에서 '로그아웃'으로 업데이트합니다. 이는 OAuth 토큰 전송을 활성화하기 위해 매우 중요하며, WebXcom은 마켓플레이스 등록을 허용하기 전에 완전한 로그아웃 상태를 확인합니다.

Request Headers 요청 헤더

Request Body 요청 본문

const response = await fetch('http://127.0.0.1:3000/v1/oauth/status/logout', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    user_id: 'user-uuid-12345',
    client_id: 'your-client-id'
  })
});

const data = await response.json();
console.log('Logout status updated:', data);

if (data.success) {
  localStorage.removeItem('access_token');
  window.location.href = '/';
}

curl -X POST http://127.0.0.1:3000/v1/oauth/status/logout \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user-uuid-12345",
    "client_id": "your-client-id"
  }'

import requests

response = requests.post(
    'http://127.0.0.1:3000/v1/oauth/status/logout',
    headers={
        'Authorization': f'Bearer {access_token}',
        'Content-Type': 'application/json'
    },
    json={
        'user_id': 'user-uuid-12345',
        'client_id': 'your-client-id'
    }
)

data = response.json()
print('Logout status updated:', data)

if data['success']:
    # Clear local session
    session.clear()
    # Redirect to homepage
    return redirect('/')

{
  "success": true,
  "message": "Logout status updated successfully",
  "user_id": "user-uuid-12345",
  "status": "logged_out",
  "transfer_enabled": true,
  "timestamp": "2026-02-05T14:30:15Z"
}

🔒 Security Best Practices 🔒 보안 모범 사례

1. Always Validate Access Tokens 1. 항상 액세스 토큰 검증

Before calling status update APIs, verify that the access token is valid and belongs to the user making the request. 상태 업데이트 API를 호출하기 전에, 액세스 토큰이 유효하고 요청하는 사용자의 것인지 확인하세요.

async function validateToken(accessToken) {
  try {
    const response = await fetch('http://127.0.0.1:3000/v1/oauth/validate', {
      headers: { 'Authorization': `Bearer ${accessToken}` }
    });
    return response.ok;
  } catch (error) {
    console.error('Token validation failed:', error);
    return false;
  }
}

2. Sync Status Updates 2. 상태 업데이트 동기화

Call the login status API immediately after successful user authentication, and the logout status API immediately before destroying the user's session. 사용자 인증 성공 직후 로그인 상태 API를 호출하고, 사용자 세션을 삭제하기 직전에 로그아웃 상태 API를 호출하세요.

• On Login: Authenticate → Issue session → Update status → Redirect to dashboard 로그인 시: 인증 → 세션 발급 → 상태 업데이트 → 대시보드 이동
• On Logout: Update status → Clear session → Redirect to homepage 로그아웃 시: 상태 업데이트 → 세션 삭제 → 홈페이지 이동

3. Handle Errors Gracefully 3. 오류 우아하게 처리

If the status update API fails, log the error but don't block the user's login/logout flow. Implement retry logic with exponential backoff. 상태 업데이트 API가 실패하면 오류를 기록하되 사용자의 로그인/로그아웃 흐름을 차단하지 마세요. 지수 백오프를 사용한 재시도 로직을 구현하세요.

async function updateStatusWithRetry(endpoint, data, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(endpoint, {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${accessToken}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify(data)
      });
      
      if (response.ok) return await response.json();
      
    } catch (error) {
      console.error(`Attempt ${i + 1} failed:`, error);
      if (i < maxRetries - 1) {
        await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
      }
    }
  }
  throw new Error('Status update failed after retries');
}

4. Monitor Transfer Eligibility 4. 이전 자격 모니터링

Before listing OAuth tokens on the marketplace, verify the user's logout status with WebXcom. Display clear warnings if transfer is not yet enabled. 마켓플레이스에 OAuth 토큰을 등록하기 전에, WebXcom으로 사용자의 로그아웃 상태를 확인하세요. 전송이 아직 활성화되지 않은 경우 명확한 경고를 표시하세요.

🎯 Complete Implementation Example 🎯 완전한 구현 예시

Here's a complete Express.js implementation showing login, logout, and status synchronization: 로그인, 로그아웃, 상태 동기화를 보여주는 완전한 Express.js 구현 예시입니다:

const express = require('express');
const axios = require('axios');

const app = express();
const WEBXCOM_API = 'http://127.0.0.1:3000';

app.post('/login', async (req, res) => {
  try {
    const { email, password } = req.body;
    
    const authResponse = await axios.post(`${WEBXCOM_API}/v1/dev-user/login_devuser`, {
      email,
      password
    });
    
    const { token, uuid } = authResponse.data;
    
    req.session.userId = uuid;
    req.session.accessToken = token;
    
    await axios.post(`${WEBXCOM_API}/v1/oauth/status/login`, {
      user_id: uuid,
      client_id: process.env.CLIENT_ID
    }, {
      headers: { 'Authorization': `Bearer ${token}` }
    });
    
    res.json({ success: true, redirect: '/dashboard' });
    
  } catch (error) {
    console.error('Login failed:', error);
    res.status(401).json({ success: false, message: 'Authentication failed' });
  }
});

app.post('/logout', async (req, res) => {
  try {
    const { userId, accessToken } = req.session;
    
    await axios.post(`${WEBXCOM_API}/v1/oauth/status/logout`, {
      user_id: userId,
      client_id: process.env.CLIENT_ID
    }, {
      headers: { 'Authorization': `Bearer ${accessToken}` }
    });
    
    req.session.destroy();
    
    res.json({ success: true, redirect: '/' });
    
  } catch (error) {
    console.error('Logout status update failed:', error);
    req.session.destroy();
    res.json({ success: true, redirect: '/' });
  }
});

app.listen(3001, () => console.log('App running on port 3001'));