1
2
3
4

1. "New GitHub App" 생성
2. 앱 이름, 설명, 웹훅 URL, 권한 설정
3. 조직/사용자가 리포지토리에 설치 (설치 범위 선택)
4. 필요 시 사용자 on-behalf 권한 부여

1
2
3
4

1. "New OAuth App" 생성
2. Client ID / Client Secret / Redirect URI 지정
3. 사용자가 승인 (Authorize)
4. 승인된 사용자 계정의 모든 접근 가능한 Repo 사용 가능

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

const jwt = require('jsonwebtoken');
const axios = require('axios');
const fs = require('fs');

// Private Key로 JWT 생성
function generateJWT(appId, privateKeyPath) {
  const privateKey = fs.readFileSync(privateKeyPath, 'utf8');
  const payload = {
    iat: Math.floor(Date.now() / 1000) - 60,  // 현재 시간 - 60초
    exp: Math.floor(Date.now() / 1000) + 600, // 10분 유효
    iss: appId
  };
  return jwt.sign(payload, privateKey, { algorithm: 'RS256' });
}

// Installation Token 발급
async function getInstallationToken(appId, installationId, privateKeyPath) {
  const jwtToken = generateJWT(appId, privateKeyPath);

  const response = await axios.post(
    `https://api.github.com/app/installations/${installationId}/access_tokens`,
    {},
    {
      headers: {
        'Authorization': `Bearer ${jwtToken}`,
        'Accept': 'application/vnd.github.v3+json'
      }
    }
  );

  return response.data.token; // 약 1시간 유효
}

// API 호출 예시
async function createIssue(installationToken, owner, repo, title, body) {
  const response = await axios.post(
    `https://api.github.com/repos/${owner}/${repo}/issues`,
    { title, body },
    {
      headers: {
        'Authorization': `token ${installationToken}`,
        'Accept': 'application/vnd.github.v3+json'
      }
    }
  );
  return response.data;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  const digest = 'sha256=' + hmac.update(payload).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(digest)
  );
}

// Express.js 예시
app.post('/webhook', (req, res) => {
  const signature = req.headers['x-hub-signature-256'];
  const isValid = verifyWebhookSignature(
    JSON.stringify(req.body),
    signature,
    process.env.WEBHOOK_SECRET
  );

  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }

  // 이벤트 처리
  const event = req.headers['x-github-event'];
  if (event === 'issues') {
    console.log('Issue event:', req.body.action);
    // 자동화 로직 실행
  }

  res.status(200).send('OK');
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

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

const CLIENT_ID = process.env.GITHUB_CLIENT_ID;
const CLIENT_SECRET = process.env.GITHUB_CLIENT_SECRET;
const REDIRECT_URI = 'http://localhost:3000/callback';

// 1단계: 사용자 인증 요청
app.get('/login', (req, res) => {
  const authUrl = `https://github.com/login/oauth/authorize?` +
    `client_id=${CLIENT_ID}&` +
    `redirect_uri=${REDIRECT_URI}&` +
    `scope=repo,user`;
  res.redirect(authUrl);
});

// 2단계: 콜백 처리 및 토큰 교환
app.get('/callback', async (req, res) => {
  const code = req.query.code;

  try {
    // Authorization Code를 Access Token으로 교환
    const tokenResponse = await axios.post(
      'https://github.com/login/oauth/access_token',
      {
        client_id: CLIENT_ID,
        client_secret: CLIENT_SECRET,
        code: code,
        redirect_uri: REDIRECT_URI
      },
      {
        headers: { 'Accept': 'application/json' }
      }
    );

    const accessToken = tokenResponse.data.access_token;

    // 3단계: 사용자 정보 조회
    const userResponse = await axios.get('https://api.github.com/user', {
      headers: {
        'Authorization': `token ${accessToken}`,
        'Accept': 'application/vnd.github.v3+json'
      }
    });

    res.json({
      user: userResponse.data,
      token: accessToken  // 주의: 실제로는 안전하게 저장해야 함
    });
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
});

// 4단계: API 호출 (사용자 권한으로)
async function getUserRepositories(accessToken) {
  const response = await axios.get('https://api.github.com/user/repos', {
    headers: {
      'Authorization': `token ${accessToken}`,
      'Accept': 'application/vnd.github.v3+json'
    },
    params: {
      sort: 'updated',
      per_page: 100
    }
  });
  return response.data;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

// Webhook 처리 예시
app.post('/webhook', async (req, res) => {
  const event = req.headers['x-github-event'];

  if (event === 'push') {
    // 빌드 트리거
    await triggerBuild(req.body.repository);
  } else if (event === 'pull_request' && req.body.action === 'opened') {
    // PR 자동 검토 코멘트
    await addPRComment(req.body.pull_request);
  }

  res.status(200).send('OK');
});

1
2
3
4
5
6
7

// 로그인 버튼 클릭 시
function loginWithGitHub() {
  window.location.href =
    'https://github.com/login/oauth/authorize?' +
    `client_id=${CLIENT_ID}&` +
    `scope=read:user,user:email`;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

app.post('/webhook', async (req, res) => {
  if (req.body.action === 'opened' && req.headers['x-github-event'] === 'pull_request') {
    const { pull_request, repository } = req.body;

    // AI 코드 분석
    const analysis = await analyzeCode(pull_request.diff_url);

    // 리뷰 코멘트 생성
    await createReview({
      owner: repository.owner.login,
      repo: repository.name,
      pull_number: pull_request.number,
      comments: analysis.comments,
      event: analysis.approved ? 'APPROVE' : 'REQUEST_CHANGES'
    });
  }

  res.status(200).send('OK');
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

// 토큰 캐싱 및 자동 갱신 예시
let cachedToken = null;
let tokenExpiry = null;

async function getValidToken(appId, installationId, privateKey) {
  const now = Date.now();

  if (cachedToken && tokenExpiry > now + 60000) {
    return cachedToken; // 1분 이상 남았으면 재사용
  }

  // 새 토큰 발급
  cachedToken = await getInstallationToken(appId, installationId, privateKey);
  tokenExpiry = now + 3600000; // 1시간 후 만료

  return cachedToken;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

// ❌ 위험: 서명 검증 없음
app.post('/webhook', (req, res) => {
  // 누구나 이 엔드포인트로 임의의 데이터를 보낼 수 있음!
  processEvent(req.body);
});

// ✅ 안전: 서명 검증 포함
app.post('/webhook', (req, res) => {
  const signature = req.headers['x-hub-signature-256'];
  if (!verifySignature(req.body, signature, WEBHOOK_SECRET)) {
    return res.status(401).send('Invalid signature');
  }
  processEvent(req.body);
});