秘密存儲

Roblox 為每個遊戲提供一個 秘密 存儲。秘密是敏感信息，如 API 金鑰、密碼和訪問令牌，您用來與外部服務進行身份驗證。例如，如果您想連接到第三方分析或音樂服務，您可能需要使用 API 金鑰來進行身份驗證。

您可以將 API 金鑰複製並粘貼到腳本中或將其添加到數據存儲中，但這些方法存在不必要的安全風險。更好的解決方案是使用秘密存儲，並通過一小組安全方法來訪問金鑰。

添加秘密

要查看、創建或編輯秘密，您必須是遊戲擁有者或群組擁有者。每個遊戲最多可以擁有 500 個秘密。

1. 瀏覽到 創作者儀表板。

2. 選擇您的遊戲，然後選擇 秘密 ⟩ 創建秘密。

3. 輸入名稱、秘密和適用的域名。

   • 名稱作為秘密的唯一標識符，因此我們建議使用描述性名稱。
   • 秘密的長度最多可以為 1,024 個字符。API 金鑰和訪問令牌應來自服務提供商，但如果秘密是密碼，您可能是自己創建的。
   • 您可以對域名使用有限的通配符語法，例如 * 代表任何域名（不建議）或 *.example.com 代表 example.com 的任何子域名。具體的域名更好，例如 my.example.com。

本地秘密

出於安全原因，每個遊戲的秘密存儲僅在實時伺服器或 協作測試 環境中可用。如果您在 本地遊戲測試 中嘗試訪問秘密，您將收到 Can't find secret with given key 錯誤。如果您嘗試從客戶端腳本訪問秘密，您也會收到相同的錯誤。

要為本地測試指定秘密，請轉到 Studio，然後轉到 文件 ⟩ 體驗設置 ⟩ 安全性。您可以在 本地秘密 部分創建新秘密並編輯或刪除現有秘密。

使用秘密

在遊戲中使用秘密之前，您必須在 Studio 的 文件 ⟩ 體驗設置 窗口的 安全性 部分啟用 允許 HTTP 請求。然後在伺服器腳本中調用 HttpService:GetSecret()：

local HttpService = game:GetService("HttpService")

local testSecret = HttpService:GetSecret("test_secret")

使用秘密存儲的部分吸引力在於您無法意外地打印出秘密。以下代碼輸出的是您在創建秘密時提供的名稱，而不是秘密本身：

print(testSecret) --> Secret(test_secret)

您無法直接操作字符串。相反，Secret 數據類型允許您為秘密添加前綴和後綴，以幫助形成 URL 或插入內容，如 Bearer：

local HttpService = game:GetService("HttpService")

local testSecret = HttpService:GetSecret("test_secret")

local prefix = "https://my.example.com/endpoint?apiKey="
local suffix = "&user=username"
local url = testSecret:AddPrefix(prefix)
url = url:AddSuffix(suffix)
print(url) --> https://my.example.com/endpoint?apiKey=Secret(test_secret)&user=username

在您擁有插入秘密的 URL 後，您可以使用 HttpService:RequestAsync() 等方法進行標準 HTTP 請求。當然，您也可以忽略這些方法，將秘密直接插入標頭中。