Xserver に送ったら 403:デプロイの道具が .htaccess の権限を 600 のまま送っていた

レンタルサーバー(Xserver)に API を初めて本番で送ったら、期待した 401 ではなく、サーバーの汎用の 403 が返りました。デプロイの道具が作った一時ファイルの権限 600 を、scp がそのまま送り、.htaccess だけが読めなくなっていたのが原因です。権限を 644 にして直した記録です。

権限 600 のまま送られた .htaccess が読めず 403 になり、644 に直して解決する流れの札

レンタルサーバー(Xserver)に .htaccess を送ったら 403 Forbidden になった場合、ファイルの権限が 600 のままかもしれません。私たちは、デプロイの道具が作った一時ファイルの権限 600 を、scp がそのまま送り、Web サーバーが .htaccess を読めなくなっていました。送ったあとに chmod 644 を明示して直しました。

不動産の業務アプリ(Kaitori Base)の API を、初めて本番のサーバーへ送った時のことです。期待していたのは、ログインしていない人への「401」でした。ところが、返ってきたのは、サーバーの汎用の「403」でした。この記事は、その原因と直し方の記録です。サーバーの名前、フォルダの場所、データベースの情報は書きません。

期待した 401 ではなく、サーバーの汎用の 403 が返った

初めての本番への送り込みのあと、ログインが要る入口を、ログインせずに開いて、401 が返ることを確かめようとしました。

古い木の戸に、真ちゅうの南京錠がかかっている写真
一時ファイルの権限 600 が、そのまま送られていた(イメージ写真)
初めて本番に送った API で、ログインせずに入口を開くと、期待した401ではなく、アプリのコードに届く前のインフラの層が返す汎用の403が返った
アプリのコードまで、リクエストが届いていない

原因:一時ファイルの権限 600 を、scp がそのまま送っていた

デプロイの道具は、送る .htaccess を、いったん一時ファイルとして作ってから送っていました。

デプロイの道具が mktemp で作った一時ファイルの権限は600で、scp がその権限のまま .htaccess を送るため、Web サーバーが読めず403になる。index.php は644のファイル由来なので影響がない
.htaccess だけが、読めなくなっていた

.htaccess が 600 のままだと、Web サーバーは、そのファイルを読めません。その結果、リクエストがアプリに届く前に、403 になりました。index.php のほうは、リポジトリにあるファイル(権限 644)をそのまま送っていたので、影響がありませんでした。.htaccess だけが、問題だったのです。

直し方:送ったあとに、chmod 644 を明示する

権限600の .htaccess は Web サーバーが読めず403になるが、送ったあとに chmod 644 を明示すると読めるようになる。index.php はリポジトリ由来の644で影響がない
.htaccess は 644 にしておく
駐車場の入口にある、「DO NOT ENTER」の大きな標識の写真
読めない権限だと、サーバーが入口で止める(イメージ写真)

直したあと、実機で次のことを確かめました。

  1. ログインせずに入口を開くと、401 が返る

    アプリが返す、自前の JSON の 401 です。WordPress の 404 でも、汎用の 403 でもありません。

  2. 存在しないパスを開くと、アプリの JSON の 404 が返る

    アプリのコードが、リクエストを受け取っている証拠です。

  3. 検証用の鍵で署名した認証の情報を送ると、期待した 401 が返る

    Authorization ヘッダーが、アプリまで正しく届いていることも、あわせて確かめました。

このサイトの切り替えでも、権限を確かめる手順を入れた

同じ種類の落とし穴は、この公式サイトの送り込みでも起こりえます。Mac の rsync は、権限をそのまま送るからです。

このサイトの送り込みの道具は、送る前にフォルダが755、ファイルが644になっているかを確かめ、違うものがあれば止まる。Mac の rsync は権限をそのまま送るため
権限を確かめてから、送る
Macで実行
find public -type d ! -perm 755
find public -type f ! -perm 644

何も表示されなければ、すべて 755 と 644 です。

まとめ

Xserver に送ったら 403:デプロイの道具が .htaccess の権限を 600 のまま送っていた:要点のまとめ。本番に初めて送ったら、期待した 401 ではなく、サーバーの汎用の 403 が返った
この記事の要点
  • 本番に初めて送ったら、期待した 401 ではなく、サーバーの汎用の 403 が返った
  • 原因は、一時ファイル(mktemp)の権限 600 を、scp がそのまま送り、.htaccess だけが Web サーバーに読めなくなったこと
  • 送ったあとに chmod 644 を明示して直した
  • 送る前に、フォルダ 755・ファイル 644 を確かめる手順を入れておくと、同じことを防げる

この記事は、AI(Claude)の支援を受けて作成し、筆者が内容を確認しています。

  • Xserver
  • 403
  • .htaccess
  • 権限
  • scp
  • rsync
  • デプロイ

関連する記事

この記事に関連するサービス・アプリ

ブログの一覧へ