概要

レガシーの Java アプリケーションが slack-api を使って通知していましたが、2020 年 3 月初旬になったら通知に失敗するようになりました。
Mac でトラブルシュートをするため、通知に失敗しているリクエストのペイロードがどのような内容であるかを確かめたいと考えました。
Fiddler を使ってトレースを取ろうとしましたが、乗ってきてくれないので、Charles を使うことに。
curl では、こちらを参考に、localhost:8888 へのプロキシを -x で指定すると、Chales でログが取得できました。

.sh

curl -x localhost:8888 -X POST --data-urlencode "payload={\"channel\": \"#general\", \"username\": \"gpedro Bot\", \"text\": \"これは #general に投稿されています。\", \"icon_emoji\": \":ghost:\"}" https://hooks.slack.com/services/<YOUR>/<TOKEN>

Java アプリケーションでは、どのように Charles で Http トレースをとるのか、というのがいまいちわからなかったので調べることにしました。

やり方

私のアプリケーションは、このライブラリを使っていてました。随分メンテナンスが放って置かれていますし、マイナー感がでていますので、このライブラリについては、この記事をご覧になられている方々はまちがいなく使われていないのではないかと思います。
ただ、Proxy クラスやあるいはそれに相当する設定を実施して、なんらかの形で HTTP リクエストを Proxy 経由で送信する方法は、どのライブラリでも存在しているのではと考えています。¹
このライブラリを使う際についても、デフォルトで API をコールするインスタンスを生成するのではなく、Proxy クラスを指定して、インスタンスを作ることができました。この方法でインスタンスを生成すると、Charles を使ってこのライブラリのリクエストの HTTP トレースをとることができました。もしも、トラブルシュートをしたいライブラリので、なんらかの形で参考になれば幸いです。

Charles のインストール

こちらの記事を参考にインストールします。キーチェーンに入った、Charles Proxy.... という証明書を信頼します。

Charles の証明書をエクスポート

キーチェーンにて、Charles Proxy... の証明書を右クリック -> [Charles Proxy CA を書き出す] にて証明書をエクスポートします。
証明書の名前にはエスケープ文字が多く含まれるので、必要に応じて名前をシンプルなものに変更します。

JDK のライブラリへ証明書インポート

こちらの記事の通り、インポートします。
私の場合は、AWS Corretto 8 を使っていたので下記でインポートしました。パスワードは上述の記事の通りでした。

.sh

sudo keytool -import -trustcacerts -file ~/Documents/charles_proxy.cer  -keystore /Library/Java/JavaVirtualMachines/amazon-corretto-8.jdk/Contents/Home/jre/lib/security/cacerts -alias ca

Proxy を指定してリクエストする

curl のときと同様に、Charles のポート 8888 を指定して、リクエストします。
このライブラリでは、

.java

import net.gpedro.integrations.slack.SlackApi;
import net.gpedro.integrations.slack.SlackMessage;

import java.net.InetSocketAddress;
import java.net.Proxy;

public class SlackExecute {

    public static void main(String[] args) {

        SlackMessage slackMessage = new SlackMessage(
                "#genearal",
                "gpedro Bot",
                "gpedro で Slack リクエストできますか"
        );
        slackMessage.setIcon(":ghost:");
        SlackApi api = new SlackApi(
                "https://hooks.slack.com/services/<SOME>/<TOKEN>", 
                new Proxy(
                    Proxy.Type.HTTP,
                    new InetSocketAddress("localhost", 8888)
                )
         );
        api.call(slackMessage);
    }
}

Charles を起動してアプリケーションを実行

これで、Charles の左ペーンに、https://hooks.slack.com が現れて内容をトレースできます。

.json

{
    "channel": "#genearal",
    "username": "gpedro Bot",
    "icon_emoji": ":ghost:",
    "unfurl_media": false,
    "unfurl_links": false,
    "link_names": false,
    "text": "gpedro でリクエストできますか"
}

例えば Spring 5 にはリクエストを行う WebClient インターフェースがあり、この記事にプロキシの指定の仕方が記載されています。このクラスの場合、WebClient.Builder#clientConnector メソッドがあります。このメソッドの引数には、ClientHttpConnector クラスが指定できます。この実装クラスの ReactorClientHttpConnector のコンストラクタには、HttpClient が指定できます。HttpClient のtcpConfiguration メソッドは、TcpClient クラスを引数にとる関数を引数にし、TcpClient クラスの、proxy メソッドは、ProxyProvider.TypeSpec の実装を引数とする関数を引数に取ります。ProxyProvider.TypeSpec インターフェースの type メソッドで、Proxy のタイプを、ProxyProvider.TypeSpec インターフェースの type メソッドの戻り値の ProxyProvider.AddressSpec の実装で、ホストまたは InetSocketAddress クラスを指定できます。Proxy クラスを使いませんが、同じことを実現しています。 ↩