Skip to main content
IP 访问列表使企业管理员可以将对 Devin 平台的访问限制为特定 IP 地址或 CIDR 网段。配置 IP 访问列表后，只有来自允许 IP 段的请求才能访问 Devin 的 API 和 Web 应用。

​
工作原理

当你配置 IP 访问列表时，Devin 会在企业级别强制执行该配置：
  • 来自不在访问列表中的 IP 的 API 请求 会被拒绝，并返回 401 Unauthorized 响应
  • Web 应用访问 将被限制为仅允许从允许的 IP 范围连接的用户
这对于需要确保 Devin 只能从企业网络、VPN 端点或其他受信任 IP 范围进行访问的企业非常有用。

​
配置 IP 访问列表

IP 访问列表通过 Enterprise API v3 进行管理。支持以下操作：

​
查看当前访问列表

获取您 Enterprise 组织当前的 IP 访问列表：
返回当前配置的允许 IP 地址段列表。

​
添加到访问列表

向现有访问列表中添加 IP 段，同时保留所有已配置的 IP 段：
请求体应为一个 JSON 对象，其中包含一个 ip_ranges 字段，该字段的值是采用 CIDR 表示法的 IP 段数组。单个 IP 地址可以通过添加 /32 后缀来指定。
新的 IP 段会合并到现有列表中，已存在的 IP 段不会重复添加。响应中会返回合并后完整的允许 IP 段列表。如果访问列表当前为空，添加 IP 段后将启用 IP 限制。

​
替换访问列表

将整个 IP 访问列表替换为一组新的 IP 段：
请求体应为一个 JSON 对象，其中包含一个 ip_ranges 字段，该字段的值是采用 CIDR 表示法的 IP 段数组。单个 IP 地址可以通过添加 /32 后缀来指定。
PUT 端点会替换整个列表。任何未包含在请求中的 IP 段都会被移除。请确保在每次更新中包含所有需要的 IP 段，或使用 POST 端点 添加 IP 段，这样不会影响现有的 IP 段。

​
清空访问列表

要移除所有 IP 限制，请清空访问列表：
当访问列表为空时，不会应用任何基于 IP 的限制。

​
权限

查看和管理 IP 访问列表需要具有 ManageIPWhitelist (“管理 IP 白名单”) 权限。此权限通常仅对企业管理员开放，也可授予自定义角色。请注意，ManageEnterpriseSettings 不授予 IP 访问列表管理权限。

​
最佳实践

  • 在启用访问列表之前，包含所有办公网络和 VPN 的出口 IP，以避免导致用户无法访问系统
  • 尽可能使用 CIDR 网段而不是单个 IP，以简化管理
  • 先使用范围更广的配置进行测试，然后根据需要逐步缩小范围
  • 在 Devin 之外保留一份记录，列出所有已配置的网段，以便在需要时恢复访问
如果你因配置错误的 IP 访问列表而不慎将自己锁在系统之外，请联系 support@cognition.ai 获取帮助。