Azure Files を IIS でマウントして Web ページをホストしてみた

背景

今回は Azure Files を使って IIS で Web ページをホストする方法 を試しました。

Web サーバーにファイルを配置するには RDP でコピー するのが簡単ですが、毎回手動でコピーするのはなんかカッコ悪い…。そこで Azure Files を使ってストレージ上にファイルを置き、それを IIS にマウント することで、ファイル管理の手間を減らせないか試してみました。

また、実際に試す中で 403 エラーが発生し、アクセス権限の問題を解決する過程 もあったので、その点についても詳しく記録しておきます。

環境

Azure VM（Windows Server 2022）
IIS（Internet Information Services）
Azure Files（SMB 3.0）
PowerShell を使用してマウント

手順と試行錯誤

① Azure Files の作成とファイルアップロード

まず、Azure Portal で employee-app というファイル共有を作成し、Web ページのファイルをアップロードしました。

📷 Azure Portal でのファイルアップロード

② Azure VM に SMB 共有をマウント

Azure Portal の「接続」オプションから、Windows 用のコマンドを取得し、VM の PowerShell で実行。
これにより、Azure Files を Y: ドライブとしてマウントしました。

📷 ドライブのマウント設定

📷 エクスプローラーで確認

📷 net use コマンドで確認

③ IIS の仮想ディレクトリ設定

次に、IIS の仮想ディレクトリを作成し、物理パスとして ¥¥<ストレージアカウント名>¥employee-app（Azure Files）を指定しました。

📷 IIS で仮想ディレクトリの設定

④ アクセスしてみると 403 Forbidden エラーが発生

iisreset を実行し、ブラウザでアクセスしてみると…

📷 403.14 エラー発生

エラーメッセージ：

HTTP Error 403.14 - Forbidden
The Web server is configured to not list the contents of this directory.

⑤ 権限の問題を疑う

403.14 Forbidden は ディレクトリの表示が許可されていない場合に発生 するエラー。
ただ、index.html はあるはずなので、 権限の問題の可能性が高い と考えました。

参考にしたサイト
https://jpaztech.github.io/blog/vm/azure-files-user-mount/

上記のサイトを参考に、New-SmbGlobalMapping を試してみることに。

⑥ New-SmbGlobalMapping の実行

New-SmbGlobalMapping とは？
通常、Windows では net use やエクスプローラーを使って Azure Files をマウントすると、そのマウントは実行したユーザー専用になります。そのため、異なるユーザー（例えば IIS の IUSR ユーザー）からは、そのマウント先にアクセスできません。

しかし、Windows Server 2019 / Windows 10 以降では New-SmbGlobalMapping コマンドを使うことで、システム全体で Azure Files をマウントできます。このコマンドを使うことで、IIS などのシステムアカウント（IUSR など）もマウントした Azure Files にアクセスできるようになるため、今回の問題解決に役立つと考えました。

📌 ポイント

net use やエクスプローラーでマウントすると、そのマウントは実行したユーザーのみに適用される。
IIS で匿名認証を使う場合、IUSR ユーザーがファイルにアクセスする必要がある。
New-SmbGlobalMapping を使うと、すべてのユーザーが Azure Files にアクセス可能になる。
Windows ユーザーがログインしていない状態でも、IIS などのサービスからファイルを参照できる。

実行したコマンド：

$User = "localhost\＜ストレージアカウント名＞" 
$PWord = ConvertTo-SecureString -String "＜ストレージアカウントアクセスキー＞" -AsPlainText -Force
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $User, $PWord

New-SmbGlobalMapping -RemotePath \\＜ストレージアカウント名＞.file.core.windows.net\＜ファイル共有名＞ -Credential $Credential -LocalPath Y: -Persistent $True

⑦ それでも解決しない…

再度ブラウザを開いてみると…

📷 403エラー再び発生

キャッシュを削除しても問題解決せず…。
そこで Get-ChildItem を実行し、ファイルが正しく見えているか確認。

⑧ 実はファイル名が原因だった！

ファイルを見直してみると index.html の拡張子が認識されていない ことが判明。

📷 拡張子が認識されていない警告

原因は index.html のファイル名の後ろにスペースが入っていた ことだった…。
このせいで IIS から index.html が正しく見えず、403 エラーの原因になっていた。

📷 ファイル名の後ろに謎のスペースがあった

📷 アイコンが正常に表示されるように！

修正後、再度 IIS をリセットし、アクセスしてみると…

📷 無事にページが表示！

まとめ

IIS で 403 エラーが出たら、まずは基本を疑え！
今回は 権限設定ではなく、ファイル名のスペース が原因だった
設定やキャッシュを疑う前に、ファイルの存在や名前をチェックするのが大事
トラブルシューティングは焦らず前提条件を確認するのが鉄則！
次回からは、まず シンプルなミスを疑う癖をつけよう