你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 FHIR 服务中将自定义 HTTP 标头添加到审核日志

项目
10/16/2024

重要

Azure API for FHIR 将于 2026 年 9 月 30 日停用。 按照迁移策略在该日期之前转换到 Azure Health Data Services FHIR® 服务。由于 Azure API for FHIR 停用，在 2025 年 4 月 1 日开始前不会允许新的部署。 Azure Health Data Services FHIR 服务是 Azure API for FHIR 的演化版本，可让客户管理 FHIR、DICOM 和医疗技术服务，并集成到其他 Azure 服务。

在 Azure 快速医疗保健互操作性资源 (FHIR®) API 中，用户可能希望在日志中包含来自调用系统的其他信息。

例如，当通过外部系统对 API 的用户进行身份验证时，该系统会将调用转发到 FHIR API。在 FHIR API 层上，由于调用已转发，因此有关原始用户的信息会丢失。出于审核或管理目的，可能需要记录和保留此用户信息。调用系统可以在 HTTP 标头中提供用户标识、调用方位置或其他所需的信息，转发调用时会携带这些信息。

可以使用自定义标头来捕获多种类型的信息。例如：

标识或授权信息
调用方的源点
发起组织
客户端系统详细信息（电子病历、患者门户）

重要

请注意，自定义标头中发送的信息在 Azure 日志监控中可用之后，会在 Microsoft 内部日志记录系统中存储 30 天。我们建议在将任何信息添加到自定义标头之前对其进行加密。不应通过自定义标头传递任何 PHI 信息。

必须对 HTTP 标头 X-MS-AZUREFHIR-AUDIT-<name> 使用以下命名约定。

这些 HTTP 标头包含在添加到日志的属性包中。例如：

X-MS-AZUREFHIR-AUDIT-USERID：1234
X-MS-AZUREFHIR-AUDIT-USERLOCATION：XXXX
X-MS-AZUREFHIR-AUDIT-XYZ：1234

将此信息添加到日志中的属性列后，此信息会序列化为 JSON。例如：

{ "X-MS-AZUREFHIR-AUDIT-USERID" : "1234",
"X-MS-AZUREFHIR-AUDIT-USERLOCATION" : "XXXX",
"X-MS-AZUREFHIR-AUDIT-XYZ" : "1234" }

与任何 HTTP 标头一样，相同的标头名称也可以用不同的值重复。例如：

X-MS-AZUREFHIR-AUDIT-USERLOCATION：HospitalA
X-MS-AZUREFHIR-AUDIT-USERLOCATION：紧急情况

将这些值添加到日志时，这些值会与逗号分隔的列表合并。例如：

{ "X-MS-AZUREFHIR-AUDIT-USERLOCATION" :"HospitalA, Emergency" }

最多可以添加 10 个唯一标头（具有不同值的相同标头的重复仅计为一）。任何一个标头值的总最大长度为 2048 个字符。

如果使用的是 Firefly C# 客户端 API 库，代码将如下所示：

FhirClient client;
client = new FhirClient(serverUrl);
client.OnBeforeRequest += (object sender, BeforeRequestEventArgs e) =>
{
    // Add custom headers to be added to the logs
    e.RawRequest.Headers.Add("X-MS-AZUREFHIR-AUDIT-UserLocation", "HospitalA");
};
client.Get("Patient");

后续步骤

在本文中，你了解了如何使用 Azure API for FHIR 中的自定义标头将数据添加到审核日志。有关如何 Azure API for FHIR 配置设置的信息，请参阅

FHIR® 是 HL7 的注册商标，经 HL7 许可使用。

通过

在 FHIR 服务中将自定义 HTTP 标头添加到审核日志

后续步骤

反馈

其他资源