管理ガイド
Trusted Profile Analyzer サービスの一般管理
概要
はじめに
Red Hat Trusted Profile Analyzer (RHTPA) 管理ガイドへようこそ。
第1章 インポーターとは
Red Hat Trusted Profile Analyzer (RHTPA) のインポーターを使用すると、さまざまなリモートソースからアドバイザリーおよび脆弱性データを取得できます。RHTPA はこのデータを使用して、ソフトウェア部品表 (SBOM) および Common Security Advisory Framework (CSAF) ドキュメントを分析する際に、より詳しい情報を提供します。
利用可能なインポーター
デフォルトでは、RHTPA には、Red Hat CSAF、Red Hat SBOM、Common Vulnerability and Exposure (CVE) リストバージョン 5、および GitHub アドバイザリーデータベースの 4 つのインポーターソースが設定されています。Red Hat CSAF および SBOM インポーターは、完了するまでに長時間かかる可能性があるため無効になっていますが、いつでも有効にできます。CVE リストと GitHub アドバイザリーデータベースインポーターソースを有効にしました。
スケジューリング
デフォルトでは、各インポーターソースの実行スケジュールは 1 日に設定されています。つまり、有効なインポーターソースは 1 日に 1 回実行されます。インポーターの最初の実行が正常に完了した後、次回の実行はインポーターのジョブが終了してから 24 時間後にスケジュールされます。
コンピューティングリソース
アプリケーションが安定し、想定通りに機能するように、Red Hat OpenShift Container Platform でコンピューティングリソースとそのリソースに対する制限を設定することが重要です。インポーターと API サーバーの両方のデプロイメントにおいて、デフォルトのリソース要求は 1 CPU と 8 GB の RAM です。デフォルトではリソース制限はありません。
安定性を犠牲にしてリソース要件を削減するか、ワークロードをサポートするためにクラスターにさらに多くのリソースを割り当てることができます。コンピューティング要件がワークロードをサポートするのに十分でない場合、Pod は起動に失敗したり、"Pending" 状態のままになったりする可能性があります。
関連情報
- コンピューティングリソースの詳細は、OpenShift Container Platform ドキュメントの リソース要求と制限について を参照してください。
第2章 software bill of materials マニフェストファイルの作成
Red Hat Trusted Profile Analyzer は、JSON ファイル形式を使用して CycloneDX および Software Package Data Exchange (SPDX) SBOM 形式の両方を分析できます。コンテナーイメージから Software Bill of Materials (SBOM) マニフェストファイルを作成したり、アプリケーションに使用したりするために、多くのオープンソースツールを利用できます。この手順では、Syft ツールを使用します。
現在、Trusted Profile Analyzer は、CycloneDX バージョン 1.3、1.4、1.5 と、SPDX バージョン 2.2、2.3 のみをサポートしています。
前提条件
ワークステーションプラットフォームに Syft をインストールしている。
手順
コンテナーイメージを使用して SBOM を作成するには、以下を行います。
CycloneDX 形式:
構文
syft IMAGE_PATH -o cyclonedx-json@1.5
例
$ syft registry:example.io/hello-world:latest -o cyclonedx-json@1.5
SPDX 形式:
構文
syft IMAGE_PATH -o spdx-json@2.3
例
$ syft registry:example.io/hello-world:latest -o spdx-json@2.3
注記Syft は多くの種類のコンテナーイメージソースをサポートしています。公式にサポートされているソースリストは、Syft の GitHub サイト を参照してください。
ローカルファイルシステムをスキャンして SBOM を作成します。
CycloneDX 形式:
構文
syft dir: DIRECTORY_PATH -o cyclonedx-json@1.5 syft file: FILE_PATH -o cyclonedx-json@1.5
例
$ syft dir:. -o cyclonedx-json@1.5 $ syft file:/example-binary -o cyclonedx-json@1.5
SPDX 形式:
構文
syft dir: DIRECTORY_PATH -o spdx-json@2.3 syft file: FILE_PATH -o spdx-json@2.3
例
$ syft dir:. -o spdx-json@2.3 $ syft file:/example-binary -o spdx-json@2.3
関連情報
- Red Hat Trusted Profile Analyzer マネージドサービスを使用して SBOM マニフェストファイルをスキャン。
- 米国商務省国家電気通信情報庁 (NTIA) How-to Guide on SBOM generation。
第3章 ライセンス情報のダウンロードと表示
Red Hat の Trusted Profile Analyzer (RHTPA) は、CycloneDX と Software Package Data Exchange (SPDX) SBOM ドキュメントの両方を分析できます。CycloneDX または SPDX 形式でアップロードされたソフトウェア部品表 (SBOM) ドキュメントからライセンス情報をダウンロードして表示できます。CycloneDX と SPDX の 2 つのライセンス形式の違いの詳細は、関連情報のセクションを参照してください。
前提条件
- Red Hat OpenShift または Red Hat Enterprise Linux への RHTPA サービスのインストール。
- アップロードされた CycloneDX 1.3、1.4、または 1.5 または SPDX 2.2、2.3 ドキュメント。
手順
- Web ブラウザーを開き、RHTPA コンソールにログインします。
- ホームページで、ナビゲーションサイドバーの Search をクリックします。
- リストから SBOM を見つけます。
- ドロップダウンメニューをクリックし、Download License Export をクリックします。
-
ダウンロードした
.zip
ファイルからライセンス情報を抽出します。 CSV (comma-separated values) ファイルを開いて表示します。
注記ライセンス参照 CSV ファイルは、SPDX 形式の SBOM のみで利用できます。