<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" data-line="0" class="code-line">
<a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> はじめに</h2>
<p data-line="1" class="code-line">先日Appleからこの様なお知らせがあり、APNs認証キーの新たな設定オプションが追加されていたので、<a href="https://developer.apple.com/account" target="_blank" rel="nofollow noopener noreferrer">Apple Developer</a>でキーの作成を試しながら変更点を整理しました。<br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__ce348f1e26028" src="https://embed.zenn.studio/card#zenn-embedded__ce348f1e26028" data-content="https%3A%2F%2Fdeveloper.apple.com%2Fjp%2Fnews%2F%3Fid%3Dwy4tb0uo" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://developer.apple.com/jp/news/?id=wy4tb0uo" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/jp/news/?id=wy4tb0uo</a></p>
<h2 id="%E5%A4%89%E6%9B%B4%E7%82%B9" data-line="4" class="code-line">
<a class="header-anchor-link" href="#%E5%A4%89%E6%9B%B4%E7%82%B9" aria-hidden="true"></a> 変更点</h2>
<h3 id="%E3%82%AD%E3%83%BC%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%A7%E3%81%8D%E3%82%8B%E7%92%B0%E5%A2%83%E3%82%92%E7%B4%B0%E3%81%8B%E3%81%8F%E5%88%B6%E9%99%90%E3%81%A7%E3%81%8D%E3%82%8B%E6%A7%98%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F" data-line="6" class="code-line">
<a class="header-anchor-link" href="#%E3%82%AD%E3%83%BC%E3%82%92%E4%BD%BF%E7%94%A8%E3%81%A7%E3%81%8D%E3%82%8B%E7%92%B0%E5%A2%83%E3%82%92%E7%B4%B0%E3%81%8B%E3%81%8F%E5%88%B6%E9%99%90%E3%81%A7%E3%81%8D%E3%82%8B%E6%A7%98%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%9F" aria-hidden="true"></a> キーを使用できる環境を細かく制限できる様になった</h3>
<p data-line="8" class="code-line">APNs認証キーの作成時に、新たに追加された以下の項目を指定することで、<strong>キーの使用が許可される環境をより細かく制限出来る</strong>様になりました。</p>
<ul data-line="10" class="code-line">
<li data-line="10" class="code-line">
<strong>Environment</strong>
<ul data-line="11" class="code-line">
<li data-line="11" class="code-line">ドキュメントでは<strong>チームスコープキー</strong>と呼ばれている。
<ul data-line="12" class="code-line">
<li data-line="12" class="code-line">EnvironmentはApple Developer上の表記。</li>
</ul>
</li>
<li data-line="13" class="code-line">
<code>Sandbox</code> / <code>Production</code> / <code>Sandbox＆Production</code>の3種類から選択可能。
<ul data-line="14" class="code-line">
<li data-line="14" class="code-line">以前はキーの使用を特定の環境に制限することは出来なかった。</li>
</ul>
</li>
</ul>
</li>
<li data-line="15" class="code-line">
<strong>Key Restriction</strong>
<ul data-line="16" class="code-line">
<li data-line="16" class="code-line">ドキュメントでは<strong>トピック固有キー</strong>と呼ばれている。
<ul data-line="17" class="code-line">
<li data-line="17" class="code-line">Key RestrictionはApple Developer上の表記。</li>
</ul>
</li>
<li data-line="18" class="code-line">
<code>Team Scoped（All Topics）</code> / <code>Topic Specific</code>の2種類から選択可能。
<ul data-line="19" class="code-line">
<li data-line="19" class="code-line">
<code>Topic Specific</code>を選択すると、具体的なBundle IDを選択して特定のアプリでのみ使用できるキーを作成可能。</li>
<li data-line="20" class="code-line">以前はアプリ毎に使用するキーを制限することが出来なかった。</li>
</ul>
</li>
</ul>
</li>
</ul>
<h3 id="%E3%82%AD%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90%E6%95%B0%E3%81%AE%E4%B8%8A%E9%99%90%E3%81%8C%E5%A2%97%E3%81%88%E3%81%9F" data-line="22" class="code-line">
<a class="header-anchor-link" href="#%E3%82%AD%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90%E6%95%B0%E3%81%AE%E4%B8%8A%E9%99%90%E3%81%8C%E5%A2%97%E3%81%88%E3%81%9F" aria-hidden="true"></a> キーの作成数の上限が増えた</h3>
<p data-line="24" class="code-line">これまではAPNs認証キーはApple Developerアカウントにつき2つまでしか作成できないという制限がありましたが、この制限についても変更されており、<strong>作成可能なキー数の上限が増えています</strong>。具体的な上限については<a href="https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns#Team-scoped-keys" target="_blank" rel="nofollow noopener noreferrer">こちら</a>に記載されています。</p>
<h2 id="apple-developer%E3%81%A7%E3%81%AE%E8%A8%AD%E5%AE%9A" data-line="26" class="code-line">
<a class="header-anchor-link" href="#apple-developer%E3%81%A7%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> Apple Developerでの設定</h2>
<p data-line="28" class="code-line">Apple Developerでこれらの設定を追加する方法を紹介します。</p>
<p data-line="30" class="code-line">APNs認証キーを作成する時に、<code>Configure</code>というボタンが表示される様になりました。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/098354674f82-20250225.png" loading="lazy" class="md-img"></p>
<p data-line="33" class="code-line"><code>Configure</code>を押すと以下の画面に遷移します。ここで先ほど紹介した<code>Environment</code>と<code>Key Restriction</code>をそれぞれ指定できます。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/85136f2d1a10-20250225.png" loading="lazy" class="md-img"></p>
<p data-line="36" class="code-line"><code>Key Restriction</code>を<code>Topic Specific</code>にすると、以下の様にTopicを追加できる様になります。キーの使用を特定のアプリに制限したい場合は、ここでBundle IDを指定できます。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/aa17621d2a9f-20250225.png" loading="lazy" class="md-img"></p>
<h2 id="%E4%BD%9C%E6%88%90%E6%B8%88%E3%81%BF%E3%81%AE%E3%82%AD%E3%83%BC%E3%81%AE%E6%89%B1%E3%81%84%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" data-line="39" class="code-line">
<a class="header-anchor-link" href="#%E4%BD%9C%E6%88%90%E6%B8%88%E3%81%BF%E3%81%AE%E3%82%AD%E3%83%BC%E3%81%AE%E6%89%B1%E3%81%84%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> 作成済みのキーの扱いについて</h2>
<p data-line="41" class="code-line">この機能が登場する前に作成していたAPNs認証キーについては、これまでと同じ挙動になり、Environmentには<code>Sandbox＆Production</code>、Key Restrictionは<code>Team Scoped（All Topics）</code>として設定されます。</p>
<p data-line="43" class="code-line"><img src="https://storage.googleapis.com/zenn-user-upload/157504b8de03-20250225.png" width="300" loading="lazy" class="md-img"></p>
<p data-line="45" class="code-line">既存のキーに対しては<code>Edit</code>ボタンが表示されて値が変更できそうに見えますが、<strong>作成済みのキーに対してEnvironmentやKey Restrictionの設定を変更することは出来ません。</strong> スコープを変更したい場合は新たにキーを作り直す必要がある為、注意が必要です。<br>
<img src="https://storage.googleapis.com/zenn-user-upload/4ba6f96d5795-20250225.png" loading="lazy" class="md-img"></p>
<h2 id="%E3%81%95%E3%81%84%E3%81%94%E3%81%AB" data-line="48" class="code-line">
<a class="header-anchor-link" href="#%E3%81%95%E3%81%84%E3%81%94%E3%81%AB" aria-hidden="true"></a> さいごに</h2>
<p data-line="50" class="code-line">APNs認証キーの新機能について整理しました。ドキュメントやApple Developerを操作しながら確認しましたが、もし間違っている点や気になる箇所等があれば、コメントをいただけると幸いです。</p>
<h2 id="%E5%8F%82%E8%80%83" data-line="52" class="code-line">
<a class="header-anchor-link" href="#%E5%8F%82%E8%80%83" aria-hidden="true"></a> 参考</h2>
<p data-line="53" class="code-line"><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__72c41af0ad90a" src="https://embed.zenn.studio/card#zenn-embedded__72c41af0ad90a" data-content="https%3A%2F%2Fdeveloper.apple.com%2Fjp%2Fnews%2F%3Fid%3Dwy4tb0uo" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://developer.apple.com/jp/news/?id=wy4tb0uo" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/jp/news/?id=wy4tb0uo</a><br style="display:none">
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__17cb63567751b" src="https://embed.zenn.studio/card#zenn-embedded__17cb63567751b" data-content="https%3A%2F%2Fdeveloper.apple.com%2Fdocumentation%2Fusernotifications%2Festablishing-a-token-based-connection-to-apns" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://developer.apple.com/documentation/usernotifications/establishing-a-token-based-connection-to-apns</a></p>


APNs認証キーの新機能について

キーを使用できる環境を細かく制限できる様になった

作成済みのキーの扱いについて

Discussion