安全往往要拖到应用快要上线时才被考虑。对初学者来说,这种推迟会让身份验证、角色、资源和审计看起来像是互不相关的管理任务。更好的做法是,在一个小巧且可复现的示例中把它们一起引入。
我仍然是 InterSystems IRIS 的初学者,这也是我写这篇文章的主要动机之一。在学习这个平台的过程中,我希望通过亲手构建、测试和观察来理解安全,而不是只阅读各种定义。看到同一个端点从 401 Unauthorized 变为 403 Forbidden,最终变为 200 OK,让我明白了不同的安全层是如何协同工作的。我决定把这段经历记录下来,让其他初学者也能复现这个过程,并从同样的递进中学到东西。
在本文中,我在 InterSystems IRIS 中构建了一个最小化的 REST API,并用它演示三种不同的安全结果:
不带凭据的请求会收到 401 Unauthorized。
已通过身份验证但没有所需权限的用户会收到 403 Forbidden。
已通过身份验证且已获授权的用户会收到 200 OK 以及虚构的数据。
最后,我会在 IRIS 审计数据库中验证这次成功的请求。这个示例刻意保持小巧,但它用到了与大型应用相同的安全概念。
本演示返回的所有名称和记录均为虚构。该项目是一个教学示例,而不是生产环境的患者 API。
示例包含的内容
该项目使用三个 ObjectScript 类:
SecurityDemo.REST 提供 GET /security-demo/api/patients。
SecurityDemo.Installer 创建受保护的资源、角色、审计事件和 REST Web 应用。
SecurityDemo.Audit 写入安全的审计记录,不存储密码、令牌或患者数据。
授权模型使用一个名为 SecurityDemo.PatientData 的自定义资源和一个名为 SecurityDemoReader 的角色。该角色授予对该自定义资源的 READ 权限。由于这个本地示例把类存放在 USER 数据库中,该角色还被授予 %DB_USER:READ,这是加载 REST 类所必需的。
第二项权限是一个重要的设计细节。对于这个隔离的本地实验环境,这样做是可以接受的,但生产应用通常应使用专用的数据库和命名空间,这样它的数据库权限就不会覆盖无关的代码或数据。
实验环境设置
在这个实验中,我使用了本地的 InterSystems IRIS 实例和 USER 命名空间。一个小型的安装类创建了演示所需的安全元素:
SecurityDemo.PatientData 资源;
SecurityDemoReader 角色;
SecurityDemo/PatientAPI/ReadPatients 审计事件;
/security-demo/api Web 应用。
该 Web 应用使用密码身份验证,并且不启用未经身份验证的访问。这样设置的目的并不是展示一个完整的应用或安装教程,而是提供一个可控的环境,使每一种安全结果都能被清楚地观察到。
技巧 1:把身份验证和授权当作两种不同的检查
身份验证回答的是:是谁在发出请求?
授权回答的是:这个身份被允许做什么?
当我们在三种条件下调用同一个端点时,这种区别就变得清晰了。
首先,我发送了一个不带凭据的请求:
objectscript
curl.exe -i "http://localhost:52773/security-demo/api/patients"
IRIS 返回了 401 Unauthorized。
Mostrar Imagem
图 1 — InterSystems IRIS 以 HTTP 401 Unauthorized 拒绝不带凭据的请求。
这个响应发生在返回任何应用数据之前。客户端尚未建立 IRIS 可以信任的身份。
技巧 2:使用普通用户而不是管理员进行测试
在下一个测试中,我在 System Administration > Security > Users 下创建了一个已启用的账户,名为 ArticleUser。起初我没有给它分配 SecurityDemoReader。
使用管理员会让这个测试产生误导。特别是,拥有 %All 的用户持有所有权限,因此无法复现授权失败的情形。
我再次调用了该端点,并让 curl 提示输入密码,而不是把密码直接写在命令里:
objectscript
curl.exe -i --user ArticleUser "http://localhost:52773/security-demo/api/patients"
这一次身份验证成功了,但由于该用户没有所需的权限,IRIS 返回了 403 Forbidden。
Mostrar Imagem
图 2 — InterSystems IRIS 阻止了没有所需权限的已验证用户。
这种区分在排查问题时很有用:
401 通常意味着身份没有被成功建立。
403 意味着身份已知,但该操作未获授权。
技巧 3:用资源而不是用户名来保护操作
REST 类中不包含 If $Username = "ArticleUser" 这样的逻辑。把用户名硬编码进去既难以维护,也无法扩展。
相反,端点检查的是一个安全资源:
objectscript
ClassMethod Patients() As %Status
{
Set allowed = $System.Security.Check("SecurityDemo.PatientData", "READ")
Do ##class(SecurityDemo.Audit).Record(allowed)
If 'allowed {
Quit ..WriteError(403, "FORBIDDEN", "The SecurityDemoReader role is required.")
}
// Build and return fictional records.
}
用户通过角色获得权限,而应用检查的是资源,并不需要知道哪些具体用户应该被允许。这种分离使得添加或移除用户时无需修改应用代码。
在管理门户中,我把 SecurityDemoReader 分配给了 ArticleUser。然后我重复了同样的请求,并建立了一个新的已验证连接。IRIS 返回了 200 OK 和两条虚构的记录:
Mostrar Imagem
图 3 — 拥有 SecurityDemoReader 角色的用户成功访问了受保护的 REST 端点。
响应中还包含两个小而有用的防御性标头:
objectscript
Cache-Control: no-store
X-Content-Type-Options: nosniff
no-store 告诉客户端和中间节点不要保留该响应。nosniff 告诉浏览器不要重新解释所声明的内容类型。这些标头不能取代身份验证、授权或 TLS,但对于返回敏感信息的 API 来说,它们是合理的补充。
该演示还禁用了跨源处理,因为它不需要来自其他源的浏览器客户端。在没有实际需求的情况下启用 CORS 会带来不必要的暴露。
技巧 4:审计有意义的应用事件
身份验证和授权决定一个操作能否发生。审计则有助于回答事后发生了什么。
该演示定义了一个用户审计事件,其标识符如下:
objectscript
Event Source: SecurityDemo
Event Type: PatientAPI
Event Name: ReadPatients
审计辅助方法只记录用户名和授权结果:
objectscript
ClassMethod Record(allowed As %Boolean) As %Status
{
Set outcome = $Select(allowed:"Allowed", 1:"Denied")
Set eventData = "username=" _ ..SafeValue($Username, 64) _ ";outcome=" _ outcome
Set description = "Patient list access " _ outcome
Quit $System.Security.Audit("SecurityDemo", "PatientAPI", "ReadPatients", eventData, description)
}
这段代码刻意避免记录密码、授权标头、返回的记录或其他敏感内容。审计日志本身就是安全资产;收集不必要的机密信息,会让审计轨迹变成另一个风险来源。
我打开了 System Administration > Security > Auditing > View Audit Database,找到了由这次成功请求产生的事件。
Mostrar Imagem
图 4 — IRIS 审计轨迹记录了已验证的用户以及对受保护端点的成功访问。
该记录标明了 ArticleUser、PatientAPI 事件类型、ReadPatients 事件以及 Allowed 结果。这证明了受保护的操作是由一个已通过身份验证且已获授权的身份执行的。
技巧 5:如实说明演示与生产环境安全的差距
这个实验聚焦于一个狭窄的学习目标。真正的部署还需要额外的控制措施,包括:
对每一个承载凭据或敏感数据的连接使用 TLS;
适合所在组织的身份验证机制,例如 OAuth 2.0、OpenID Connect、Kerberos 或 LDAP;
专用的应用数据库和命名空间;
使用密钥管理,而不是把凭据放在源代码或脚本中;
数据库加密以及有文档记录的密钥管理流程;
审计日志的监控、保留、保护和审查;
禁用未使用的服务和应用;
定期审查用户、角色和权限;
同时针对成功访问和预期的安全失败进行测试。
最重要的一课是,安全应当是可观察、可测试的。仅仅创建一个角色并假定它有效是不够的。请分别使用无凭据、权限不足以及具备预期角色的方式发出请求。验证确切的 HTTP 结果,然后在审计轨迹中确认相应的活动。
结论
仅用一个小小的 REST 端点,这个示例就演示了 IRIS 的若干核心安全概念,而无需一个完整的应用:
身份验证拒绝匿名请求;
授权区分了已验证用户和已授权用户;
资源描述了被保护的对象;
角色把应用用户所需的权限归为一组;
编程式检查在靠近受保护操作的地方强制执行访问控制;
审计提供了有意义活动的踪迹。
对初学者来说,401 → 403 → 200 这个序列是理解这些层如何协同工作的实用方法。它还能产生可重复的证据,证明安全配置按预期运行。
构建并测试这个小项目,让我对 IRIS 安全的理解比分别学习每个概念时清晰得多。作为初学者,能够在一个实验中同时看到身份验证、授权、角色、资源和审计的运作,尤其令人受到鼓舞。我希望这份演练能为其他开发者提供一个简单的起点,并鼓励他们探索 InterSystems IRIS 中更广泛的安全功能。
官方文档
InterSystems IRIS Security
Privileges and Permissions
Securing REST Services
Managing Applications
Auditing
作者:Murilo Przybyloviecz
初学者标签汇集了面向 InterSystems 数据平台初学者的文章和问题


.png)


