秘密鍵の管理

PlayFab 開発者の秘密鍵を使用すると、タイトルで PlayFab Admin および Server API 呼び出しを行うことができます。 開発者キーとも呼ばれる秘密鍵は、PlayFab タイトルに強く結び付けられています。

ゲーム マネージャーの [秘密鍵] ページを使用して、鍵の作成、削除、無効化、有効期限の設定を行うことができます。 これにより、タイトルの秘密鍵をローテーションできます (これまでは困難でした)。また、タイトルへの一時的なアクセス権を付与することもできます。

注意

お客様に送信するクライアント ビルドに開発者の秘密鍵を含めないでください。 これを行うと、タイトルが不正使用される可能性があります。

タイトルの秘密鍵を管理するには:

1. ゲーム マネージャーにサインインします。
2. タイトルを選択します。
3. 右上隅で、歯車のアイコンを選択します。
4. [Title settings (タイトル設定)] を選択して、[Secret Keys (秘密鍵)] タブを選択します。

[秘密鍵] ページには、削除キーのオプション、各鍵の状態、その名前、値、有効期限が表示されます (これらが存在する場合)。 次の表では、鍵を使用できるか監査できます。

ダッシュボードを使用して、既存の鍵の名前の変更、有効、無効、有効期限の設定をできます。 鍵のオプションを表示するには、鍵を選択します。 各タイトルは、既定の鍵を使用して開始します。

鍵を交換するには:

1. [New Secret Key](新しい秘密鍵) を選択します。
2. 鍵の [名前] とオプションの有効期限を入力します。
3. 新しい鍵を使用するようにコードを更新します。
4. 古い鍵を無効にします。 古い鍵を選択し、[秘密鍵の編集] ページで、[無効にする] チェック ボックスをオンにします。
5. [SAVE SECRET KEY](秘密鍵を保存) を選択します。

Important

古い鍵が侵害された場合、鍵をローテーションしてタイトルをセキュリティで保護された状態に戻します。

このフローはダウンタイムが発生しません。古い鍵を削除するまで各ステップを安全にロールバックできます。 最初の手順で問題が発生した場合、新しい鍵を削除できます。 誰もその鍵を使うことはありません。

手順 2 では、両方の鍵はアクティブであるため、コードを安全に変更することもロールバックすることもできます。

手順 3 で、再度鍵を有効にできますが、この時点でも鍵に依存していることはすべて解決できます。

このプロセス全体が完了した時に、古い鍵を削除する必要はありません。 その鍵を削除すると、復旧できません。 削除は永続的な操作であり、元に戻すことはできません。

鍵を期限切れに設定すると、他のユーザーにタイトルへの一時的なアクセスを許可する必要がある場合に便利です。

たとえば、お客様のゲームに対して作業するコントラクターがいる場合、必要と思われる期間だけアクセスできる鍵を付与できます。 元の予期された有効期限を超えるアクセスが必要な場合は、有効期限をリセットして秘密鍵の有効期間を延長できます。