専用サーバー IAM クライアントを設定する - AccelByte Multiplayer Servers (AMS) による専用サーバー - (Unreal Engine モジュール)

Last updated on September 28, 2026

注釈：本資料はAI技術を用いて翻訳されています。

注記

AGS CLI は AGS 向けの統一コマンドラインツールであり、Extend と AMS のツールも含まれるようになりました。このページの手順は現在も有効です。統合ツールの詳細は AGS CLI のドキュメント を参照してください。

概要​

IAM クライアントは、AccelByte Gaming Services (AGS) 内の特定のリソースに対する権限を与えるために使用します。ゲームの専用サーバーが AccelByte Multiplayer Servers (AMS) と通信できるようにするには、正しい IAM クライアント権限を設定する必要があります。

サーバー IAM クライアントを作成する​

サーバーのアイデンティティおよびアクセス管理 (IAM) クライアントは、ゲームサーバーに権限を与える IAM クライアントです。ゲームサーバーが AMS と通信できるようにするには、十分な権限が必要です。

  1. Admin Portal にログインし、ゲームのネームスペースダッシュボードに移動します。

  2. Foundations > Identity & Access > IAM Clients に移動し、Create New をクリックします。

  3. What is this client for? ウィンドウで Dedicated Server を選択し、Continue をクリックします。New IAM Client ページが表示されます。

    IAM クライアントテンプレートが表示された What is this client for ウィンドウを示す画像

  4. Basic Info および Client Settings セクションで、以下の設定を使用して新しいサーバー IAM クライアントを作成します。

    • Client Name: IAM クライアントの名前です。ByteWars-GameServer に設定します。
    • Secret: IAM クライアントのシークレットまたはパスワードです。自分のシークレットを使用することも、Generate をクリックしてランダムに生成することもできます。
    • Redirect URI: IAM クライアントの認証が成功した後にリダイレクトするために使用される URI です。Localhost を選択すると、http://127.0.0.1 に設定されます。

  5. Permissions セクションで、クライアントに以下の権限があることを確認します。これらの権限により、サーバーはゲームセッションの管理、統計の更新、プレイヤー情報の読み取り、AMS 設定の管理を行えます。

    ResourcePermission
    AMS > Dedicated ServerCreate, Read, Update, Delete
    IAM > UsersRead
    Session > Game SessionCreate, Read
    Statistics > User’s Statistics ValueCreate, Read, Update

  6. Continue をクリックします。Save your client secret ウィンドウが表示されます。Copy secret をクリックし、シークレットを安全な場所に保存します。次に、I have copied and stored this client secret securely にチェックを入れ、Create をクリックして IAM クライアントを作成します。

    warning

    Secret は IAM クライアントを作成した後に再表示されません。Create をクリックする前に、必ずコピーして保存してください。

    Copy secret ボタンがある Save your client secret ウィンドウを示す画像

AMS CLI IAM クライアントを作成する​

AMS コマンドラインインターフェース (CLI) IAM クライアントは、サーバーを AMS にアップロードするための権限を与える IAM クライアントです。

  1. Admin Portal にログインし、ゲームのネームスペースダッシュボードに移動します。

  2. Foundations > Identity & Access > IAM Clients に移動し、Create New をクリックします。

  3. What is this client for? ウィンドウで Build and Deploy Tool を選択し、Continue をクリックします。New IAM Client ページが表示されます。

    IAM クライアントテンプレートが表示された What is this client for ウィンドウを示す画像

  4. Basic Info および Client Settings セクションで、以下の設定を使用して新しい AMS CLI IAM クライアントを作成します。

    • Client Name: IAM クライアントの名前です。ByteWars-AMSCLI に設定します。
    • Secret: IAM クライアントのシークレットまたはパスワードです。自分のシークレットを使用することも、Generate をクリックしてランダムに生成することもできます。
    • Redirect URI: IAM クライアントの認証が成功した後にリダイレクトするために使用される URI です。Localhost を選択すると、http://127.0.0.1 に設定されます。

  5. Permissions セクションで、クライアントにこの権限があることを確認します。この権限により、AMS CLI を使用してサーバーイメージを AMS にアップロードできます。

    ResourcePermission
    AMS > Dedicated Server ToolkitCreate, Read, Update

  6. Continue をクリックします。Save your client secret ウィンドウが表示されます。Copy secret をクリックし、シークレットを安全な場所に保存します。次に、I have copied and stored this client secret securely にチェックを入れ、Create をクリックして IAM クライアントを作成します。

    warning

    Secret は IAM クライアントを作成した後に再表示されません。Create をクリックする前に、必ずコピーして保存してください。

    Copy secret ボタンがある Save your client secret ウィンドウを示す画像

Server SDK を設定する​

Admin Portal でサーバー IAM クライアントを設定したら、ゲームプロジェクト内で Server SDK を設定する必要があります。このセクションでは、ゲームサーバーが AMS と通信できるように認証されるよう、Server SDK の設定方法を説明します。

  1. Byte Wars Unreal プロジェクトディレクトリの Config フォルダにある DefaultEngine.ini ファイルを開きます。

  2. ファイル内で [/Script/AccelByteUe4Sdk.AccelByteServerSettings] セクションを見つけ、サーバー IAM クライアントを作成するセクション のステップ3で作成したサーバー IAM クライアント情報で Client ID と Client Secret を置き換えます。次に、bManualRegisterServer と bServerUseAMS のブール値を true に切り替え、[Core.Log] の下にある一部のログカテゴリの詳細レベルを verbose に上げます。また、ゲームのネームスペースと AGS 環境に基づいて、他のプレースホルダー値も置き換えます。


    [/Script/AccelByteUe4Sdk.AccelByteServerSettings]
    ClientId=<server_iam_client_id>
    ClientSecret=<server_iam_client_secret>
    Namespace=<game_namespace_id>
    PublisherNamespace=
    RedirectURI="http://127.0.0.1"
    BaseUrl="https://<game_namespace_id>.prod.gamingservices.accelbyte.io"

    [OnlineSubsystemAccelByte]
    bManualRegisterServer=True

    [/Script/AccelByteUe4Sdk.AccelByteSettings]
    bServerUseAMS=True

    ; ByteWars tutorial module specific
    [/ByteWars/TutorialModule.DSEssentials]
    bServerUseAMS=true

    [Core.Log]
    LogAccelByte=Log
    LogAccelByteOSS=Verbose
    LogAccelByteAMS=Verbose
    LogAccelByteDSHub=Verbose
    備考
    • ClientId はランダムに生成され、サーバー IAM クライアントを一意に識別するために使用されます。
    • ClientSecret はサーバー IAM クライアントのシークレット (パスワード) です。
    • Namespace はゲームのネームスペース ID です。
    • RedirectURI は、サーバー認証が完了した後にゲームサーバーをリダイレクトする URI です。デフォルト値は http://127.0.0.1 です。
    • BaseUrl は、ゲームのネームスペース ID と Admin Portal 環境を組み合わせて作られるベース URL です。
    • bManualRegisterServer は、専用サーバーがプレイヤーを迎える準備ができたことを AMS に手動で伝えられるようにするフラグです。これは、サーバーがまだ初期化状態 (アセットの読み込み、クラウドセーブ設定の取得など) にあるにもかかわらず、プレイヤーがサーバーに接続しようとする問題を避けるためのものです。
    • bServerUseAMS は、ゲームクライアントが AGS Game SDK を使用して利用可能な AMS の場所を取得するためのフラグです。
    ヒント

    • ゲームのネームスペース ID を確認するには、Admin Portal に移動し、ゲームのネームスペースが一覧表示されている Namespace ページに移動します。次に、GAMES セクションの下でゲームのネームスペースを見つけ、gear アイコンをクリックします。新しいページで Namespace ID プロパティを見つけると、そこでゲームのネームスペース ID の値を確認できます。

    • 同様に、パブリッシャーのネームスペース ID を確認するには、Admin Portal に移動し、ゲームのネームスペースが一覧表示されている Namespace ページに移動します。次に、PUBLISHER セクションの下でパブリッシャーのネームスペースを見つけ、gear アイコンをクリックします。新しいページで Namespace ID プロパティを見つけると、そこでパブリッシャーのネームスペース ID の値を確認できます。

  3. DefaultEngine.ini ファイルを保存し、Byte Wars プロジェクトを再ビルドします。

に最終更新
On this page