Firely Auth Docker镜像文档

概述

Firely Auth是一个OAuth2服务器，专门提供符合SMART on FHIR标准的令牌及声明。其核心用途是为***健康领域的FHIR应用提供安全的认证与授权服务，支持默认SQLite存储模式，部署便捷。

核心功能与特性

• 符合标准：严格遵循SMART on FHIR规范，确保生成的令牌及声明满足***健康数据交互需求。
• 默认存储：采用SQLite作为默认数据存储，简化初始部署流程，无需额外配置外部数据库。
• 许可证支持：需通过许可证运行，支持两种许可证提供方式（文件挂载或环境变量注入）。
• 灵活集成：可与Firely Server集成，通过自定义配置文件实现协同工作。

使用场景与适用范围

适用于***健康领域中基于FHIR标准构建的应用系统，如电子健康记录（EHR）系统、***数据交换平台等，需实现安全的用户认证、授权及令牌管理场景。

使用方法与配置说明

1. 获取许可证

运行Firely Auth需有效的许可证文件：

• 从fire.ly官网下载评估版许可证，默认文件名为firelyserver-license.json。
• 将文件重命名为firely-auth-license.json，保存至本地工作目录。

2. 配置文件（可选，如需集成Firely Server）

若需与Firely Server连接，需创建自定义配置文件appsettings.instance.json，配置方法参考***文档，并保存至本地工作目录。

3. 运行容器

通过以下命令启动Firely Auth容器，根据本地终端类型选择对应命令：

Powershell终端

powershell
docker run -d -p 5100:5100 --name firely.auth -v ${PWD}/firely-auth-license.json:/app/firely-auth-license.json -v ${PWD}/appsettings.instance.json:/app/appsettings.instance.json firely/auth:latest

Command Prompt终端

cmd
docker run -d -p 5100:5100 --name firely.auth -v %CD%/firely-auth-license.json:/app/firely-auth-license.json -v %CD%/appsettings.instance.json:/app/appsettings.instance.json firely/auth:latest

参数说明

• -d：后台运行容器。
• -p 5100:5100：将容器内5100端口映射至主机5100端口。
• --name firely.auth：指定容器名称为firely.auth。
• -v ${PWD}/firely-auth-license.json:/app/firely-auth-license.json：挂载许可证文件至容器内/app目录。
• -v ${PWD}/appsettings.instance.json:/app/appsettings.instance.json：（可选）挂载自定义配置文件至容器内/app目录。

4. 访问服务

容器启动后，通过浏览器访问 http://localhost:5100 即可打开Firely Auth的 landing page。

许可证的其他提供方式

除文件挂载外，还可通过环境变量提供许可证内容：

• 设置环境变量 FIRELY_AUTH_License__LicenseString，值为许可证文件内容的字符串形式。

参考文档

• Firely Auth***文档
• Firely Auth部署指南