Content last updated 2023-11-22

セキュリティ部門のエコシステム

概要

このページでは、セキュリティ部門のエコシステムを各部門の様々なプロセスとともに説明し、概観します。 これらのプロセスは図で表現され、当社のチーム間のデータフローだけでなく、Product や Engineering 部門のような外部のアクターとのデータフローも強調します。

目的

このページは、セキュリティ部門のエコシステムをどのように維持するかを記述します。

セキュリティエコシステムのスコープ

セキュリティが関与するすべてのプロセスは、このページに文書化される必要があります。各セキュリティ部門が表現され、自身の図に責任を持ちます。

プロセス

図は、説明されているプロセスに責任を持つチームまたは部門が維持します。エコシステムは各部門のサブフォルダーで利用可能であるべきで、CODEOWNERS ファイルを活用して適切な承認者が要求されるようにします。各部門、さらには各サブ部門ごとに専用のページが推奨されます。

SAFE でないコンテンツに関する図は、内部ハンドブック に保管できます。

セキュリティ部門エコシステムは、プロセスが更新されるにつれて、これらのプロセスのシングルソースオブトゥルースとして維持・更新される必要があります。 セキュリティリーダーシップは、各オフサイトの前にエコシステム図をレビューします。

ツール

すべての図とこのエコシステム全体で一貫性を維持するため、当社は GitLab とこのハンドブックでの Mermaid ネイティブ統合 を使用します。

図は FY24-Q2 セキュリティリーダーシップオフサイトで作成され、ハンドブックに移行されるまでは Security Google Drive (セキュリティ部門のチームメンバーのみアクセス可能) で利用できます。

シーケンス図のリンクはまだサポートされていません が、エコシステム図の上下に runbook やその他のドキュメントへのリンクを追加することが有用な場合があります。

ガイドライン

シーケンス図用 Mermaid DSL は、参加者と相互作用がどのように宣言されるかをすでに定義しています。以下のガイドラインと推奨事項を使用してください。

シーケンス番号

シーケンス番号 (autonumber) を使用して、各矢印にシーケンス番号を付けます。これによりシーケンスの読みやすさが向上し、必要に応じて図の一部を参照できます。

例:

sequenceDiagram
    
    autonumber

    participant H1 as HackerOne
    participant SE as SecEng
    
    H1->>SE: Hackerone report
    SE-->>H1: Validation

代替パス

「または」条件を表現するために代替パス (alt) を使用できます。

例:

sequenceDiagram
    
    autonumber

    participant H1 as HackerOne
    participant TM as Threat Management
    participant SE as SecEng
    
    
    alt Report/Research/Threat
        TM->>SE: Threat
    else
        H1->>SE: Hackerone report
    end

リソース