†OWASP ZAP入門-設定から診断まで-†

# 初めに
業務でOWASP ZAPを用いた脆弱性診断を行う機会があったので備忘録的に。
**設定から実際の診断まで**の流れを一通り説明します。

# 環境
- macOS High Sierra ver 10.13.6
- OWASP ZAP ver 2.8.0

# ダウンロード
[こちら](https://www.zaproxy.org/download/)からダウンロードすることができます。

# 起動
OWASP ZAP起動時、以下のダイアログが出現します。
<img width="516" alt="スクリーンショット 2020-01-16 12.00.27.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/56e543d8-81e5-c347-af4d-1452d88f0f54.png">
ver2.4以降、セッションの保持方法が選択可能となりました。セッションにより保持されるデータは、アクセス/スキャンしたURL、そのリクエスト/レスポンス、発見された脆弱性などです。しかし、スパイダーや動的スキャンそのもののデータは保持されません。
セッションデータを読み込むことで、設定や診断結果を再現することが可能となります。

全ての場面ではなく、必要に応じて保存すればよいケースがほとんどだと思うので、「継続的に保存せず、必要に応じてセッションを保存」を選択すれば事足りるでしょう。
また、ダイアログ内メッセージにもある通り、この設定は「オプション > データベース」から変更が可能です。
<img width="770" alt="スクリーンショット 2020-01-16 12.12.45.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/98d231d6-674c-ac36-a0c7-e1a4fb20d375.png">
セッションの保持に関しては、以下の記事が大変参考になります。
[OWASP ZAP 2.4 のデータ保存について - Web Application Security Memo](https://www.pupha.net/archives/3056/)

# 起動後最初に行うこと
まず初めに、<font color="Red">**モードをプロテクトモードに変更**</font>しましょう。

<img width="868" alt="スクリーンショット 2020-01-17 12.25.02.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/f003617f-9f58-a7a1-8d1f-17bca14b8e76.png">

標準モード/攻撃モードだと、意図せず自分の管理外のサイトをスキャンしてしまう恐れがあります。
また、セーフモードではブラウザで画面操作しながらレスポンスを解析する静的スキャンは可能ですが、実際に攻撃を仕掛ける動的スキャンは実行することができません。

# 設定
設定の流れは、
1. ローカルプロキシの設定
2. コンテキストの設定
3. その他の設定(Basic認証、ログイン処理、CSRFトークン対応)
の3段階に分けて記載します。

## 1. ローカルプロキシの設定
OWASP ZAPをプロキシとして使用することで診断対象サイトへリクエストを送信し、そのレスポンスから脆弱性を診断します。

### OWASP ZAP側の設定
「ツール」 > 「オプション」 > 「ローカル・プロキシ」を選択。
Address欄には「localhost」、ポート欄には任意のポート番号(他と競合しない番号)を入力。49152~65535は自由に利用できるポート番号として割り当てられているため、今回は「55555」を使用。
ポート番号の入力欄は見えづらいので(使ってみれば分かります)、右スクロールまたは画面拡大するのが良いでしょう。

<img width="1437" alt="スクリーンショット 2019-08-09 12.09.09.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/db5acde1-117c-53b1-4ff7-caaaffb42272.png">

※画面左上の赤枠にて「プロテクトモード」を選択していますが、他サイトに誤って攻撃を仕掛けないためにも最初にこの設定に変更しておきましょう。デフォルトでは「標準モード」が選択されています。

<img width="1096" alt="スクリーンショット 2019-08-09 12.09.48.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/ebfb64f9-f1e3-1483-04fb-cefc5fde5307.png">

### ブラウザ側の設定
今回使用するブラウザは**FireFox**です。Firefoxはプロキシ設定をOSと切り離して行うことができるため、設定の戻し忘れによるネットワーク繋がらない問題を回避できたりと、何かと便利なようです。

画面右上ハンバーガーメニュー > 「設定」 > 画面下部の「ネットワーク設定」の「接続設定」を選択。
「手動でプロキシーを設定する」を選択し、HTTP プロキシー欄に「localhost」、ポート欄に先程OWASP ZAP側で設定したものと同じ番号「55555」を入力。
さらにその下の「すべてのプロトコルでこのプロキシーを使用する」にチェック。

<img width="1440" alt="スクリーンショット 2019-08-09 12.27.42.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/57d0e527-ee19-9df5-6c91-c1f750afd17a.png">

<img width="1440" alt="スクリーンショット 2019-08-09 12.28.23.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/9bd7bd2f-bcbd-2f7c-9503-3a544b80d565.png">

これにてプロキシの設定は終了です。

## 2. コンテキストの設定
次にコンテキストの設定を行います。簡単に言えば、診断対象となるサイトを指定することです。
**あくまでも診断は自分が管理するサイトに対してのみ行うようにしてください。**許可を得ないまま他サイトに攻撃仕掛けちゃうとまずいので、充分注意しましょう。
※筆者は「じゅうぶん」は「十分」ではなく「充分」と書く派です。駿台予備校時代に数学の石川先生に影響を受けました。

1でプロキシの設定を終えた後、診断したいサイトにFireFoxからアクセスしてみてください。
すると、以下の画像の赤枠で囲った部分に諸々反映されてくるはずです。

<img width="1432" alt="スクリーンショット 2019-08-09 12.55.20.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/c4ef0696-b582-c12b-6cc4-efcee5c530f6.png">

ここで診断対象としたいサイトのトップURLを右クリックし、「コンテキストに含める」 > 「New Context」を選択すると、以下の画面が出てきます。
ここで診断対象サイトのURLを確認し、右の「変更」ボタンをクリックし、\Qと\Eで囲ってエスケープしておきましょう。

<img width="651" alt="スクリーンショット 2019-08-09 13.05.27.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/2b4bd70a-70fe-2218-30d5-dd297251462e.png">

コンテキストに含めることができたら、左側のコンテキスト欄に診断対象サイトのURLが追加されていることを確認しましょう。

<img width="1439" alt="スクリーンショット 2019-08-09 14.27.52.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/d3f53476-571a-577b-bd12-9aefd30e024c.png">

以上で基本的なコンテキストの設定は終了です。

## 3. その他の設定
さて、ここまできて早速診断を開始したいところですが、いくつか問題がありました。
今回の診断対象サイトにはBasic認証が設定されており、かつログイン機能がありました。

今回はその他の設定として、**Basic認証**と**ログイン処理**への対応方法を紹介します。

### Basic認証への対応方法
jsで記述したスクリプトを読み込み実行することで対応します。

1. 「サイト」の右の「+」 > 「スクリプト」をクリック。
<img width="1437" alt="スクリーンショット 2019-08-09 14.36.03.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/6b4bda14-10c5-f439-b1b0-6fbbde054f1b.png">
2. 「Stand Alone」で右クリック > 「新規スクリプト」をクリック。
<img width="1435" alt="スクリーンショット 2019-08-09 14.36.40.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/b0560c91-ea1a-0888-5cda-1b28ab935626.png">
3. 以下の画像のように設定。Script engineは「ECMAScript : Oracle Nashorn」を選択。
<img width="502" alt="スクリーンショット 2019-08-09 14.38.08.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/b75d0dae-6899-702b-a306-19f3fb07183e.png">
4. スクリプト　コンソールに以下のコードを記述し、「実行」をクリック。

```javascript

org.parosproxy.paros.network.HttpSender.addListener(
   new org.zaproxy.zap.network.HttpSenderListener {
     getListenerOrder: function() {
       return 1;
     },
     onHttpRequestSend: function(msg, initiator) {
       msg.getRequestHeader().setHeader(
         // 第1引数：「Authorization」、第2引数:「Basic 」 + 「ユーザー名:パスワード」をBase64でエンコードした文字列
         “Authorization”, “Basic xxxxxxxxxxxxxxxxxx”
         );
     },
     onHttpResponseReceive: function(msg, initiator) {
     }
 });
```
<img width="1440" alt="スクリーンショット 2019-08-09 17.07.10.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/ea07f72c-b466-c798-4b5d-b8720d31a4d5.png">
これでBasic認証は突破できるようになりました。
ちなみにBase64でエンコードする際は、以下のサイトなどが便利です。
[データ変換ツール（BASE64, URLエンコード(URLデコード), HEX(16進ダンプ), MD5, SHA-1変換フォーム）](https://hogehoge.tk/tool/)

### ログイン処理への対応方法
自動認証機能を使用します。
これにより、ログインが必要なページに移動した際、適切なPOSTデータを送信し、ログイン状態となって移動してくれます。また、ログアウトした際にも、ログアウト状態(つまりログインしていない状態)であることを検知し、自動でログイン処理を行い期待する動作に復帰してくれます。

1. 診断対象コンテキストをダブルクリックし、「認証」部分をクリック。
    1. 「Currently selected Authentication method for the Context」 => 「Form-based Authentication」を選択。※今回はemailとpasswordの2つのパラメータによる認証フォームを想定しています。
    2. 「Login Form Target URL」にログインページのURLを入力。
    3. 「Login Request Post Data(if any)」にPOSTで送信されるパラメータを入力。デフォルトのusername, passwordの部分を適宜変更しましょう。
    4. 「Username Parameter」と「Password Parameter」を適切な値に設定。今回は「Username Parameter」 => 「email」、 「Password Parameter」 => 「password」となります。
    5. 「Regex pattern identified in Logged In response messages」に、HTTPレスポンスヘッダまたはボディの中で、ログイン状態の際にのみ出現する文字列を正規表現で指定。この文字列が含まれていればログイン状態、含まれていなければログアウト状態であると判断されます。今回はログアウトリンクを指定しました。
    6. 「Regex pattern identified in Logged Out response messages」は、上の「Regex pattern identified in Logged In response messages」を入力していれば入力は不要です。5と反対にログアウト状態であると識別するための文字列を指定します。

<img width="845" alt="スクリーンショット 2019-08-09 17.40.46.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/b5dc79de-cfe6-f2b8-fc34-aed729769c07.png">

2. その下の「ユーザ」をクリック。
    1. 右側の「追加」をクリック。
    2. ユーザ名：何でもよい。今回は適当にtestuserと入力。
    3. 有効チェックボックス：ON
    4. Username：ログイン権限のあるユーザの名前
    5. パスワード：5のユーザのパスワード
    6. 「追加」、「OK」をクリック。
    <img width="845" alt="スクリーンショット 2019-08-09 17.46.15.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/6a5bc12a-9f74-467e-0775-40bb6471afc9.png">
    7. 最後に、作成したユーザを利用して診断を行うようにするため、画面上部の錠前アイコンをクリックして有効にします。
    
    有効になる前
<img width="1438" alt="スクリーンショット 2019-08-09 18.24.43.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/0d17545e-78be-3918-b819-9d1c4a665a9d.png">
有効になった後
<img width="1434" alt="スクリーンショット 2019-08-09 18.24.58.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/299210/dec998e5-e010-7818-3402-e3192ccc23c1.png">

これにてログイン処理への対応の準備も整いました。

---

以上で初期設定は完了となります。
いよいよここから実際に診断を行っていくのですが、ここまでで体力が尽きてしまいました。
また気が向いた際に実際の診断方法なども執筆していきたいと思います。

# 頻出アラートと対処例
・X-Content-Type-Optionsヘッダの設定ミス
HTTP Respose Headerに「X-Content-Type-Options: nosniff」を付与する。

# 最後に
これが私のQiitaデビューです！
最後までお読みいただきありがとうございました！
間違っている箇所などあればご指摘いただけると幸いです。

# 参考記事一覧
- [OWASP ZAPの設定と使い方 - Qiita](https://qiita.com/sangi/items/ba7e3d39237045c9be36)
https://kama3.jp/archives/214
- [OWASP ZAPというWebアプリの脆弱性診断ツールの使い方（入門編） | kamaの技術ブログ](https://techblog.gmo-ap.jp/2018/12/12/owasp-zap%E3%81%A7web%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E8%84%86%E5%BC%B1%E6%80%A7%E8%A8%BA%E6%96%AD/)
- [OWASP ZAP 2.3 自動認証機能の設定 - Web Application Security Memo](https://www.pupha.net/archives/2046/)
- [MacでOWASP ZAPを使ってBasic認証かけたサイトを簡易脆弱性診断 &#8211; myMemoBlog by 256hax](https://blog.tanebox.com/archives/20/)