と GitHub の統合 GitHub による認証 CloudWatch パイプラインの設定サポートされているオープンサイバーセキュリティスキーマフレームワークイベントクラス

注記

重要: このコネクタを使用するには、GitHub Enterprise アカウントが必要です。GitHub 個人用アカウントまたは組織アカウントはサポートされていません。

GitHub 監査ログのソース設定

と GitHub の統合

Amazon Telemetry パイプラインを使用すると、GitHub Enterprise Cloud から監査ログを収集できます。GitHub Enterprise は、最新の開発の複雑なワークフロー用に設計されたエンタープライズグレードのソフトウェア開発プラットフォームです。GitHub Enterprise Cloud は、GitHub Enterprise のクラウドベースのソリューションであり、GitHub のサーバーでホストされています。

GitHub による認証

監査ログを読み込むには、パイプラインが GitHub アカウントで認証される必要があります。エンタープライズスコープでは個人用アクセストークンを使用でき、組織スコープでは個人用アクセストークンまたは GitHub アプリを使用できます。

個人用アクセストークンとして認証するトークンを生成します。

GitHub アカウントの認証情報を使用して GitHub にサインインします。
このエンドポイントを使用するには、認証されたユーザーがエンタープライズ管理者である必要があります。
GitHub の [Personal access tokens (classic)] ページを開き、[Generate new token (classic)] を見つけ、GitHub の手順に従って、スコープが read:audit_log で有効期限のないトークンを生成します。
この新しいトークンを、AWS Secrets Manager のキー personal_access_token の下にあるシークレットに保存します。

GitHub アプリとして認証するプライベートキーを生成します。

GitHub アカウントの認証情報を使用して GitHub にサインインします。
GitHub アプリに「管理」組織のアクセス許可 (読み込み) が付与されていることを確認します。
「GitHub Apps の秘密キーの管理」の手順に従って、プライベートキーを生成します。
このプライベートキーを AWS Secrets Manager のキー private_key の下にあるシークレットに保存し、GitHub アプリ名をキー app_id の下に保存します。

CloudWatch パイプラインの設定

GitHub Enterprise Cloud から監査ログを読み込むようにパイプラインを設定するときは、データソースとして GitHub Audit Logs を選択します。統合のスコープに基づいてソースタイプをエンタープライズまたは組織として選択し、選択したスコープに従ってエンタープライズ名や組織名などの必要な情報を入力します。パイプラインを作成すると、選択した CloudWatch Logs ロググループでデータを使用できます。