如何通过Atlassian Connect获取Bitbucket工作区用户增减事件

核心结论 #

Bitbucket Connect Webhook没有全局用户创建/删除事件（这类属于Atlassian Identity范畴），但工作区成员的添加/移除是可以通过指定事件捕获的，以下是具体配置和排查步骤：

1. 正确订阅工作区成员变动事件 #

你需要在Connect应用的descriptor中，明确订阅workspace_member:created和workspace_member:deleted事件，示例配置如下：

"modules": {
  "webhooks": [
    {
      "event": "workspace_member:created",
      "url": "/your-webhook-endpoint/member-added",
      "description": "Trigger when a user is added to the workspace"
    },
    {
      "event": "workspace_member:deleted",
      "url": "/your-webhook-endpoint/member-removed",
      "description": "Trigger when a user is removed from the workspace"
    }
  ]
}

注意事件名称必须严格匹配，Bitbucket的Webhook事件名称区分大小写。

2. 全局用户创建/删除的限制 #

Bitbucket Connect不提供全局用户账号的创建/删除事件，因为用户账号归属于Atlassian Identity系统，而非Bitbucket工作区。若需监控这类事件，需使用Atlassian Identity相关API，但这需要Organization管理员权限，且不属于Bitbucket Connect的覆盖范围。

3. 排查未收到通知的常见原因 #

• 权限检查：确保你的Connect应用已获得workspace:read或更高权限（在descriptor的scopes字段声明），否则无法接收工作区成员变动事件。
• 端点可用性：验证你的Webhook接收端点是否能正常响应请求，Bitbucket会发送初始的ping事件用于验证，可通过日志确认是否收到。
• 注册状态：登录Bitbucket工作区，进入「设置」→「Apps and integrations」→「Installed apps」，找到你的应用，确认Webhook已正确注册，且对应事件已启用。

内容的提问来源于stack exchange，提问作者melihkizmaz