GitHub の設定ガイド

Code Tempo を利用するための GitHub OAuth 認証の設定手順、Organization へのアクセス許可、トラブルシューティングについて説明します。

Step 1: GitHub でログイン

Code Tempo のログインページにアクセスし、「GitHub でログイン」ボタンをクリックします。

ログインページにアクセス

Code Tempo のトップページから「ログイン」ボタンをクリックします。

GitHub の認可画面が表示される

GitHub にリダイレクトされ、Code Tempo へのアクセスを許可するかどうかの確認画面が表示されます。

「Authorize」をクリック

要求される権限を確認し、「Authorize code-tempo」ボタンをクリックして認可します。

Code Tempo にリダイレクト

認可が完了すると自動的に Code Tempo に戻り、ダッシュボードが表示されます。

認可スコープと必要な権限

認可画面では、Code Tempo が要求する権限（スコープ）が一覧表示されます。各スコープの目的は以下のとおりです。

スコープ	権限	目的
`read:user`	プロフィール読み取り	ユーザー名、アバターの表示
`user:email`	メール読み取り	アカウント識別
`repo`	リポジトリアクセス	コミット、PR、Issue の分析（読み取り専用で使用）
`read:org`	Organization 読み取り	所属 Organization のリポジトリ一覧取得
`read:project`	Projects 読み取り	GitHub Projects v2 の進捗分析

各スコープの詳細はCode Tempo と GitHub の関係をご覧ください。

Organization へのアクセス許可

Organization のリポジトリを分析するには、OAuth 認可時に追加の許可が必要です。

認可画面で Organization を確認

GitHub の認可画面の下部に、所属する Organization の一覧が表示されます。各 Organization の横に「Grant」または「Request」ボタンがあります。

「Grant」をクリックして許可

分析したい Organization の「Grant」ボタンをクリックします。Organization の管理者でない場合は「Request」をクリックすると、管理者に承認リクエストが送られます。

管理者による承認（Request の場合）

Organization の管理者が GitHub の Settings → Third-party access から承認すると、その Organization のリポジトリが利用可能になります。

Organization の許可を忘れた場合、後から追加することもできます。GitHub のSettings → Applications → Authorized OAuth Apps → Code Tempo から Organization のアクセスを管理できます。

複数 Organization の利用

Code Tempo は複数の Organization を横断して分析できます。以下の点に注意してください。

Organization ごとに許可が必要

各 Organization は個別にアクセス許可が必要です。認可画面または GitHub の設定から許可してください。

横断分析が可能

許可された全 Organization のリポジトリを統合して分析できます。ダッシュボードで一括表示されます。

権限は Organization 管理者が制御

Organization のオーナーまたは管理者が OAuth アプリのアクセスを許可・制限できます。

後から追加・削除が可能

Organization の許可はいつでも GitHub の設定から追加・取り消しができます。

認証エラーの対処法

ログインや認証で問題が発生した場合、以下の対処法をお試しください。

「認可に失敗しました」エラー

GitHub の認可画面で「Deny」をクリックした場合に表示されます。再度ログインページからやり直してください。

Organization のリポジトリが表示されない

Organization へのアクセスが許可されていない可能性があります。GitHub の Settings → Applications → Authorized OAuth Apps → Code Tempo から、対象 Organization の「Grant」をクリックしてください。

「登録が制限されています」エラー

現在、新規登録には招待コードが必要です。既存ユーザーから招待リンクを受け取ってからログインしてください。

セッション切れで再ログインが必要

セキュリティのため、セッションは 24 時間で有効期限が切れます。再度ログインページからログインしてください。

データが更新されない

GitHub API のレート制限に達している可能性があります。しばらく待ってからページを更新してください。通常は 1 時間以内に回復します。

アクセス権の取り消し

Code Tempo へのアクセス権はいつでも取り消すことができます。

GitHub の設定を開く

GitHub にログインし、右上のアバター → Settings をクリックします。

Applications を開く

左メニューの「Applications」をクリックし、「Authorized OAuth Apps」タブを選択します。

Code Tempo を取り消し

一覧から「Code Tempo」を見つけ、クリックして「Revoke access」ボタンを押します。

アクセス権を取り消すと、Code Tempo はデータを取得できなくなります。再度利用する場合はログインし直して再認可してください。