GitHub:App Activities 連携の設定

この記事では、GitHub の App Activities 連携の設定方法について説明します。

概要

App Activities は、接続された SaaS アプリケーションにおける全てのユーザーの活動のバンド外可視性を提供する API ベースのソリューションです。 アプリ内のデータの可視性を App Activities に提供するには、必要なアプリケーションと統合を設定する必要があります。 統合を作成した後、フィールドが変更または期限切れになった場合は、リソース >統合 >統合されたアプリページから編集できます。 詳細は、APIによるアプリ活動のアプリケーション制御とは何かをご覧ください。

Appアクティビティ統合を設定するには、次の手順を実行してください:

  1. SaaSアプリケーション内で統合を設定します

  2. CMAでAPIコネクタを作成します

App Activities には CASB ライセンスが必要です。 このライセンスには、APIを通じたアプリとデータの制御およびアプリ活動が含まれます。 CASB ライセンスの購入についての詳細は、Cato の担当者にお問い合わせください。

GitHubの接続の利点

このコネクタを作成すると、GitHub環境内の活動を表示および監視できます。 例えば、

  • ユーザーのログイン

  • リポジトリのクローン作成

  • コミット

  • プルリクエスト

  • リポジトリ/組織設定の変更

  • コード/脆弱性スキャンの警告

これにより、不審な活動を特定し対応することができ、これらの活動に関して警告を受け取ることができます。

  • コードセキュリティスキャン

  • 脆弱性(Dependabot)スキャン

  • 秘密スキャン

GitHub統合の設定

GitHub インテグレーションを設定するには、新しいパーソナルアクセストークンを作成します。

前提条件

  • GitHub Enterprise ライセンスを購入している必要があります

  • これらのスコープ(権限)が提供されます:

    • User - read:user

    • Audit_log - read:audit_log

    • Org - read:org

    • Enterprise - read:enterprise

    • リポジトリ - セキュリティイベント:参照のみ

注意

注: 2026年3月から、GitHubコネクタは、監査およびクロスプラットフォーム相関のためにセキュリティイベントを収集できます。 2026年3月以前にこのコネクタを作成した場合、追加のsecurity_events:参照のみスコープを使用してアクセストークンを再生成し、CMAに新しいトークンを追加する必要があります。

アクセストークンを再生成するには、GitHubの開発者センターでCato統合に使用する既存のトークンを選択します。 トークンを再生成をクリックし、リポジトリセクションでsecurity_events:参照のみが選択されていることを確認します。 トークンを再生成をクリックして変更を適用します。 以下のステップ2に従って新しいトークンをCMAに追加します。

ステップ1: GitHub Developer Centerで統合を設定

GitHub デベロッパーセンターで、CMAに入力するアクセストークンを特定します。

GitHub インテグレーションの設定方法:

  1. GitHub Developer Center で、Personal access tokens > Tokens (classic) に移動します。

  2. Generate new token をクリックします。

  3. トークンの有効期限を設定します。

    有効期限を 1 年間とする最大許容期間に設定することをお勧めします。

  4. 上記のスコープを追加します。

  5. Generate token をクリックします。

  6. 新しいアクセストークンをコピーして保存し、CMA に追加できるようにします。

  7. Settings > Enterprises に移動します。

  8. あなたの企業の名前をクリックします。

    あなたの企業のログインページが表示されます。

  9. URL の最後のセグメントをコピーして保存し、CMA に追加できるようにします。 例として、URL https://github.com/enterprises/cato の場合、cato をコピーして保存します。

ステップ2: CMAでAPIコネクタを作成

必要なアプリケーションとの統合を設定した後、CMAに詳細を追加します。

CMAでAPIコネクタを作成するには:

  1. ナビゲーションメニューから、リソース > 統合をクリックします。

  2. 設定済み統合タブをクリックします。

  3. 新規をクリックします。

    新しい統合パネルが開きます。

  4. 追加したいSaaS アプリケーション を選択します。

  5. 機能 のドロップダウンから App アクティビティ を選択します。

  6. ステップ1で作成した詳細を追加します。

  7. 保存をクリックしてください。

  8. アプリは統合されたアプリテーブルに接続済みのステータスで表示されます。

APIを接続した後、クラウド活動ダッシュボードでアプリ活動を追跡できます。 データが表示されるまでに数分かかることがあります。

既知の制限

  • すべてのイベントが取得されます

ソース

  • Enterprise Audit Log Endpoint - イベントエンドポイントのクエリ

  • GraphQL and Users Endpoint - GitHub ユーザーについてのクエリ。

この記事は役に立ちましたか?

1人中1人がこの記事が役に立ったと言っています

0件のコメント