跳轉到主要內容
透過這項新功能,遊戲開發人員可以在遊戲伺服器上安全地上傳、列出、更新及使用秘密,例如檢測金鑰和秘密金鑰。

如何使用秘密管理功能

若要有效地管理和使用秘密,建議的工作流程包括:
  1. 新增秘密 (此步驟可針對多個秘密重複執行)
  2. 建立新組建時依名稱參考秘密
  3. 從遊戲伺服器存取秘密
  4. 視需要更新秘密

新增秘密

可以透過 UploadSecret API 新增秘密。 此 API 可將新的秘密上傳至服務,或在 ForceUpdate 參數設定為 true 時更新現有的秘密。

部署秘密

若要在新建立的 VM 中部署秘密,請使用 CreateBuild API 中的 GameSecretReferences 參數,將秘密納入組建 (適用於容器型和處理序型部署)。
組建建立後,就無法再新增秘密;不過,更新現有的秘密可讓新的 VM 使用其更新後的值 (現有 VM 將保留原始值)。
以下是如何參考秘密的範例:

存取秘密

新增秘密並在新組建中參考後,遊戲伺服器 (無論是容器型還是處理序型) 都可以透過每部遊戲伺服器內的環境變數存取這些秘密值。 環境變數的命名慣例為:

刪除秘密

若要移除舊的秘密,請使用 DeleteSecret DeleteSecret API。 嘗試刪除秘密之前,請確定沒有任何組建使用該秘密,否則刪除將不會成功。

在 VM 啟動指令碼中使用秘密

VM 啟動指令碼可以透過參考所述的環境變數來使用秘密值。例如,這可讓您在啟動任何遊戲伺服器之前使用遙測金鑰或其他必要的值。

另請參閱

最後修改於 2026年10月8日