> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PlayFab Game Manager の API 機能設定

> PlayFab Game Manager で、カスタム データの JSON 検証、プライバシー オプション、その他のタイトル全体の API 動作など、API 機能設定を構成します。

PlayFab Game Manager の API 機能は、タイトル用の PlayFab API の動作を管理するためのオプションです。これらのオプションは、アクセス、プライバシー、およびその他の機能を管理するためのツールを提供します。

これらのオプションを構成する画面を見つけるには:

* **Game Manager** に移動します。
* 左のメニューから **Settings** を選択します。
* **API Features** タブを選択します。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-api-features-full.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=ff65da3a46374af1c80aa9f84952074b" alt="Game Manager - Settings - API Features" width="1269" height="1255" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-settings-api-features-full.png" />

これらのチェック ボックスの一部は明白ですが、そうでないものもあります。このチュートリアルでは、いくつかを詳細に説明します。

<Note>
  このチュートリアルのいくつかのスクリーンショットとデモンストレーションでは、[Postman](/services/playfab/sdks/postman/postman-quickstart) を活用します。
</Note>

## カスタム データ値に有効な JSON を必須にする

ハッキングされたクライアントは、ゲームに深刻な問題を引き起こす可能性があります。不正な API 呼び出し元が誤ったフォーマットのデータを投稿すると、開発者にとってノイズ、バグ、問題が発生する可能性があります。フォーマットが不十分なデータを持つプレイヤーは、クリーンアップのために手動介入が必要になることがよくあります。

カスタム データ値に有効な JSON を必須にすると、データがデータベースに保存される *前に* 基本的なコンテンツ タイプの検証が実行されます。これらの問題を早期にキャッチすると、これらの問題が長引くのを防ぎ、ハッカーが通常の開発を妨害するのを止めることができます。

このフラグが設定されると、クライアントはカスタム データの各キーに有効な JSON を渡すように強制されます。単純な JSON 検証だけでは *すべての* 問題を防ぐことはできませんが、いくつかの不正な行動を排除するのに役立ちます。

このオプションをオンにすると、プレイヤー、パブリッシャー、キャラクター、タイトル、アイテムのデータを含むすべてのカスタム データに保存される各キーが有効な JSON である必要があります。

<Note>
  このフラグはいつでも *オン* または *オフ* に切り替えることができます。ただし、遡及的ではありません *。* 既存の値は影響 *を受けません*。*新しく書き込まれる値のみが検証されます。*
</Note>

無効な JSON を値として渡そうとすると、`HTTP Status Code 400 "Bad Request"` でリクエストが拒否されます。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/postman-sending-invalid-json.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=f36cfcd0c8e160dfdac63e529c3a5b9e" alt="Postman - 無効な JSON の送信" width="1355" height="1152" data-path="images/playfab/live-service-management/gamemanager/tutorials/postman-sending-invalid-json.png" />

## すべての API リクエスト アクセスを無効にする

意外にも、タイトルへのすべての API アクセスを無効にすることは有用な場合があります。

たとえば、ダウンタイムを伴う重要な移行を実行している場合、迷惑な API リクエストは深刻な中断を引き起こす可能性があります。ゲームを廃止する場合、これでゲームが本当にオフになることが保証されます。

<Warning>
  このチェックボックスをマークすると **文字通りゲームが壊れる** ことに注意してください。慎重に使用してください!
</Warning>

API アクセスをオフにする必要があると判断し、ボックスをチェックすると、すべての API リクエストが数分以内に失敗し始めます。

PlayFab は `HTTP Status Code 400 "Bad Request"` を返し、タイトルがそのような使用を無効にしたことを示します。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/postman-accessing-a-disabled-api.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=5699272b227f83fc32e34ec6f7ac7eb0" alt="Postman - 無効化された API にアクセス" width="1368" height="1020" data-path="images/playfab/live-service-management/gamemanager/tutorials/postman-accessing-a-disabled-api.png" />

これらの `HTTP Status Code 400` 応答は、ボックスのチェックを外すまで続きます。繰り返しますが、チェックを外すのが有効になるには数分かかる場合があります。

## プレイヤーの IP アドレスの難読化を有効にする

多くのスタジオにとって、**個人特定可能情報** (**PII**) を保有することは、避けるべき責任です。**PII** の一般的な (そして有用な) 形式の 1 つが **IP アドレス** です。

IP アドレスは、地理的位置情報などいくつかの理由で有用です。ただし、IP の *完全な* 精度はしばしば PII と見なされます。

PlayFab は、IP アドレスの一部を難読化することでこれを制限するのに役立ちます。ボックスをチェックするだけで、この機密データの収集を停止できます。

このボックスをチェックすると、PlayFab は常にプレイヤーの IP の最後のオクテットに **0** を記録します。**Players** タブでプレイヤーのログイン履歴を確認することで、これが機能していることを確認できます。

すべての IP が **.0** で終わっていることが確認できるはずです。IP アドレスの難読化が有効になる前に記録された IP は、完全な詳細を保持します。したがって、ゲームが PII に敏感な場合は、リリースする前にこのチェックボックスを設定してください。

<Note>
  難読化を有効にすると、IP アドレスを使用する *他の* 機能に影響します。最も直接的な影響を受けるのは、IP ベースの地理的位置情報、IP バン、および IP アドレスを指定するプレイヤー バンの 3 つです。
</Note>

PlayFab はログイン時に自動的に IP ベースの地理的位置情報を実行します。これにより、プレイヤーが地球上のどこから来たかを自動的に判別できます。

ただし、難読化された IP を使用する場合、*特に* 都市レベルで精度が低下する場合があります。これは意図的なもので、IP を難読化する目的は、正確な位置を含む PII の記録を回避することだからです。

さらに、IP を難読化すると [IP バン](/services/playfab/player-progression/player-data/ip-bans) に影響を与える可能性があります。悪質なプレイヤーは新しいアカウントを作成できるため、1 つのアカウントを一度にバンするよりも IP バンを発行する方が実用的なことがよくあります。

IP をバンすると、悪質なプレイヤーが同じインターネット接続から新しいアカウントを作成することを防ぎます。多くの場合、これは効果的なツールです。

ただし、難読化された IP では、正確な IP のバンは機能しません。代わりに、最終オクテットとして **.0** を持つ IP のバンを使用する必要があります。これは事実上 *IP 範囲全体* をバンすることになりますので注意してください。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-obfuscated-ip-ban.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=efc08197810551e86f8922aa35b53f74" alt="Game Manager - IP バン - バンの追加" width="823" height="728" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-obfuscated-ip-ban.png" />

以下に示すように、**.0** で終わる難読化されたアドレスに依存する代わりに、同等の CIDR 範囲を入力することで範囲を明示的にします。2 つのバンは機能的に同等です。

<img src="https://mintcdn.com/microsoft-4404708b/dqv53299jA1M-fNi/images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-range-ban.png?fit=max&auto=format&n=dqv53299jA1M-fNi&q=85&s=80c74e8f043eed7f9933c7bcadfc8036" alt="Game Manager - IP バン - 範囲バン" width="943" height="725" data-path="images/playfab/live-service-management/gamemanager/tutorials/game-manager-ipbans-range-ban.png" />

これでも悪質なプレイヤーはバンされますが、似た IP アドレスを持つ他の無実のプレイヤーが影響を受ける可能性があります。さらに、特定の難読化されていない IP アドレスに対する既存のバンは、もはや効果的ではなくなります。


## Related topics

- [PlayFab の PlayStream イベント モデル リファレンス](/ja-jp/services/playfab/api-references/events/index.md)
- [PlayFab ライブ サービス管理ドキュメント](/ja-jp/services/playfab/live-service-management/index.md)
- [title_api_settings_changed](/ja-jp/services/playfab/api-references/events/ApiAccessPolicy/title-api-settings-changed.md)
- [Game Manager の API アクセス ポリシー](/ja-jp/services/playfab/live-service-management/gamemanager/api-access-page-doc.md)
- [PlayFab Game Saves の Steam Deck 実装ガイド](/ja-jp/services/playfab/player-progression/game-saves/steam-deck-implementation.md)