Photon Steam認証

アプリケーションのセットアップ

Steamは認証プロバイダとして簡単に追加でき、 追加はPhotonアプリケーションのダッシュボードから数秒で設定できます。
アプリケーションの「管理」ページに進み、「認証」セクションにスクロールダウンしてください。

新たな認証プロバイダをSteamに追加する場合、または既存の認証プロバイダを編集する場合には、以下の設定が必須です:

  • apiKeySecret: SteamパブリッシャーWeb APIのキーです。Steam User Keyと混同しないよう留意してください。取得の方法はこちらを参照してください。
  • appid: SteamゲームのID。Steam Directの処理後(旧 Steam Greenlight)にこのIDを取得できます。
  • verifyOwnership:trueまたはfalseの値となります:認証の際に所有権の検証を有効化するかを設定します。
    これによって、ユーザーが本当にそのゲームを所有しているか(ゲームを購入し、ライブラリにそのゲームを所有しているか)を検証できます。
    有効化されている場合には、この手順はユーザーのセッションチケットを認証後に実行されます。
    これを有効化すると、認証が遅延する可能性があります。このため、本当に必要な場合のみ有効化してください。
  • verifyVacBan: trueまたはfalseの値となります: 認証の際にValveのAnti-Cheat (VAC)を使用し、ユーザーが禁止されたか確認を設定できます。
    詳細はこちらを参照してください。
    これを有効化すると、認証が遅延する可能性があります。このため、本当に必要な場合のみ有効化してください。
  • verifyPubBan: trueまたはfalseの値となります:認証の際にPublisher Banを使用し、ユーザーが禁止されたか確認を設定できます。
    詳細はこちらを参照してください。
    これを有効化すると、認証が遅延する可能性があります。このため、本当に必要な場合のみ有効化してください。
  • version: 1または2の可能性があります(デフォルト値は1です)。バージョンが2に設定されている場合には、セッションチケットの検証にアイデンティティーパラメータが使用されます。アイデンティティーを使用していない場合には、1のままにします。
  • identity: バージョンが2に設定されている場合に使用されます。Steamworks SDK 1.57では、アイデンティティーパラメータを必要とするGetAuthTicketForWebAPIが追加されました。任意の文字列識別子(デフォルトは「photon」)を指定できます。

クライアントコード(Unity)

クライアントは、セッションチケットを取得するためにValveのSteamworks APIを使用する必要があります。
このチケットは、そのクライアントが有効なSteamユーザーであることの証明です。

Steamworks.NET

Steamworks.NETは一般的かつ無償のオープンソースSteamworks APIラッパーです。
Steamworks.NETのUnityバージョンをインポートするには、 このページに記載された手順に従ってください。

チケットを取得

C#

// hAuthTicket should be saved so you can use it to cancel the ticket as soon as you are done with it
public string GetSteamAuthTicket(out HAuthTicket hAuthTicket)
{
    byte[] ticketByteArray = new byte[1024];
    uint ticketSize;
    hAuthTicket = SteamUser.GetAuthSessionTicket(ticketByteArray, ticketByteArray.Length, out ticketSize);
    System.Array.Resize(ref ticketByteArray, (int)ticketSize);
    StringBuilder sb = new StringBuilder();
    for(int i=0; i < ticketSize; i++)
    {
        sb.AppendFormat("{0:x2}", ticketByteArray[i]);
    }
    return sb.ToString();
}

上記のアイデンティティーパラメータの説明を参照してください。バージョンが2に設定されている場合にはGetAuthSessionTicketではなくGetAuthTicketForWebAPIを使用する必要があります。

チケットを送信

クライアントはユーザーのセッションチケット(16進暗号化UTF-8文字列に変換後)をクエリ文字列キー「チケット」の値として送信する必要があります。

C#

AuthenticationValues authValues = new AuthenticationValues();
authValues.AuthType = CustomAuthenticationType.Steam;
authValues.AddAuthParameter("ticket", SteamAuthSessionTicket);
authValues.UserId = SteamUser.GetSteamID().ToString(); // UserId is always required in Photon Chat
// do not set authValues.Token or authentication will fail
chatClient.Connect(chatAppId, chatAppVersion, authValues);

チケットをキャンセル

認証完了後に、チケットをキャンセルまたは無効化することを推奨します。

C#

SteamUser.CancelAuthTicket(hAuthTicket);

Facepunch.Steamworks

Facepunch.Steamworksは、もう1つの代替的な無償かつオープンソースのSteamworks API実装です。
Facepunch.Steamworksをインポートするには、このページに記載された手順に従ってください。

チケットを取得

以下のコードでセッションチケットを取得してください。その後、そのチケットを16進暗号化UTF-8文字列に変換します:

C#

// authTicket should be saved so you can use it to cancel the ticket as soon as you are done with it
public string GetSteamAuthTicket(out AuthTicket authTicket)
{
    authTicket = SteamUser.GetAuthSessionTicket();
    StringBuilder ticketString = new StringBuilder();
    for (int i = 0; i < authTicket.Data.Length; i++)
    {
        ticketString.AppendFormat("{0:x2}", authTicket.Data[i]);
    }
    return ticketString.ToString();
}

チケットを送信

クライアントはユーザーのセッションチケット(16進暗号化UTF-8文字列に変換後)をクエリ文字列キー「チケット」の値として送信する必要があります。

C#

AuthenticationValues authValues = new AuthenticationValues();
authValues.AuthType = CustomAuthenticationType.Steam;
authValues.AddAuthParameter("ticket", SteamAuthSessionTicket);
authValues.UserId = SteamClient.SteamId.ToString(); // UserId is always required in Photon Chat
chatClient.Connect(chatAppId, chatAppVersion, authValues);

チケットをキャンセル

認証完了後に、チケットをキャンセルまたは無効化することを推奨します。

C#

ticket.Cancel();

Change History

June 20, 2023:

  • Added: description for Steam identity usage
Back to top