メインコンテンツまでスキップ

GitHub を連携する

GitHub 組織に Takumi を連携すると、Takumi はプライベートリポジトリも診断可能になります。

Takumi が使う GitHub App​

GitHub のデータを Takumi と連携するには、GitHub 組織に GitHub App をインストールする必要があります。Takumi で使用する GitHub App は、リポジトリの読み取りのみを行う「Read 用」と、書き込みも行う「Write 用」の 2 種類があります。

種類用途連携
Read 用リポジトリのコードやプルリクエストの読み取り(診断、チャット、Dependabot PR の自動トリアージなど)必須
Write 用自動修正のプルリクエストの作成、Dependabot PR へのコメントと自動クローズ任意

Takumi による修正やプルリクエストの作成が不要で、診断のみを利用する場合は、Read 用の GitHub App のみを連携してください。

Write 用の GitHub App の連携について

自動修正のプルリクエストを作成する場合も、Takumi はまず Read 用の GitHub App を使用してリポジトリのデータを読み取ります。そのため、Write 用の GitHub App を連携する GitHub 組織とリポジトリには、Read 用の GitHub App も引き続き連携しておく必要があります。

連携手順​

Read 用の GitHub App は、以下の手順で連携できます。

  1. Shisho Cloud コンソールで 設定 > サービス連携 に移動してください。CSPM または WASPM を利用している組織では、続けて Takumi向け連携 タブを選択してください。
  2. GitHub のカードにある 設定 をクリックし、GitHub 連携のダイアログを開いてください。
  3. 新たなGitHub Organizationの追加 をクリックし、続けて GitHub App を新規インストールして連携 をクリックしてください。
  4. GitHub の画面で連携する GitHub 組織とリポジトリを選択し、Read 用の GitHub App をインストールしてください。

GitHub 組織に Read 用の GitHub App がすでにインストールされており、Shisho Cloud にはまだ連携されていない場合は、手順 3 で 既存の GitHub App を連携 をクリックしてください。連携可能な GitHub 組織が一覧表示されるので、対象の組織を選択してください。

GitHub 組織での権限によっては、GitHub App のインストールに組織オーナーの承認が必要となる場合があります。承認の流れについては、「外部連携を設定する > GitHub」をご参照ください。オーナーによる承認後は、既存の GitHub App を連携 から連携を行ってください。

GitHub App は 1 つの Shisho Cloud 組織にのみ紐づけられます

GitHub App は、1 つの Shisho Cloud 組織にのみ紐づけることができます。これは、お客様のセキュリティを保護するための仕様です。

複数の Shisho Cloud 組織への紐づけを許可すると、インストール済みの GitHub App を悪用し、お客様の意図しないところでリポジトリにアクセスできる別の Shisho Cloud 組織(シャドー組織)が作成されるリスクがあります。

そのため、原則として、1 法人につき 1 つの Shisho Cloud 組織での運用を推奨しています。

Slack のスコープ設定について

Takumi では Slack チャンネルごとに、アクセス可能なリポジトリを制限するスコープ設定が設けられています。そのため、GitHub 連携を完了しただけでは、Slack 経由で Takumi からリポジトリにアクセスすることはできません。

Slack 経由で Takumi を利用する場合は、GitHub 連携の完了後、「Takumi の Slack コマンドを使用する」を参考に、スコープ設定も行ってください。

Write 用の GitHub App の連携方法について

Write 用の GitHub App の連携方法については、「Dependabot PR 自動トリアージ」の「GitHub 書き込み権限の設定」をご参照ください。

Takumi byGMO App と Shisho Cloud App の違い​

Takumi では、2026 年 11 月より、Read 用の GitHub App として Takumi byGMO App の提供を開始しました。

従来、Read 用として使用していた Shisho Cloud App は、CSPM・WASPM と共通の GitHub App として、各サービスに必要な権限を備えていました。今回、Takumi 専用の Takumi byGMO App を新たに提供することで、Takumi の診断に必要な権限のみで連携できるようになりました。

Shisho Cloud App は引き続き利用できるため、Takumi byGMO App への切り替えは必須ではありません。ただし、CSPM・WASPM を利用していない場合は、より権限を限定できる Takumi byGMO App への切り替えをご検討ください。

Shisho Cloud App から切り替える​

Shisho Cloud コンソールには、Shisho Cloud App から Takumi byGMO App への切り替えを支援する機能があります。

この機能を使用すると、Shisho Cloud App で連携している GitHub 組織とリポジトリがあらかじめ選択された状態で、Takumi byGMO App のインストール画面が開きます。連携先の GitHub 組織やリポジトリを改めて確認・選択する手間を省き、スムーズに切り替えられます。

切り替えの手順は以下のとおりです。

  1. Shisho Cloud コンソールで 設定 > サービス連携 に移動してください。CSPM または WASPM を利用している組織では、続けて Takumi向け連携 タブを選択してください。
  2. GitHub のカードにある 設定 をクリックし、GitHub 連携のダイアログを開いてください。
  3. 切り替えたい GitHub 組織の Shisho Cloud App の連携で、設定を引き継いで Takumi byGMO App を連携 をクリックしてください。
  4. GitHub のインストール画面で、選択されている GitHub 組織とリポジトリを確認し、Takumi byGMO App をインストールしてください。

なお、Takumi byGMO App を連携しても、Shisho Cloud App の連携は自動的には削除されません。同じ GitHub 組織に両方の App が連携されていても問題はなく、Takumi は Takumi byGMO App を優先してリポジトリのデータを読み取ります。しかしながら、Takumi byGMO App での動作を確認し、問題がなければ、Shisho Cloud App の連携を削除することをおすすめします。

送信元 IP アドレス​

Takumi がホワイトボックス診断などでリポジトリへアクセスする際は、以下の送信元 IP アドレスを使用します。GitHub 組織で IP アドレスによるアクセス制限(IP allow list)を設定している場合は、以下の IP アドレスからのアクセスを許可してください。

34.97.228.101
13.113.43.245
18.178.91.176
54.150.4.178
54.168.46.6
54.248.85.10
143.189.213.53
57.181.160.191
13.193.20.236
13.192.129.171
35.73.41.87
13.193.159.19
54.95.249.68
3.115.77.204
13.158.171.234
35.72.197.30
52.192.245.72
13.196.117.140
54.168.104.163
13.197.87.202
35.73.247.65
34.104.221.59
info

この送信元 IP アドレスは予告なく変更される可能性があります。あらかじめご了承ください。

注意事項​

送信元 IP アドレスの固定について(ベータ機能)​

GitHub へのアクセス時に送信元 IP アドレスを固定する機能は、現在ベータ機能として提供しています。

ベータ機能のため、Takumi が GitHub に対して行うすべてのアクセスについて、送信元 IP アドレスの固定を保証するものではありません。GitHub 組織で IP アドレスによるアクセス制限(IP allow list)を設定する場合は、この点をご考慮ください。

また、送信元 IP アドレス固定の適用範囲は限定されており、機能ごとの対応状況についてはご案内できない場合があります。あらかじめご了承ください。