Sentry 企业级数据安全解决方案 - Relay 项目配置

内容整理自官方文档

系列

• • 
    
• ​​Sentry 企业级数据安全解决方案 - Relay 入门​​
• ​​Sentry 企业级数据安全解决方案 - Relay 运行模式​​
• ​​Sentry 企业级数据安全解决方案 - Relay 配置选项​​
• ​​Sentry 企业级数据安全解决方案 - Relay 监控 & 指标收集​​
  • 
    

项目配置

在 ​​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://[e-mail]/2244​​​，​​key​​ 是​​12345abcdb1e4c123490ecec89c1f199​​。

一个项目可能包含多个公钥，但只会处理使用已启用项目密钥的消息。同样，可以使用 ​​isEnabled​​ ​​flag​​ 禁用 ​​key​​。

​​config.allowedDomains​​

配置 ​​Sentry​​ 应接受事件的 ​​Origin​​ 或 ​​Referer​​ URL。这对应于 ​​Sentry UI​​ 中的 ​​Allowed Domains​​ 设置。

空列表拒绝所有来源。使用默认的 ​​["*"]​​ 以允许所有来源。

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