文章 Shengzhi Wu · 十月 28 13m read

🏆 比赛投票进行中(截止美东时间 11 月 15 日)。如果这篇文章对你有用,欢迎在 Open Exchange 上给 PaymentGuard AI 投一票——在列表里找到 PaymentGuard AI 点 Vote 即可。

在线体验:http://43.139.159.100:8082/paymentguard/

——仪表盘、REST API 与背后的互操作生产全程在线,灰色地带决策由 DeepSeek 实时作出。

本文是英文参赛文章的中文版。源码:github.com/Dylan5237/payment-guard-ai。

以下是正文:


支付授权,本质上是个决策问题。

大多数支付没什么可纠结的:老客户、熟悉的金额、常用的设备,几条确定性规则微秒级就能放行或拦下。真正难的是中间那片灰色地带——新设备、不常见的国家、比平时高出一截的金额、KYC 还没过审的客户。人工分析师的时间基本都耗在这里,而这恰恰是大模型 Agent 能帮上忙的地方——前提是它手里有真工具,查得到真数据。

PaymentGuard AI 做的事就这么直接:把一个真实的 IRIS AI Hub Agent(%AI.Agent)当成一个业务操作,塞进一条普通的互操作生产里。

0
1 34
InterSystems开发者社区
与开发者和专家交流,提出问题、寻找答案,并分享有关 InterSystems 技术、产品和解决方案的知识。 了解更多
29,026 名开发者,社区仍在不断壮大
文章 pan John · 十月 28 16m read

为什么同一个人有两条记录,名字却不同?当相似的记录包含相互冲突的标识符时,系统应如何处理?当关键信息缺失时,系统应给出建议,还是应向来源方索取更多证据?

这些问题促使我开发了“患者身份冲突审查助手”。我希望在互操作性工作流中嵌入一个人工智能代理,供人工审查并可随时暂停。该代理负责收集证据并推荐处理方案;而人工审查员则负责授权记录之间的关联。

该应用程序使用了InterSystems IRIS Community AI Hub EAP 版本 154 中的原生 ObjectScript SDK。本文描述的是 pi-review1.1.0版本(提交编号 ab53930)。 所有案例和源数据均为合成数据,与任何医院均无关联。模型使用情况来自保存的实时呼叫记录。

项目链接:GitHub 代码库·Open Exchange 应用程序 (1.1.0)·带版本号的安装指南。下文所述的实现基于已固定的 1.1.0 源代码。

从一个缺失数据案例开始

合成案例 c6 最初缺少身份标识符和出生日期。一名操作员明确启动了调查。代理读取了该案例,验证了其来源,检索了治理规则,并返回了 NEEDS_DATA。随后,生产环境通过原生 MCP 请求了数据丰富处理。

当操作员获取数据丰富结果时,服务器在更新案例前检查了收据、来源范围和版本。随后,操作员显式地启动了另一项调查

0
1 28
文章 Teresa Gonxhe · 十一月 11 5m read

这是我关于 SynapseHealer 的第二篇文章,该作品是我参加 InterSystems 编程大赛“互操作性工作流中的 AI 代理”的参赛作品。 第一篇文章介绍了整体思路:将死信队列转变为一个能够修复损坏消息的处理管道。本文则探讨了我不得不反复推敲的部分,即当代理不应独自做出决策时该如何处理。

Open Exchange:https://openexchange.intersystems.com/package/SynapseHealerGitHub:https://github.com/Josephjbassey/synapse-healer

三种结果,而非两种

每条进入生产环境的被拒绝消息最终都会落入以下三个位置之一:

  • AUTO_HEAL:修复操作与已知的运行手册匹配,通过了验证,且风险较低。 ResubmitDeliveryOp 将其转发。
  • QUARANTINE:有效载荷已损坏或看起来危险(脚本标签、SQL 片段)。QuarantineVaultOp 将其隔离。
  • HUMAN_WORKFLOW:修复方案看似合理,但我不希望由软件来做最终决定。例如 1985-02-31 这种不合理的出生日期就是典型的案例。代理可以提出修复建议,但猜测患者的真实生日并非其职责所在。

负责做出该决定。在实时模式下,它会咨询一位 (Synapse.Agent.DeadLetterHealerAgent

0
0 7
文章 Nicky Zhu · 十一月 10 13m read

IRIS Production 可以成功生成、编译并启动,但集成仍可能出错:映射可能产生错误值;消息完成不一定代表预期数据已正确落地;组件也可能因为许可调度而存在于 Production 中却处于停用状态。

承接上一篇《从组件拓扑到 IRIS Production:生成、编译与启动》,作为主线系列的收尾篇,本文讨论生成之后如何解读验证证据、平台如何响应检查结果,以及管道如何在长期运行中保持可管理。本文不再逐步讲解常规消息处理过程。

1. “已生成”不等于“能正常工作”

我们经常把几个不同的问题混为一谈:

  • 拓扑中是否包含管道所需的组件和关系?
  • IRIS 是否加载并编译了 Production 定义?
  • Production 是否正在运行,这条管道的组件是否启用?
  • 相关消息是否正常流转,没有运行错误?
  • 目标端是否出现预期结果,而且值正确?

每个问题都需要各自的证据。某一层的检查通过固然有用,却不能替代下一层的检查。编译成功无法证明映射在业务语义上正确;Production 正在运行无法证明源端已经产生消息;消息已完成也无法证明每个目标值都正确。

验证证据是分层的:每项检查回答不同的问题

图 1:证据从定义有效性逐渐深入到目标数据观察;任何单一层都不足以证明端到端正确。

2. 验证不是一个绿灯,而是一组检查

生成链路会汇总一份事实验证报告。根据管道类型和可用证据,报告可能包含:

  1. 拓扑:预期的组件类型与关系是否存在?
0
0 12
文章 Shengzhi Wu · 十一月 9 10m read

PaymentGuard 的仪表盘如何逐跳还原一次 AI 决策,以及如何把同样的视图加到另一个 IRIS 生产里。

在线演示:http://43.139.159.100:8082/paymentguard/ 源码:github.com/Dylan5237/payment-guard-ai 上一篇:PaymentGuard AI:让 AI Hub Agent 在 IRIS 互操作生产里管支付风控

以下是正文:


问题:决策很快,过程是黑盒

Agent 两秒内就能给出支付决策。真正难回答的是这两秒里发生了什么。

生产里走了哪些消息?Agent 看到了什么上下文?调了哪些工具、拿回了什么?最后一步是谁批的?模型花了多少 token?

对于一笔可能拦掉客户支付、也可能放过欺诈的决策,"模型说可以"不构成审计记录。PaymentGuard 的仪表盘用一个回放面板回答这些问题:选中一笔决策,真实的生产链路按毫秒逐跳播放;下方再展开 Agent 的推理链,一条消息一条消息地看。

面板里没有编造的内容。每一跳都是 Ens.MessageHeader 的一行,每一步推理都来自持久化的 %AI.Agent.Session。仪表盘只是把 IRIS 已经记录的数据拼成一个视图。

这篇文章讲它是怎么实现的,包括最花时间的几个细节,最后给一份可以套用到其他 IRIS 生产上的清单。

PaymentGuard AI 的 Flow 回放面板:任务队列、按生产拓扑逐跳回放的真实 Ens.MessageHeader 链路(含 Human Review 工作流节点),以及 Agent 推理链

0
0 10
公告 Claire Zheng · 十一月 9

Hi 大家好!

InterSystems技术分享线上课第五期来啦!这期课程我们将聚焦“基于JSON的通用SQL组件”这一主题。

👉点击此处报名参加培训👈

以下场景,你是否熟悉?

  • 需要定时从HIS或其他业务数据库中抽取数据,不同场景往往需要进行相应的开发和配置。
  • 外部系统传入不同的查询条件,需要执行不同的SQL,接口越来越多,开发和维护工作也随之增加。
  • 面对不同的数据源和业务需求,基础的数据交互逻辑经常需要重复处理。
  • SQL查询结果已经返回,但转成JSON后,如何进一步用于业务流程和数据转换?

数据交互是系统集成中的常见需求。面对定时取数、动态查询、数据转换等不同场景,如何充分利用通用组件,减少重复开发?

这是一期聚焦基于JSON的通用SQL组件的实战分享,适用于医院信息平台数据同步、业务系统取数接口和通用查询等场景。

0
0 13
公告 Claire Zheng · 十一月 9

Hi 开发者们,

投票时间到了!请浏览参赛作品,并在“InterSystems编程大赛:互操作性工作流中的 AI Agent”中投出您的一票:

🔥为您最喜爱的应用投票🔥


投票时间:2026年11月9日 - 11月15日 (美国东部时间)

如何投票?详情如下。

0
0 12
文章 cheng yu · 十一月 6 19m read

我每天都在使用嵌入式 Python,至今已有两年多了。 也许现在是时候分享一下这段经历的感想了。

为什么要写这篇心得?因为,我想,我和这里的大多数人一样,都是一名ObjectScript开发者,而且我认为这些心得能给社区带来帮助,让大家更好地了解在IRIS中选择嵌入式Python进行开发所涉及的利弊,同时也避免一些陷阱。

image

引言

我自2010年起从事开发工作,自2013年起开始使用ObjectScript。

0
0 14
文章 cheng yu · 十一月 6 17m read

引言

如今,像Claude、GitHub Copilot和Cursor这样的编码助手已经彻底改变了开发者编写代码的方式。 然而,这些工具因与开发人员日常使用的系统和数据源隔离而受到限制。这一限制可以通过模型上下文协议(MCP)来克服——这是一项开放标准,旨在以安全且标准化的方式将 AI 助手与外部数据源和工具连接起来。

在这篇综述文章中,我们将探讨 InterSystems 生态系统内 MCP 的最新发展状况。 此外,我们将探讨该开放标准如何将 AI 助手与外部数据源连接起来,并展示一个用 Python 开发且与intersystems-irispython 包集成的自定义 MCP 服务器的首个示例。

目录

目录

  • 第 1 部分:什么是模型上下文协议?
    • 1.1 起源与背景
    • 1.2 为什么 MCP 很重要
  • 第 2 部分:了解 MCP 架构
    • 2.1 客户端-主机-服务器模型
    • 2.2 传输层
    • 2.3 数据层
    • 2.4 核心原语
  • 第 3 部分:使用 Python 从零开始构建 MCP 服务器
    • 3.1 使用 uv 创建新的 Python 包
    • 3.2 MCP 服务器的基本结构
    • 3.3 实现核心原语
  • 第 4 部分:将 MCP 与 AI 开发工具结合使用
    • 4.1 配置 MCP 服务器
  • 第 5 部分:使用 uv 和 uvx 分发和运行 MCP 服务器
    • 5.1 本地克隆(开发模式)
    • 5.2 GitHub 仓库
    • 5.3 PyPI
      • 5.3.
0
0 25
文章 cheng yu · 十一月 6 8m read

https://media.giphy.com/media/Nxu57gIbNuYOQ/giphy.gif

别急,别急,我可不是在鼓吹那种科幻片里常见的“反机器战争”,为了阻止奥创或天网统治世界。 还没到那一步,还没到那一步 🤔

我邀请大家通过使用 ObjectScript 并嵌入 Python 来制作一款非常简单的游戏,以此向机器发起挑战。

我必须说,InterSystems IRIS 上的“嵌入式 Python”功能让我超级兴奋,它为创建精彩的应用打开了无数可能性,简直令人难以置信。

让我们来制作一个井字棋游戏吧,规则非常简单,我相信大家都知道怎么玩。

在孩子们还没有手机或平板电脑的年代,正是这个游戏让我在童年时期与家人长途驾车旅行时免于无聊——没有什么比在模糊的车窗玻璃上挑战兄弟姐妹来几局更让人乐在其中的了。

所以,系好安全带,我们开始吧!

规则

如前所述,规则非常简单:

  • 每局仅限2名玩家
  • 在3×3的网格上轮流下棋
  • 人类玩家始终代表字母X,电脑代表字母O
  • 玩家只能将字母填入空格中
  • 最先在水平、垂直或对角线上连成3个相同字母的一方获胜
  • 当9个空格全部被填满时,即为平局,比赛结束

所有机制和规则都将用ObjectScript编写,而电脑玩家的机制将用Python编写。

让我们动手实践吧

我们将通过一个全局变量来控制棋盘,其中每一行对应一个节点,每一列对应一枚棋子。

0
0 11
文章 cheng yu · 十一月 6 2m read

与图片中提到的电影(对于不了解的人来说,就是1999年的《黑客帝国》)不同,在动态SQL和嵌入式SQL之间做出选择,并非在现实与幻想之间抉择,但这仍然是一个需要做出的决定。下面,我将尝试帮助您更轻松地做出选择。

如果您的需求是客户端与应用程序(进而与数据库)之间的交互,那么动态 SQL 可能更合适,因为它能非常轻松地“适应”这些查询变化。然而,这种动态性是有代价的:每次新的查询都会重新构建,这可能会导致更高的执行成本。下面是一个简单的 Python 代码片段示例。

0
0 9
文章 cheng yu · 十一月 6 6m read

引言

REST API(表征状态转移)是一种接口,它允许不同的应用程序通过HTTP协议,利用GET、POST、PUT和DELETE等标准操作进行相互通信。REST API在软件开发中被广泛应用,用于提供可供其他应用程序访问的服务,从而实现不同系统之间的集成。

然而,为了确保 API 易于理解和使用,完善的文档至关重要。这就是 OpenAPI 发挥作用的地方。

OpenAPI 是一种用于描述 RESTful API 的标准。它允许以结构化的方式定义 API 的功能,包括指定可用的端点、接受和返回的数据类型、必需的参数以及预期的响应。 所有这些信息都汇总在一个规范文件中(通常扩展名为 .yaml 或 .json),自动化工具可以解析该文件以生成代码、文档等内容。

OpenAPI 规范旨在同时满足机器和人类的可读性,从而以标准化方式实现 RESTful Web 服务的描述、生成、使用和可视化。因此,OpenAPI 文档代表了对 API 的正式描述,既有助于需要使用该API 的开发者,也便于相关工具利用它来自动化各种流程。

定义规范文件有什么用处?

采用 OpenAPI 来记录 API 具有以下几个好处:

  • 清晰度:它提供了详细且结构化的文档,使开发人员能够快速了解如何与 API 交互、应发送哪些请求以及响应中会包含哪些数据。
  • 自动化:文档可从代码中自动生成,并能随着 API 的任何变更而保持最新。
0
0 12
文章 cheng yu · 十一月 6 6m read

Prettier 适用于 ObjectScript

如果您在 JavaScript 或 TypeScript 代码中使用Prettier,现在也可以将其用于 ObjectScript 了。prettier-plugin-objectscript是一个 Prettier 插件,可对类(.cls)、例程(.mac, .int)以及包含文件()。

前后对比

该插件使用tree-sitter-objectscript 的语法规则、用于类的 UDL 语法以及用于例程和包含文件的例程语法来解析文件,并通过 Prettier 3 进行格式化输出。语法规则的选用依据文件扩展名、命令行参数以及 VS Code 中的设置。以以下类为例:

Class Demo.Greeter Extends %RegisteredObject {
Property Name As %String [Required];

/// Returns a greeting for the given name.
ClassMethod Greet(name As %String="world",times As %Integer=1) As %String [ Private ]
{
 s result=""
 f i=1:1:times {
 s result=result_"Hello, "_name_"! "
 }
 q:name="" "nobody"
 i times>1 { w "Greeted ",times," times",! }
 q result
}
}
0
0 16
问题 pan John · 十一月 6

你好,

我正在使用Ensemble 2018,并通过EnsLib.HL7.Operation.HTTPOperation经由 HTTPS 发送 HL7 消息。
我正在研究是否可以通过ReplyCodeActions及相关操作设置,针对不同的失败类型配置不同的重试行为。

我的需求是:

  • 对 TCP/IP 连接问题进行无限期重试。
  • 对其他错误仅在短时间内(300秒)进行重试。

我已配置如下:

ReplyCodeActions: E*无法打开 TCP/IP 套接字=R,E=RF
FailureTimeout : 300s

我原本希望诸如“无法打开 TCP/IP 套接字”之类的 TCP/IP 连接错误能无限期地继续重试,而其他错误则仅重试 300 秒。

然而,我观察到 TCP/IP 错误在配置的 FailureTimeout 时间段结束后也会停止重试。

是否有任何设置或支持的机制,可以允许特定错误(例如,由 E* ReplyCodeAction 模式标识的 TCP/IP 连接错误)无限期重试,同时对所有其他错误保持有限的 FailureTimeout 重试时间?

谢谢

1
0 11
公告 Claire Zheng · 十一月 5

InterSystems Reports 26.2 版本现已在 InterSystems 软件分发网站的“组件”部分发布。该软件以“InterSystems Reports Designer”和“InterSystems Reports Server”的名义列出,支持 macOS、Windows 和 Linux 操作系统。

此版本对通过 Reports Server 提供的 Page Studio 和 Web Studio 的焕新用户界面进行了进一步优化。(请参阅下文的许可更新。)其他增强功能包括通过 TrueType 字体扩展了字体支持,新增了 2D 条形码,以及来自我们的合作伙伴 insightsoftware 的众多修复、安全更新和其他增强功能。

InterSystems Reports 26.2 基于 Logi Report 26.2 Service Pack 2 构建。如需了解更多信息,请参阅 insightsoftware 提供的发布说明。

2026 年的许可更新

自 2026 年 1 月起,InterSystems 增加了对Page Report Studio和Web Report Studio 的访问权限。这些功能使客户能够直接在报告服务器上执行更多报告编辑操作,从而减少了许多报告设计任务对安装 Report Designer 的需求。

0
0 11
文章 pan John · 十一月 5 9m read

《Readback》是我参加 InterSystems 编程大赛*“互操作性工作流中的 AI 代理*”主题的参赛作品。 一个 InterSystems AI Hub 代理在 IRIS for Health 互操作性生产环境中对实验室结果进行分级处理。它可以将结果升级为“危急”级别,但绝不会将规则已判定为“危急”的结果降级,且在有人正确复核该数值之前,系统不会向任何人发送“危急”结果的通知。

通过构建该代理,我总结出的核心经验是:**规则保障安全,而代理负责解释。**我对此进行了测试,相关数据如下。

问题

一项关键的实验室检测结果——例如钾离子浓度为6.9 mmol/L,或血红蛋白在一天内下降了4 g/dL——如果相关人员未能获知并复述该结果,那么这些数据便毫无用处。以下两个环节的失误至关重要:

  • **遗漏:**危急结果被误报为正常。
  • **开环:**通知已发出,但无人确认。
0
0 13
文章 pan John · 十一月 5 5m read

Hugging Face 提供了一个庞大的数据集集合,涵盖自然语言处理、分类、问答以及其他机器学习任务。要在 InterSystems IRIS 中使用这些数据集之一,开发人员通常需要下载该数据集,将其字段映射到 SQL 数据类型,创建表,并加载数据行。

iris-hf-import简化了这一流程。它允许您通过单个 ObjectScript 调用,将 Hugging Face 数据集导入到 IRIS SQL 表中。

该项目实现了Ideas Portal 中的 DPI-I-543 提案:将 Hugging Face 数据集加载到 IRIS 中,并为社区赏金计划的第三轮而创建。

导入数据集

安装包后,打开 IRIS 终端并运行:

write ##class(dc.hfloader.Loader).Load("hitorilabs/iris", "train")

该命令将加载数据集 hitorilabs/iris 的 train 分割集,创建目标表,并插入相关行。

在我的测试环境中,该调用返回了如下结果:

{
  "status": "success",
  "error": "",
  "dataset": "hitorilabs/iris",
  "config": "default",
  "split": "train",
  "table": "HFData.iris",
  "rowsWritten": 150,
  "columns": 5
}
0
0 11
文章 cheng yu · 十一月 5 10m read

人工智能代理即使出错,依然可能很有用

回复丢失了,但变更依然生效。我觉得我以前遇到过这种情况。

一个管理请求可以成功到达 InterSystems IRIS,修改配置,但在返回途中丢失了响应。操作员看到一条错误提示,但配置变更实际上已经生效。如果软件将无响应视为失败并重新发送请求,那么自动化反而会引发下一起故障事件。

这一切始于“请求超时。IRIS 是否已更改?”。首要任务是让不确定性保持可见,并防止因回复丢失而导致重复操作。现在,我们要求代理协助调查这种不确定性,同时仍坚持对证据的相同要求。

在《让创造力引领》一文中 让执行可追溯》一文中,我曾探讨如何在给予人员和代理创新空间的同时,确保最终工作结果能经得起证据检验。在那一阶段,Battery 已具备合成演示环境和经过测试的实时只读连接。下一步是进行真实的配置变更,通过原生 AI Hub 进行审查,并找出我们的信心超前于实际实现的环节。

这就是接下来的这一步。代理出错了,我们的代码也出错了。但我们继续前行。

这正是我希望Armada Battery去面对的问题。我打算通过让机器对其行为负责来取得成功。这当然不是什么特殊的设计难题,但很少有人会将此视为一项耀眼的成就。这是一个值得坚守的真理:怀疑并非弱点。批判性的眼光比盲目的崇拜更有价值。

那个比响应更持久的变更

我们的联机测试使用了 IRIS AI Hub EAP 109 版的一次性安装环境。

0
0 19
文章 pan John · 十一月 5 5m read

大多数 IRIS 开发人员每天都在使用 $LISTBUILD —— 往往自己都浑然不觉。

它不仅仅是一个用于构建列表的便捷函数,更是数据库引擎内部用于存储行数据、全局值以及许多中间结构的默认格式。

尽管如此,关于 $LISTBUILD 值的实际二进制表示形式却鲜少被提及。大多数开发者仅依赖其行为表现,却从未探究过数据究竟是如何存储的。

本文严格聚焦于**$LISTBUILD 值的** 二进制布局 ,并基于通过 zzdump 进行的直接检查。


元素结构

一个 值是由一系列元素组成的序列。每个元素的编码形式如下:

[length][type][payload]

对于较小的元素:

  • length 占用 1 字节,并包含该元素的全部内容
  • type 表示 1 字节
  • payload 长度可变

示例:


字节序

更新:感谢 @Steven Hobbs

本文中的所有示例均采用小端字节序——这绝非偶然。

尽管 IRIS 内部同时支持小端和大数据字节序平台,但 对所有二进制有效载荷都采用统一的小端编码。

这适用于:

  • 整数值
  • 十进制尾数
  • 浮点数值 (08, 09)
  • UTF-16 字符串(UTF-16LE)

例如:

0
0 14
文章 Lilian Huang · 十一月 5 13m read

大家好,社区的朋友们!

在本系列的第一部分中,我们使用 HL7 消息类型构建了一个生产环境,并创建了一个 BPL 业务流程,该流程会在将传入的 HL7 消息传递给路由引擎之前,在消息中添加 %DynamicObject 进行丰富。 如果您尚未阅读第 1 部分,请先从那里开始。该部分全面介绍了生产环境的设置、上下文属性以及“构建动态对象代码”活动。

本文将重点探讨在生产环境中开始使用 %DynamicObject 之后会发生什么。 有七个具体的属性访问陷阱,每个开发人员迟早都会遇到。它们都有一个令人沮丧的共同特征:既没有错误,事件日志中也没有警告,只是出现了一个空值,导致您的路由规则转而执行默认操作,却完全不知道原因。

为了解决这个问题,我们在第一部分中的同一 Demo.HL7Router BPL 中添加了第二个“代码”活动。随后,我们通过可运行的代码演示了这七个陷阱,并在事件日志和可视化跟踪中验证了结果。


简而言之

  • 这七个常见的 %DynamicObject 陷阱都会产生相同的症状:值为空,无错误,无警告。
  • 属性名中包含下划线、大小写错误以及嵌套对象访问是前三大常见问题;针对所有这些问题,请使用 %Get()。
  • 使用 %IsDefined() 检查属性是否存在,使用 %GetIterator() 遍历属性,使用 %GetTypeOf() 区分 null 和空字符串。
0
0 9
文章 cheng yu · 十一月 4 2m read

……你并不孤单。 

有帮助可寻。

我花了一段时间才弄明白这一点,我想可能还有其他人也在为此苦恼。 我仔细研究了所有关于 Entra 的资料,试图设置一个客户端凭据工作流,以便通过 Microsoft 365 账户发送电子邮件。虽然我成功获取了令牌,但始终无法使用 %Net.SMTP 类通过 SMTP 服务器进行身份验证。解决这个问题主要涉及两个方面。

首先,身份验证器的访问令牌不能仅仅是访问令牌本身。它必须采用以下格式:

set smtp.authenticator.AccessToken = "user="_emailaddress_$C(1)_"auth=Bearer "_token_$C(1,1)

其中 emailaddress 是您用于发送邮件的邮箱地址,token 是从服务器获取的 OAuth 令牌。

其次,默认的 %Net.SASL.XOAUTH2 机制的行为方式与 SMTP 服务器所期望的不一致。 具体来说,它不会向服务器发送初始响应就直接开始身份验证,但服务器期望立即收到该访问令牌。为解决此问题,您需要创建一个继承自 %Net.SASL.XOAUTH2 的类,并重写一个简单的方法:

Class User.MSOAUTH2 Extends %Net.SASL.XOAUTH2
{

/// Start authentication based on UserName and AccessToken using the XOAUTH2 SASL mechanism.
Method Start(ByRef response As %String) As %Boolean
{
 if (..AccessToken="") quit 0
 set response=..AccessToken		;in the original class, no response is sent here
 set ..state=1
 quit 1
}

}
0
0 12
文章 cheng yu · 十一月 4 8m read

这是两篇系列文章中的第二篇,我将带您逐步了解:

  • 第一部分——简介与快速导览(上一篇文章)
    • 这是什么?
    • 部署 InterSystems IRIS Cloud Document
    • 通过服务用户界面快速浏览该服务
  • 第二部分——示例(基于 Docker 的)Java 应用程序(本文)
    • 获取连接详细信息和 TLS 证书
    • 审阅一个简单的 Java 示例,该示例用于创建集合、插入文档并查询文档
    • 配置并运行 Java(Docker 化)端到端示例

如前所述,我们的目标是为您提供流畅的“首次运行”体验。

0
0 11
文章 pan John · 十一月 4 7m read

Supabase 是一款基于 Postgres 的流行后端即服务(BaaS)平台。它为您的数据表提供了 API、身份验证、Studio 以及 Edge Functions 功能。然而,大量有价值的数据存储在InterSystems IRIS中, 且不会迁移。 本文将介绍iris-supabase-fdw,这是我针对社区奖励计划*“从创意到应用”(第三轮)*中Ideas Portal 创意“为 Supabase 添加 InterSystems 封装层”(DPI-I-663)所做的实现。 它使 IRIS 表在 Supabase 中以普通 Postgres 表的形式呈现,因此您可以对其进行查询、连接和 更新操作。

select p.name, a.startsat, a.doctor
from iris.appointment a
join iris.patient p on p.id = a.patient
where p.city = 'Roma' and a.status = 'scheduled';

iris.appointment 和 iris.patient 是 IRIS 表。数据绝不会被复制。

0
0 12
文章 pan John · 十一月 4 7m read

某交易伙伴在凌晨2点更改了订单的日期格式。到了早上,你收到了五十条警报,每条对应一笔失败的订单。而你真正想要的只是一条通知:哪里出了问题、原因是什么,以及如何解决。

这正是我开发 OcuTalon 的初衷。 OcuTalon 是一款在 InterSystems IRIS 环境中作为互操作性生产环境运行的个人助理。它会监控您的生产环境,在出现需要您处理的问题时及时通知您,并提出待您确认的修复方案。其代理程序是 IRIS AI Hub 代理,相关工作记录会显示在 Visual Trace 中——这正是您目前用于管理数据流的工具。

the OcuTalon page on the online demo, with the incident card for 50 failed orders and the Simulated phone showing the same approval request

无需安装,两分钟即可体验

访问demo.ocutalon.com。登录信息显示在启动画面上。该演示运行的是实时模型 Claude Haiku 5.5:您所看到的并非录屏内容。演示中的 Visual Trace 处于共享状态,因此请勿输入任何个人信息。

页面顶部的演示指南包含五个步骤:观看、提醒、中断数据流、批准和打开跟踪记录。

1. 监控。点击“发送”,指南会以通俗语言向 OcuTalon 发出指令:“监控‘订单’生产流程,仅在需要我介入时通知我。”‘订单’是一个由模拟合作伙伴提供数据的小型演示生产环境。步骤 2(提醒)为可选操作。

2. 中断数据流。点击“中断数据流”。合作伙伴将以新的日期格式发送 50 份订单,这些订单会在“订单”生产环境中真实地失败。

0
0 17
文章 Murilo Przybyloviecz · 十一月 4 7m read
安全往往要拖到应用快要上线时才被考虑。对初学者来说,这种推迟会让身份验证、角色、资源和审计看起来像是互不相关的管理任务。更好的做法是,在一个小巧且可复现的示例中把它们一起引入。

我仍然是 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
0
0 18