<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>セキュリティ &#8211; CFXLOG</title>
	<atom:link href="https://cfxlog.com/tag/security/feed/index.xml" rel="self" type="application/rss+xml" />
	<link>https://cfxlog.com/</link>
	<description></description>
	<lastBuildDate>Wed, 18 Nov 2026 22:05:27 +0000</lastBuildDate>
	<language>ja</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.1.4</generator>

<image>
	<url>https://cfxlog.com/wp-content/uploads/2026/07/cfxlog-favicon-150x150.png</url>
	<title>セキュリティ &#8211; CFXLOG</title>
	<link>https://cfxlog.com/</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>【VPSのセキュリティ対策】個人のVPSに1週間でどんな攻撃が来たか？実際のログと防ぎ方</title>
		<link>https://cfxlog.com/vps-security-measures/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 15 Nov 2026 22:02:09 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[SSH]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5778</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/11/vps-security-measures-1024x538.png" class="webfeedsFeaturedVisual" /></p>個人開発で Web サービスを公開するために、VPS を運用しています。 今回は、そんな僕の VPS にどんな攻撃が来ているのか、1週間分のログを集計してみました。 結果は次のとおりです。 個人で運用している VPS で [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/11/vps-security-measures-1024x538.png" class="webfeedsFeaturedVisual" /></p>
<p class="wp-block-paragraph">個人開発で Web サービスを公開するために、VPS を運用しています。</p>



<p class="wp-block-paragraph">今回は、そんな僕の VPS にどんな攻撃が来ているのか、1週間分のログを集計してみました。</p>



<p class="wp-block-paragraph">結果は次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>SSH へのログイン失敗：約9,900件</li>



<li>404 を返した Web アクセス：約20,000件</li>



<li>ファイアウォールで遮断した通信：約8,700件</li>
</ul>
</div></div>



<p class="wp-block-paragraph">個人で運用している VPS でも、これだけの通信が来ます。</p>



<p class="wp-block-paragraph">とはいえ、ログを見てみると、その多くは決まったユーザー名やファイル名を機械的に試しているもの。</p>



<p class="wp-block-paragraph">基本的なセキュリティ対策をしておくだけでも、多くの攻撃に対応できます。</p>



<p class="wp-block-paragraph">また、VPS を運用するうえで大切だと思うのが、<strong><span class="swl-marker mark_yellow">必要のないものはそもそも外部に公開しないこと。</span></strong></p>



<p class="wp-block-paragraph">この記事では、実際に僕の VPS に来た攻撃と、その防ぎ方についてご紹介します。</p>



<h2 class="wp-block-heading">1週間でどれくらいの攻撃が来たのか</h2>



<p class="wp-block-paragraph">2026年11月9日〜15日の約1週間分のログを集計した結果がこちら。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>件数</th></tr></thead><tbody><tr><td>Web へのリクエスト</td><td>78,585件</td></tr><tr><td>404 を返したリクエスト</td><td>20,122件</td></tr><tr><td>SSH へのログイン失敗</td><td>9,906件</td></tr><tr><td>ファイアウォールで遮断した通信</td><td>8,684件</td></tr><tr><td>アクセス回数制限による拒否（429）</td><td>521件</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Web へのリクエストのうち、約4分の1が404（Not Found）を返しています。</p>



<p class="wp-block-paragraph">もちろん、404 のすべてが攻撃というわけではありませんが、ログには明らかに怪しいファイルを探しに来ているアクセスが大量にありました。</p>



<p class="wp-block-paragraph">SSH に関しては、1日平均で約1,400件のログイン失敗が発生しています。</p>



<p class="wp-block-paragraph">ちなみに、ファイアウォールのログは一部を間引いて記録しているため、実際に遮断している通信はもっと多いはずです。</p>



<p class="is-style-icon_info wp-block-paragraph">集計期間は UTC 基準です。<br>攻撃の種類別の件数はログのパターンから分類した概数で、サイト自身の計測処理などによる404は攻撃の集計から除外しています。<br>また、各分類には重複する可能性があるため、単純に合計したものが攻撃の総数になるわけではありません。</p>



<h2 class="wp-block-heading">VPS に来た攻撃とその防ぎ方</h2>



<p class="wp-block-paragraph">今回確認できた主な攻撃・不審なアクセスは次の8種類です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>SSH へのパスワード総当たり</li>



<li>秘密のファイル探し</li>



<li>WordPress のログイン画面・管理画面狙い</li>



<li>古いプラグインや PHP の脆弱性探し</li>



<li>IP アドレス直打ち・踏み台探し</li>



<li>Web 以外のポートへのアクセス</li>



<li>クローラーなどによる大量アクセス</li>



<li>ディレクトリトラバーサルなど</li>
</ol>
</div></div>



<p class="wp-block-paragraph">では、それぞれ詳しく見ていきます。</p>



<h3 class="wp-block-heading">SSH へのパスワード総当たり</h3>



<p class="wp-block-paragraph">まずは SSH へのログインを試みる攻撃です。</p>



<p class="wp-block-paragraph">1週間で約9,900件、260個の IP アドレスからログインの試行がありました。</p>



<figure class="wp-block-table"><table><thead><tr><th>ログイン対象</th><th>件数</th></tr></thead><tbody><tr><td>存在しないユーザー</td><td>6,448件</td></tr><tr><td>root</td><td>3,458件</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">存在しないユーザー名のうち、よく使われていたものがこちら。</p>



<figure class="wp-block-table"><table><thead><tr><th>ユーザー名</th><th>件数</th></tr></thead><tbody><tr><td>admin</td><td>1,111件</td></tr><tr><td>user</td><td>426件</td></tr><tr><td>debian</td><td>261件</td></tr><tr><td>centos</td><td>153件</td></tr><tr><td>administrator</td><td>120件</td></tr><tr><td>server</td><td>105件</td></tr><tr><td>claude</td><td>91件</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">ほかにも、以下のようなユーザー名が使われていました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>wallet</li>



<li>blockchain</li>



<li>bitcoin</li>



<li>crypto</li>



<li>gpu</li>
</ul>
</div></div>



<p class="wp-block-paragraph">暗号資産や GPU を使ったサーバーを狙っているのでしょうか。</p>



<p class="wp-block-paragraph">個人的に面白かったのが <code>claude</code> というユーザー名。</p>



<p class="wp-block-paragraph">AI エージェント用に構築されたサーバーも狙っているのかもしれません。</p>



<p class="wp-block-paragraph">時代を感じますね。</p>



<h4 class="wp-block-heading">SSH への攻撃の防ぎ方</h4>



<p class="wp-block-paragraph">SSH のパスワード総当たりを防ぐためには、以下の2つの対策が有効です。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>パスワード認証を無効にする</li>



<li>root ユーザーでのログインを禁止する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">OpenSSH の設定例は以下のとおりです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">SSH Config</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
PubkeyAuthentication yes</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">PasswordAuthentication</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">no</span></span>
<span class="line"><span style="color: #569CD6">KbdInteractiveAuthentication</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">no</span></span>
<span class="line"><span style="color: #569CD6">PermitRootLogin</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">no</span></span>
<span class="line"><span style="color: #569CD6">PubkeyAuthentication</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">yes</span></span></code></pre></div>



<p class="wp-block-paragraph">パスワード認証を無効にし、公開鍵認証を使うようにします。</p>



<p class="wp-block-paragraph">公開鍵認証とは、サーバーに登録した公開鍵と、それに対応する秘密鍵を使って認証する仕組みです。</p>



<p class="wp-block-paragraph">パスワード認証を無効にしておけば、正しいパスワードを知っていたとしても、パスワードではログインできません。</p>



<p class="wp-block-paragraph">また、root ユーザーでの直接ログインも禁止しておきます。</p>



<p class="wp-block-paragraph">これだけでも、今回のようなパスワード総当たりには非常に有効です。</p>



<p class="is-style-big_icon_caution wp-block-paragraph"><strong>設定変更前に、一般ユーザーで公開鍵認証によるログインができることを必ず確認しておきましょう。</strong><br>確認せずにパスワード認証を無効にすると、自分までサーバーにログインできなくなる可能性があります。</p>



<p class="wp-block-paragraph">設定を反映する前に、以下のコマンドで設定内容をチェックしておきましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo sshd -t</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">sshd</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-t</span></span></code></pre></div>



<p class="wp-block-paragraph">設定を反映したあとは、現在の SSH 接続を残したまま、別のターミナルでログインできることを確認しておくと安心です。</p>



<p class="wp-block-paragraph">ちなみに、ほかにも以下のような対策があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>fail2ban で何度もログインに失敗する IP を一時的に遮断する</li>



<li>SSH のポート番号を変更する</li>



<li>接続元の IP アドレスを制限する</li>
</ul>
</div></div>



<p class="is-style-big_icon_memo wp-block-paragraph">ポート番号の変更は機械的な攻撃を減らす効果が期待できますが、認証そのものが強化されるわけではありません。</p>



<h3 class="wp-block-heading">秘密のファイル探し</h3>



<p class="wp-block-paragraph">続いて、Web サーバー上にある秘密のファイルを探す攻撃です。</p>



<p class="wp-block-paragraph">こちらは1週間で5,317件、106個の IP アドレスからアクセスがありました。</p>



<p class="wp-block-paragraph">実際に探されていたファイルの一例がこちら。</p>



<figure class="wp-block-table"><table><thead><tr><th>ファイル</th><th>主な内容</th></tr></thead><tbody><tr><td><code>/.env</code></td><td>環境変数・認証情報</td></tr><tr><td><code>/.env.local</code></td><td>ローカル環境の設定</td></tr><tr><td><code>/.env.production</code></td><td>本番環境の設定</td></tr><tr><td><code>/.env.bak</code></td><td>環境変数のバックアップ</td></tr><tr><td><code>/.git/config</code></td><td>Git の設定情報</td></tr><tr><td><code>/.git/HEAD</code></td><td>Git の参照情報</td></tr><tr><td><code>/.aws/credentials</code></td><td>AWS の認証情報</td></tr><tr><td><code>/credentials.json</code></td><td>各種認証情報</td></tr><tr><td><code>/.docker/config.json</code></td><td>Docker の設定情報</td></tr><tr><td><code>/.kube/config</code></td><td>Kubernetes の接続情報</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Web アプリを開発している方であれば、見覚えのあるファイル名が多いのではないでしょうか。</p>



<p class="wp-block-paragraph">特に多かったのが <code>.env</code> ファイルを探すアクセスです。</p>



<p class="wp-block-paragraph"><code>.env</code> には、以下のような情報を記載することがあります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>データベースのパスワード</li>



<li>外部サービスの API キー</li>



<li>アプリケーションのシークレットキー</li>
</ul>
</div></div>



<p class="wp-block-paragraph">こういった情報が外部から見られる状態になっていると、VPS だけでなく、連携している外部サービスにまで被害が及ぶ可能性があります。</p>



<p class="wp-block-paragraph">また、<code>.git</code> ディレクトリが公開されていると、ソースコードや過去の変更履歴を取得される可能性も。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">現在のソースコードから認証情報を削除していても、過去のコミットに残っている場合があるので注意が必要です。</p>



<h4 class="wp-block-heading">秘密のファイル探しの防ぎ方</h4>



<p class="wp-block-paragraph">基本的な対策としては、<strong><span class="swl-marker mark_yellow">公開ディレクトリに秘密のファイルを置かないこと。</span></strong></p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>Web サーバーから配信するのは公開用のファイルだけにする</li>



<li>.env などは公開ディレクトリの外に置く</li>



<li>認証情報はサーバー側の環境変数などで管理する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">開発用のディレクトリをそのまま Web サーバーの公開ディレクトリにするのではなく、公開に必要なファイルだけを配信するようにしましょう。</p>



<p class="wp-block-paragraph">なお、環境変数を使っていても、フロントエンドの JavaScript に埋め込んでしまうと外部から見られてしまいます。</p>



<p class="is-style-big_icon_memo wp-block-paragraph">Next.js であれば、<code>NEXT_PUBLIC_</code> が付いた環境変数などが該当します。<br>秘密にしておきたい情報はサーバー側だけで扱うようにしましょう。</p>



<p class="wp-block-paragraph">今回のログでは、秘密のファイルを探すアクセスはいずれも404でした。</p>



<h3 class="wp-block-heading">WordPress のログイン画面・管理画面狙い</h3>



<p class="wp-block-paragraph">WordPress を狙ったアクセスもかなり多く、1週間で約1,200件ありました。</p>



<p class="wp-block-paragraph">よく見かけたのは以下のような URL です。</p>



<figure class="wp-block-table"><table><thead><tr><th>URL</th><th>考えられる目的</th></tr></thead><tbody><tr><td><code>/wp-login.php</code></td><td>ログインの試行</td></tr><tr><td><code>/wp-admin/</code></td><td>管理画面へのアクセス</td></tr><tr><td><code>/xmlrpc.php</code></td><td>XML-RPC を利用した攻撃</td></tr><tr><td><code>/wp-json/wp/v2/users</code></td><td>ユーザー情報の取得</td></tr><tr><td><code>/wp-json/batch/v1</code></td><td>API の探索・悪用</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">特に注意したいのが <code>xmlrpc.php</code>。</p>



<p class="wp-block-paragraph">WordPress を外部から操作するための仕組みですが、構成によってはパスワード総当たりなどの攻撃に悪用されることがあります。</p>



<h4 class="wp-block-heading">WordPress への攻撃の防ぎ方</h4>



<p class="wp-block-paragraph">WordPress への攻撃を防ぐ方法のひとつが、静的サイト化です。</p>



<p class="wp-block-paragraph">僕も WordPress の静的化には <a href="https://wordpress.org/plugins/simply-static/" target="_blank" rel="noreferrer noopener">Simply Static</a> というプラグインを使っています。</p>



<p class="wp-block-paragraph">ざっくりとした静的サイトの運用イメージは次のとおりです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>非公開の WordPress で記事を書く</li>



<li>Simply Static で HTML に書き出す</li>



<li>書き出したファイルを公開する</li>
</ol>
</div></div>



<p class="wp-block-paragraph">公開するのは HTML や CSS、JavaScript などの静的ファイルだけ。</p>



<p class="wp-block-paragraph">WordPress 本体や PHP をインターネットに公開する必要がなくなります。</p>



<p class="wp-block-paragraph">ログイン画面や管理画面も存在しないため、今回のような攻撃の多くを無効化できます。</p>



<p class="is-style-big_icon_point wp-block-paragraph"><strong>WordPress をどう守るかではなく、WordPress 自体を外部に公開しないという考え方です。</strong></p>



<p class="wp-block-paragraph">もちろん、会員制サイトや動的な機能が必要なサイトなど、静的化に向かないサイトもあります。</p>



<p class="wp-block-paragraph">一方、記事を読んでもらうことがメインのブログであれば、静的化は有力な選択肢になると思います。</p>



<p class="wp-block-paragraph">静的化が難しい場合は、WordPress 本体やプラグインの更新、ログイン保護などの基本的な対策をしておきましょう。</p>



<h3 class="wp-block-heading">古いプラグインや PHP の脆弱性探し</h3>



<p class="wp-block-paragraph">WordPress のログイン画面以外にも、PHP のファイルや古いプラグインを探すアクセスが大量にありました。</p>



<p class="wp-block-paragraph">件数は1週間で約5,100件です。</p>



<p class="wp-block-paragraph">例えば以下のようなもの。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>/info.php</code></li>



<li><code>/phpinfo.php</code></li>



<li><code>/test.php</code></li>



<li><code>/simple.php</code></li>



<li><code>/wp-content/plugins/hellopress/wp_filemanager.php</code></li>
</ul>
</div></div>



<p class="wp-block-paragraph"><code>phpinfo.php</code> などは、PHP の設定情報を表示するファイルが置かれていないか探しているものと思われます。</p>



<p class="wp-block-paragraph">また、脆弱なプラグインや、ほかの攻撃者が設置したバックドアを探していると思われるアクセスもありました。</p>



<p class="is-style-big_icon_memo wp-block-paragraph">バックドアとは、正規の認証を経由せずにシステムにアクセスするための裏口のことです。</p>



<p class="wp-block-paragraph">面白いことに、以下のような URL へのアクセスもありました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>/actuator/env</code></li>



<li><code>/actuator/configprops</code></li>
</ul>
</div></div>



<p class="wp-block-paragraph">こちらは Java の Spring Boot で使われる管理用のエンドポイントです。</p>



<p class="wp-block-paragraph">どうやら、相手のサーバーで何が動いているかにかかわらず、攻撃に使えそうな URL を手当たり次第に試しているようです。</p>



<h4 class="wp-block-heading">脆弱性探しへの対策</h4>



<p class="wp-block-paragraph">対策としては、以下のようなものがあります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>使っていないソフトウェアはインストールしない</li>



<li>不要なプラグインは削除する</li>



<li>デバッグ用のファイルを公開しない</li>



<li>ソフトウェアを定期的にアップデートする</li>
</ul>
</div></div>



<p class="wp-block-paragraph">今回のログでは、こういったアクセスはいずれも404でした。</p>



<p class="wp-block-paragraph">便利そうだからといって、使う予定のない管理ツールなどを入れておかないことも大切ですね。</p>



<h3 class="wp-block-heading">IP アドレス直打ち・踏み台探し</h3>



<p class="wp-block-paragraph">ドメイン名を指定せずに、VPS の IP アドレスに直接アクセスしてくる通信もあります。</p>



<p class="wp-block-paragraph">関係のないドメイン名を指定したアクセスと合わせて、1週間で約3,100件ありました。</p>



<p class="wp-block-paragraph">VPS を契約したばかりで、まだドメインを取得していないから大丈夫……というわけではないんですね。</p>



<p class="wp-block-paragraph">インターネット上の IP アドレスを順番に調べているスキャナーなどが存在するためです。</p>



<p class="wp-block-paragraph">また、HTTP の Host ヘッダーに以下のような、関係のないドメイン名を指定したアクセスもありました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>httpbin.org</li>



<li>ip-api.com</li>



<li>icanhazip.com</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これらは、VPS がオープンプロキシとして使えるかを確認している可能性があります。</p>



<p class="is-style-big_icon_memo wp-block-paragraph">オープンプロキシとは、第三者が自由に通信を中継できるプロキシサーバーのことです。意図せず公開してしまうと、迷惑行為などの踏み台にされる可能性があります。</p>



<h4 class="wp-block-heading">IP アドレス直打ちへの対策</h4>



<p class="wp-block-paragraph">nginx を使っている場合は、<code>default_server</code> を使って、知らないドメイン名でのアクセスにはサイトの内容を返さないようにする方法があります。</p>



<p class="wp-block-paragraph">nginx では、<code>server_name</code> に一致するサイトがなかった場合に、既定のサーバー設定で処理することができます。</p>



<p class="wp-block-paragraph">そこで404を返したり、nginx 独自の <code>444</code> を使ってレスポンスを返さずに接続を切断したりするわけです。</p>



<p class="wp-block-paragraph">また、以下の設定で nginx のバージョン番号を表示しないようにすることもできます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Nginx</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>server_tokens off;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">server_tokens </span><span style="color: #D4D4D4">off;</span></span></code></pre></div>



<p class="wp-block-paragraph">もちろん、バージョン番号を隠すだけで脆弱性を防げるわけではありません。</p>



<p class="wp-block-paragraph">あくまで外部に余計な情報を出さないための設定です。</p>



<h3 class="wp-block-heading">Web 以外のポートへのアクセス</h3>



<p class="wp-block-paragraph">ここまでは主に Web サーバーと SSH への攻撃でしたが、ほかのポートにも大量の通信が来ています。</p>



<p class="wp-block-paragraph">ファイアウォールで遮断した通信のうち、よく見かけたポートがこちら。</p>



<figure class="wp-block-table"><table><thead><tr><th>ポート番号</th><th>主な用途</th></tr></thead><tbody><tr><td>23</td><td>Telnet</td></tr><tr><td>25 / 465 / 587</td><td>メール送信</td></tr><tr><td>3389</td><td>Windows のリモートデスクトップ</td></tr><tr><td>8080 / 8443</td><td>Web サーバー・管理画面など</td></tr><tr><td>2222</td><td>SSH の代替ポートなど</td></tr><tr><td>34567</td><td>防犯カメラのレコーダーなど</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Telnet への通信だけで686件、メール送信関連のポートには合計523件の通信がありました。</p>



<p class="wp-block-paragraph">こちらも、攻撃に使えそうなサービスが動いていないか、機械的に探しているようです。</p>



<h4 class="wp-block-heading">ファイアウォールで不要な通信を遮断する</h4>



<p class="wp-block-paragraph">Ubuntu であれば、ufw というファイアウォールの管理ツールを使うと便利です。</p>



<p class="wp-block-paragraph">例えば、SSH と Web サーバーだけを外部に公開する場合、許可するポートは次のようになります。</p>



<figure class="wp-block-table"><table><thead><tr><th>ポート番号</th><th>用途</th></tr></thead><tbody><tr><td>22</td><td>SSH</td></tr><tr><td>80</td><td>HTTP</td></tr><tr><td>443</td><td>HTTPS</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">基本的な設定例は以下のとおりです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo ufw default deny incoming
sudo ufw default allow outgoing

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

sudo ufw enable</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">default</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">deny</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">incoming</span></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">default</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">allow</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">outgoing</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">allow</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">22</span><span style="color: #CE9178">/tcp</span></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">allow</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">80</span><span style="color: #CE9178">/tcp</span></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">allow</span><span style="color: #D4D4D4"> </span><span style="color: #B5CEA8">443</span><span style="color: #CE9178">/tcp</span></span>
<span class="line"></span>
<span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">enable</span></span></code></pre></div>



<p class="wp-block-paragraph">設定状況は以下のコマンドで確認できます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo ufw status verbose</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">ufw</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">status</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">verbose</span></span></code></pre></div>



<p class="is-style-big_icon_caution wp-block-paragraph">SSH のポート番号を変更している場合などは、ご自身の環境に合わせて設定してください。SSH の通信を許可する前に ufw を有効化すると、サーバーに接続できなくなる可能性があります。また、既存の許可ルールが残っていないかも確認しておきましょう。</p>



<h4 class="wp-block-heading">Docker を使っている場合は要注意</h4>



<p class="wp-block-paragraph">Docker を使っている場合、少し注意が必要です。</p>



<p class="wp-block-paragraph">例えば Docker Compose で以下のようにポートを公開したとします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ports:
  - "8000:8000"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  - </span><span style="color: #CE9178">&quot;8000:8000&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">この場合、通常はすべてのネットワークインターフェースでポートが公開されます。</p>



<p class="is-style-big_icon_caution wp-block-paragraph"><strong>Docker のポート公開設定によっては、ufw で拒否しているつもりでも、外部からアクセスできてしまうことがあります。</strong></p>



<p class="wp-block-paragraph">ホスト内からだけアクセスできればよい場合には、以下のようにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ports:
  - "127.0.0.1:8000:8000"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">ports</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  - </span><span style="color: #CE9178">&quot;127.0.0.1:8000:8000&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">こうすることで、通常はホストのループバックアドレスに公開先を限定できます。</p>



<p class="wp-block-paragraph">また、コンテナ間でしか通信しないのであれば、そもそも <code>ports</code> を指定せず、Docker の内部ネットワークで通信させる方法もあります。</p>



<p class="wp-block-paragraph">データベースやバックエンドの API などは、外部に直接公開する必要がないことも多いです。</p>



<p class="wp-block-paragraph">ufw の設定だけで安心せず、Docker のポート公開設定や、外部から実際に接続できるかどうかも確認しておきましょう。</p>



<p class="wp-block-paragraph">参考：<a href="https://docs.docker.com/engine/network/packet-filtering-firewalls/" target="_blank" rel="noreferrer noopener">Packet filtering and firewalls | Docker Docs</a></p>



<h3 class="wp-block-heading">クローラーなどによる大量アクセス</h3>



<p class="wp-block-paragraph">短時間に大量のページを取得しようとするアクセスもありました。</p>



<p class="wp-block-paragraph">データをまとめて収集しようとしているクローラーと思われます。</p>



<p class="wp-block-paragraph">クローラー自体が悪いわけではありませんが、短時間で大量のリクエストが来ると、サーバーへの負荷が大きくなってしまいます。</p>



<h4 class="wp-block-heading">nginx でアクセス回数を制限する</h4>



<p class="wp-block-paragraph">こういったアクセスへの対策として便利なのが、nginx の <code>limit_req</code> です。</p>



<p class="wp-block-paragraph">IP アドレスごとにリクエストの頻度を制限し、一定の頻度を超えたアクセスを拒否することができます。</p>



<p class="wp-block-paragraph">拒否する際に429（Too Many Requests）を返すようにしておくと、回数制限によるエラーであることがわかります。</p>



<p class="wp-block-paragraph">今回の集計期間では、521件のリクエストに対して429を返していました。</p>



<p class="wp-block-paragraph">このアクセス回数制限については、実装時に2つほど失敗があったのでご紹介します。</p>



<h4 class="wp-block-heading">失敗談①：アクセス回数の制限が全ユーザー共通になっていた</h4>



<p class="wp-block-paragraph">以前、Next.js と Django REST Framework（DRF）を使った Web アプリで、アクセス回数制限を実装したときのことです。</p>



<p class="wp-block-paragraph">当初、Django 側で IP アドレスをもとにアクセス回数を制限していました。</p>



<p class="wp-block-paragraph">ところが、API を呼び出しているのは Next.js のサーバーです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<p class="has-text-align-center wp-block-paragraph">利用者 A・B・C</p>



<p class="has-text-align-center wp-block-paragraph">↓</p>



<p class="has-text-align-center wp-block-paragraph"><strong>Next.js</strong></p>



<p class="has-text-align-center wp-block-paragraph">↓</p>



<p class="has-text-align-center wp-block-paragraph"><strong>Django API</strong></p>
</div></div>



<p class="wp-block-paragraph">Django 側から見ると、利用者が誰であっても Next.js からの通信です。</p>



<p class="wp-block-paragraph">僕が設定していた回数制限では、全員が同じ IP アドレスとしてカウントされていたわけです。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl" data-colset="col1"><div class="cap_box_ttl"><span>発生していた問題</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">1人が大量にアクセスすると、全員分のアクセス回数の枠を使い切ってしまい、ほかの利用者までエラーになっていました。</p>
</div></div>



<p class="wp-block-paragraph">こちらについては、利用者ごとのアクセス回数を正しく数えられるように、制限を行う場所や設定を見直すことで対応しました。</p>



<p class="is-style-big_icon_point wp-block-paragraph">アクセス回数を制限する際には、<strong>誰のアクセス回数を数えているのか</strong>を意識する必要がありますね。</p>



<h4 class="wp-block-heading">失敗談②：Next.js の prefetch で普通の利用者まで制限していた</h4>



<p class="wp-block-paragraph">もうひとつの問題が Next.js の prefetch です。</p>



<p class="wp-block-paragraph">Next.js の <code>Link</code> コンポーネントには、リンク先のページを事前に読み込む機能があります。</p>



<p class="wp-block-paragraph">あらかじめページを読み込んでおくことで、リンクをクリックした際にスムーズに画面遷移できるという便利な機能です。</p>



<p class="wp-block-paragraph">ところが、リンクが大量に並んでいる一覧ページでは、先読みのためのリクエストもまとめて発生します。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl" data-colset="col1"><div class="cap_box_ttl"><span>発生していた問題</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">普通に一覧ページを開いただけの利用者まで、アクセス回数制限に引っかかってしまっていました。</p>
</div></div>



<p class="wp-block-paragraph">こちらについては、大量のリンクが並ぶページで prefetch を無効にすることで対応しました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TSX</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>&lt;Link href={url} prefetch={false}>
  詳細を見る
&lt;/Link></textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #808080">&lt;</span><span style="color: #4EC9B0">Link</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">href</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">{</span><span style="color: #9CDCFE">url</span><span style="color: #569CD6">}</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">prefetch</span><span style="color: #D4D4D4">=</span><span style="color: #569CD6">{false}</span><span style="color: #808080">&gt;</span></span>
<span class="line"><span style="color: #D4D4D4">  詳細を見る</span></span>
<span class="line"><span style="color: #808080">&lt;/</span><span style="color: #4EC9B0">Link</span><span style="color: #808080">&gt;</span></span></code></pre></div>



<p class="wp-block-paragraph">すべてのページで無効にする必要はなく、リンクが大量に並ぶ一覧ページなどで無効にするだけでも効果があります。</p>



<p class="wp-block-paragraph">修正後のログでは、先読みによる429は0件になりました。</p>



<p class="wp-block-paragraph">セキュリティ対策のつもりで設定したアクセス回数制限が、普通の利用者の邪魔をしてしまっては本末転倒です。</p>



<p class="is-style-big_icon_point wp-block-paragraph">回数制限を導入する際には、ブラウザが裏側で発行しているリクエストについても確認しておきましょう。</p>



<h3 class="wp-block-heading">ディレクトリトラバーサルなど</h3>



<p class="wp-block-paragraph">件数は少なかったものの、公開ディレクトリの外にあるファイルを読み込もうとするアクセスもありました。</p>



<p class="wp-block-paragraph">ディレクトリトラバーサルと呼ばれる攻撃です。</p>



<p class="wp-block-paragraph">例えば、URL に <code>../</code> などを含めることで、本来アクセスできない上位ディレクトリのファイルを取得しようとするものです。</p>



<p class="wp-block-paragraph">設定ファイルや認証情報などが狙われます。</p>



<p class="wp-block-paragraph">今回、こうした攻撃に分類したアクセスは5件でした。</p>



<h4 class="wp-block-heading">ディレクトリトラバーサルへの対策</h4>



<p class="wp-block-paragraph">nginx には URL を正規化して処理する仕組みがあります。</p>



<p class="wp-block-paragraph">ただし、nginx を使っていればすべてのディレクトリトラバーサルを防げるというわけではありません。</p>



<p class="wp-block-paragraph">アプリケーション側で、利用者から受け取ったファイル名をそのままファイルの読み込み処理に渡している場合などは注意が必要です。</p>



<p class="wp-block-paragraph">基本的には以下のような対策を行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>公開するディレクトリを限定する</li>



<li>利用者から受け取ったファイルパスをそのまま使わない</li>



<li>フレームワークが提供する安全な処理を利用する</li>



<li>nginx やフレームワークを定期的に更新する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">SQL インジェクションなどについても、フレームワークの ORM やパラメータ化されたクエリを使うなど、基本的な対策をしておきましょう。</p>



<h2 class="wp-block-heading">VPS を運用するうえでやっておきたいセキュリティ対策</h2>



<p class="wp-block-paragraph">ここまでご紹介した対策をまとめると、次のようになります。</p>



<figure class="wp-block-table"><table><thead><tr><th>対象</th><th>対策</th></tr></thead><tbody><tr><td>ファイアウォール</td><td>必要なポート以外は拒否する</td></tr><tr><td>SSH</td><td>公開鍵認証・root ログイン禁止</td></tr><tr><td>Web サーバー</td><td>知らないドメイン名でのアクセスを拒否する</td></tr><tr><td>大量アクセス</td><td>アクセス回数を制限する</td></tr><tr><td>API・DB</td><td>不要な外部公開をしない</td></tr><tr><td>WordPress</td><td>可能であれば静的化する</td></tr><tr><td>認証情報</td><td>公開ディレクトリの外で管理する</td></tr><tr><td>ソフトウェア</td><td>定期的にアップデートする</td></tr><tr><td>ログ</td><td>定期的に集計して確認する</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">ほかにも、VPS を運用するうえでやっておきたい対策がいくつかあります。</p>



<h3 class="wp-block-heading">OS や Docker イメージのアップデート</h3>



<p class="wp-block-paragraph">どれだけ丁寧に設定していても、使用しているソフトウェア自体に脆弱性があれば攻撃を受ける可能性があります。</p>



<p class="wp-block-paragraph">Ubuntu であれば、unattended-upgrades を使ってセキュリティアップデートを自動で適用することもできます。</p>



<p class="wp-block-paragraph">また、Docker を使っている場合には、ホスト側の OS だけでなく、コンテナ側のソフトウェアも更新する必要があります。</p>



<p class="is-style-big_icon_memo wp-block-paragraph">ホスト側の OS を更新しただけでは、Docker コンテナ内のソフトウェアは更新されません。Docker イメージの更新やコンテナの再作成も忘れないようにしましょう。</p>



<h3 class="wp-block-heading">HTTPS 化とセキュリティヘッダーの設定</h3>



<p class="wp-block-paragraph">Web サイトを公開するのであれば、HTTPS 化もしておきたいところです。</p>



<p class="wp-block-paragraph">Let&#8217;s Encrypt を使えば、無料で TLS 証明書を発行することができます。</p>



<p class="wp-block-paragraph">また、セキュリティ関連の HTTP レスポンスヘッダーも設定しておくとよいでしょう。</p>



<figure class="wp-block-table"><table><thead><tr><th>ヘッダー</th><th>主な役割</th></tr></thead><tbody><tr><td>Strict-Transport-Security（HSTS）</td><td>HTTPS での通信を強制する</td></tr><tr><td>X-Content-Type-Options</td><td>ブラウザによるコンテンツタイプの推測を制限する</td></tr><tr><td>Referrer-Policy</td><td>リンク元の情報をどこまで送信するか制御する</td></tr><tr><td>Content-Security-Policy（CSP）</td><td>スクリプトなどの読み込み・実行を制限する</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">それぞれ役割は異なりますが、意図しないスクリプトの実行や情報の漏えいなど、ブラウザ側で発生するリスクを減らすためのものです。</p>



<h3 class="wp-block-heading">Docker コンテナの権限制限</h3>



<p class="wp-block-paragraph">Docker を使っている場合には、コンテナの権限を必要最小限にしておくことも大切です。</p>



<p class="wp-block-paragraph">例えば、以下のような対策があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>コンテナ内のプロセスを非 root ユーザーで動かす</li>



<li>必要のない権限を与えない</li>



<li>ファイルシステムを可能な範囲で読み取り専用にする</li>



<li>メモリなどのリソースに上限を設ける</li>
</ul>
</div></div>



<p class="wp-block-paragraph">また、<code>no-new-privileges</code> という設定を使うことで、コンテナ内のプロセスが実行時に新たな権限を取得することを制限できます。</p>



<p class="wp-block-paragraph">Docker Compose であれば、以下のように記載します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>security_opt:
  - no-new-privileges:true</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">security_opt</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  - </span><span style="color: #CE9178">no-new-privileges:true</span></span></code></pre></div>



<p class="wp-block-paragraph">仮にアプリケーションに脆弱性があった場合でも、被害をできるだけ小さくするための対策ですね。</p>



<h3 class="wp-block-heading">ログを定期的に確認する</h3>



<p class="wp-block-paragraph">セキュリティ対策をするだけでなく、ログを定期的に確認することも大切です。</p>



<p class="wp-block-paragraph">ログを集計することで、以下のようなことがわかります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>どんなファイルが狙われているのか</li>



<li>どのくらいの頻度で攻撃が来ているのか</li>



<li>大量アクセスが発生していないか</li>



<li>普通の利用者までアクセス回数制限に引っかかっていないか</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ちなみに、nginx のアクセスログは JSON 形式で記録することもできます。</p>



<p class="wp-block-paragraph">JSON 形式にしておくと、Python などでログを集計する際にも便利です。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">URL のクエリパラメータやリクエストの内容には、個人情報や認証情報が含まれる場合があります。セキュリティのためのログとはいえ、必要以上に利用者の情報を記録しないようにすることも大切です。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">今回は、個人で運用している VPS に来た1週間分の攻撃と、その防ぎ方についてご紹介しました。</p>



<p class="wp-block-paragraph">個人の小さな VPS であっても、インターネットに公開している以上、さまざまな攻撃や不審なアクセスが来ます。</p>



<p class="wp-block-paragraph">ただ、実際にログを見てみると、その多くは決まったユーザー名やファイル名を機械的に試しているものです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-check_list">
<li>パスワード認証を無効にする</li>



<li>不要なポートを閉じる</li>



<li>秘密のファイルを公開しない</li>



<li>使っていないソフトウェアを入れない</li>



<li>ソフトウェアを定期的に更新する</li>



<li>ログを定期的に確認する</li>
</ul>
</div></div>



<p class="wp-block-paragraph">こういった基本的な対策だけでも、今回観測した攻撃の多くに対応できます。</p>



<p class="wp-block-paragraph">そして、VPS を運用するうえで大切だと思うのが、<strong><span class="swl-marker mark_yellow">守るよりも、そもそも外部に公開しないこと。</span></strong></p>



<p class="wp-block-paragraph">WordPress を静的化することも、データベースを Docker の内部ネットワークに閉じておくことも、この考え方に基づいています。</p>



<p class="wp-block-paragraph">もちろん、今回ご紹介した対策だけですべての攻撃を防げるわけではありません。</p>



<p class="wp-block-paragraph">ログを定期的に確認しながら、必要に応じて対策を見直していくことも大切です。</p>



<p class="wp-block-paragraph">VPS で個人開発のサービスを運用している方の参考になれば幸いです。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>sshd_configの設定｜SSHのパスワード無効・rootログイン禁止の手順</title>
		<link>https://cfxlog.com/vps-ssh-hardening/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 05 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[SSH]]></category>
		<category><![CDATA[サーバー運用]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/vps-ssh-hardening/</guid>

					<description><![CDATA[SSH の設定は、同じ項目を最初に読んだ値で決まります。 そのため、sshd_config.d に置くファイルの名前の番号で、効く値が変わります。 この記事では、僕の VPS で実際に動かしている設定を例に、パスワードロ [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>SSH のパスワードログインを止めたのに、sshd -T で見ると yes のまま</li>



<li>sshd_config と sshd_config.d のどこに書けば効くのか分からない</li>



<li>設定を間違えて、自分がサーバーに入れなくなるのが怖い</li>
</ul>
</div></div>



<p class="wp-block-paragraph">SSH の設定は、<strong>同じ項目を最初に読んだ値で決まります</strong>。</p>



<p class="wp-block-paragraph">そのため、sshd_config.d に置くファイルの名前の番号で、効く値が変わります。</p>



<p class="wp-block-paragraph">この記事では、僕の VPS で実際に動かしている設定を例に、パスワードログインと root ログインを止める手順を紹介します。</p>



<p class="wp-block-paragraph">あわせて、締め出されないための確かめ方と、ログで総当たりの数を数える方法もまとめます。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody><tr><td>VPS</td><td>KAGOYA CLOUD VPS（2コア・メモリ2GB）</td></tr><tr><td>OS</td><td>Ubuntu 26.04.1 LTS</td></tr><tr><td>SSH サーバー</td><td>OpenSSH 10.2p1</td></tr><tr><td>ファイアウォール</td><td>UFW（22・80・443 だけ許可）</td></tr></tbody></table><figcaption class="wp-element-caption">この記事の環境（2026年11月19日に確認）</figcaption></figure>



<p class="wp-block-paragraph">以前はエックスサーバーVPS を使っていましたが、値段が年々上がったので KAGOYA CLOUD VPS に移りました。</p>



<p class="wp-block-paragraph"><a href="https://px.a8.net/svt/ejp?a8mat=4BGO4I+CIDQQ+7YE+TR13N&amp;a8ejpredirect=https%3A%2F%2Fwww.kagoya.jp%2Fvps%2F" rel="nofollow sponsored">KAGOYA CLOUD VPS の公式サイトを見る</a></p>



<h2 class="wp-block-heading">結論：sshd_config.d に番号の若いファイルを置き、sshd -T で確かめる</h2>



<p class="wp-block-paragraph">先に、僕が最終的に置いている設定を載せます。ファイルは <code>/etc/ssh/sshd_config.d/01-myserver.conf</code> です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
PubkeyAuthentication yes
X11Forwarding no</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">PasswordAuthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">KbdInteractiveAuthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">PermitRootLogin no</span></span>
<span class="line"><span style="color: #D4D4D4">PubkeyAuthentication yes</span></span>
<span class="line"><span style="color: #D4D4D4">X11Forwarding no</span></span></code></pre></div>



<p class="wp-block-paragraph">大事なのは、中身よりも<strong>ファイル名の先頭の 01-</strong> です。</p>



<p class="wp-block-paragraph">この番号にしている理由を、次の章で説明します。</p>



<h2 class="wp-block-heading">sshd_config.d は名前順に読まれ、最初の値が使われる</h2>



<p class="wp-block-paragraph">Ubuntu の <code>/etc/ssh/sshd_config</code> は、先頭のほうで sshd_config.d の中のファイルを読み込みます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Include /etc/ssh/sshd_config.d/*.conf</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">Include /etc/ssh/sshd_config.d/*.conf</span></span></code></pre></div>



<p class="wp-block-paragraph">読み込む順番は、ファイル名の順です。</p>



<p class="wp-block-paragraph">そして sshd は、<strong>同じ項目が何度出てきても、最初に読んだ値を使います</strong>。あとから書いた値で上書きされるわけではありません。</p>



<h3 class="wp-block-heading">実例：cloud-init のファイルに PasswordAuthentication yes があった</h3>



<p class="wp-block-paragraph">僕の VPS の sshd_config.d には、ファイルが2つあります。</p>



<figure class="wp-block-table"><table><thead><tr><th>ファイル</th><th>置いたもの</th><th>PasswordAuthentication</th></tr></thead><tbody><tr><td><code>01-myserver.conf</code></td><td>自分</td><td>no</td></tr><tr><td><code>50-cloud-init.conf</code></td><td>cloud-init（サーバー作成時の初期設定）</td><td><strong>yes</strong></td></tr></tbody></table><figcaption class="wp-element-caption">sshd_config.d の中身（2026年11月19日）</figcaption></figure>



<p class="wp-block-paragraph">50-cloud-init.conf は、サーバーを作ったときに自動で置かれたものです。中にパスワードログインを許す設定が入っていました。</p>



<p class="wp-block-paragraph">自分のファイルを 01- で始めたので、こちらが先に読まれ、no が勝っています。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">もし自分のファイルを 60-myserver.conf のような名前にしていたら、先に読まれる 50- の yes が使われます。</p>



<p class="wp-block-paragraph">書いたはずの no が効かないときは、まず sshd_config.d の中のファイル名を見てください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ls /etc/ssh/sshd_config.d/
sudo grep -ri passwordauthentication /etc/ssh/sshd_config /etc/ssh/sshd_config.d/</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ls /etc/ssh/sshd_config.d/</span></span>
<span class="line"><span style="color: #D4D4D4">sudo grep -ri passwordauthentication /etc/ssh/sshd_config /etc/ssh/sshd_config.d/</span></span></code></pre></div>



<h2 class="wp-block-heading">パスワードログインと root ログインを止める手順</h2>



<p class="wp-block-paragraph">ここからは、設定を入れる手順です。</p>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>締め出されないための進め方</span></div><div class="cap_box_content">
<ol class="wp-block-list is-style-num_circle">
<li>鍵でログインできることを先に確かめる</li>



<li>設定ファイルを作る</li>



<li>sshd -t で書き間違いがないか確かめる</li>



<li>設定を読み直す</li>



<li><strong>今の接続を切らずに</strong>、別の端末で鍵ログインを確かめる</li>



<li>sshd -T で実際に効いている値を確かめる</li>
</ol>
</div></div>



<h3 class="wp-block-heading">① 鍵でログインできることを先に確かめる</h3>



<p class="wp-block-paragraph">パスワードを止めると、鍵がないとログインできなくなります。</p>



<p class="wp-block-paragraph">先に、鍵だけでログインできるかを確かめます。<code>BatchMode=yes</code> を付けると、パスワードを聞かれずに鍵だけで試せます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ssh -i ~/.ssh/my-vps.key -o BatchMode=yes ubuntu@VPS_IP</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ssh -i ~/.ssh/my-vps.key -o BatchMode=yes ubuntu@VPS_IP</span></span></code></pre></div>



<p class="wp-block-paragraph">鍵の作り方や接続の基本は、こちらの記事にまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ssh-guide-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ssh-guide/">SSH接続の方法｜基本の手順から便利な設定・トラブルシューティングまで</a>
						<span class="p-blogCard__excerpt">公開鍵方式ってなんだか苦手… 秘密鍵と公開鍵、何が違うの？ 鍵のセットアップがわからん！ このような方に向けて書きました。 Webのお仕事をしていると、当然のように&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">② 設定ファイルを作る</h3>



<p class="wp-block-paragraph">sshd_config.d に、01- で始まるファイルを作ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo nano /etc/ssh/sshd_config.d/01-myserver.conf</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo nano /etc/ssh/sshd_config.d/01-myserver.conf</span></span></code></pre></div>



<p class="wp-block-paragraph">中身は、結論で載せた5行です。それぞれの意味は次のとおりです。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>値</th><th>意味</th></tr></thead><tbody><tr><td><code>PasswordAuthentication</code></td><td>no</td><td>パスワードでのログインを許さない</td></tr><tr><td><code>KbdInteractiveAuthentication</code></td><td>no</td><td>キーボード入力式の認証（パスワード入力の一種）を許さない</td></tr><tr><td><code>PermitRootLogin</code></td><td>no</td><td>root で直接ログインさせない</td></tr><tr><td><code>PubkeyAuthentication</code></td><td>yes</td><td>鍵での認証を使う</td></tr><tr><td><code>X11Forwarding</code></td><td>no</td><td>画面の転送（X11）を使わない</td></tr></tbody></table><figcaption class="wp-element-caption">01-myserver.conf の設定</figcaption></figure>



<p class="wp-block-paragraph">PasswordAuthentication だけを no にしても、KbdInteractiveAuthentication が yes だと、パスワードを入力する形のログインが残ることがあります。</p>



<p class="wp-block-paragraph">そのため、2つとも no にしておきます。</p>



<p class="wp-block-paragraph">root でのログインをやめて一般ユーザーで作業する考え方は、こちらの記事で書いています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-ubuntu-user-management-security-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-ubuntu-user-management-security/">Ubuntuのスーパーユーザーとrootログイン禁止・sudo設定</a>
						<span class="p-blogCard__excerpt">Ubuntuのユーザーってどんなもの？ 普段rootユーザーでログインしてる… セキュリティ対策が気になる このような方に向けて書きました。 普段 root ユーザーのまま Ubunt&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h3 class="wp-block-heading">③ sshd -t で書き間違いがないか確かめる</h3>



<p class="wp-block-paragraph">保存したら、反映する前に文法を確かめます。<strong>問題がなければ何も表示されません</strong>。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo sshd -t</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo sshd -t</span></span></code></pre></div>



<p class="wp-block-paragraph">項目名の打ち間違いなどがあると、ファイル名と行番号つきでエラーが出ます。直してから次へ進みます。</p>



<h3 class="wp-block-heading">④ 設定を読み直す</h3>



<p class="wp-block-paragraph">Ubuntu では、SSH のサービス名は ssh です。reload で設定を読み直します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo systemctl reload ssh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo systemctl reload ssh</span></span></code></pre></div>



<h3 class="wp-block-heading">⑤ 今の接続を切らずに、別の端末で鍵ログインを確かめる</h3>



<div class="swell-block-capbox cap_box is-style-onborder_ttl"><div class="cap_box_ttl"><span>注意：今のターミナルは閉じない</span></div><div class="cap_box_content">
<p class="wp-block-paragraph">設定を間違えていると、新しい接続ができなくなります。</p>



<p class="wp-block-paragraph">作業中のターミナルは残したまま、別のターミナルを開いて鍵でログインできるかを確かめてください。</p>
</div></div>



<p class="wp-block-paragraph">新しいターミナルで、①と同じコマンドを実行します。ログインできれば、今までのターミナルを閉じても大丈夫です。</p>



<p class="wp-block-paragraph">あわせて、パスワードでは入れないことも確かめておくと安心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>ssh -o PubkeyAuthentication=no ubuntu@VPS_IP</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">ssh -o PubkeyAuthentication=no ubuntu@VPS_IP</span></span></code></pre></div>



<p class="wp-block-paragraph">鍵を使わない設定で接続し、<code>Permission denied (publickey)</code> のように断られれば止まっています。</p>



<h3 class="wp-block-heading">⑥ sshd -T で実際に効いている値を確かめる</h3>



<p class="wp-block-paragraph">大文字の <code>-T</code> は、すべてのファイルを読んだ結果、<strong>実際に使われる値</strong>を表示します。</p>



<p class="wp-block-paragraph">ファイルの中身ではなく最終的な値が見られるので、番号の問題もここで分かります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo sshd -T | grep -E '^(permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication) '</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo sshd -T | grep -E '^(permitrootlogin|passwordauthentication|kbdinteractiveauthentication|pubkeyauthentication) '</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の VPS では、次の値になっていました。項目名は小文字で表示されます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>permitrootlogin no
passwordauthentication no
kbdinteractiveauthentication no
pubkeyauthentication yes</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">permitrootlogin no</span></span>
<span class="line"><span style="color: #D4D4D4">passwordauthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">kbdinteractiveauthentication no</span></span>
<span class="line"><span style="color: #D4D4D4">pubkeyauthentication yes</span></span></code></pre></div>



<p class="wp-block-paragraph">50-cloud-init.conf に yes が書かれていても、passwordauthentication は no です。01- のファイルが効いていることが分かります。</p>



<h2 class="wp-block-heading">ログで総当たりの数を数える（journalctl -u ssh）</h2>



<p class="wp-block-paragraph">設定が効いているかは、ログからも確かめられます。Ubuntu の SSH のログは <code>journalctl -u ssh</code> で読めます。</p>



<h3 class="wp-block-heading">ログインの失敗を数える</h3>



<p class="wp-block-paragraph">直近7日の失敗のログを数えるなら、次のようにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo journalctl -u ssh --since "7 days ago" | grep -cE 'Invalid user|authentication failure|preauth'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo journalctl -u ssh --since "7 days ago" | grep -cE 'Invalid user|authentication failure|preauth'</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の VPS でこのコマンドを実行すると、<strong>7日間で 20,157 行</strong>でした（2026年11月19日に確認）。1回の試行で複数の行が出るので、回数ではなく行数の目安です。</p>



<p class="wp-block-paragraph">存在しないユーザー名での試行、認証の失敗、認証の途中での切断が中心です。root への総当たりで出る <code>maximum authentication attempts exceeded for root</code> も出ていました。</p>



<h3 class="wp-block-heading">成功したログインが自分だけか確かめる</h3>



<p class="wp-block-paragraph">失敗の数よりも大事なのは、<strong>成功したログインに知らないものがないか</strong>です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo journalctl -u ssh --since "7 days ago" | grep 'Accepted'</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo journalctl -u ssh --since "7 days ago" | grep 'Accepted'</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の VPS では、成功したログインは全部、自分の鍵での接続（<code>Accepted publickey</code>）だけでした。</p>



<p class="wp-block-paragraph">パスワードを止めているので、1万回試されてもパスワードでは入れません。</p>



<h3 class="wp-block-heading">古い ssh-rsa の鍵は断られる</h3>



<p class="wp-block-paragraph">ログには、次のような行も出ていました。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Plaintext</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>userauth_pubkey: signature algorithm ssh-rsa not in PubkeyAcceptedAlgorithms</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">userauth_pubkey: signature algorithm ssh-rsa not in PubkeyAcceptedAlgorithms</span></span></code></pre></div>



<p class="wp-block-paragraph">古いクライアントが、SHA-1 を使う ssh-rsa の署名で接続しようとして断られた記録です。今の OpenSSH は、初期設定でこの署名を受け付けません。</p>



<p class="wp-block-paragraph">自分の鍵でこのエラーが出るときは、ed25519 などの新しい鍵を作り直すのが早いです。</p>



<p class="wp-block-paragraph">1週間に届いた攻撃の中身（よく狙われるユーザー名など）は、こちらの記事にまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/vps-security-measures-300x158.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/vps-security-measures/">【VPSのセキュリティ対策】個人のVPSに1週間でどんな攻撃が来たか？実際のログと防ぎ方</a>
						<span class="p-blogCard__excerpt">個人開発で Web サービスを公開するために、VPS を運用しています。 今回は、そんな僕の VPS にどんな攻撃が来ているのか、1週間分のログを集計してみました。 結果は次&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">ログから必要な行だけを抜き出すときは、grep が便利です。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/03/linux-grep-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-grep-command/">【Linux】grep コマンドを使ってテキスト検索を効率化しよう！</a>
						<span class="p-blogCard__excerpt">この記事では、Linux でテキスト検索を行うためのgrepコマンドを解説します。 基本的な使い方から正規表現を使った高度な検索方法までをカバーしますので、検索に自信が&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">UFW で 22・80・443 だけを開ける</h2>



<p class="wp-block-paragraph">SSH の設定とあわせて、ファイアウォールで受け付けるポートを絞っています。</p>



<p class="wp-block-paragraph">僕の VPS の UFW は、いまは有効です。<strong>外から来る通信は既定で拒否し、22（SSH）・80・443（Web）だけ</strong>を許可しています。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo ufw status verbose</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo ufw status verbose</span></span></code></pre></div>



<p class="wp-block-paragraph">表示の中に、<code>Default: deny (incoming)</code> と、22/tcp・80/tcp・443/tcp の ALLOW（IPv4 と IPv6）が並んでいれば同じ状態です。</p>



<h3 class="wp-block-heading">有効にする前に 22 番を許可する</h3>



<p class="wp-block-paragraph">これから UFW を有効にする場合は、<strong>先に 22 番を許可してから</strong> enable します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo ufw allow 22/tcp</span></span>
<span class="line"><span style="color: #D4D4D4">sudo ufw allow 80/tcp</span></span>
<span class="line"><span style="color: #D4D4D4">sudo ufw allow 443/tcp</span></span>
<span class="line"><span style="color: #D4D4D4">sudo ufw enable</span></span></code></pre></div>



<p class="is-style-big_icon_caution wp-block-paragraph">22 番を許可せずに有効にすると、今の SSH 接続も切れることがあります。ここでも、今のターミナルは閉じずに進めます。</p>



<h3 class="wp-block-heading">待ち受けているポートも確かめる</h3>



<p class="wp-block-paragraph">ファイアウォールとは別に、サーバーが実際に待ち受けているポートも見ておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo ss -tlnp</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">sudo ss -tlnp</span></span></code></pre></div>



<p class="wp-block-paragraph">僕の VPS で外向けに待ち受けているのは、22（sshd）と 80・443（Docker の nginx）だけでした。</p>



<p class="is-style-icon_info wp-block-paragraph">Docker で ports に書いて公開したポートは、UFW の設定を通らずに外から届くことがあります。Docker の公式ドキュメントでも注意されている点です。</p>



<p class="wp-block-paragraph">そのため僕は、アプリや DB のポートを ports で公開せず、nginx の 80・443 だけを公開しています。</p>



<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">SSH のポート番号は 22 から変えたほうがいいですか？</h3><div class="faq_a">
<p class="wp-block-paragraph">僕は 22 のままにしています。</p>



<p class="wp-block-paragraph">ポートを変えるとログに残る試行は減るかもしれませんが、パスワードを止めて鍵だけにする方が先です。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">sshd_config の本体を直接書き換えてもいいですか？</h3><div class="faq_a">
<p class="wp-block-paragraph">書き換えても動きます。ただ、本体より先に読まれる sshd_config.d の値が優先されることがあります。</p>



<p class="wp-block-paragraph">自分の設定は sshd_config.d に番号の若いファイルで置くと、どこが効いているか分かりやすいです。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">設定を間違えて入れなくなったらどうしますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">VPS の事業者が用意しているコンソール（ブラウザから入る画面）からログインして、設定ファイルを直します。</p>



<p class="wp-block-paragraph">そうならないよう、今の接続を残したまま別の端末で確かめてください。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：番号の若いファイルに書き、sshd -T と別端末で確かめる</h2>



<p class="wp-block-paragraph">SSH のパスワードログインと root ログインは、sshd_config.d に 01- で始まるファイルを置いて止めます。</p>



<p class="wp-block-paragraph">反映したら、今の接続を残したまま別の端末で鍵ログインを確かめ、sshd -T で実際の値を見ておけば安心です。</p>



<p class="wp-block-paragraph">VPS を借りてからサイトを公開するまでの全体の流れは、こちらにまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-vps-roadmap/">個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</a>
						<span class="p-blogCard__excerpt">個人で VPS を借りたいけど、何から始めればいいか分からない Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい HTTPS 化や Docker での運用まで、ど&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">KAGOYA CLOUD VPS でサーバーを作ってから最初にログインするまでは、こちらの記事にあります。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-300x130.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-kagoya-vps-setup/">KAGOYA CLOUD VPSの使い方｜インスタンス作成からSSH接続・初期設定まで【Ubuntu】</a>
						<span class="p-blogCard__excerpt">KAGOYA CLOUD VPS を契約したけれど、最初に何をすればいいか分からない インスタンス作成画面の項目が多くて、どれを選べばいいか迷う SSH でログインして、最低限の初&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>メール送信しないドメインのSPF・DMARC｜v=spf1 -allの設定</title>
		<link>https://cfxlog.com/dns-spf-dmarc-no-mail-domain/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 01 Nov 2026 00:00:00 +0000</pubDate>
				<category><![CDATA[VPS・サーバー運用]]></category>
		<category><![CDATA[DNS]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/dns-spf-dmarc-no-mail-domain/</guid>

					<description><![CDATA[メールを使わないドメインでも、「このドメインからはメールを送らない」と DNS で宣言しておくと、なりすましメールに使われにくくなります。 やることは、TXT レコードを2つ足すだけです。 この記事では、僕が Web だ [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Web サイトだけで、メールは使わないドメインを持っている</li>



<li>メールを送らないなら、SPF や DMARC は設定しなくていいのか知りたい</li>



<li>TXT レコードを足したら、前からあったレコードが消えないか心配</li>
</ul>
</div></div>



<p class="wp-block-paragraph">メールを使わないドメインでも、<strong>「このドメインからはメールを送らない」と DNS で宣言しておく</strong>と、なりすましメールに使われにくくなります。</p>



<p class="wp-block-paragraph">やることは、TXT レコードを2つ足すだけです。</p>



<p class="wp-block-paragraph">この記事では、僕が Web だけで使っているドメインに入れた設定と、KAGOYA の DNS で登録したときに気づいた注意点を紹介します。</p>



<figure class="wp-block-table"><table><thead><tr><th>項目</th><th>内容</th></tr></thead><tbody><tr><td>DNS</td><td>KAGOYA CLOUD VPS の DNS（ネームサーバーを KAGOYA に委任）</td></tr><tr><td>ドメインの用途</td><td>Web サイトだけ。メールの送受信はしない</td></tr><tr><td>登録・確認した日</td><td>2026年11月12日</td></tr><tr><td>確かめたコマンド</td><td>dig（権威 DNS の ns0・ns1 に問い合わせ）</td></tr></tbody></table><figcaption class="wp-element-caption">この記事の環境</figcaption></figure>



<h2 class="wp-block-heading">結論：v=spf1 -all と v=DMARC1; p=reject の2行を足す</h2>



<p class="wp-block-paragraph">足すのは、次の2つの TXT レコードです。</p>



<figure class="wp-block-table"><table><thead><tr><th>ホスト名</th><th>種類</th><th>値</th><th>意味</th></tr></thead><tbody><tr><td>（ルート）</td><td>TXT</td><td><code>v=spf1 -all</code></td><td>このドメインからはメールを送らない</td></tr><tr><td><code>_dmarc</code></td><td>TXT</td><td><code>v=DMARC1; p=reject</code></td><td>なりすましメールを受信側で拒否させる</td></tr></tbody></table><figcaption class="wp-element-caption">メールを使わないドメインに足す TXT レコード</figcaption></figure>



<p class="wp-block-paragraph">どちらも、<strong>今ある TXT レコードは書き換えず、別の行として足します</strong>。理由はあとで書きます。</p>



<h2 class="wp-block-heading">なぜメールを送らないドメインに設定するのか</h2>



<p class="wp-block-paragraph">メールの送信者のアドレスは、誰でも自由に書けてしまいます。</p>



<p class="wp-block-paragraph">何も設定していないドメインは、受信側から見ると「本物かどうか判断できない」状態です。その名前で、なりすましメールを送られるおそれがあります。</p>



<h3 class="wp-block-heading">SPF の v=spf1 -all：送ってよいサーバーは1つもない</h3>



<p class="wp-block-paragraph">SPF は、そのドメインのメールを送ってよいサーバーを DNS に書いておく仕組みです。</p>



<p class="wp-block-paragraph"><code>v=spf1 -all</code> は、送ってよいサーバーを1つも書かずに <code>-all</code>（ほかはすべて不合格）で終える書き方です。</p>



<p class="wp-block-paragraph">つまり、<strong>このドメインを名乗るメールは、どこから届いても不合格</strong>という意味になります。</p>



<p class="wp-block-paragraph">末尾が <code>~all</code> だと「不合格の疑いあり」くらいの弱い意味です。送らないと決まっているなら <code>-all</code> で言い切れます。</p>



<h3 class="wp-block-heading">DMARC の p=reject：不合格のメールは受け取らないよう頼む</h3>



<p class="wp-block-paragraph">DMARC は、SPF などで不合格になったメールを、受信側にどう扱ってほしいかを伝える仕組みです。</p>



<p class="wp-block-paragraph"><code>p=reject</code> は「受け取らずに拒否して」という、いちばん強い指定です。</p>



<p class="wp-block-paragraph">ホスト名 <code>_dmarc</code> に置いた設定は、サブドメインのメールにも効きます。</p>



<p class="wp-block-paragraph">SPF だけでは、不合格のメールをどう扱うかは受信側しだいです。DMARC まで入れておくと、拒否してほしいとはっきり伝えられます。</p>



<h2 class="wp-block-heading">KAGOYA の DNS で登録する手順</h2>



<p class="wp-block-paragraph">KAGOYA CLOUD VPS のコントロールパネルの DNS 画面で、レコードを追加します。ほかの DNS サービスでも、入れる値は同じです。</p>



<h3 class="wp-block-heading">今ある TXT は書き換えず、別の行で足す</h3>



<p class="wp-block-paragraph">僕のドメインのルートには、Google Search Console の所有権の確認に使う TXT（<code>google-site-verification=…</code>）が入っています。</p>



<p class="is-style-big_icon_caution wp-block-paragraph">Search Console は、所有権を定期的に確かめ直します。この TXT を消したり書き換えたりすると、確認が外れてしまいます。</p>



<p class="wp-block-paragraph">そのため、SPF は既存の TXT の値に書き足すのではなく、<strong>新しい TXT の行として追加</strong>します。</p>



<p class="wp-block-paragraph">同じホスト名に TXT が何行あっても問題ありません。</p>



<h3 class="wp-block-heading">初期設定の SPF が外れていないか確かめる</h3>



<p class="wp-block-paragraph">僕のドメインでは、KAGOYA が初期設定で <code>~all</code> で終わる SPF を入れていました。</p>



<p class="wp-block-paragraph">ところが、TXT を追加したときに、その SPF が外れていました。</p>



<p class="wp-block-paragraph">TXT をいじったあとは、<strong>ほかの TXT が残っているかを必ず dig で確かめる</strong>ようにしています。</p>



<h3 class="wp-block-heading">ルートに v=spf1 -all、_dmarc に p=reject を追加する</h3>



<p class="wp-block-paragraph">DNS 画面で、次の2件を追加しました。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>ホスト名：空欄（ルート）　種類：TXT　値：<code>v=spf1 -all</code></li>



<li>ホスト名：<code>_dmarc</code>　種類：TXT　値：<code>v=DMARC1; p=reject</code></li>
</ul>
</div></div>



<p class="wp-block-paragraph">KAGOYA の公式手順では、レコードを設定してからネームサーバーに反映されるまで約15分で、更新は毎時0・15・30・45分と案内されています。</p>



<h2 class="wp-block-heading">dig で権威 DNS に確かめる</h2>



<p class="wp-block-paragraph">反映したかは、dig で<strong>権威 DNS（KAGOYA のネームサーバー）に直接</strong>問い合わせて確かめます。</p>



<p class="wp-block-paragraph">キャッシュを持つ DNS に聞くと、古い答えが返ることがあるためです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">ShellScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ルートの TXT（SPF と Search Console の確認用）
dig @ns0.kagoya.net example.com TXT +norecurse +short
dig @ns1.kagoya.net example.com TXT +norecurse +short

# DMARC
dig @ns0.kagoya.net _dmarc.example.com TXT +norecurse +short
dig @ns1.kagoya.net _dmarc.example.com TXT +norecurse +short</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># ルートの TXT（SPF と Search Console の確認用）</span></span>
<span class="line"><span style="color: #D4D4D4">dig @ns0.kagoya.net example.com TXT +norecurse +short</span></span>
<span class="line"><span style="color: #D4D4D4">dig @ns1.kagoya.net example.com TXT +norecurse +short</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># DMARC</span></span>
<span class="line"><span style="color: #D4D4D4">dig @ns0.kagoya.net _dmarc.example.com TXT +norecurse +short</span></span>
<span class="line"><span style="color: #D4D4D4">dig @ns1.kagoya.net _dmarc.example.com TXT +norecurse +short</span></span></code></pre></div>



<p class="wp-block-paragraph">ルートの TXT では、<code>"v=spf1 -all"</code> と <code>"google-site-verification=…"</code> の両方が返れば大丈夫です。</p>



<p class="wp-block-paragraph">_dmarc では、<code>"v=DMARC1; p=reject"</code> が返れば反映しています。</p>



<p class="wp-block-paragraph">僕のときは、登録して少し待ってから ns0・ns1 の両方で返ることを確かめました。</p>



<p class="wp-block-paragraph">dig で TXT や MX を確かめる方法は、こちらの記事に詳しくまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/dig-mx-txt-mail/">digでMX・TXTレコードを確認する方法｜メールが届かないときのDNS調査</a>
						<span class="p-blogCard__excerpt">メール障害時のMX・SPF・DKIM・DMARCの確認方法を解説。digで分かる範囲と、メールヘッダーやログで確認する項目を整理します。</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">反映されないときに、権威 DNS とキャッシュのどちらを見ればいいかは、こちらです。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/dig-dns-propagation/">DNSが反映されないときの確認方法｜digで権威DNSとキャッシュを比較</a>
						<span class="p-blogCard__excerpt">DNS変更後も古いIPが返る原因を解説。権威DNS、公開リゾルバー、TTL、ネガティブキャッシュを順番に確認します。</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">KAGOYA が自動で入れる MX は消せない</h2>



<p class="wp-block-paragraph">KAGOYA の DNS には、メールの受け取り先を示す MX レコードが自動で入っています。</p>



<h3 class="wp-block-heading">一覧に出ず、DNS 画面から削除できない</h3>



<p class="wp-block-paragraph">この MX は DNS 画面のレコード一覧に表示されず、削除もできませんでした。</p>



<p class="wp-block-paragraph">ただ、MX が指している先のホスト名には A レコードがありません。そのため、このドメイン宛てのメールは届きません。</p>



<h3 class="wp-block-heading">送信のなりすましは SPF と DMARC で防げる</h3>



<p class="wp-block-paragraph">MX は受信のためのレコードで、送信には関係しません。</p>



<p class="wp-block-paragraph">送信のなりすましは、上で足した SPF と DMARC で防げます。MX が消せなくても、この2件があれば困ることはありませんでした。</p>



<p class="is-style-icon_info wp-block-paragraph">ドメインを買ったのはエックスサーバーで、そちらにも DNS の設定画面があります。ただ、ネームサーバーを KAGOYA に任せているので、そちらの設定は使われません。</p>



<p class="wp-block-paragraph">KAGOYA にネームサーバーを向ける手順は、こちらの記事にあります。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/11/kagoya-vps-create-spec-300x130.png" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-kagoya-vps-setup/">KAGOYA CLOUD VPSの使い方｜インスタンス作成からSSH接続・初期設定まで【Ubuntu】</a>
						<span class="p-blogCard__excerpt">KAGOYA CLOUD VPS を契約したけれど、最初に何をすればいいか分からない インスタンス作成画面の項目が多くて、どれを選べばいいか迷う SSH でログインして、最低限の初&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">よくある質問</h2>



<div class="swell-block-faq is-style-faq-border" data-q="fill-custom" data-a="fill-main">
<div class="swell-block-faq__item"><h3 class="faq_q">SPF のレコードを2つ入れてもいいですか？</h3><div class="faq_a">
<p class="wp-block-paragraph">SPF（v=spf1 で始まる TXT）は、1つのドメインに1つだけにします。2つあると、正しく判定されなくなります。</p>



<p class="wp-block-paragraph">ほかの TXT（Search Console など）とは、別の行で並べて問題ありません。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">あとでメールを使うことになったら？</h3><div class="faq_a">
<p class="wp-block-paragraph">使うメールサービスの案内に合わせて、SPF の -all の前に送信元を足し、DMARC の設定も見直します。</p>



<p class="wp-block-paragraph">p=reject のままだと、設定が整う前のメールが拒否されることがあるので注意してください。</p>
</div></div>



<div class="swell-block-faq__item"><h3 class="faq_q">サブドメインにも SPF を入れる必要がありますか？</h3><div class="faq_a">
<p class="wp-block-paragraph">僕はルートと _dmarc の2件だけにしています。</p>



<p class="wp-block-paragraph">_dmarc の p=reject はサブドメインにも効くので、なりすましのメールは拒否してもらえます。</p>
</div></div>
</div>



<h2 class="wp-block-heading">まとめ：送らないドメインは -all と p=reject で宣言しておく</h2>



<p class="wp-block-paragraph">メールを使わないドメインには、ルートに <code>v=spf1 -all</code>、<code>_dmarc</code> に <code>v=DMARC1; p=reject</code> の TXT を足しておきます。</p>



<p class="wp-block-paragraph">既存の TXT は書き換えず別の行で足し、最後に dig で権威 DNS に確かめれば完了です。</p>



<p class="wp-block-paragraph">dig コマンドの使い方をまとめて知りたい場合は、こちらをどうぞ。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/02/linux-dig-command-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-dig-command/">【完全保存版】digコマンドの全網羅ガイド｜DNS調査・トラブルシューティングの必須ツールを徹底解説</a>
						<span class="p-blogCard__excerpt">DNS の調査や、サイトが表示されない時のトラブルシューティングでは dig コマンドが便利。 この記事では、初級〜上級エンジニアまで必ず使える 「dig の使い方を可能な&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">VPS を借りてからドメインを設定し、サイトを公開するまでの流れは、こちらにまとめています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/linux-vps-roadmap/">個人でVPSを構築する手順まとめ｜借りてからWebサイト公開・Docker運用まで5ステップ</a>
						<span class="p-blogCard__excerpt">個人で VPS を借りたいけど、何から始めればいいか分からない Web サーバーを立てて、自分のサイトを公開するまでの流れを知りたい HTTPS 化や Docker での運用まで、ど&#8230;</span>					</div>
				</div>
			</div>
		</div>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【解決法付き】Chrome の「Permissions policy violation: Geolocation access has been blocked」エラーとは？原因と nginx での対処方法</title>
		<link>https://cfxlog.com/code-nginx-geolocation-permission/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 06 Aug 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Other]]></category>
		<category><![CDATA[UI実装]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[トラブルシューティング]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=5248</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/code-nginx-geolocation-permission-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>Web アプリで現在地を取得する機能を作っていると、Chrome のコンソールにこのエラーが表示されることがあります。この記事を読めば、原因の切り分け方と nginx での解決方法がわかります。 最初は JavaScri [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/08/code-nginx-geolocation-permission-1024x538.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>「Geolocation access has been blocked」というエラーが出て、現在地取得ができない</li>



<li>JavaScript の書き方もユーザーの許可設定も間違っていないのに動かない</li>



<li>nginx で直せると聞いたが、どこに何を書けばいいかわからない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Web アプリで現在地を取得する機能を作っていると、Chrome のコンソールにこのエラーが表示されることがあります。この記事を読めば、<strong>原因の切り分け方と nginx での解決方法</strong>がわかります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>[Violation] Permissions policy violation: Geolocation access has been blocked because of a permissions policy applied to the current document.</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">[Violation] Permissions policy violation: Geolocation access has been blocked because of a permissions policy applied to the current document.</span></span></code></pre></div>



<p class="wp-block-paragraph">最初は JavaScript の問題かと思いがちですが、実は <strong>ブラウザ側のポリシー（Permissions-Policy）によって Geolocation API が禁止されている</strong>ことが原因です。</p>



<h2 class="wp-block-heading">位置情報がブロックされる3つのレイヤー</h2>



<p class="wp-block-paragraph">位置情報まわりのトラブルは、だいたい次の <strong>3つのレイヤー</strong> のどこかで止められています。</p>



<h3 class="wp-block-heading">①プロトコルレイヤー</h3>



<p class="wp-block-paragraph">Geolocation API は <strong>HTTPS が必須</strong>です。HTTP では、そもそも API 自体が使えません。</p>



<h3 class="wp-block-heading">②ブラウザ・ユーザー権限レイヤー</h3>



<p class="wp-block-paragraph">Chrome などが表示する「このサイトに位置情報の利用を許可しますか？」というダイアログで、ユーザーが「拒否」を選ぶと <code>PERMISSION_DENIED</code> になります。</p>



<h3 class="wp-block-heading">③サーバー側ポリシーレイヤー（Permissions-Policy）</h3>



<p class="wp-block-paragraph">レスポンスヘッダー <code>Permissions-Policy</code> で、「このページは geolocation を使っていい・ダメ」をサーバー側から定義できます。<strong>今回のエラーは、この3番目のレイヤーでブロックされているパターンです。</strong></p>



<p class="wp-block-paragraph">JavaScript の書き方が正しく、ユーザーが許可していても、サーバー側の <code>Permissions-Policy</code> で <code>geolocation=()</code> のように禁止されていると、ブラウザはそもそも Geolocation API を使わせてくれません。</p>



<p class="wp-block-paragraph">コンソールにエラーが出たら、まずは<strong>どのレイヤーで止められているか</strong>を切り分けることが大切です。</p>



<h2 class="wp-block-heading">Permissions-Policyでできること</h2>



<p class="wp-block-paragraph"><code>Permissions-Policy</code> は、<strong>「このページは、ブラウザのどの機能を使ってよいか」をサーバーが宣言するヘッダー</strong> です。</p>



<p class="wp-block-paragraph">たとえば以下について「どの origin に対して許可するか？」を細かく制御できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>geolocation（位置情報）</li>



<li>camera（カメラ）</li>



<li>microphone（マイク）</li>



<li>fullscreen（フルスクリーン）</li>



<li>payment（決済） …など</li>
</ul>
</div></div>



<h3 class="wp-block-heading">基本の構文</h3>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Permissions-Policy: geolocation=&lt;allowlist&gt;;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Permissions-Policy: geolocation=&lt;allowlist>;</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>&lt;allowlist&gt;</code> には、次のような値を指定できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>()</code><br>→ だれにも許可しない（完全に禁止）</li>



<li><code>self</code><br>→ 自分自身の origin には許可する（デフォルト）</li>



<li><code>self "https://example.com/"</code><br>→ 自分と <code>https://example.com/</code> からのコンテンツにのみ許可</li>
</ul>
</div></div>



<p class="wp-block-paragraph">今回のケースでコンソールに出ていた以下は、「<strong>どこからも geolocation を使わせない</strong>」という非常に強い制限です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>Permissions-Policy: geolocation=()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">Permissions-Policy: geolocation=()</span></span></code></pre></div>



<p class="wp-block-paragraph">また、ヘッダー自体が無い場合でも、環境や iframe 内などで <strong>デフォルト禁止になるケースがあります</strong>。</p>



<h2 class="wp-block-heading">原因の切り分け方</h2>



<p class="wp-block-paragraph">Chrome DevTools で以下を確認できます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list is-style-num_circle">
<li>DevTools → Network タブ</li>



<li>ページをリロード</li>



<li>どれかのリクエストをクリック</li>



<li>Headers → Response Headers を確認</li>
</ol>
</div></div>



<p class="wp-block-paragraph">もし次のような項目があれば、これが犯人です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>permissions-policy: geolocation=()</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">permissions-policy: geolocation=()</span></span></code></pre></div>



<h2 class="wp-block-heading">nginxでの解決方法</h2>



<p class="wp-block-paragraph">結論：nginx のレスポンスヘッダーに geolocation を許可する設定を追加すれば解決します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Text</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>add_header Permissions-Policy "geolocation=(self)";</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">add_header Permissions-Policy "geolocation=(self)";</span></span></code></pre></div>



<p class="wp-block-paragraph">これは、「このサイト自身のコンテンツ（self）では Geolocation を許可する」という指定です。<code>server</code>ブロックに追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">NGINX</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>server {
    listen 443 ssl;
    server_name example.com;

    # Geolocation を許可
    add_header Permissions-Policy "geolocation=(self)";

    # ここから下は普段の設定
    ssl_certificate     /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    root /var/www/example;
    index index.html index.htm;
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#569CD6">server</span><span style="color:#D4D4D4"> {</span></span>
<span class="line"><span style="color:#569CD6">    listen </span><span style="color:#B5CEA8">443</span><span style="color:#D4D4D4"> ssl;</span></span>
<span class="line"><span style="color:#569CD6">    server_name </span><span style="color:#D4D4D4">example.com;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    # Geolocation を許可</span></span>
<span class="line"><span style="color:#569CD6">    add_header </span><span style="color:#D4D4D4">Permissions-Policy </span><span style="color:#CE9178">"geolocation=(self)"</span><span style="color:#D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955">    # ここから下は普段の設定</span></span>
<span class="line"><span style="color:#569CD6">    ssl_certificate </span><span style="color:#D4D4D4">    /etc/letsencrypt/live/example.com/fullchain.pem;</span></span>
<span class="line"><span style="color:#569CD6">    ssl_certificate_key </span><span style="color:#D4D4D4">/etc/letsencrypt/live/example.com/privkey.pem;</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    root </span><span style="color:#D4D4D4">/var/www/example;</span></span>
<span class="line"><span style="color:#569CD6">    index </span><span style="color:#D4D4D4">index.html index.htm;</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">設定後は nginx を reload します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>sudo systemctl reload nginx</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">sudo</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">systemctl</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">reload</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">nginx</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定を追加すると、Chrome のコンソールに出ていたエラーは消えます。</p>



<div class="wp-block-group has-border -border04"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>navigator.geolocation.getCurrentPosition()</code></li>



<li>Leaflet の現在地機能</li>



<li>Google Maps API の geolocation</li>
</ul>
</div></div>



<p class="wp-block-paragraph">実際にこれらすべてが正常に動作するようになりました。</p>



<h2 class="wp-block-heading">それでも直らない場合</h2>



<p class="wp-block-paragraph">もし nginx に追加したのに解決しない場合、たとえば Cloudflare の <strong>Security → HTTP headers</strong> や、Django の middleware で <code>Permissions-Policy</code> を追加しているケースでは、ヘッダーが上書きされている可能性があります。</p>



<p class="wp-block-paragraph">もう一つ、nginx特有の落とし穴として、<strong><code>add_header</code>は同じスコープ内に自分で書いたものしか継承されない</strong>という仕様があります。<code>location</code>ブロック側で別の<code>add_header</code>を書いていると、<code>server</code>ブロックで設定した<code>Permissions-Policy</code>が丸ごと無視されることがあるので、該当する<code>location</code>にも同じ行を追記してみてください。</p>



<p class="wp-block-paragraph">DevTools のレスポンスヘッダーを必ず確認しましょう。</p>



<h2 class="wp-block-heading">まとめ</h2>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>問題</th><th>Chrome が geolocation をブロックしていた</th></tr></thead><tbody><tr><td>原因</td><td>Permissions-Policy で geolocation が無効</td></tr><tr><td>解決</td><td>nginx に <code>add_header Permissions-Policy "geolocation=(self)"</code> を追加</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Geolocation を使うサイト（現在地検索、マップアプリ、位置情報機能など）では、今後ますます Permissions-Policy の設定が重要になります。同じエラーが出た場合は、まずレスポンスヘッダーを確認してみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</title>
		<link>https://cfxlog.com/nextjs-jwt-memory-token-auth/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 12 Jul 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-jwt-memory-token-auth/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。 TypeScriptで実装します。ファイル名は lib/auth.ts として、認証 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Next.jsでJWTトークンをどこに保存すればいいか知りたい</li>



<li>複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい</li>



<li>401レスポンスを受け取ったときに自動でリトライする仕組みを作りたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのフロントエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">TypeScriptで実装します。ファイル名は <code>lib/auth.ts</code> として、認証に関わる関数をすべてここにまとめます。</p>



<h2 class="wp-block-heading">アクセストークンをメモリに保持する</h2>



<p class="wp-block-paragraph">アクセストークンはモジュールスコープの変数に保存します。localStorageやsessionStorageを使わないことがXSS対策の核心です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// モジュールスコープの変数でメモリ管理する
let accessTokenInMemory: string | null = null;

export const getAccessToken = () => accessTokenInMemory;
export const setAccessToken = (t: string | null) => {
  accessTokenInMemory = t;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// モジュールスコープの変数でメモリ管理する</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">accessTokenInMemory</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">t</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">モジュールスコープの変数はページをリロードすると消えます。ただし、有効なリフレッシュCookieがあればページ初期化時に自動で復元されます。この仕組みは後述の <code>initializeAuth()</code> で実装します。</p>



<h2 class="wp-block-heading">localStorageはセッションフラグだけに使う</h2>



<p class="wp-block-paragraph">HttpOnly CookieはJavaScriptから読めないため、ログイン済みかどうかを確認する手段がありません。そこで「セッションが存在するかどうか」というboolean値だけをlocalStorageに保存します。トークン本体は絶対に保存しません。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const SESSION_FLAG = 'has_session';

// ログイン時に呼ぶ
export const markSessionActive = () => {
  try { localStorage.setItem(SESSION_FLAG, '1'); } catch { /* ignore */ }
};

// ログアウト時に呼ぶ
export const clearSessionFlag = () => {
  try { localStorage.removeItem(SESSION_FLAG); } catch { /* ignore */ }
};

// ログイン済みかどうかのヒントとして使う
export const hasSessionFlag = (): boolean => {
  try { return localStorage.getItem(SESSION_FLAG) === '1'; } catch { return false; }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4"> = </span><span style="color: #CE9178">&apos;has_session&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">setItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログアウト時に呼ぶ</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4"> = () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">removeItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">); } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #6A9955">/* ignore */</span><span style="color: #D4D4D4"> }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ログイン済みかどうかのヒントとして使う</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">hasSessionFlag</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">localStorage</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">getItem</span><span style="color: #D4D4D4">(</span><span style="color: #4FC1FF">SESSION_FLAG</span><span style="color: #D4D4D4">) === </span><span style="color: #CE9178">&apos;1&apos;</span><span style="color: #D4D4D4">; } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> { </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">; }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">このフラグはUIの表示切り替え（ログイン状態の初期判定）に使うもので、実際のAPIリクエストの認証はメモリ上のアクセストークンで行います。</p>



<h2 class="wp-block-heading">CSRF トークンの取得</h2>



<p class="wp-block-paragraph">DjangoはCSRF保護が有効なため、POSTリクエストには <code>X-CSRFToken</code> ヘッダーが必要です。まずCookie からCSRFトークンを読む関数を用意し、次にCSRF Cookieを取得するエンドポイントを呼び出す関数を作ります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// document.cookie からCSRFトークンを読む
const getCookie = (name: string): string | null => {
  const m = document.cookie.match(new RegExp(`(?:^|; )${name}=(&#91;^;&#93;*)`))
  return m ? decodeURIComponent(m&#91;1&#93;) : null
}

// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする
export const fetchCsrfCookie = async () => {
  try {
    await fetch('/auth/csrf_cookie/', {
      method: 'GET',
      credentials: 'include',
    })
  } catch {
    // 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる
  }
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// document.cookie からCSRFトークンを読む</span></span>
<span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4"> = (</span><span style="color: #9CDCFE">name</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">): </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">m</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">document</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">cookie</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">match</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">RegExp</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`(?:^|; )</span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">name</span><span style="color: #569CD6">}</span><span style="color: #CE9178">=(&#91;^;&#93;*)`</span><span style="color: #D4D4D4">))</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4"> ? </span><span style="color: #DCDCAA">decodeURIComponent</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">m</span><span style="color: #D4D4D4">&#91;</span><span style="color: #B5CEA8">1</span><span style="color: #D4D4D4">&#93;) : </span><span style="color: #569CD6">null</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955">// ページ初期化時に1回だけ呼んでCSRF Cookieをセットする</span></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/csrf_cookie/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;GET&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    })</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 広告ブロッカー等でブロックされる可能性があるため静かに失敗させる</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">refreshToken() の並走対策（mutex）</h2>



<p class="wp-block-paragraph">ここがこの実装の核心部分です。<code>ROTATE_REFRESH_TOKENS = True</code> の環境では、複数のリクエストが同時に <code>refreshToken()</code> を呼び出すと競合が起きます。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストをモジュールスコープ変数に保持し、2回目以降の呼び出しでは同じPromiseを返すことです。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）
let refreshingPromise: Promise&lt;boolean> | null = null;

export const refreshToken = (): Promise&lt;boolean> => {
  // 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）
  if (refreshingPromise) return refreshingPromise;

  refreshingPromise = (async () => {
    try {
      const res = await fetch('/auth/jwt/refresh/', {
        method: 'POST',
        credentials: 'include', // HttpOnly Cookieをブラウザが自動送信
        headers: {
          'Content-Type': 'application/json',
          'X-CSRFToken': getCookie('csrftoken') ?? '',
        },
        body: JSON.stringify({}),
      });
      if (!res.ok) return false;
      const data = await res.json() as { access?: string };
      if (data?.access) setAccessToken(data.access);
      return !!data?.access;
    } catch {
      return false;
    } finally {
      // 成功・失敗にかかわらず次の呼び出しに備えてリセット
      refreshingPromise = null;
    }
  })();

  return refreshingPromise;
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">// 進行中のリフレッシュリクエストを保持する（mutexとして機能する）</span></span>
<span class="line"><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; | </span><span style="color: #4EC9B0">null</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4"> = (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">boolean</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 既に進行中なら同じPromiseを返す（新たにリクエストを送らない）</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = (</span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;/auth/jwt/refresh/&apos;</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955">// HttpOnly Cookieをブラウザが自動送信</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">          </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">        },</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({}),</span></span>
<span class="line"><span style="color: #D4D4D4">      });</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">?: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">) </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> !!</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">?.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">false</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #6A9955">// 成功・失敗にかかわらず次の呼び出しに備えてリセット</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">    }</span></span>
<span class="line"><span style="color: #D4D4D4">  })();</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">refreshingPromise</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">3つのリクエストが同時に401を受け取って <code>refreshToken()</code> を呼び出したとしても、実際にサーバーへ送るリフレッシュリクエストは1本だけになります。他の2本は同じPromiseを待つため、競合が起きません。</p>



<h2 class="wp-block-heading">apiFetch() で 401 を自動リトライする</h2>



<p class="wp-block-paragraph">APIリクエストのラッパー関数を実装します。401レスポンスを受け取ったら自動でリフレッシュし、元のリクエストを再実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>const API_BASE_URL = process.env.NEXT_PUBLIC_API_URL ?? '';

export async function apiFetch(input: string, init: RequestInit = {}) {
  const headers = new Headers(init.headers);
  const token = getAccessToken();
  if (token) headers.set('Authorization', `Bearer ${token}`);

  let res = await fetch(`${API_BASE_URL}${input}`, {
    ...init,
    headers,
    credentials: 'include',
  });

  // 401以外はそのまま返す
  if (res.status !== 401) return res;

  // アクセストークン切れ → リフレッシュしてリトライ
  const refreshed = await refreshToken();
  if (!refreshed) return res; // リフレッシュも失敗したら元の401を返す

  // 新しいアクセストークンで再リクエスト
  headers.set('Authorization', `Bearer ${getAccessToken()}`);
  return fetch(`${API_BASE_URL}${input}`, { ...init, headers, credentials: 'include' });
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #D4D4D4"> = </span><span style="color: #9CDCFE">process</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">env</span><span style="color: #D4D4D4">.</span><span style="color: #4FC1FF">NEXT_PUBLIC_API_URL</span><span style="color: #D4D4D4"> ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">function</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">apiFetch</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">input</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">RequestInit</span><span style="color: #D4D4D4"> = {}) {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">headers</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Headers</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">token</span><span style="color: #D4D4D4"> = </span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">token</span><span style="color: #D4D4D4">) </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #9CDCFE">token</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">let</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 401以外はそのまま返す</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">status</span><span style="color: #D4D4D4"> !== </span><span style="color: #B5CEA8">401</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// アクセストークン切れ → リフレッシュしてリトライ</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">refreshed</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">refreshed</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">; </span><span style="color: #6A9955">// リフレッシュも失敗したら元の401を返す</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #6A9955">// 新しいアクセストークンで再リクエスト</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">set</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;Authorization&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #CE9178">`Bearer </span><span style="color: #569CD6">${</span><span style="color: #DCDCAA">getAccessToken</span><span style="color: #D4D4D4">()</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}${</span><span style="color: #9CDCFE">input</span><span style="color: #569CD6">}</span><span style="color: #CE9178">`</span><span style="color: #D4D4D4">, { ...</span><span style="color: #9CDCFE">init</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">headers</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4"> });</span></span>
<span class="line"><span style="color: #D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">呼び出し側は通常の <code>fetch()</code> と同じ感覚で使えます。401ハンドリングを意識する必要がなく、コードがシンプルに保てます。</p>



<h2 class="wp-block-heading">ログイン・ログアウトの実装</h2>



<p class="wp-block-paragraph">ログインはDjoserの <code>/auth/jwt/create/</code> を呼び出します。アクセストークンをメモリに保存し、セッションフラグを立てます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const login = async (email: string, password: string) => {
  const res = await fetch(`${API_BASE_URL}/auth/jwt/create/`, {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRFToken': getCookie('csrftoken') ?? '',
    },
    body: JSON.stringify({ email, password }),
  });
  if (!res.ok) throw new Error('ログインに失敗しました');
  const data = await res.json() as { access: string };
  setAccessToken(data.access);
  markSessionActive();
  return data;
};

export const logout = async () => {
  try {
    await fetch(`${API_BASE_URL}/auth/logout/`, {
      method: 'POST',
      credentials: 'include',
      headers: { 'X-CSRFToken': getCookie('csrftoken') ?? '' },
    });
  } finally {
    // サーバー側の処理が失敗してもローカルはクリアする
    setAccessToken(null);
    clearSessionFlag();
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">login</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4">) </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">res</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/jwt/create/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;Content-Type&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;application/json&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    },</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">body:</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">JSON</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">stringify</span><span style="color: #D4D4D4">({ </span><span style="color: #9CDCFE">email</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">password</span><span style="color: #D4D4D4"> }),</span></span>
<span class="line"><span style="color: #D4D4D4">  });</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> (!</span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">ok</span><span style="color: #D4D4D4">) </span><span style="color: #C586C0">throw</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">new</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">Error</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;ログインに失敗しました&apos;</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #4FC1FF">data</span><span style="color: #D4D4D4"> = </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">res</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">json</span><span style="color: #D4D4D4">() </span><span style="color: #C586C0">as</span><span style="color: #D4D4D4"> { </span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">: </span><span style="color: #4EC9B0">string</span><span style="color: #D4D4D4"> };</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">.</span><span style="color: #9CDCFE">access</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #DCDCAA">markSessionActive</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">return</span><span style="color: #D4D4D4"> </span><span style="color: #9CDCFE">data</span><span style="color: #D4D4D4">;</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span>
<span class="line"></span>
<span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">logout</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> () </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetch</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">`</span><span style="color: #569CD6">${</span><span style="color: #4FC1FF">API_BASE_URL</span><span style="color: #569CD6">}</span><span style="color: #CE9178">/auth/logout/`</span><span style="color: #D4D4D4">, {</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">method:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;POST&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">credentials:</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;include&apos;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #9CDCFE">headers:</span><span style="color: #D4D4D4"> { </span><span style="color: #CE9178">&apos;X-CSRFToken&apos;</span><span style="color: #9CDCFE">:</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">getCookie</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;csrftoken&apos;</span><span style="color: #D4D4D4">) ?? </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4"> },</span></span>
<span class="line"><span style="color: #D4D4D4">    });</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">finally</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// サーバー側の処理が失敗してもローカルはクリアする</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">setAccessToken</span><span style="color: #D4D4D4">(</span><span style="color: #569CD6">null</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #DCDCAA">clearSessionFlag</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">ログアウトは <code>try...finally</code> を使い、サーバー側のブラックリスト登録が失敗してもローカルのアクセストークンとセッションフラグは必ずクリアします。</p>



<h2 class="wp-block-heading">ページ初期化時の認証復元（initializeAuth）</h2>



<p class="wp-block-paragraph">ページをリロードするとメモリ上のアクセストークンが消えます。有効なリフレッシュCookieがあれば自動で復元できるよう、アプリ起動時に一度だけ呼ぶ初期化関数を用意します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">TypeScript</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>export const initializeAuth = async (): Promise&lt;void> => {
  try {
    // 1. CSRF Cookieを取得する（POSTリクエストに必要）
    await fetchCsrfCookie();
    // 2. リフレッシュCookieでアクセストークンを復元する
    await refreshToken();
  } catch (e) {
    console.warn('initializeAuth failed', e);
  }
};</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">export</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">const</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">initializeAuth</span><span style="color: #D4D4D4"> = </span><span style="color: #569CD6">async</span><span style="color: #D4D4D4"> (): </span><span style="color: #4EC9B0">Promise</span><span style="color: #D4D4D4">&lt;</span><span style="color: #4EC9B0">void</span><span style="color: #D4D4D4">&gt; </span><span style="color: #569CD6">=&gt;</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #C586C0">try</span><span style="color: #D4D4D4"> {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 1. CSRF Cookieを取得する（POSTリクエストに必要）</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">fetchCsrfCookie</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955">// 2. リフレッシュCookieでアクセストークンを復元する</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">await</span><span style="color: #D4D4D4"> </span><span style="color: #DCDCAA">refreshToken</span><span style="color: #D4D4D4">();</span></span>
<span class="line"><span style="color: #D4D4D4">  } </span><span style="color: #C586C0">catch</span><span style="color: #D4D4D4"> (</span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">) {</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #9CDCFE">console</span><span style="color: #D4D4D4">.</span><span style="color: #DCDCAA">warn</span><span style="color: #D4D4D4">(</span><span style="color: #CE9178">&apos;initializeAuth failed&apos;</span><span style="color: #D4D4D4">, </span><span style="color: #9CDCFE">e</span><span style="color: #D4D4D4">);</span></span>
<span class="line"><span style="color: #D4D4D4">  }</span></span>
<span class="line"><span style="color: #D4D4D4">};</span></span></code></pre></div>



<p class="wp-block-paragraph">Next.jsのApp Routerを使っている場合、ルートの <code>layout.tsx</code> に配置した <code>AuthProvider</code> などのクライアントコンポーネントから <code>useEffect(() =&gt; { initializeAuth(); }, [])</code> で呼び出します。</p>



<p class="wp-block-paragraph">リフレッシュCookieが有効期限切れの場合は <code>refreshToken()</code> が <code>false</code> を返します。この場合はアクセストークンが復元されず、ユーザーは未ログイン状態になります。</p>



<h2 class="wp-block-heading">まとめ：この実装で防げること</h2>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>XSSによるトークン盗取</strong><br>アクセストークンはメモリのみ。リフレッシュトークンはHttpOnly Cookie。どちらもXSSスクリプトから直接読み出せない。</li>



<li><strong>CSRF攻撃</strong><br>アクセストークンはAuthorizationヘッダー送信のみ。リフレッシュCookieのパスは <code>/auth/</code> に限定されているため、API全体をCSRFで叩くことができない。</li>



<li><strong>リフレッシュの並走競合</strong><br>mutexパターンにより、同時に何本のリクエストが来ても実際のリフレッシュAPIは1本のみ実行される。</li>



<li><strong>アクセストークン期限切れによるエラー</strong><br><code>apiFetch()</code> が自動でリフレッシュ＆リトライするため、呼び出し側で期限切れを意識しなくてよい。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンド（Django）側の設定は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</title>
		<link>https://cfxlog.com/django-simplejwt-djoser-setup/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Thu, 14 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/django-simplejwt-djoser-setup/</guid>

					<description><![CDATA[この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。 この記事では、djangorestframework-simplejwt と djos [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>DjangoでJWT認証を実装したい</li>

<li>SimpleJWTとDjoserをどう組み合わせるか知りたい</li>

<li>不要なエンドポイントを封鎖してセキュリティを高めたい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この記事は、Next.js + Django JWT認証シリーズのバックエンド実装編です。設計の考え方は下記の記事で解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-django-jwt-auth-design/">Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</a>
						<span class="p-blogCard__excerpt">JWTをlocalStorageに保存していいのか不安 アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい XSSとCSRFを両方対策した設計の考え方を理解したい JW&#8230;</span>					</div>
				</div>
			</div>
		</div>


<p class="wp-block-paragraph">この記事では、<code>djangorestframework-simplejwt</code> と <code>djoser</code> の設定、Redisを使ったレートリミットミドルウェアの実装を解説します。</p>



<h2 class="wp-block-heading">必要なパッケージ</h2>



<p class="wp-block-paragraph">JWT認証に必要なパッケージを追加します。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>djangorestframework-simplejwt</strong><br>JWTの発行・検証・リフレッシュ・ブラックリスト管理を担う。</li>

<li><strong>djoser</strong><br>ユーザー登録・ログイン・パスワードリセットなどの認証エンドポイントを提供するライブラリ。SimpleJWTと組み合わせて使う。</li>

<li><strong>django-redis</strong><br>RedisをDjangoのキャッシュバックエンドとして使うためのパッケージ。レートリミットのカウンターをマルチワーカー間で共有できる。</li>

<li><strong>django-environ</strong><br>環境変数を <code>.env</code> ファイルから読み込むユーティリティ。</li>
</ul>
</div></div>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># uv を使う場合
uv add djangorestframework djangorestframework-simplejwt djoser django-redis django-environ

# pip を使う場合
pip install djangorestframework djangorestframework-simplejwt djoser django-redis django-environ</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#6A9955"># uv を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">uv</span><span style="color:#CE9178"> add</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span>
<span class="line"></span>
<span class="line"><span style="color:#6A9955"># pip を使う場合</span></span>
<span class="line"><span style="color:#DCDCAA">pip</span><span style="color:#CE9178"> install</span><span style="color:#CE9178"> djangorestframework</span><span style="color:#CE9178"> djangorestframework-simplejwt</span><span style="color:#CE9178"> djoser</span><span style="color:#CE9178"> django-redis</span><span style="color:#CE9178"> django-environ</span></span></code></pre></div>



<h2 class="wp-block-heading">INSTALLED_APPS と MIDDLEWARE の設定</h2>



<p class="wp-block-paragraph">インストールしたパッケージを <code>INSTALLED_APPS</code> に追加します。<code>rest_framework_simplejwt.token_blacklist</code> はリフレッシュトークンのローテーション時に古いトークンを無効化するために必要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = [
    "django.contrib.admin",
    "django.contrib.auth",
    "django.contrib.contenttypes",
    "django.contrib.sessions",
    "django.contrib.messages",
    "django.contrib.staticfiles",
    # サードパーティ
    "corsheaders",
    "rest_framework",
    "rest_framework_simplejwt",
    "rest_framework_simplejwt.token_blacklist",
    "djoser",
    # ローカルアプリ
    "apps.users",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">INSTALLED_APPS = [</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.admin"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.contenttypes"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.staticfiles"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # サードパーティ</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "rest_framework_simplejwt.token_blacklist"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "djoser"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # ローカルアプリ</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>MIDDLEWARE</code> には <code>CorsMiddleware</code> を最上位に、カスタムミドルウェアを末尾に追加します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MIDDLEWARE = [
    "corsheaders.middleware.CorsMiddleware",  # 最上位に置く
    "django.middleware.security.SecurityMiddleware",
    "whitenoise.middleware.WhiteNoiseMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    # カスタム
    "apps.users.middleware.RateLimitMiddleware",
    "apps.users.middleware.SecurityHeadersMiddleware",
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">MIDDLEWARE = [</span></span>
<span class="line"><span style="color:#CE9178">    "corsheaders.middleware.CorsMiddleware"</span><span style="color:#D4D4D4">,  </span><span style="color:#6A9955"># 最上位に置く</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.security.SecurityMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "whitenoise.middleware.WhiteNoiseMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.sessions.middleware.SessionMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.common.CommonMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.csrf.CsrfViewMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.auth.middleware.AuthenticationMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.contrib.messages.middleware.MessageMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "django.middleware.clickjacking.XFrameOptionsMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # カスタム</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.RateLimitMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "apps.users.middleware.SecurityHeadersMiddleware"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<h2 class="wp-block-heading">REST_FRAMEWORK の設定</h2>



<p class="wp-block-paragraph">デフォルトの認証クラスを <code>JWTAuthentication</code> のみにします。Sessionなど不要な認証方式を残すとセキュリティ上のリスクになるため削除します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "rest_framework_simplejwt.authentication.JWTAuthentication",
    ],
    "DEFAULT_PERMISSION_CLASSES": [
        "rest_framework.permissions.IsAuthenticated",
    ],
    "DEFAULT_PAGINATION_CLASS": "rest_framework.pagination.PageNumberPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_RENDERER_CLASSES": [
        "rest_framework.renderers.JSONRenderer",
    ],
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">REST_FRAMEWORK = {</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_AUTHENTICATION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework_simplejwt.authentication.JWTAuthentication"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PERMISSION_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_PAGINATION_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"rest_framework.pagination.PageNumberPagination"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "PAGE_SIZE"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">20</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "DEFAULT_RENDERER_CLASSES"</span><span style="color:#D4D4D4">: [</span></span>
<span class="line"><span style="color:#CE9178">        "rest_framework.renderers.JSONRenderer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    ],</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">SimpleJWT の設定</h2>



<p class="wp-block-paragraph">トークンの有効期限とローテーション設定が中心です。各パラメータの意味を確認しておきます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from datetime import timedelta

SIMPLE_JWT = {
    # アクセストークン: 15分（短命にしてリスクを限定）
    "ACCESS_TOKEN_LIFETIME": timedelta(minutes=15),
    # リフレッシュトークン: 14日
    "REFRESH_TOKEN_LIFETIME": timedelta(days=14),
    # リフレッシュのたびに新しいリフレッシュトークンを発行
    "ROTATE_REFRESH_TOKENS": True,
    # 使用済みリフレッシュトークンをブラックリストに登録
    "BLACKLIST_AFTER_ROTATION": True,
    "AUTH_HEADER_TYPES": ("Bearer",),
    "TOKEN_TYPE_CLAIM": "token_type",
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> datetime </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> timedelta</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">SIMPLE_JWT = {</span></span>
<span class="line"><span style="color:#6A9955">    # アクセストークン: 15分（短命にしてリスクを限定）</span></span>
<span class="line"><span style="color:#CE9178">    "ACCESS_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">minutes</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">15</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュトークン: 14日</span></span>
<span class="line"><span style="color:#CE9178">    "REFRESH_TOKEN_LIFETIME"</span><span style="color:#D4D4D4">: timedelta(</span><span style="color:#9CDCFE">days</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">14</span><span style="color:#D4D4D4">),</span></span>
<span class="line"><span style="color:#6A9955">    # リフレッシュのたびに新しいリフレッシュトークンを発行</span></span>
<span class="line"><span style="color:#CE9178">    "ROTATE_REFRESH_TOKENS"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#6A9955">    # 使用済みリフレッシュトークンをブラックリストに登録</span></span>
<span class="line"><span style="color:#CE9178">    "BLACKLIST_AFTER_ROTATION"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">True</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "AUTH_HEADER_TYPES"</span><span style="color:#D4D4D4">: (</span><span style="color:#CE9178">"Bearer"</span><span style="color:#D4D4D4">,),</span></span>
<span class="line"><span style="color:#CE9178">    "TOKEN_TYPE_CLAIM"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"token_type"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行されます。古いトークンがブラックリストに入るため、トークン漏洩時の被害を限定できます。</p>



<p class="wp-block-paragraph">ただし、フロントエンドで複数のAPIリクエストが並走してリフレッシュを呼び出すと競合が起きます。この問題の対策はフロントエンド実装の記事で解説します。</p>



<h2 class="wp-block-heading">Djoser の設定 &#8211; 不要なエンドポイントを封鎖する</h2>



<p class="wp-block-paragraph">Djoserはデフォルトでユーザー登録・削除・メール変更など多くのエンドポイントを公開します。使わないエンドポイントを <code>IsAdminUser</code> で封鎖することが重要です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>DJOSER = {
    "SERIALIZERS": {
        "current_user": "apps.users.serializers.UserProfileSerializer",
    },
    "PERMISSIONS": {
        "current_user": ["rest_framework.permissions.IsAuthenticated"],
        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）
        "user_create": ["rest_framework.permissions.IsAdminUser"],
        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）
        "set_username": ["rest_framework.permissions.IsAdminUser"],
        # 自己削除を禁止（関連データが失われるため）
        "user_delete": ["rest_framework.permissions.IsAdminUser"],
        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）
        "password_reset": ["rest_framework.permissions.IsAdminUser"],
        "password_reset_confirm": ["rest_framework.permissions.IsAdminUser"],
    },
    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）
    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND": False,
    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND": False,
}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#D4D4D4">DJOSER = {</span></span>
<span class="line"><span style="color:#CE9178">    "SERIALIZERS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"apps.users.serializers.UserProfileSerializer"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#CE9178">    "PERMISSIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "current_user"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAuthenticated"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # /auth/users/ への直接登録を禁止（独自の承認フローを使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_create"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # メールアドレス変更を禁止（乗っ取り時に元オーナーが復旧できなくなるため）</span></span>
<span class="line"><span style="color:#CE9178">        "set_username"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # 自己削除を禁止（関連データが失われるため）</span></span>
<span class="line"><span style="color:#CE9178">        "user_delete"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#6A9955">        # djoser標準のパスワードリセットを封鎖（独自実装を使うため）</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#CE9178">        "password_reset_confirm"</span><span style="color:#D4D4D4">: [</span><span style="color:#CE9178">"rest_framework.permissions.IsAdminUser"</span><span style="color:#D4D4D4">],</span></span>
<span class="line"><span style="color:#D4D4D4">    },</span></span>
<span class="line"><span style="color:#6A9955">    # ユーザー列挙攻撃を防ぐ（未登録メールでも同じレスポンスを返す）</span></span>
<span class="line"><span style="color:#CE9178">    "PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">    "USERNAME_RESET_SHOW_EMAIL_NOT_FOUND"</span><span style="color:#D4D4D4">: </span><span style="color:#569CD6">False</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<p class="wp-block-paragraph">特に <code>PASSWORD_RESET_SHOW_EMAIL_NOT_FOUND = False</code> は重要です。これを有効にしないと、未登録のメールアドレスを送信したときに「そのメールは登録されていません」というレスポンスが返り、攻撃者にユーザー一覧を推測させてしまいます。</p>



<h2 class="wp-block-heading">Redis キャッシュの設定</h2>



<p class="wp-block-paragraph">レートリミットのカウンターをマルチワーカー間で共有するために、Redisをキャッシュバックエンドとして使います。Gunicornなど複数ワーカーを立てる場合に必要な設定です。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" data-code="import environ
env = environ.Env()

REDIS_URL = env(&quot;REDIS_URL&quot;, default=&quot;redis://localhost:6379/1&quot;)
CACHES = {
    &quot;default&quot;: {
        &quot;BACKEND&quot;: &quot;django_redis.cache.RedisCache&quot;,
        &quot;LOCATION&quot;: REDIS_URL,
        &quot;OPTIONS&quot;: {
            &quot;CLIENT_CLASS&quot;: &quot;django_redis.client.DefaultClient&quot;,
        },
    }
}" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> environ</span></span>
<span class="line"><span style="color:#D4D4D4">env = environ.Env()</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">REDIS_URL = env(</span><span style="color:#CE9178">"REDIS_URL"</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">default</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"redis://localhost:6379/1"</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">CACHES = {</span></span>
<span class="line"><span style="color:#CE9178">    "default"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">        "BACKEND"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.cache.RedisCache"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#CE9178">        "LOCATION"</span><span style="color:#D4D4D4">: REDIS_URL,</span></span>
<span class="line"><span style="color:#CE9178">        "OPTIONS"</span><span style="color:#D4D4D4">: {</span></span>
<span class="line"><span style="color:#CE9178">            "CLIENT_CLASS"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"django_redis.client.DefaultClient"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">        },</span></span>
<span class="line"><span style="color:#D4D4D4">    }</span></span>
<span class="line"><span style="color:#D4D4D4">}</span></span></code></pre></div>



<h2 class="wp-block-heading">RateLimitMiddleware の実装</h2>



<p class="wp-block-paragraph">Redisキャッシュを使ってIPアドレスごとにリクエスト数を制限するカスタムミドルウェアを実装します。<code>cache.add()</code> と <code>cache.incr()</code> を組み合わせることで、レースコンディションが起きないアトミックな実装になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import json
from django.conf import settings
from django.core.cache import cache
from django.http import HttpResponse
from django.utils.deprecation import MiddlewareMixin


class RateLimitMiddleware(MiddlewareMixin):
    def __init__(self, get_response):
        super().__init__(get_response)
        auth_req = 120 if settings.DEBUG else 30
        self.rate_limits = {
            "default":  {"requests": 100, "window": 60},
            "auth":     {"requests": auth_req, "window": 60},
            "register": {"requests": 5,   "window": 3600},
            "contact":  {"requests": 5,   "window": 3600},
        }

    def process_request(self, request):
        exempt = ["/static/", "/media/", "/favicon.ico", "/admin/"]
        if any(request.path.startswith(p) for p in exempt):
            return None
        ip = self._get_client_ip(request)
        endpoint = self._get_endpoint_type(request.path)
        if not self._check_rate_limit(ip, endpoint):
            return HttpResponse(
                json.dumps({"detail": "Rate limit exceeded."}),
                content_type="application/json",
                status=429,
            )
        return None

    def _get_client_ip(self, request):
        """リバースプロキシ経由の実クライアントIPを取得する"""
        remote_addr = request.META.get("REMOTE_ADDR", "")
        trusted = getattr(settings, "TRUSTED_PROXIES", [])
        if remote_addr in trusted:
            xff = request.META.get("HTTP_X_FORWARDED_FOR", "")
            if xff:
                # nginx は実クライアントIPを末尾に追記する
                return xff.split(",")[-1].strip()
        return remote_addr

    def _get_endpoint_type(self, path):
        if "/api/auth/register/" in path:
            return "register"
        if "/auth/" in path or "/login" in path:
            return "auth"
        if "/api/contact/" in path:
            return "contact"
        return "default"

    def _check_rate_limit(self, ip, endpoint):
        """アトミックなカウントアップで競合を防ぐ"""
        config = self.rate_limits.get(endpoint, self.rate_limits["default"])
        key = f"rate_limit:{endpoint}:{ip}"
        # キーが存在しない場合のみ0で初期化（TTL付き）
        cache.add(key, 0, config["window"])
        # アトミックにインクリメント
        count = cache.incr(key)
        return count &lt;= config["requests"]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> json</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.conf </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> settings</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.core.cache </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> cache</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.http </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> HttpResponse</span></span>
<span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.utils.deprecation </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> MiddlewareMixin</span></span>
<span class="line"></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">class</span><span style="color:#4EC9B0"> RateLimitMiddleware</span><span style="color:#D4D4D4">(</span><span style="color:#4EC9B0">MiddlewareMixin</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> __init__</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">get_response</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#4EC9B0">        super</span><span style="color:#D4D4D4">().</span><span style="color:#DCDCAA">__init__</span><span style="color:#D4D4D4">(get_response)</span></span>
<span class="line"><span style="color:#D4D4D4">        auth_req = </span><span style="color:#B5CEA8">120</span><span style="color:#C586C0"> if</span><span style="color:#D4D4D4"> settings.DEBUG </span><span style="color:#C586C0">else</span><span style="color:#B5CEA8"> 30</span></span>
<span class="line"><span style="color:#569CD6">        self</span><span style="color:#D4D4D4">.rate_limits = {</span></span>
<span class="line"><span style="color:#CE9178">            "default"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">100</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "auth"</span><span style="color:#D4D4D4">:     {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: auth_req, </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">60</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "register"</span><span style="color:#D4D4D4">: {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#CE9178">            "contact"</span><span style="color:#D4D4D4">:  {</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">5</span><span style="color:#D4D4D4">,   </span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">: </span><span style="color:#B5CEA8">3600</span><span style="color:#D4D4D4">},</span></span>
<span class="line"><span style="color:#D4D4D4">        }</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> process_request</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#D4D4D4">        exempt = [</span><span style="color:#CE9178">"/static/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/media/"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/favicon.ico"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">"/admin/"</span><span style="color:#D4D4D4">]</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#DCDCAA"> any</span><span style="color:#D4D4D4">(request.path.startswith(p) </span><span style="color:#C586C0">for</span><span style="color:#D4D4D4"> p </span><span style="color:#C586C0">in</span><span style="color:#D4D4D4"> exempt):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#569CD6"> None</span></span>
<span class="line"><span style="color:#D4D4D4">        ip = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_client_ip(request)</span></span>
<span class="line"><span style="color:#D4D4D4">        endpoint = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">._get_endpoint_type(request.path)</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#569CD6"> not</span><span style="color:#569CD6"> self</span><span style="color:#D4D4D4">._check_rate_limit(ip, endpoint):</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#D4D4D4"> HttpResponse(</span></span>
<span class="line"><span style="color:#D4D4D4">                json.dumps({</span><span style="color:#CE9178">"detail"</span><span style="color:#D4D4D4">: </span><span style="color:#CE9178">"Rate limit exceeded."</span><span style="color:#D4D4D4">}),</span></span>
<span class="line"><span style="color:#9CDCFE">                content_type</span><span style="color:#D4D4D4">=</span><span style="color:#CE9178">"application/json"</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#9CDCFE">                status</span><span style="color:#D4D4D4">=</span><span style="color:#B5CEA8">429</span><span style="color:#D4D4D4">,</span></span>
<span class="line"><span style="color:#D4D4D4">            )</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#569CD6"> None</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_client_ip</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">request</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """リバースプロキシ経由の実クライアントIPを取得する"""</span></span>
<span class="line"><span style="color:#D4D4D4">        remote_addr = request.META.get(</span><span style="color:#CE9178">"REMOTE_ADDR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#D4D4D4">        trusted = </span><span style="color:#DCDCAA">getattr</span><span style="color:#D4D4D4">(settings, </span><span style="color:#CE9178">"TRUSTED_PROXIES"</span><span style="color:#D4D4D4">, [])</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#D4D4D4"> remote_addr </span><span style="color:#569CD6">in</span><span style="color:#D4D4D4"> trusted:</span></span>
<span class="line"><span style="color:#D4D4D4">            xff = request.META.get(</span><span style="color:#CE9178">"HTTP_X_FORWARDED_FOR"</span><span style="color:#D4D4D4">, </span><span style="color:#CE9178">""</span><span style="color:#D4D4D4">)</span></span>
<span class="line"><span style="color:#C586C0">            if</span><span style="color:#D4D4D4"> xff:</span></span>
<span class="line"><span style="color:#6A9955">                # nginx は実クライアントIPを末尾に追記する</span></span>
<span class="line"><span style="color:#C586C0">                return</span><span style="color:#D4D4D4"> xff.split(</span><span style="color:#CE9178">","</span><span style="color:#D4D4D4">)[-</span><span style="color:#B5CEA8">1</span><span style="color:#D4D4D4">].strip()</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> remote_addr</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _get_endpoint_type</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">path</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/auth/register/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "register"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/auth/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path </span><span style="color:#569CD6">or</span><span style="color:#CE9178"> "/login"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "auth"</span></span>
<span class="line"><span style="color:#C586C0">        if</span><span style="color:#CE9178"> "/api/contact/"</span><span style="color:#569CD6"> in</span><span style="color:#D4D4D4"> path:</span></span>
<span class="line"><span style="color:#C586C0">            return</span><span style="color:#CE9178"> "contact"</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#CE9178"> "default"</span></span>
<span class="line"></span>
<span class="line"><span style="color:#569CD6">    def</span><span style="color:#DCDCAA"> _check_rate_limit</span><span style="color:#D4D4D4">(</span><span style="color:#9CDCFE">self</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">ip</span><span style="color:#D4D4D4">, </span><span style="color:#9CDCFE">endpoint</span><span style="color:#D4D4D4">):</span></span>
<span class="line"><span style="color:#CE9178">        """アトミックなカウントアップで競合を防ぐ"""</span></span>
<span class="line"><span style="color:#D4D4D4">        config = </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits.get(endpoint, </span><span style="color:#569CD6">self</span><span style="color:#D4D4D4">.rate_limits[</span><span style="color:#CE9178">"default"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#D4D4D4">        key = </span><span style="color:#569CD6">f</span><span style="color:#CE9178">"rate_limit:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">endpoint</span><span style="color:#569CD6">}</span><span style="color:#CE9178">:</span><span style="color:#569CD6">{</span><span style="color:#D4D4D4">ip</span><span style="color:#569CD6">}</span><span style="color:#CE9178">"</span></span>
<span class="line"><span style="color:#6A9955">        # キーが存在しない場合のみ0で初期化（TTL付き）</span></span>
<span class="line"><span style="color:#D4D4D4">        cache.add(key, </span><span style="color:#B5CEA8">0</span><span style="color:#D4D4D4">, config[</span><span style="color:#CE9178">"window"</span><span style="color:#D4D4D4">])</span></span>
<span class="line"><span style="color:#6A9955">        # アトミックにインクリメント</span></span>
<span class="line"><span style="color:#D4D4D4">        count = cache.incr(key)</span></span>
<span class="line"><span style="color:#C586C0">        return</span><span style="color:#D4D4D4"> count &lt;= config[</span><span style="color:#CE9178">"requests"</span><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">ポイントは <code>cache.add()</code> と <code>cache.incr()</code> の組み合わせです。<code>cache.add()</code> はキーが存在しない場合のみ値をセットし、TTLも同時に設定します。その後 <code>cache.incr()</code> でアトミックにカウントを増やします。</p>



<p class="wp-block-paragraph">もし <code>cache.get()</code> → <code>cache.set()</code> のパターンで書いてしまうと、並走リクエストが同時に「0件」を読んでそれぞれがカウントをリセットするレースコンディションが起きます。</p>



<h2 class="wp-block-heading">URL の設定</h2>



<p class="wp-block-paragraph">DjoserのURLを2行追加します。<code>djoser.urls</code> がユーザー管理系エンドポイント、<code>djoser.urls.jwt</code> がJWT発行・リフレッシュ・ログアウトのエンドポイントを提供します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.urls import path, include

urlpatterns = [
    path("auth/", include("djoser.urls")),
    path("auth/", include("djoser.urls.jwt")),
    path("api/", include("apps.main.urls")),
]</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color:#1E1E1E;color:#D4D4D4" tabindex="0"><code><span class="line"><span style="color:#C586C0">from</span><span style="color:#D4D4D4"> django.urls </span><span style="color:#C586C0">import</span><span style="color:#D4D4D4"> path, include</span></span>
<span class="line"></span>
<span class="line"><span style="color:#D4D4D4">urlpatterns = [</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"auth/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"djoser.urls.jwt"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">    path(</span><span style="color:#CE9178">"api/"</span><span style="color:#D4D4D4">, include(</span><span style="color:#CE9178">"apps.main.urls"</span><span style="color:#D4D4D4">)),</span></span>
<span class="line"><span style="color:#D4D4D4">]</span></span></code></pre></div>



<p class="wp-block-paragraph">この設定で有効になる主なエンドポイントです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>POST /auth/jwt/create/</strong><br>ログイン。アクセストークンとリフレッシュトークンを返す。</li>

<li><strong>POST /auth/jwt/refresh/</strong><br>リフレッシュ。HttpOnly CookieのリフレッシュトークンをもとにアクセストークンをJSON で返す。</li>

<li><strong>POST /auth/logout/</strong><br>ログアウト。リフレッシュトークンをブラックリストに登録する。</li>

<li><strong>GET /auth/users/me/</strong><br>ログイン中のユーザー情報を返す。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">バックエンドの設定はこれで完成です。フロントエンド側でこれらのエンドポイントをどう呼び出すかは、次の記事で解説します。</p>


<div class="swell-block-postLink"></div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js + Django JWT認証の設計｜アクセストークンはメモリ、リフレッシュはHttpOnly Cookieに分ける理由</title>
		<link>https://cfxlog.com/nextjs-django-jwt-auth-design/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Wed, 13 May 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[Next.js]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/nextjs-django-jwt-auth-design/</guid>

					<description><![CDATA[JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。 この記事では、なぜその設計になるのかを理由から解説します。 [&#8230;]]]></description>
										<content:encoded><![CDATA[
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>JWTをlocalStorageに保存していいのか不安</li>

<li>アクセストークンとリフレッシュトークンをどこに保存すべきか知りたい</li>

<li>XSSとCSRFを両方対策した設計の考え方を理解したい</li>
</ul>
</div></div>



<p class="wp-block-paragraph">JWTの保存場所は「localStorageかCookieか」と語られがちですが、アクセストークンとリフレッシュトークンで保存先を分けるのがより安全な設計です。</p>



<p class="wp-block-paragraph">この記事では、なぜその設計になるのかを理由から解説します。実装コードはバックエンド・フロントエンドで別記事に分けてあるので、この記事では「設計の考え方」に絞ります。</p>



<h2 class="wp-block-heading">JWTの保存場所は3種類ある</h2>



<p class="wp-block-paragraph">JWTを保存できる場所は主に3つあり、それぞれセキュリティ特性が異なります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>localStorage</strong><br>JavaScriptから自由に読み書きできる。XSSが成立すると <code>localStorage.getItem()</code> 一行でトークンが盗まれる。</li>

<li><strong>HttpOnly Cookie</strong><br>JavaScriptから読み書きできない。ただしブラウザが同一オリジンへのリクエストに自動付与するため、CSRF攻撃の対象になりやすい。</li>

<li><strong>メモリ（JS変数）</strong><br>ページをまたいで持続しない。同じタブ内のJavaScriptからは参照できるが、localStorageのように永続化されないため露出範囲が限られる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">「HttpOnly Cookieが最も安全だから、全部そこに入れればいい」と思いたくなります。しかし、アクセストークンとリフレッシュトークンでは性質が大きく違うため、同じ保存先にまとめるのは最適解ではありません。</p>



<h2 class="wp-block-heading">アクセストークンとリフレッシュトークンを分ける理由</h2>



<p class="wp-block-paragraph">2種類のトークンには、用途と有効期限に大きな差があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン（有効期限: 15分）</strong><br>APIリクエストのたびに <code>Authorization: Bearer</code> ヘッダーに付けて送る。短命なので仮に流出しても被害期間が限定される。</li>

<li><strong>リフレッシュトークン（有効期限: 14日）</strong><br>アクセストークンが切れたときだけ使う。長命なので慎重に管理する必要がある。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">この性質の差から、次の方針が導き出されます。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><strong>アクセストークン → メモリ（JS変数）</strong><br>短命なのでリロードで消えても問題ない。Authorizationヘッダーで送るため、Cookieのような自動付与によるCSRFリスクがない。</li>

<li><strong>リフレッシュトークン → HttpOnly Cookie（パス: /auth/ に限定）</strong><br>JavaScriptから読めないのでXSSで盗まれない。パスを <code>/auth/</code> に絞ることで <code>/api/</code> へのリクエストにはCookieが付かず、CSRF攻撃の対象面を最小化できる。</li>
</ul>
</div></div>



<p class="wp-block-paragraph">両方をHttpOnly Cookieに入れた場合と比べて、アクセストークンがヘッダー送信のみになるため、CSRFトークンによる保護が不要なリクエストの範囲が広がります。</p>



<h2 class="wp-block-heading">認証フローの全体像</h2>



<p class="wp-block-paragraph">設計を決めたら、次はフローを整理します。ログインからAPIアクセス、トークン更新、ログアウトまでの流れです。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ol class="wp-block-list">
<li><strong>ページ初期化</strong><br>CSRF Cookieを取得 → <code>/auth/jwt/refresh/</code> にリクエスト → ブラウザがHttpOnly Cookieを自動送信 → サーバーがアクセストークンを返す → メモリに保存する</li>

<li><strong>APIリクエスト</strong><br>メモリ上のアクセストークンを <code>Authorization: Bearer {token}</code> ヘッダーに付けて送信する</li>

<li><strong>401レスポンス時</strong><br>アクセストークンの有効期限切れ → <code>refreshToken()</code> でトークン更新 → 新しいアクセストークンをメモリに保存 → 元のリクエストを自動リトライする</li>

<li><strong>ログアウト</strong><br>サーバー側でリフレッシュトークンをブラックリスト登録 → メモリ上のアクセストークンをクリアする</li>
</ol>
</div></div>



<p class="wp-block-paragraph">「メモリ保存だとページリロードでトークンが消えるのでは？」という疑問は正しくて、リロード後はステップ1の初期化フローが走ります。有効なリフレッシュCookieがあれば自動でアクセストークンが復元されます。</p>



<h2 class="wp-block-heading">ROTATE_REFRESH_TOKENSが引き起こす並走リフレッシュ問題</h2>



<p class="wp-block-paragraph">Djangoの <code>djangorestframework-simplejwt</code> では <code>ROTATE_REFRESH_TOKENS = True</code> を設定すると、リフレッシュのたびに新しいリフレッシュトークンが発行され、古いトークンがブラックリストに登録されます。セキュリティ上望ましい設定ですが、フロントエンドで問題が起きることがあります。</p>



<p class="wp-block-paragraph">ページ読み込み直後など、複数のAPIリクエストが同時に走るタイミングで、それぞれが並走して <code>refreshToken()</code> を呼び出すケースです。1本目のリフレッシュが成功すると古いリフレッシュトークンがブラックリストに入り、2本目以降は同じトークンで呼び出しているためエラーになります。</p>



<p class="wp-block-paragraph">対策は、進行中のリフレッシュリクエストがあれば新たに呼び出さず、同じPromiseを使い回す「mutex」パターンです。シンプルな実装で解決できます。詳しくはフロントエンド実装の記事で解説します。</p>



<h2 class="wp-block-heading">バックエンド（Django）の実装</h2>



<p class="wp-block-paragraph">SimpleJWT・Djoserの設定と、RedisキャッシュによるレートリミットミドルウェアをDjangoで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/django-simplejwt-djoser-setup/">Django JWT認証の実装｜SimpleJWT + Djoser設定とRedisレートリミット</a>
						<span class="p-blogCard__excerpt">DjangoでJWT認証を実装したい SimpleJWTとDjoserをどう組み合わせるか知りたい 不要なエンドポイントを封鎖してセキュリティを高めたい この記事は、Next.js + Django J&#8230;</span>					</div>
				</div>
			</div>
		</div>


<h2 class="wp-block-heading">フロントエンド（Next.js）の実装</h2>



<p class="wp-block-paragraph">アクセストークンのメモリ管理・セッションフラグ・refreshToken()のmutex・apiFetch()の自動リトライをTypeScriptで実装する方法を解説しています。</p>


<div class="swell-block-postLink">			<div class="p-blogCard -internal" data-type="type1" data-onclick="clickLink">
				<div class="p-blogCard__inner">
					<span class="p-blogCard__caption">あわせて読みたい</span>
					<div class="p-blogCard__thumb c-postThumb"><figure class="c-postThumb__figure"><img decoding="async" src="https://cfxlog.com/wp-content/uploads/2026/07/swell-eyecatch-noimg-300x158.jpg" alt="" class="c-postThumb__img u-obf-cover" width="320" height="180"></figure></div>					<div class="p-blogCard__body">
						<a class="p-blogCard__title" href="https://cfxlog.com/nextjs-jwt-memory-token-auth/">Next.js JWT認証の実装｜アクセストークンをメモリ管理・リフレッシュ並走バグを防ぐmutexパターン</a>
						<span class="p-blogCard__excerpt">Next.jsでJWTトークンをどこに保存すればいいか知りたい 複数リクエストが同時にリフレッシュを呼んでエラーになる問題を解決したい 401レスポンスを受け取ったときに自&#8230;</span>					</div>
				</div>
			</div>
		</div>]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>【Django】SECRET_KEYを再生成する方法</title>
		<link>https://cfxlog.com/python-django-secret-key/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 01 Mar 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=111</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key.jpg" class="webfeedsFeaturedVisual" /></p>このような疑問にお答えします。 SECRET_KEYは、以下の条件を満たす必要があります。 これを自力で考えるのはとても大変なので、Django組み込みの関数を使って生成する方法をお伝えします。 DjangoのSECRE [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-secret-key.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>まちがえて<code>SECRET_KEY</code>をGitHubにプッシュしてしまった！</li>



<li>Django標準の機能で<code>SECRET_KEY</code>を生成したい！</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような疑問にお答えします。</p>



<p class="wp-block-paragraph"><code>SECRET_KEY</code>は、以下の条件を満たす必要があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>5種類以上の文字を使用</li>



<li>50文字以上の長さ</li>
</ul>
</div></div>



<p class="wp-block-paragraph">これを自力で考えるのはとても大変なので、Django組み込みの関数を使って生成する方法をお伝えします。</p>



<h2 class="wp-block-heading">DjangoのSECRET_KEYを再生成する方法</h2>



<h3 class="wp-block-heading">Django 組み込みの関数でキーを発行</h3>



<p class="wp-block-paragraph">Djangoで<code>SECRET_KEY</code>を再生成するには、以下の関数を使います。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>from django.core.management.utils import get_random_secret_key

# SECRET_KEYを生成する
new_secret_key = get_random_secret_key()
print(new_secret_key)</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">from</span><span style="color: #D4D4D4"> django.core.management.utils </span><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> get_random_secret_key</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># SECRET_KEYを生成する</span></span>
<span class="line"><span style="color: #D4D4D4">new_secret_key = get_random_secret_key()</span></span>
<span class="line"><span style="color: #DCDCAA">print</span><span style="color: #D4D4D4">(new_secret_key)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>get_random_secret_key()</code>関数は、Djangoが<code>settings.py</code>の<code>SECRET_KEY</code>を生成しているものなので安心して使えます。</p>



<h3 class="wp-block-heading">環境変数で管理することでセキュリティ向上を目指す</h3>



<p class="wp-block-paragraph"><code>SECRET_KEY</code>はハードコーディングせずに、環境変数として管理することが推奨されます。</p>



<p class="wp-block-paragraph">もちろん<code>get_random_secret_key()</code>を使ってから<code>.env</code>に文字列を貼り付けても良いですが、ちょっと面倒なのでシェルスクリプトを作ってコマンド一つで実装できるようにしましょう。</p>



<p class="wp-block-paragraph">スクリプトは以下になります。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(2 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>#!/bin/bash

# OSの種類を判定
if [&#91; "$OSTYPE" == "darwin"* &#93;]; then
    # MacOS
    OS_TYPE="MacOS"
else
    # その他のUNIX系OS（主にLinux）
    OS_TYPE="Other"
fi

# DjangoでSECRET_KEYを生成
SECRET_KEY=$(python3 -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())")

# .envファイルのパスを指定
ENV_FILE=".env"

# .envファイルの存在確認
if &#91; -f "$ENV_FILE" &#93;; then
    echo ".envファイルが見つかりました。SECRET_KEYを更新します。"
    
    # OSに応じてsedコマンドを実行
    if &#91; "$OS_TYPE" == "MacOS" &#93;; then
        sed -i '' '/^SECRET_KEY=/d' "$ENV_FILE"
    else
        sed -i '/^SECRET_KEY=/d' "$ENV_FILE"
    fi
    
    echo "SECRET_KEY=$SECRET_KEY" >> "$ENV_FILE"
    echo "SECRET_KEYを更新しました。"
else
    echo ".envファイルが見つかりません。新しく作成します。"
    echo "SECRET_KEY=$SECRET_KEY" > "$ENV_FILE"
    echo ".envファイルを作成し、SECRET_KEYを設定しました。"
fi

# 変更の確認
echo "更新後の.envファイルの内容:"
cat "$ENV_FILE"</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955">#!/bin/bash</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># OSの種類を判定</span></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> [&#91; </span><span style="color: #CE9178">&quot;$OSTYPE&quot;</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;darwin&quot;</span><span style="color: #D4D4D4">* &#93;]; then</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># MacOS</span></span>
<span class="line"><span style="color: #D4D4D4">    OS_TYPE=</span><span style="color: #CE9178">&quot;MacOS&quot;</span></span>
<span class="line"><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># その他のUNIX系OS（主にLinux）</span></span>
<span class="line"><span style="color: #D4D4D4">    OS_TYPE=</span><span style="color: #CE9178">&quot;Other&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">fi</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># DjangoでSECRET_KEYを生成</span></span>
<span class="line"><span style="color: #D4D4D4">SECRET_KEY=</span><span style="color: #F44747">$</span><span style="color: #D4D4D4">(python3 -c </span><span style="color: #CE9178">&quot;from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルのパスを指定</span></span>
<span class="line"><span style="color: #D4D4D4">ENV_FILE=</span><span style="color: #CE9178">&quot;.env&quot;</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルの存在確認</span></span>
<span class="line"><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> &#91; -f </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span><span style="color: #D4D4D4"> &#93;; then</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルが見つかりました。SECRET_KEYを更新します。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #6A9955"># OSに応じてsedコマンドを実行</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">if</span><span style="color: #D4D4D4"> &#91; </span><span style="color: #CE9178">&quot;$OS_TYPE&quot;</span><span style="color: #D4D4D4"> == </span><span style="color: #CE9178">&quot;MacOS&quot;</span><span style="color: #D4D4D4"> &#93;; then</span></span>
<span class="line"><span style="color: #D4D4D4">        sed -i </span><span style="color: #CE9178">&apos;&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&apos;/^SECRET_KEY=/d&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">        sed -i </span><span style="color: #CE9178">&apos;/^SECRET_KEY=/d&apos;</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    fi</span></span>
<span class="line"><span style="color: #D4D4D4">    </span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEY=$SECRET_KEY&quot;</span><span style="color: #D4D4D4"> &gt;&gt; </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEYを更新しました。&quot;</span></span>
<span class="line"><span style="color: #C586C0">else</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルが見つかりません。新しく作成します。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;SECRET_KEY=$SECRET_KEY&quot;</span><span style="color: #D4D4D4"> &gt; </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">    echo </span><span style="color: #CE9178">&quot;.envファイルを作成し、SECRET_KEYを設定しました。&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">fi</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># 変更の確認</span></span>
<span class="line"><span style="color: #D4D4D4">echo </span><span style="color: #CE9178">&quot;更新後の.envファイルの内容:&quot;</span></span>
<span class="line"><span style="color: #D4D4D4">cat </span><span style="color: #CE9178">&quot;$ENV_FILE&quot;</span></span></code></pre></div>



<p class="wp-block-paragraph">これをプロジェクトのルートディレクトリに配置して、以下のコマンドを実行します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>bash ./update_env_secret_key.sh</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">bash ./update_env_secret_key.sh</span></span></code></pre></div>



<p class="wp-block-paragraph">環境変数の<code>SECRET_KEY</code>をsettings.pyで読み込むために、以下のように書き換えます。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>import environ

# .envファイルのパスを指定
env = environ.Env()
environ.Env.read_env(".env")

SECRET_KEY = env("SECRET_KEY")</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #C586C0">import</span><span style="color: #D4D4D4"> environ</span></span>
<span class="line"></span>
<span class="line"><span style="color: #6A9955"># .envファイルのパスを指定</span></span>
<span class="line"><span style="color: #D4D4D4">env = environ.Env()</span></span>
<span class="line"><span style="color: #D4D4D4">environ.Env.read_env(</span><span style="color: #CE9178">&quot;.env&quot;</span><span style="color: #D4D4D4">)</span></span>
<span class="line"></span>
<span class="line"><span style="color: #D4D4D4">SECRET_KEY = env(</span><span style="color: #CE9178">&quot;SECRET_KEY&quot;</span><span style="color: #D4D4D4">)</span></span></code></pre></div>



<p class="wp-block-paragraph"><code>.gitignore</code>ファイルで<code>.env</code>を Git 管理対象外にしておくことで、間違ってキーを公開してしまうことを防げます。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Django REST framework で CORS 対策をする方法</title>
		<link>https://cfxlog.com/python-django-rest-cors/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sat, 07 Feb 2026 15:00:00 +0000</pubDate>
				<category><![CDATA[Django]]></category>
		<category><![CDATA[API連携]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4704</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors.jpg" class="webfeedsFeaturedVisual" /></p>このような場合の対策をお伝えします。 Django REST framework（以下「DRF」とします）では、外部ライブラリを使うことで簡単に CORS 対策ができます。 本記事では CORS 対策の方法と、そもそも  [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/python-django-rest-cors.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li>Django REST framework で CORS エラーが出ている…</li>
</ul>
</div></div>



<p class="wp-block-paragraph">このような場合の対策をお伝えします。</p>



<p class="wp-block-paragraph">Django REST framework（以下「DRF」とします）では、外部ライブラリを使うことで簡単に CORS 対策ができます。</p>



<p class="wp-block-paragraph">本記事では CORS 対策の方法と、そもそも CORS とはどのようなものかをお伝えします。</p>



<h2 class="wp-block-heading">DRF での CORS 対策の方法</h2>



<p class="wp-block-paragraph">DRF で CORS 対策するのはとても簡単で、以下の流れで行います。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>ライブラリのインストール</li>



<li>INSTALLED APPS に追記</li>



<li>ミドルウェアに追記</li>



<li>CORS ポリシーを追記</li>
</ul>
</div></div>



<p class="wp-block-paragraph">ちょっとしたコツもあるので、詳しく解説していきます。</p>



<h3 class="wp-block-heading">ライブラリのインストール</h3>



<p class="wp-block-paragraph">DRF の CORS 対策用に &#8220;django-cors-headers&#8221; ライブラリをインストールします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>pip install django-cors-headers</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">pip</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">install</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">django-cors-headers</span></span></code></pre></div>



<h3 class="wp-block-heading">INSTALLED APPS に追記</h3>



<p class="wp-block-paragraph">続いて settings.py の INSTALLED_APPS に django-cors-headers を追記して、Django プロジェクト内で有効化します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>INSTALLED_APPS = &#91;
    ...
    "corsheaders",
    ...
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">INSTALLED_APPS = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;corsheaders&quot;</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">記載する順番はどこでもOKです。</p>



<h3 class="wp-block-heading">ミドルウェアに追記</h3>



<p class="wp-block-paragraph">この手順では、<strong>追記する順番が大事</strong>になります。</p>



<p class="wp-block-paragraph">MIDDLEWARE CommonMiddleware より上に、CorsMiddleware を追記しましょう。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>MIDDLEWARE = &#91;
    ...
    "corsheaders.middleware.CorsMiddleware", # 追記
    "django.middleware.common.CommonMiddleware", # デフォルトで存在
    ...
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #D4D4D4">MIDDLEWARE = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;corsheaders.middleware.CorsMiddleware&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955"># 追記</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;django.middleware.common.CommonMiddleware&quot;</span><span style="color: #D4D4D4">, </span><span style="color: #6A9955"># デフォルトで存在</span></span>
<span class="line"><span style="color: #D4D4D4">    ...</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<p class="wp-block-paragraph">Django のミドルウェアは上から順番に処理していきます。<br>CommonMiddleware は URL の末尾スラッシュの扱いや www の追加などを担当するミドルウェアです。</p>



<p class="wp-block-paragraph">仮に CorsMiddleware の前に CommonMiddleware が処理されると、CORS ヘッダがレスポンスに付与される前にリダイレクトなどの処理が行われてしまい、CORS ヘッダがうまく付与されない恐れがあります。</p>



<p class="wp-block-paragraph">そのため、CommonMiddleware の前に CorsMiddleware を記載しておく必要があるのです。</p>



<h3 class="wp-block-heading">CORS ポリシーを追記</h3>



<p class="wp-block-paragraph">どのドメインからアクセスを許可するかに応じて、大きく次の２パターンの設定方法があります。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list is-style-num_circle">
<li>全てのドメインからのアクセスを許可</li>



<li>特定のオリジンからのアクセスのみを許可</li>
</ul>
</div></div>



<p class="wp-block-paragraph">いずれかを採用して、settings.py ファイルに追記してください。</p>



<h4 class="wp-block-heading">全てのドメインからのアクセスを許可</h4>



<p class="wp-block-paragraph">特に制限をかける必要がない場合には、以下のように追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 全てのオリジンからのアクセスを許可
CORS_ALLOW_ALL_ORIGINS = True</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 全てのオリジンからのアクセスを許可</span></span>
<span class="line"><span style="color: #D4D4D4">CORS_ALLOW_ALL_ORIGINS = </span><span style="color: #569CD6">True</span></span></code></pre></div>



<h4 class="wp-block-heading">特定のオリジンからのアクセスのみを許可</h4>



<p class="wp-block-paragraph">一方で、特定のオリジンからのアクセスに限定したい場合には、以下のように追記します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Python</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># 許可するオリジンを指定
CORS_ALLOWED_ORIGINS = &#91;
    "https://example.com/",
    "https://sub.example.com/",
&#93;</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># 許可するオリジンを指定</span></span>
<span class="line"><span style="color: #D4D4D4">CORS_ALLOWED_ORIGINS = &#91;</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;https://example.com&quot;/</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #CE9178">&quot;https://sub.example.com&quot;/</span><span style="color: #D4D4D4">,</span></span>
<span class="line"><span style="color: #D4D4D4">&#93;</span></span></code></pre></div>



<h2 class="wp-block-heading">そもそも CORS とは？</h2>



<p class="wp-block-paragraph">CORS（Cross-Origin Resource Sharing）について少し突っ込んでご説明します。</p>



<h3 class="wp-block-heading">目的はセキュリティ対策</h3>



<p class="wp-block-paragraph">原則として Web ページは、異なるドメインからのアクセスは拒否する仕組みになっています。</p>



<p class="wp-block-paragraph">もしも異なるドメインからのアクセスをすべて許可してしまうと、悪意のあるクライアントからのアクセスも許すことになってしまい不都合です。</p>



<p class="wp-block-paragraph">そこで「アクセスを許可したクライアントにだけ CORS ヘッダーを付与する」ことで、API にアクセスできるクライアントを限定することができます。</p>



<p class="wp-block-paragraph">具体的にはサーバー側で対象のクライアントからのアクセスがあった場合、Access-Control-Allow-Origin という HTTP ヘッダがレスポンスに含まれることになります。</p>



<p class="wp-block-paragraph">このHTTPヘッダを付与するのに使われるのが、最初にご紹介した &#8220;django-cors-headers&#8221; ライブラリになります。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">CORS は API サーバー側でアクセス制限するための仕組みでした。</p>



<p class="wp-block-paragraph">JavaScript フレームワークと DRF を併用する際によく遭遇する事項になりますので、もし困った場合には今回ご紹介した手順に従って CORS 対策を行ってみてください。</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Next.js × DockerでGoogle認証を導入する時の「環境変数」ベストプラクティス</title>
		<link>https://cfxlog.com/nextjs-docker-google-auth-env/</link>
		
		<dc:creator><![CDATA[CFXLOG]]></dc:creator>
		<pubDate>Sun, 30 Nov 2025 15:00:00 +0000</pubDate>
				<category><![CDATA[Next.js]]></category>
		<category><![CDATA[Docker]]></category>
		<category><![CDATA[セキュリティ]]></category>
		<category><![CDATA[認証]]></category>
		<guid isPermaLink="false">https://cfxlog.com/?p=4877</guid>

					<description><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-docker-google-auth-env.jpg" class="webfeedsFeaturedVisual" /></p>Next.jsでGoogle認証（OAuth）を導入し、Dockerで本番運用するときにハマるポイントです。 環境変数の渡し方が問題だった場合の対策をお伝えします。 Next.js&#160;× DockerでGoogl [&#8230;]]]></description>
										<content:encoded><![CDATA[<p><img src="https://cfxlog.com/wp-content/uploads/2026/03/nextjs-docker-google-auth-env.jpg" class="webfeedsFeaturedVisual" /></p>
<div class="wp-block-group is-style-crease"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> がうまく渡らない</li>



<li><code>client_id</code> が空で Google ログインができない</li>
</ul>
</div></div>



<p class="wp-block-paragraph">Next.jsでGoogle認証（OAuth）を導入し、Dockerで本番運用するときにハマるポイントです。</p>



<p class="wp-block-paragraph"><strong>環境変数の渡し方</strong>が問題だった場合の対策をお伝えします。</p>



<h2 class="wp-block-heading">Next.js&nbsp;× DockerでGoogle認証を導入する時の「環境変数」ベストプラクティス</h2>



<h3 class="wp-block-heading">Next.jsの環境変数の基本</h3>



<p class="wp-block-paragraph">Next.jsの環境変数には2種類あります。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>環境変数名の形式</th><th>使用場所</th><th>読み取りタイミング</th></tr></thead><tbody><tr><td><code>NEXT_PUBLIC_</code> から始まる</td><td>クライアントサイド（ブラウザ）</td><td><strong>ビルド時</strong></td></tr><tr><td>通常の環境変数</td><td>サーバーサイド（API/SSR）</td><td><strong>実行時</strong></td></tr></tbody></table></figure>



<p class="wp-block-paragraph">NEXT_PUBLIC_ 付きの環境変数は 「ビルド時」 に読み込まれ、JSに静的に埋め込まれます。</p>



<p class="is-style-icon_info wp-block-paragraph">ビルド時に<code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code>が空だと、アプリ中の<code>client_id</code>は空のままになります。実行時に渡しても意味がありません。</p>



<h3 class="wp-block-heading">Docker運用での落とし穴</h3>



<p class="wp-block-paragraph">よくある間違った設定は、以下の通り。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># ビルド時には使えない
services:
  frontend:
    environment:
      - NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxxxxx.apps.googleusercontent.com</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># ビルド時には使えない</span></span>
<span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">frontend</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">environment</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      - </span><span style="color: #CE9178">NEXT_PUBLIC_GOOGLE_CLIENT_ID=xxxxxx.apps.googleusercontent.com</span></span></code></pre></div>



<p class="wp-block-paragraph">Dockerでは、<code>environment</code> で渡しても <strong>実行時</strong> にしか使えません。</p>



<p class="wp-block-paragraph">そのため、<strong>クライアントサイド用の環境変数には反映されずビルド時に反映されないのです。</strong></p>



<h3 class="wp-block-heading">正しい設定方法（build.args を使う）</h3>



<p class="wp-block-paragraph">結論、build.argsを使ってビルド時に環境変数を渡します。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">YAML</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>services:
  frontend:
    build:
      context: ./frontend
      args:
        NEXT_PUBLIC_API_URL: https://api.example.com/api
        NEXT_PUBLIC_GOOGLE_CLIENT_ID: xxxxxxxx.apps.googleusercontent.com</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #569CD6">services</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">  </span><span style="color: #569CD6">frontend</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">    </span><span style="color: #569CD6">build</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">context</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">./frontend</span></span>
<span class="line"><span style="color: #D4D4D4">      </span><span style="color: #569CD6">args</span><span style="color: #D4D4D4">:</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">NEXT_PUBLIC_API_URL</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">https://api.example.com/api</span></span>
<span class="line"><span style="color: #D4D4D4">        </span><span style="color: #569CD6">NEXT_PUBLIC_GOOGLE_CLIENT_ID</span><span style="color: #D4D4D4">: </span><span style="color: #CE9178">xxxxxxxx.apps.googleusercontent.com</span></span></code></pre></div>



<p class="wp-block-paragraph">上記のようにdocker-compose.yamlを書いた場合には、<code>Dockerfile</code>に以下のようにします。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Dockerfile</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly># クライアント用の環境変数をビルド時に受け取る
ARG NEXT_PUBLIC_API_URL
ENV NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}

ARG NEXT_PUBLIC_GOOGLE_CLIENT_ID
ENV NEXT_PUBLIC_GOOGLE_CLIENT_ID=${NEXT_PUBLIC_GOOGLE_CLIENT_ID}</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #6A9955"># クライアント用の環境変数をビルド時に受け取る</span></span>
<span class="line"><span style="color: #569CD6">ARG</span><span style="color: #D4D4D4"> NEXT_PUBLIC_API_URL</span></span>
<span class="line"><span style="color: #569CD6">ENV</span><span style="color: #D4D4D4"> NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}</span></span>
<span class="line"></span>
<span class="line"><span style="color: #569CD6">ARG</span><span style="color: #D4D4D4"> NEXT_PUBLIC_GOOGLE_CLIENT_ID</span></span>
<span class="line"><span style="color: #569CD6">ENV</span><span style="color: #D4D4D4"> NEXT_PUBLIC_GOOGLE_CLIENT_ID=${NEXT_PUBLIC_GOOGLE_CLIENT_ID}</span></span></code></pre></div>



<p class="is-style-icon_good wp-block-paragraph">これで Next.js のビルド時に <code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> が正しく埋め込まれます！</p>



<h3 class="wp-block-heading">最後にコンテナの再ビルド・再起動をする</h3>



<p class="wp-block-paragraph">環境変数を修正したら、<strong>必ず再ビルド</strong>してください。</p>



<div class="wp-block-kevinbatdorf-code-block-pro cbp-has-line-numbers" data-code-block-pro-font-family="Code-Pro-JetBrains-Mono" style="font-size:.875rem;font-family:Code-Pro-JetBrains-Mono,ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;--cbp-line-number-color:#D4D4D4;--cbp-line-number-width:calc(1 * 0.6 * .875rem);line-height:1.25rem;--cbp-tab-width:2;tab-size:var(--cbp-tab-width, 2)"><span style="display:flex;align-items:center;padding:16px 0 0 16px;width:100%;text-align:left;background-color:#1e1e1e"><span style="background:#c7c7c7;padding:0.3rem 0.5rem 0.2rem;border-radius:1rem;font-size:0.8em;line-height:1;height:1.25rem;text-align:center;display:inline-flex;align-items:center;justify-content:center;color:#1e1e1e">Bash</span></span><span role="button" tabindex="0" style="color:#D4D4D4;display:none" aria-label="Copy" class="code-block-pro-copy-button"><pre class="code-block-pro-copy-button-pre" aria-hidden="true"><textarea class="code-block-pro-copy-button-textarea" tabindex="-1" aria-hidden="true" readonly>docker-compose down
docker-compose build --no-cache
docker-compose up -d</textarea></pre><svg xmlns="http://www.w3.org/2000/svg" style="width:24px;height:24px" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2"><path class="with-check" stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5"></path><path class="without-check" stroke-linecap="round" stroke-linejoin="round" d="M16.5 8.25V6a2.25 2.25 0 00-2.25-2.25H6A2.25 2.25 0 003.75 6v8.25A2.25 2.25 0 006 16.5h2.25m8.25-8.25H18a2.25 2.25 0 012.25 2.25V18A2.25 2.25 0 0118 20.25h-7.5A2.25 2.25 0 018.25 18v-1.5m8.25-8.25h-6a2.25 2.25 0 00-2.25 2.25v6"></path></svg></span><pre class="shiki dark-plus" style="background-color: #1E1E1E" tabindex="0"><code><span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">down</span></span>
<span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">build</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">--no-cache</span></span>
<span class="line"><span style="color: #DCDCAA">docker-compose</span><span style="color: #D4D4D4"> </span><span style="color: #CE9178">up</span><span style="color: #D4D4D4"> </span><span style="color: #569CD6">-d</span></span></code></pre></div>



<p class="is-style-icon_announce wp-block-paragraph">値が空のままビルドされると、再起動しても直りません。<br>再ビルドが必須です！</p>



<h2 class="wp-block-heading">よくある質問（FAQ）</h2>



<h3 class="wp-block-heading">Q. <code>environment</code> は設定不要？</h3>



<p class="wp-block-paragraph"><code>NEXT_PUBLIC_</code> 環境変数は、基本的に<code>build.args</code>のみで大丈夫です。</p>



<p class="wp-block-paragraph">一方で、APIやSSRなどのサーバーサイドで参照する変数の場合にはenvironmentへの登録が必要です。</p>



<h3 class="wp-block-heading">Q. <code>.env.local</code> は本番で使える？</h3>



<p class="wp-block-paragraph">Docker本番では反映されないので、使えません。</p>



<p class="wp-block-paragraph"><code>.env.local</code>はその名の通り、ローカル開発用の環境変数設定ファイルです。</p>



<h2 class="wp-block-heading">まとめ</h2>



<p class="wp-block-paragraph">本記事の結論をまとめます。</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><thead><tr><th>やること</th><th>方法</th></tr></thead><tbody><tr><td>公開環境変数を渡す</td><td><code>build.args</code> + <code>Dockerfile ARG/ENV</code></td></tr><tr><td>サーバー環境変数を渡す</td><td><code>environment</code></td></tr><tr><td>変更後の対応</td><td><code>docker-compose build --no-cache</code></td></tr><tr><td>.env.local</td><td>本番では使わない</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Next.js × Docker で Google OAuth を使うときは、以下を気をつけましょう。</p>



<div class="wp-block-group has-border -border01"><div class="wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained">
<ul class="wp-block-list">
<li><code>NEXT_PUBLIC_GOOGLE_CLIENT_ID</code> は <strong>ビルド時に渡す！</strong></li>



<li>Docker では <code>build.args</code> で渡し、Dockerfile に <code>ARG</code>/<code>ENV</code> を必ず書く！</li>



<li>再ビルドは <strong>忘れずに！</strong></li>
</ul>
</div></div>



<p class="wp-block-paragraph">これはGoogle認証だけでなく、<strong>すべての <code>NEXT_PUBLIC_</code> 環境変数に共通</strong>です。</p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
