你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
导出去识别的数据
注意
使用 FHIR® 服务的 deidentified (de-ID) 导出时的结果因导出的数据的性质以及正在使用的 de-ID 函数而异。 Microsoft无法评估未识别的导出输出或确定用例和合规性需求的可接受性。 FHIR 服务的无标识导出不保证满足任何特定的法律、法规或合规性要求。
运行操作时 $export
,FHIR 服务可以取消数据。 对于未识别的导出,FHIR 服务使用来自 FHIR 工具的 匿名引擎进行 GitHub 上的匿名化 (OSS) 项目。 有一个 示例配置文件 可帮助你开始编辑/转换包含个人身份信息的 FHIR 数据字段。
配置文件
匿名引擎附带了一个示例配置文件,可帮助你开始使用 HIPAA 安全港方法 de-ID 要求。 配置文件是一个 JSON 文件,其中包含四个属性:fhirVersion
、、parameters
processingErrors
fhirPathRules
。
fhirVersion
指定匿名引擎的 FHIR 版本。processingErrors
指定要对匿名化期间出现的任何处理错误采取的操作。 可以根据 需求引发 或 保留 异常。fhirPathRules
指定要使用的匿名方法。 规则按照它们在配置文件中显示的顺序执行。parameters
为 fhirPathRules 中指定的匿名行为设置更多控件。
下面是 FHIR R4 的示例配置文件:
{
"fhirVersion": "R4",
"processingError":"raise",
"fhirPathRules": [
{"path": "nodesByType('Extension')", "method": "redact"},
{"path": "Organization.identifier", "method": "keep"},
{"path": "nodesByType('Address').country", "method": "keep"},
{"path": "Resource.id", "method": "cryptoHash"},
{"path": "nodesByType('Reference').reference", "method": "cryptoHash"},
{"path": "Group.name", "method": "redact"}
],
"parameters": {
"dateShiftKey": "",
"cryptoHashKey": "",
"encryptKey": "",
"enablePartialAgesForRedact": true
}
}
有关详细信息,请参阅 FHIR 匿名化。
管理存储帐户中的配置文件
需要在 ADLS Gen2 帐户中为已取消识别的导出创建容器,并在 API 请求中指定 <<container_name>>
,如下所示。 此外,需要将 JSON 配置文件与匿名规则放置在容器中,并在 API 请求中指定 <<config file name>>
。
注意
通常的做法是命名容器 anonymization
。 容器中的 JSON 文件通常命名 anonymizationConfig.json
。
在 ACR 中管理配置文件
建议在 Azure 容器注册表(ACR)上托管导出配置文件。
- 将配置文件推送到Azure 容器注册表。
- 在 FHIR 服务实例上启用托管标识。
- 提供对 FHIR 服务托管标识的 ACR 的访问权限。
- 在 FHIR 服务中注册 ACR 服务器。 可以使用门户在“转换和传输数据”部分中打开“项目”来添加 ACR 服务器。
- 为 ACR 防火墙配置安全访问。
使用 $export
终结点来取消数据解析
下面是匿名的“$export”查询的示例。
https://<<FHIR service base URL>>/$export?_container=<<container_name>>&_anonymizationConfigCollectionReference=<<ACR image reference>>&_anonymizationConfig=<<config file name>>&_anonymizationConfigEtag=<<ETag on storage>>
注意
现在,FHIR 服务仅支持在系统级别($export
)取消识别导出。
查询参数 | 示例 | 可选性 | 说明 |
---|---|---|---|
_容器 | exportContainer | 必须 | 导出数据的已配置的存储帐户中的容器的名称。 |
_anonymizationConfigCollectionReference | “myacr.azurecr.io/deidconfigs:default” | 可选 | 对 ACR 上的 OCI 映像的引用,其中包含用于取消 ID 导出的 de-ID 配置文件(如 stu3-config.json、r4-config.json)。 应在 FHIR 服务中注册映像的 ACR 服务器。 (格式: <RegistryServer>/<imageName>@<imageDigest> , <RegistryServer>/<imageName>:<imageTag> ) |
_anonymizationConfig | anonymizationConfig.json |
必须 | 配置文件的名称。 请在此处查看配置文件格式。 如果 提供了_anonymizationConfigCollectionReference ,我们将搜索并使用指定图像中的此文件。 否则,我们会在配置的 ADLS Gen2 帐户中搜索并使用名为匿名的容器中的此文件。 |
_anonymizationConfigEtag | "0x8D8494A069489EC" | 可选 | 配置文件的 Etag,可从 Azure 存储 资源管理器中的 blob 属性获取。 仅当配置文件存储在 Azure 存储帐户中时,才指定此参数。 如果使用 ACR 托管配置文件,则不应包含此参数。 |
重要
原始导出和已取消识别的导出操作写入到 FHIR 服务的导出配置中指定的同一 Azure 存储帐户。 如果需要多个取消标识配置,建议为每个配置创建一个不同的容器,并在容器级别管理用户访问。
后续步骤
导出数据(export-data.md)
注意
FHIR® 是 HL7 的注册商标,经 HL7 许可使用。