Sentry 企業級數據安全解決方案 - Relay 項目配置

• 2022 年 1 月 8 日
• 筆記

內容整理自官方文檔

系列

• Sentry 企業級數據安全解決方案 - Relay 入門
• Sentry 企業級數據安全解決方案 - Relay 運行模式
• Sentry 企業級數據安全解決方案 - Relay 配置選項
• Sentry 企業級數據安全解決方案 - Relay 監控 & 指標收集

項目配置

在 static 或 proxy 模式下運行 Relay 時，您可以在文件系統上配置項目設置。
Static 項目配置位於 Relay 配置目錄的 projects 子目錄下，默認位於 .relay/projects。

託管(managed) 模式下的 Relay 僅適用於商業和企業計劃。//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 中，例如 //[email protected]/2244，key 是12345abcdb1e4c123490ecec89c1f199。

一個項目可能包含多個公鑰，但只會處理使用已啟用項目密鑰的消息。同樣，可以使用 isEnabled flag 禁用 key。

config.allowedDomains

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

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

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