Trust Agent をソースコード管理ツールに接続する方法

SCW Trust Agent を Git ベースのソースコード管理ツールに接続するための複数のアプローチを提供しています。各アプローチには利点と制限があり、お客様の組織固有の環境とポリシーに基づいて決定することができます。

すべてのアプローチは、以下を含むコミット・メタデータのみを保存します：

• コミット作者名
• コミット著者のメールアドレス
• コミットのタイムスタンプ
• コミットで変更されたファイル拡張子のリスト
• 変更されたファイルに基づく、コミットに関連するプログラミング言語とフレームワークのリスト

この要約データは、ダッシュボードやレポートの生成、Secure Code Warrior の学習経路の最適化や設定したポリシーの適用などの自動化アクションを実行する目的で、SCW Trust Agent によって保存されます。

ソースコードは、正確なフレームワーク検出を容易にするために検査されますが、保存されることはありません。分析結果のみが、上記のようにファイル拡張子または言語とフレームワークのリストの形で保存されます。

オンプレミス

このアプローチは、あなたのチームによって設定・管理されるコンテナをあなたの環境内で実行することで、柔軟性とリスク軽減の組み合わせを提供します。これは、サード・パーティのプラットフォームをソース・コード管理ツールに直接接続するリスクを相殺する。

オンプレミス・コンテナは設定可能で、クラウドベースとオンプレミスの両方のソースコード管理プラットフォームで動作します。オンプレミス・コンテナは、指定されたリポジトリに自動的に接続し、要約されたデータをSCW Trust Agentにプッシュバックするために、定期的に実行することができます。このアプローチでは、組織のソースコードや、組織のソースコードにアクセスするためのキーが環境から離れることはありません。

GitHubアプリ

この方法は、GitHub CloudやGitHub Enterprise Cloudをソースコード管理ツールとして使っている組織に特有のものです。GitHubのエコシステムフレームワークで動作するGitHub Appをインストールするシンプルなプロセスを含み、全体的に最も簡単なアプローチと考えられています。ただし、Secure Code Warriorが実際に保存するのは要約されたコミット・メタデータのみであるため、コミット・データにアクセスするためには、アプリがリポジトリのコンテンツにアクセスするための読み取りパーミッションが必要です。フレームワーク検出の目的で検査されたソースコードは、分析後に直ちに破棄され、保存されることはありません。ソースコードが検査されないことを希望される場合は、CSMにお知らせいただければ、この動作を明示的に無効にすることができますが、この場合、フレームワーク検出機能も無効になりますのでご注意ください。

手動アップロード

この方法は、Git ベースのソースコード管理ツールとの直接の統合を必要とせず、SCW Trust Agent にアップロードするために要約されたコミットメタデータをエクスポートするその場限りの手動プロセスに依存します。その結果、SCW Trust Agent を試用するのに適した方法ですが、ポイントインタイムのスナップショットしか得られず、多数のリポジトリに対してスケーラブルではありません。

手動アップロードプロセスでは、選択したリポジトリをローカルシステムにクローンし、提供されたシェルスクリプトを実行して、SCW Trust Agent のウェブインタフェース経由でアップロードできるコミットサマリーを生成します。これは、選択した頻度で手動で実行できます。このアプローチでは、組織のソースコードや、組織のソースコードにアクセスするためのキーが環境から離れることはありません。

SUBDIRS=$(find . -type d -name ".git" -exec dirname {} ˶;)
BASEDIR=$(pwd)
for SUBDIR in $SUBDIRS
する
  cd $SUBDIR

  PROJECT_NAME=$(basename -s .git `git config --get remote.origin.url`)

  echo "$SUBDIR のコミットデータをエクスポート中"
  git log --name-only --since="3 years ago" --no-merges --pretty=format:'- hash：%H
  authorDate: %aI
  authorEmail：e
  authorName：an
  modifiedFileExtensions:'| sed -e '/^[^ -]/ s/.*. \(.*)/ -  \1/' | sed -e '/^[^ -]/d' | sed '$!N; /^(.*)\n \1$/!P; D'> $BASEDIR/scw_gci_$PROJECT_NAME.yaml

  cd $BASEDIR
完了