本文介绍如何在 InterSystems IRIS 中通过继承 EnsLib.HTTP.GenericOperation（或 EnsLib.REST.GenericOperation）实现 OAuth2.0 支持，包括 OAuth2.0 Client 配置、Access Token 自动获取与 Header 注入，适用于各类第三方 REST API 集成场景。

在企业集成项目中，我们经常需要通过 REST API 对接第三方平台，例如 CRM、支付系统、云服务和 Open API 网关。

这些接口大多数采用 OAuth 2.0 作为授权机制。

虽然 InterSystems IRIS 提供了功能强大的通用 HTTP / REST 业务操作类：

• EnsLib.HTTP.GenericOperation
• EnsLib.REST.GenericOperation

但目前它们不直接支持 OAuth2.0 Access Token 自动注入。

本文将介绍一种常见且推荐的实现方式：

通过继承 GenericOperation类，自定义一个支持 OAuth2.0 的通用业务操作类（Business Operation）

实现以下能力：

• 自动检查令牌(Token)是否有效
• 自动获访问令牌(Access Token)
• 自动注入授权头(Authorization Header)
• 对业务调用透明

一、先理解 OAuth2.

InterSystems 常见问题

如果您尝试从顶级节点删除在子脚本级别映射的全局变量，您将收到一个<SLMSPAN>错误，并且它不会被删除。这是因为用于子脚本级别映射全局变量的kill命令不能跨映射使用。

// Suppose subscript-mapped globals exist in different databases, as shown below:
^TEST(A*～K*) -> database A
^TEST(L*～Z*) -> database B

// Trying to kill from the top level will result in a <SLMSPAN> error.
NAMESPACE>Kill ^TEST
<SLMSPAN> <- This error is output.

要只删除当前命名空间（数据库）中的全局，请使用以下命令：

NAMESPACE>Kill ^["^^."]TEST

在子脚本级别映射的全局变量必须移动到数据库并直接删除。

要切换到数据库，请使用以下命令：

zn "^^c:\intersystems\iris\mgr\user"
or
set $namespace="^^c:\intersystems\iris\mgr\user"

使用 $System.OBJ.

InterSystems 常见问题

使用 TCP 适配器的业务主机保持连接和池大小的默认设置如下：

如果网络问题导致与业务主机的连接丢失，生产端将无法检测到这一情况，也不会接受新的连接。 在这种情况下，事件日志中不会记录任何事件。 如果将 StayConnected 设置为默认值（-1），连接将不会超时，您需要重启业务主机后才能接受新的连接。 我们建议将 StayConnected 设置为大于或等于 0 的值，以避免出现这种情况。

例如，如果将其设置为 300（秒），TCP 业务主机在 300 秒或更长时间内没有收到任何新信息，就会自动断开连接并重新连接。

对于繁忙的系统，通常会将 StayConnected（保持连接）值设为一个较小的值，如 5 秒。

本文将讨论 Microsoft Visual Studio Code IDE中包含的所有调试工具 。

内容包括

• 断点
• 观察窗口
• 调用堆栈

让我们从了解调试要求开始！

前提条件

有两个插件（扩展）可用于调试 ObjectScript：

第一个是 InterSystems ObjectScript 扩展包的一部分 。第二个是 Serenji，它是一个独立的插件，提供编辑器、文件管理器和调试功能。这两个插件都可以从插件商店安装。要激活关键功能，Serenji 需要许可证。在本文中，我们将使用 InterSystems ObjectScript 扩展包来降低学习难度。在掌握基础知识后，您可以考虑购买 Serenji 的付费许可证。

什么是 FHIR Profile?？

FHIRProfile是规则和约束的集合，用于定制和完善基础快速医疗互操作性资源 (FHIR) 资源（resource）。Profiling是一个重要的过程，它可以调整基础 FHIR 资源标准，以满足特定用例、地理区域、医疗机构或临床工作流程的独特要求。

基础 FHIR 规范为资源（如病人、观察或药物）提供了通用、灵活的定义，而Profiling则将这些通用资源转化为更精确的资源。这就确保了为特定社区或实施量身定制的数据交换的一致性和互操作性。

FHIR 旨在覆盖全球各种医疗保健场景。配置文件允许实施者在不丧失标准化优势的情况下调整这一通用平台。

Embeddedpy-bridge：嵌入式 Python 工具包

概述

嵌入式 Python改变了 InterSystems IRIS 的游戏规则，可直接在数据库中访问庞大的 Python 生态系统。但是，在 ObjectScript 和 Python 之间架起桥梁有时会让人感觉像是在两个不同的世界之间转换。

为了实现这种无缝过渡，请使用embeddedpy-bridge。

该软件包是一个以开发人员为中心的实用工具包，旨在为嵌入式 Python 提供高级 ObjectScript 封装、熟悉的语法和强大的错误处理功能。它允许开发人员使用他们已经熟悉的本地 IRIS 模式与 Python 数据结构交互。

挑战

虽然 %SYS.Python 库功能强大，但开发人员经常面临一些障碍：

1. 处理代理：使用原始代理浏览 Python 列表和字典对于 ObjectScript 来说并不 "原生"。
2. 迭代：标准 ObjectScript While 循环无法与 Python 迭代器进行本地 "对话"。
3. 命名空间管理：确保 Python 实用程序在整个系统中可用。

解决方案：embeddedpy-bridge

我的目标是创建一个 "桥梁"，让 Python 感觉像是 ObjectScript 中的一等公民。

主要功能

• py 前缀约定：%ZPython.

InterSystems IRIS 的架构将数据的逻辑组织（命名空间）与其物理存储位置（数据库）分开。理解这种分离以及命名空间和数据库之间的区别对于有效的数据管理、安全性，尤其是高性能数据共享至关重要。

在本文中，我将讨论这些基础组件，并提供利用全局映射跨不同逻辑环境共享本地数据结构（全局）的实用指南。

数据库：物理现实

数据库代表了数据存储在磁盘上的物理现实。首先，它是文件系统中名为 IRIS.dat 的文件（例如，<安装文件夹>\mgr\user\IRIS.DAT ）。该文件的最大容量为 32TB。它是所有实际数据和代码的容器。数据库由 IRIS 内核管理，它在物理文件级别处理缓存、日志和事务日志。

安装 InterSystems IRIS DBMS 时，会自动安装以下数据库：

有时，根据预先定义的资源 "列表（List）"限制 FHIR 搜索会更方便、更高效、更安全。

自 2025.1 版起，我们的 FHIR 服务器支持多个与列表相关的功能。

我将在此重点介绍这些功能，并提供一些示例。

 InterSystems IRIS^® data platform, InterSystems IRIS^® for Health, and HealthShare^® Health Connect 2026.1的第三个开发者预览版已发布到 WRC 开发人员预览版网站。 容器镜像可在我们的容器注册表中找到，其标签为latest-preview。

这些开发者预览版包括从 2026.1.0 开始不再支持 Mac Intel，以及为 2026.1.0 重新添加对 Windows Server 2019 的支持。

初始文档可在以下链接中找到：

• InterSystems IRIS Data Platform 2026.1 | 文档主页
• HealthShare Health Connect 2026.1 | 文档主页

这些文档链接目前只是占位符，随着最终版本的推出和更多细节的分享，这些链接将不断更新。以下是 2026.1 文档的一些显著新增内容：

• 扩展数据库大小
• DataMove.API.Finish(Name As %String) As %Status

由于这是早期的开发者预览版，一些内容仍在开发中，我们将在功能最终完成后提供完整的文档。我们感谢您在此阶段的耐心等待和反馈！

可用性和软件包信息

该版本为所有支持的平台提供了经典安装包，如需完整列表，请参阅 "支持的平台 "文档。

在使用InterSystems 互操作性（Iris/Health Connect/Ensemble）时，配置数据通常分散在许多生产项目中：服务、流程、操作、适配器及其设置。

常见的操作或安全需求是回答以下问题：

• 哪些接口引用了文件系统路径？
• 目录、网络共享或绝对路径配置在哪里？
• 我能否在所有产品中快速审核或记录这些信息？

下面的 ObjectScript 工具正是通过将选定的配置设置导出到 CSV 文件来解决这个问题的。

该脚本

1. 循环浏览所有现有命名空间
2. 查询所有命名空间中的所有互操作性配置项(Ens_Config.Item)
3. 遍历每个项目的设置
4. 提取文件系统/URL 路径（包含 :、/ 或 \ 的值）
5. 将结果写入CSV 文件，按类别分组
6. 生成便于审计的输出，可在 Excel 中打开或与操作/安全团队共享

典型用例

当您需要时，应使用此实用程序：

• 🔍审计整个产品的文件系统使用情况
• 🛡审查安全风险（本地路径、网络共享、数据库连接）
• 📄记录迁移、升级或灾难恢复规划的配置
• 🔄比较环境（开发环境vs测试环境vs 生产环境）
• 🧹清理遗留或未使用的路径

这对使用许多接口和适配器的多个产品的大型实例尤其有用。

此外，在以前的版本中，您可以定义您的 FHIR 服务器接受通过 OAuth 2.0 发送的请求（例如，用于 FHIR 客户端上的 SMART），但在前不久发布的 v2024.3 中，有一项新功能可以更轻松地实现这一点，即OAuth FHIR 客户端快速启动（OAuth FHIR Client QuickStart）。

InterSystems API 管理器（IAM）是 InterSystems IRIS 数据平台的核心组件，提供集中式 API 管理，重点强调安全性。IAM 简化了从创建到退出的整个 API 生命周期，并提供了一个开发人员门户，便于发现和集成 API。访问控制功能允许管理员定义精确的权限，IAM 与 IRIS 数据平台无缝集成，增强了数据管理和集成能力。

IAM 的功能包括

• API 网关：集中式 API 管理和安全中心。
• API 生命周期管理：从创建到退出的完整生命周期控制。
• 安全性：身份验证、授权和数据加密。
• 监控和分析：使用监控和模式分析工具。
• 开发人员门户网站：具有文档和测试功能的 API 发现门户。
• 访问控制：对 API 访问和操作进行细粒度控制。
• 与 InterSystems IRIS 集成：与 IRIS 数据平台无缝集成。

使用案例： 本报告中的用例是身份和访问管理。

符合 OAuth 2.0 标准的身份验证和授权，使用 IAM 确保 FHIR 服务器的安全。

在本文档中，您将了解如何使用 InterSystems API Manager 通过 OAuth 2.0 确保 FHIR 服务器的安全。OAuth 2.0 是一种广泛使用的授权标准，可使应用程序访问 FHIR 服务器上受保护的资源。

您发送了一个 HTTP 请求，但得到了一个 HTTP 错误，而且是一个您意想不到的 HTML 错误页面......这是怎么回事？

具体举例来说，也许您尝试读取 FHIR 资源（例如 /Patient/123），但得到的是 404 错误页面，尽管使用其他患者 ID 时，您得到的是资源有效载荷，因此 "页面 "肯定存在......为什么会得到 404 错误页面？

大家好，现在我想继续我们之前讨论过的话题

使用 Postman 测试 InterSystems FHIR 存储库的 OAuth2.0 - 第一部分

问题1：我的client_id和client_secret是从哪里来的？

简短回答：身份验证服务器（Authentication Server）。

如果没有身份验证服务器，可按以下方法设置一个

提供主机名（主机必须支持 Https）、至少 1 种大类型（这里我们选择客户端凭证）和 SSL/TSL 配置

输入作用域（这里我们输入user/*.read和user/ *. write，这是基于 FHIR 服务器（资源服务器）支持的作用域）。万一我们遗漏了某些作用域，请检查 "允许不支持的作用域（Allow unsupported scope）"。

JWT 设置选择 RS256（这只是一个示例，您可以选择适合您架构的设置）

将生成令牌类（Generate token class）更改为%OAuth2.Server.JWT。如果需要，还可以更新命名空间。

保存（Save）设置

问题 2：如何查看身份验证服务器的 client_id 和 client_secret？

简短回答： 设置 OAuth2.0 客户端（如果没有）并创建一个客户端

以下是设置 OAuth2.0 客户端的步骤。

大家好，又是我来分享我最近的学习心得了。

最近，我正在学习如何为 InterSystems FHIR 资源库设置 OAuth2 身份验证。我发现以下文章非常好，而且很容易理解。

使用 IRIS for Health 启动 FHIR EHR 的 SMART

在 IRIS for Health 上构建 FHIR 资源库 + OAuth2 授权服务器/资源服务器配置》第 2 部分

对我来说，作为一个对 OAuth2.0 没有太多了解的用户。我认为，在了解整个 OAuth2.0 环境之前，从纯粹的用户角度来看（它是什么、我需要哪些参数、预期输出是什么），理解如何设置整个 OAuth2.0 环境是相当困难的。在这里，我们使用 Postman 作为客户端。

如果你想有一个 OAuth 的测试环境，可以试试下面的 dockers

workshop-iris-oauth2 或本文中的 docker在 IRIS for Health 上构建 FHIR 资源库 + OAuth2 授权服务器/资源服务器配置 第 1 部分

在本文中，我在本地计算机上设置了一个支持 HTTPS 的 InterSystems FHIR 资源库 。(根据我的观察，要使 InterSystems OAuth 正常工作，资源服务器必须支持 HTTPS😑😐。）

因此，让我们从简单的开始。

IPM 0.10.5 版已于 2026 年 1 月 15 日发布。新版本包含大量改进和错误修复，请务必直接从GitHub 页面或社区注册中心查看！

主要变化如下

• 重写了依赖关系解析，大大提高了性能，包括在非常复杂的情况下速度提高了 200 倍
• 跟踪 IPM 安装、加载、更新和卸载的历史日志，可使用zpm "log "查看
• 系统表达式（如${namespace} 和 $$$ 宏）现在可在 CPF 合并文件中进行评估，使初始配置更具灵活性
• 模块.xml 中的 <Invoke> 将更直观地表现为始终检查 %Status 返回值，前提是且仅当方法签名声明返回 %Status。这意味着如果没有返回任何值、返回值不是 %Status 或不是 $$$OK，就会产生错误。

以下是完整的变更列表：

已添加

• #938:为软件包命令添加了 -export-python-deps 标志
• #462:用于版本库配置的 repo 命令现在支持使用 -password-stdin 标志的密码秘密输入终端模式。
• #935:添加通用的 JFrog Artifactory tarball 资源处理器，用于将工件与软件包捆绑，并在安装时部署到最终位置。

互操作性用户界面项目从 2025.1 版继续 进行，并纳入了许多我们的客户和合作伙伴建议和观察到的项目。 我们将继续投资于反馈和更新这一重要的用户体验。在最新发布的 2025.3 版（适用于 IRIS、 IRIS for Health、 HealthConnect 和 Health Connect Cloud） 中 ， DTL 编辑器 和 生产配置 应用程序可选择
NOTE：

• 您可以在现代化和标准体验之间切换。
• 所有其他互操作性屏幕仍保留在标准用户界面中。
• 由于新的用户界面将提供新的工作流程，我们希望在这项工作继续进行的同时提供两种体验。

• 现在每个生产配置主机上都会显示池大小 数量。
• 现在可以在主机的类别字段中直接输入命名约定来创建新类别。
• 生产配置中现在支持浏览器级控制查找。
• 生产配置主机项目现在具有测试主机功能。
• 在新的 "设置面板 "中，出现了 X 取消图标以取消操作。
• 较长的类工具提示 说明根据类文档格式化。
  • 
    
    • 增强了配置项描述的显示，以尊重较长结构化描述的标记。

• 如果不在主机项目或生产的上下文中，操作项目会显示为灰色 。
• 创建主机时可自动创建路由器和角色。
• 在支持的情况下，现在可以选择更新和恢复生产。
• 现在可以 通过新的用户界面创建产品 。
• 编辑主机类别时，允许查看连接。