热门搜索:
ivanjosipovic/ingress-nginx-validate-jwt
ivanjosipovic
使ingress-nginx能够验证JWT令牌的API服务器，支持基于Ingress的自定义JWT验证配置
下载次数: 0状态：社区镜像维护者：ivanjosipovic仓库类型：镜像最近更新：1 年前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
ingress-nginx-validate-jwt
概述
该项目是一个API服务器，与ingress-nginx的https://github.com/kubernetes/ingress-nginx/blob/main/docs/user-guide/nginx-configuration/annotations.md#external-authentication%E6%B3%A8%E8%A7%A3%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%EF%BC%8C%E5%AE%9E%E7%8E%B0%E6%AF%8F%E4%B8%AAIngress%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89JWT%E9%AA%8C%E8%AF%81%E3%80%82
安装
bashhelm repo add ingress-nginx-validate-jwt https://ivanjosipovic.github.io/ingress-nginx-validate-jwt helm repo update helm install ingress-nginx-validate-jwt \ ingress-nginx-validate-jwt/ingress-nginx-validate-jwt \ --create-namespace \ --namespace ingress-nginx-validate-jwt \ --set openIdProviderConfigurationUrl="https://login.microsoftonline.com/common/v2.0/.well-known/openid-configuration"
配置选项
- openIdProviderConfigurationUrl
- 身份提供商的OpenID Provider配置URL
- logLevel
- 日志级别（Trace、Debug、Information、Warning、Error、Critical、None）
- Helm Values
配置Ingress
yamlapiVersion: networking.k8s.io/v1 kind: Ingress metadata: name: ingress namespace: default annotations: # 配置认证URL指向验证服务 nginx.ingress.kubernetes.io/auth-url: http://ingress-nginx-validate-jwt.ingress-nginx-validate-jwt.svc.cluster.local:8080/auth?tid=11111111-1111-1111-1111-111111111111&aud=22222222-2222-2222-2222-222222222222&aud=33333333-3333-3333-3333-333333333333 spec: # Ingress规则配置（省略）
验证参数
/auth端点支持{claim}={value}格式的可配置参数。当同一claim多次出现时，只需匹配其中一个即可通过验证。
例如，使用以下查询字符串：
/auth? tid=11111111-1111-1111-1111-111111111111 &aud=22222222-2222-2222-2222-222222222222 &aud=33333333-3333-3333-3333-333333333333
除验证JWT令牌有效性外，令牌还必须包含tid=11111111-1111-1111-1111-111111111111且满足aud为22222222-2222-2222-2222-222222222222或33333333-3333-3333-3333-333333333333中的一个。
设计
!https://github.com/IvanJosipovic/ingress-nginx-validate-jwt/raw/main/docs/validate-jwt.png
指标
指标通过:8080/metrics端点暴露：
| 指标名称 | 描述 |
|---|---|
| ingress_nginx_validate_jwt_authorized | 已授权操作的数量 |
| ingress_nginx_validate_jwt_unauthorized | 未授权操作的数量 |
| ingress_nginx_validate_jwt_duration_seconds | JWT验证持续时间的直方图 |
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 ingress-nginx-validate-jwt 镜像标签
docker pull docker.xuanyuan.run/ivanjosipovic/ingress-nginx-validate-jwt:<标签>
DockerHub 原生拉取命令
docker pull ivanjosipovic/ingress-nginx-validate-jwt:<标签>
更多 ingress-nginx-validate-jwt 镜像推荐
nginx/nginx-ingress
NGINX 官方镜像
NGINX和NGINX Plus入口控制器是专为Kubernetes设计的流量管理工具，主要用于管理外部HTTP/HTTPS流量进入Kubernetes集群，支持请求路由、负载均衡、SSL终止、流量控制等功能，适用于容器化应用和微服务架构，其中NGINX Plus还提供商业支持、高级监控和增强的负载均衡能力，帮助提升集群流量管理的效率与安全性。
121 次收藏10亿+ 次下载
3 天前更新
nginx/nginx-ingress-operator
NGINX 官方镜像
用于NGINX和NGINX Plus入口控制器的NGINX入口操作器，基于Helm图表构建。
4 次收藏100万+ 次下载
16 天前更新
nginx/nginx-prometheus-exporter
NGINX 官方镜像
NGINX Prometheus Exporter用于收集并导出NGINX与NGINX Plus的监控指标，供Prometheus采集以实现对其运行状态的监控。
51 次收藏5000万+ 次下载
4 个月前更新
nginxinc/nginx-unprivileged
nginxinc
非特权NGINX Docker构建文件是指用于构建以非root用户身份在Docker容器中运行NGINX的配置文件，通过预设用户权限、环境变量及安全参数，确保NGINX在低权限模式下仍能正常处理HTTP请求、反向代理及负载均衡等功能，有效降低因容器漏洞引发的权限提升风险，适用于对安全性要求较高的生产环境部署场景。
190 次收藏10亿+ 次下载
6 天前更新
nginxinc/nginx-s3-gateway
nginxinc
基于NGINX的认证和缓存网关，用于S3 API后端服务。
6 次收藏500万+ 次下载
1 个月前更新
extension/nginx
extension
NGINX Development Center for Docker Desktop
5万+ 次下载
3 年前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"