Sentry 企業級資料安全解決方案 - Relay 專案配置

為少發表於2022-01-08


內容整理自官方文件

系列

專案配置

在 static 或 proxy 模式下執行 Relay 時，您可以在檔案系統上配置專案設定。
Static 專案配置位於 Relay 配置目錄的 projects 子目錄下，預設位於 .relay/projects。

託管(managed) 模式下的 Relay 僅適用於商業和企業計劃。https://sentry.io/pricing/

要配置專案，請在該位置新增名為 <PROJECT_ID>.json 的檔案：

.relay/
└── projects/
    ├── 17.json
    ├── 21.json
    └── 42.json

專案配置是一種可擴充套件格式，主要由可選欄位組成。最低配置 必須 包含以下欄位：

{
  "slug": "my-project",
  "publicKeys": [
    {
      "publicKey": "<DSN_KEY>",
      "isEnabled": true
    }
  ],
  "config": {
    "allowedDomains": ["*"]
  }
}

公鑰 (<DSN_KEY>) 是專案 DSN 的金鑰，與用於 Relay 註冊的 Relay 公鑰無關。

基本選項

slug

專案的簡稱，顯示在 Sentry 中。Relay 當前需要此值才能接受事件。

{
 "slug": "my-project"
}

disabled

專案是否被禁用。如果設定為 true，則 Relay 將丟棄傳送到此專案的所有事件。

{
 "disabled": false
}

publicKeys

已知公鑰（DSN 中的公鑰）的列表以及是否應接受使用該金鑰的事件。

{
 "publicKeys": [
   {
     "publicKey": "12345abcdb1e4c123490ecec89c1f199",
     "isEnabled": true
   }
 ]
}

您可以通過進入 Sentry > Project Settings > Client Keys (DSN) 來獲取金鑰。公鑰可以從 DSN 中提取。 在這個 DSN 中，例如 https://12345abcdb1e4c123490ecec89c1f199@o1.ingest.sentry.io/2244，key 是12345abcdb1e4c123490ecec89c1f199。

一個專案可能包含多個公鑰，但只會處理使用已啟用專案金鑰的訊息。同樣，可以使用 isEnabled flag 禁用 key。

config.allowedDomains

配置 Sentry 應接受事件的 Origin 或 Referer URL。這對應於 Sentry UI 中的 Allowed Domains 設定。

空列表拒絕所有來源。使用預設的 ["*"] 以允許所有來源。

{
 "config": {
   "allowedDomains": ["mycompany.com"]
 }
}

相關文章