Local by FlywheelでOAuthやJWTがエラーを起こす場合の対処法 – Capital P

Local by FlywheelはWordPress開発環境の新定番として日本でも人気が出つつあるソフトである。先日のポッドキャストでコントリビューターデイの話題になったとき、Localについて触れたのだが、そこで話した「LocalってJWTとかでコケることあるよね」という話に反応があったので、個別のチップスとして切り出して紹介する。

LocalのサイトでJWTやOAuthが失敗する場合

JWT（ジョット）とはJSON Web Tokenの略であり、APIアクセスする際の管理者権限の証明としてよく使われる。典型的な利用方法としては、GCPやAWSなどのサービスを利用する際に利用する。

詳細は省くが、こうした認証においては、リクエストの有効期限を確かめるためにタイムスタンプが利用されている。「このリクエストの認証の有効期限は5分以内」といった類のチェック機構である。

ところがLocalのDockerコンテナは非常に薄い設定となっており、たとえばVimも入っていないし、ユーザーもrootログインしかできない。さらに、ntpdというサーバーの時刻合わせを行うツールも入っていない。すると、OSのスリープなどを繰り返しているうちに、この時間が少しずつずれていき、いつしかJWTやOAuthで定められた規定のタイムリミットをオーバーするようになってしまう。その結果、どんなリクエストを発行してもエラーとなってしまう。

これは想定外の挙動であるため、原因を特定するためにものすごくハマる。