Offensive Security試験レポートテンプレート（Markdown）

私は**Offensive Security試験レポートテンプレート（Markdown）**を作成しました。これにより、Offensive SecurityのOSCP、OSWE、OSEE、OSWP、OSEP、OSED、OSWA、OSDA、OSMR、OSTH、OSIR試験中にLaTeX、Microsoft Office Word、LibreOffice Writerは不要になります！

試験レポート作成中に効率的かつ迅速に作業できます！

• 🚀 作成を高速化、試験レポート作成の24時間を無駄にしません
• ⭐ WYSIWYGエディターによる書式設定の手間なし、Microsoft Office WordやLibreOffice Writerからの不要な空白や改行にさようなら
• 📝 Markdownノートを再利用、Markdownノートの太字や斜体をレポートに再フォーマットする必要がなくてとても嬉しいでしょう
• 🔒 バージョン管理対応、MarkdownテンプレートをPRIVATE gitリポジトリに保存すれば、増分バックアップが可能になります。バージョン管理はバイナリ（.doc、.odt）ではなくテキストのMarkdown（.md）で機能します
• 🖊️ お気に入りのエディターやノートアプリを使用、Markdownを使えばお気に入りのエディター（VSCode、Atomなど）やノートアプリ（Vnote、QOwnNotes、Boostnoteなど）で試験レポートを書くことができ、MS Wordを使うためにWindowsに切り替える必要がありません
• 🎩 クリーンでプロフェッショナルなスタイル、プロフェッショナルな認定資格にふさわしい見た目のレポート
• 👌 エラーフリー、生成スクリプトを使用してレポートとアーカイブを生成すれば、提出形式と名前の間違いを防げます

例:

OSCP whoisflynn改良テンプレート v3.2

OSCP公式Offensive Securityテンプレート v1

必要条件

• Pandoc
• LaTeX（例：TeX Live）で pdflatex または xelatex を利用可能にする
• Eisvogel Pandoc LaTeX PDF Template
• p7zip（スクリプトを使用してアーカイブを生成する場合）

一般的なディストリビューションの例:

• ArchLinux: pacman -S p7zip haskell-pandoc texlive-basic texlive-fontsextra texlive-fontsrecommended texlive-latexextra
• openSUSE: zypper in texlive-scheme-medium pandoc p7zip-full
• Ubuntu: apt install texlive-latex-recommended texlive-fonts-extra texlive-latex-extra pandoc p7zip-full

使い方

レポートをmarkdownで書きます。

自動

以下の処理を行うスクリプトがあります:

1. テンプレートを選択
2. シンタックスハイライトスタイルを選択
3. PDFを生成（+ プレビューオプション）
4. 7zアーカイブを生成
5. アップロード後の検証用にMD5ハッシュを出力

レポート作成に使用するテンプレートを選択してコピーします:

ruby osert.rb init

PDFレポートと7zアーカイブを生成します:

ruby osert.rb generate

[!TIP] 生成を複数回実行する場合、インタラクティブプロンプトの時間を節約するためにオプション（ruby osert.rb generate -h）を確認するとよいでしょう。

[!NOTE] osert は BlackArch Linux の公式パッケージとして利用可能です: pacman -S osert。

手動

MarkdownテンプレートからレポートPDFを生成:

pandoc src/OSCP-exam-report-template_whoisflynn_v3.2.md \
-o output/OSCP-OS-XXXXX-Exam-Report.pdf \
--from markdown+yaml_metadata_block+raw_html \
--template eisvogel \
--table-of-contents \
--toc-depth 6 \
--number-sections \
--top-level-division=chapter \
--highlight-style breezedark \
--resource-path=.:src

コードのシンタックスハイライトテーマは --highlight-style で変更できます。

カラーセット

テンプレートのYAMLフロントマターで使用できる、レンダリングの良いカラーセット:

titlepage-color	titlepage-text-color	titlepage-rule-color
DC143C (Crimson)	FFFFFF (White)	FFFFFF (White)
00FF7F (SpringGreen)	006400 DarkGreen	000000 (Black)
1E90FF (DodgerBlue)	FFFAFA (Snow)	FFFAFA (Snow)
483D8B (DarkSlateBlue)	FFFAFA (Snow)	FFFAFA (Snow)
FFD700 (Gold)	000000 (Black)	000000 (Black)
FFEFD5 (PapayaWhip)	000000 (Black)	000000 (Black)
FF8C00 (DarkOrange)	000000 (Black)	000000 (Black)
FFEF96 (no name)	50394C (no name)	50394C (no name)

シンタックスハイライトテーマは pandoc --list-highlight-styles で一覧表示できます。

利用可能なテンプレート

レポートテンプレート:

ネットワーク侵入テスト:

• OSCP
  • 公式Offensive Securityテンプレート v1
  • 公式Offensive Securityテンプレート v2
  • [whoisflynn][whoisflynn] 改良 テンプレート v3.2
• OSWP
  • 公式Offensive Securityテンプレート v1
• OSEP
  • 公式Offensive Securityテンプレート v1
  • [ceso][ceso] 改良 テンプレート v1

ウェブアプリケーション:

• OSWA
  • 公式Offensive Securityテンプレート v1
• OSWE
  • 公式Offensive Securityテンプレート v1
  • [noraj][noraj] 改良 テンプレート v1
  • [xl-sec][XL-SEC] 改良 テンプレート v1

エクスプロイト開発:

• OSED
  • 公式Offensive Securityテンプレート v1
  • [epi][epi] 改良 テンプレート v1
• OSEE
  • 公式Offensive Securityテンプレート v1
• OSCE (非推奨)
  • 公式Offensive Securityテンプレート v1
• OSMR
  • 公式Offensive Securityテンプレート v1

セキュリティ運用:

• OSDA
  • 公式Offensive Securityテンプレート v1

脅威ハンティング:

• OSTH
  • 公式Offensive Securityテンプレート v1

インシデント対応: