teamdigitale/io-onboarding-pa-api
teamdigitale
IO公共行政部门入职门户的后端应用，支持SPID登录认证、数据持久化及邮件测试等功能，用于意大利公共机构的入职流程管理。
下载次数: 0状态：社区镜像维护者：teamdigitale仓库类型：镜像最近更新：6 年前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
IO入职门户后端镜像
该镜像包含IO公共行政部门入职门户的后端应用代码，用于支持意大利公共机构的入职流程管理。IO项目详情可参考官方网站。
核心功能
- 支持SPID（意大利公共身份识别系统）登录认证
- 依赖PostgreSQL实现数据持久化
- 集成MailHog进行邮件发送测试
- 灵活的环境变量配置
- 支持本地开发测试与生产环境部署
使用场景
- 意大利公共行政部门的入职流程管理系统
- SPID登录功能的本地测试与调试
- 后端服务的容器化部署与扩展
- 生产环境下的Kubernetes集群部署
配置说明
前提条件
- Bash/GitBash
- Docker及Docker Compose
依赖服务
本地测试需启动以下服务（通过docker-compose自动拉起）：
- SPID测试环境（spid-testenv2）
- PostgreSQL数据库
- MailHog SMTP服务器
环境变量
必填变量
| 变量名称 | 描述 | 类型 |
|---|---|---|
| BACKEND_PORT | Express Web服务器端口 | 数字 |
| POSTGRESQL_HOST | PostgreSQL服务器主机名 | 字符串 |
| POSTGRESQL_PASSWORD | PostgreSQL连接密码 | 字符串 |
| POSTGRESQL_USERNAME | PostgreSQL用户名 | 字符串 |
| POSTGRESQL_DATABASE | 数据库名称 | 字符串 |
| CLIENT_DOMAIN | 允许CORS的客户端域名 | 字符串 |
| COOKIE_DOMAIN | 接收会话token的允许主机 | 字符串 |
| CLIENT_SPID_LOGIN_REDIRECTION_URL | SPID登录重定向路径 | 字符串 |
| CLIENT_SPID_ERROR_REDIRECTION_URL | SPID登录错误重定向路径 | 字符串 |
| CLIENT_SPID_SUCCESS_REDIRECTION_URL | SPID登录成功重定向路径 | 字符串 |
| SAML_ACCEPTED_CLOCK_SKEW_MS | SAML认证允许的时钟偏差（毫秒） | 数字 |
| SAML_ATTRIBUTE_CONSUMING_SERVICE_INDEX | SAML属性消费服务索引 | 数字 |
| SAML_CALLBACK_URL | SAML断言消费服务端点URL | 字符串 |
| SAML_ISSUER | 服务提供者的Issuer ID | 字符串 |
| SAML_CERT_PATH | SAML认证使用的公钥证书路径 | 字符串 |
| SAML_KEY_PATH | SAML认证使用的私钥路径 | 字符串 |
| SPID_TESTENV_URL | SPID测试环境URL | 字符串 |
| IDP_METADATA_URL | IDP元数据下载URL | 字符串 |
| TOKEN_DURATION_IN_SECONDS | 会话token有效期（秒） | 整数 |
| EMAIL_PASSWORD | SMTP服务器密码 | 字符串 |
| EMAIL_USER | SMTP服务器用户名 | 字符串 |
| EMAIL_SMTP_HOST | SMTP服务器主机名 | 字符串 |
| EMAIL_SMTP_PORT | SMTP服务器端口 | 整数 |
| EMAIL_SMTP_SECURE | 是否启用TLS连接 | 布尔值 |
| EMAIL_SENDER | 发件人***地址 | 字符串 |
| INDICEPA_ADMINISTRATIONS_URL | 公共行政部门信息下载URL | 字符串 |
| ARSS_WSDL_URL | Aruba远程签名服务WSDL URL | 字符串 |
| ARSS_IDENTITY_OTP_PWD | ARSS签名事务的用户OTP | 字符串 |
| ARSS_IDENTITY_TYPE_OTP_AUTH | ARSS用户的认证域 | 字符串 |
| ARSS_IDENTITY_USER | ARSS用户名 | 字符串 |
| ARSS_IDENTITY_USER_PWD | ARSS用户密码 | 字符串 |
可选变量
| 变量名称 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| ADMINISTRATION_SEARCH_RESULTS_LIMIT | 行政部门搜索结果最大数量 | 数字 | 30 |
部署示例
本地测试部署
shell# 复制示例环境变量文件 cp env.example .env # 编辑.env配置变量 docker-compose up -d database docker-compose up
后端API可访问：http://localhost:3000
重建镜像
shelldocker-compose up --build
SPID登录测试
访问以下URL使用测试用户登录（默认用户：pippo/test、pinco/test）： http://localhost:3000/login?entityID=xx_testenv2&authLevel=SpidL2
生产部署
- 每次master分支推送时，Azure Pipeline自动构建镜像并推送到DockerHub（teamdigitale/io-onboarding-pa-api）
- 使用专用Helm Chart部署到Kubernetes集群，详情参考https://github.com/teamdigitale/io-infrastructure-post-config
- 已部署的后端地址：[***]
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 io-onboarding-pa-api 镜像标签
docker pull docker.xuanyuan.run/teamdigitale/io-onboarding-pa-api:<标签>
DockerHub 原生拉取命令
docker pull teamdigitale/io-onboarding-pa-api:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"