Skip to main content

Integrate GitHub

info

The English user guide is currently in beta preview. Most of the documents have been automatically translated from the Japanese version. Should you find any inaccuracies, please reach out to Flatt Security.

When you connect Takumi to your GitHub organization, Takumi can also assess private repositories.

GitHub Apps Used by Takumi​

To connect GitHub data to Takumi, you need to install a GitHub App on your GitHub organization. Takumi uses two kinds of GitHub Apps: the "Read" app, which only reads repositories, and the "Write" app, which also writes to them.

KindPurposeIntegration
ReadReading the code and pull requests of repositories (assessments, chat, Dependabot PR auto-triage, etc.)Required
WriteCreating Autofix pull requests, and commenting on and auto-closing Dependabot PRsOptional

If you only use assessments and do not need Takumi to make fixes or create pull requests, integrate only the Read GitHub App.

Integrating the Write GitHub App

Even when Takumi creates an Autofix pull request, it first reads the repository data with the Read GitHub App. Therefore, keep the Read GitHub App integrated with the GitHub organizations and repositories you integrate with the Write GitHub App.

Integration Steps​

You can integrate the Read GitHub App with the following steps.

  1. In the Shisho Cloud console, go to Settings > Service Integrations. If your organization uses CSPM or WASPM, then select the Takumi Integrations tab.
  2. Click Settings on the GitHub card to open the GitHub integration dialog.
  3. Click Setup a new GitHub Organization, then click Install a GitHub App to integrate.
  4. On GitHub, choose the GitHub organization and repositories to integrate, and install the Read GitHub App.

If the Read GitHub App is already installed on your GitHub organization but not yet integrated with Shisho Cloud, click Integrate an existing GitHub App in step 3. The GitHub organizations you can integrate are listed, so choose the one you want.

Depending on your role in the GitHub organization, an organization owner may have to approve the installation of the GitHub App. For the approval flow, see "Configure External Integrations > GitHub". After the owner approves it, integrate it from Integrate an existing GitHub App.

A GitHub App can only be linked to one Shisho Cloud organization

A GitHub App can only be linked to one Shisho Cloud organization. This restriction is intended to protect your security.

If a GitHub App could be linked to multiple Shisho Cloud organizations, an installed GitHub App could be abused to create another Shisho Cloud organization (a shadow organization) that can access your repositories without your knowledge.

For this reason, we recommend operating with one Shisho Cloud organization per company.

Slack scope settings

Takumi has a scope setting for each Slack channel that limits which repositories it can access. Therefore, completing the GitHub integration alone does not allow Takumi to access repositories via Slack.

If you use Takumi via Slack, after completing the GitHub integration, also configure the scope settings by referring to "Using Takumi Slack Commands".

How to integrate the Write GitHub App

For how to integrate the Write GitHub App, see "Configuring GitHub Write Permissions" in "Dependabot PR Auto-Triage".

Differences Between the Takumi byGMO App and the Shisho Cloud App​

Since November 2026, Takumi has offered the Takumi byGMO App as its Read GitHub App.

The Shisho Cloud App, previously used as the Read app, is a GitHub App shared with CSPM and WASPM, with the permissions each service needs. With the new Takumi byGMO App, a GitHub App dedicated to Takumi, you can now integrate with only the permissions Takumi assessments need.

You can keep using the Shisho Cloud App, so switching to the Takumi byGMO App is not required. However, if you use neither CSPM nor WASPM, consider switching to the Takumi byGMO App, which narrows the permissions you grant.

Switch from the Shisho Cloud App​

The Shisho Cloud console has a feature that helps you switch from the Shisho Cloud App to the Takumi byGMO App.

With this feature, the Takumi byGMO App installation page opens with the GitHub organization and repositories of your Shisho Cloud App integration already selected. You do not have to look up and select them again, so you can switch smoothly.

You can switch with the following steps.

  1. In the Shisho Cloud console, go to Settings > Service Integrations. If your organization uses CSPM or WASPM, then select the Takumi Integrations tab.
  2. Click Settings on the GitHub card to open the GitHub integration dialog.
  3. On the Shisho Cloud App integration of the GitHub organization you want to switch, click Connect Takumi byGMO App with these settings.
  4. On the GitHub installation page, check the selected GitHub organization and repositories, and install the Takumi byGMO App.

Note that integrating the Takumi byGMO App does not delete the Shisho Cloud App integration automatically. Having both apps integrated with the same GitHub organization causes no problem, and Takumi reads repository data with the Takumi byGMO App first. However, after confirming that Takumi works with the Takumi byGMO App, we recommend deleting the Shisho Cloud App integration.

Source IP Addresses​

Takumi uses the following source IP addresses when it accesses your repositories, such as during whitebox assessments. If your GitHub organization restricts access with an IP allow list, allow access from the following IP addresses.

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

These source IP addresses may change without prior notice. We appreciate your understanding.

Important Notes​

Fixing Source IP Addresses (Beta)​

Fixing the source IP addresses used for GitHub access is currently offered as a beta feature.

Because it is a beta feature, we do not guarantee that all access Takumi makes to GitHub originates from these fixed source IP addresses. Please take this into account when you configure an IP allow list for your GitHub organization.

In addition, source IP address fixing applies to a limited scope, and we may be unable to provide details on which features are supported. We appreciate your understanding.