本文是为Kubernetes中任意应用添加基于oauth2的认证保护的下篇,将图文详解如何使用基于钉钉认证的oauth2 proxy为自身本没有认证授权功能的Web站点实现认证及授权。
示例是使用的AWS EKS服务作为K8S环境。鉴于K8S的应用运行时属性,该示例也可以部署在其他云厂商托管的K8S。
示例模块简介
- Nginx Ingress Controller为K8S集群内Web应用提供反向代理,以及支持外部认证。
- 简单的Web站点,基于Nginx docker容器。该站点默认没有认证及授权功能,使用外部钉钉应用作为认证及授权。
- OAuth2 Proxy on Dingtalk提供基于钉钉应用的扫码认证及授权,只有认证且授权的用户才可以访问上面的Web站点。
默认设定
- Web站点域名
web.kane.mx
- 认证服务域名
oauth.kane.mx
准备AWS EKS环境
- 创建EKS集群。由于Nginx Ingress服务是LoadBalancer类型,EKS创建NLB或ELB对应的targets时需要targets部署在public VPC subnets,所以为了简化部署EKS集群的VPC subnets都选择public subnet。新建的EKS集群允许公开访问。
- 本地安装配置kubectl, aws-iam-authenticator用于远程管理集群。
- 为集群添加worker节点。
- 配置Helm部署环境。
钉钉应用准备
- 为企业或组织开通钉钉开发平台
- 创建一个新的移动应用。回调域名填写
<http or https>/<认证服务域名>/oauth2/callback
。记录下来应用的appId
和appSecret
。 - 创建一个企业内部工作台应用。地址可以随意设置。服务器出口IP设置为
EKS集群中工作节点的公网IP
或者NAT EIP
,取决于工作节点如何访问Internet。并记录下来应用appKey
和appSecret
。
部署示例应用
- 克隆示例部署脚本。
- 替换
values.yaml
中的dingtalk_corpid
为工作台应用的appKey
,dingtalk_corpsecret
为工作台应用的appSecret
。
由于社区维护的oauth2-proxy charts并不支持dingtalk扩展的SECRET ENV,所以将密钥配置到了
configmap
中。用于生产环境的话,建议按这个commit使用secret
保存应用secret。
oauth2-proxy:
config:
clientID: aaa
clientSecret: bbb
cookieSecret: ccc
configFile: |+
email_domains = [ "*" ]
cookie_domain = "kane.mx"
cookie_secure = false
dingtalk_corpid = "<appkey of dingtalk app>"
dingtalk_corpsecret = "<appsecret of dingtalk app>"
如果仅希望企业部分部门的员工可以获得授权,在上面configFile
配置下添加如下配置,
dingtalk_departments = ["xx公司/产品技术中心","xx公司/部门2/子部门3"]
- 替换部署应用的域名为你的域名。
- 执行以下命令安装Helm部署依赖。
helm dep up
- 执行以下命令部署nginx ingress controller, web应用以及oauth2 proxy
helm upgrade --install -f values.yaml --set oauth2-proxy.config.clientID=<移动应用appid>,oauth2-proxy.config.clientSecret=<移动应用appsecret> site-with-auth --wait ./
如果集群中已经部署了Nginx Ingress Controller
,修改values.yaml
如下将忽略部署Nginx ingress,
affinity: {}
nginx-ingress:
enabled: false
controller:
ingressClass: nginx
config:
- 部署成功后,获取
ELB
地址。
kubectl get svc -o jsonpath='{ $.status.loadBalancer.ingress[*].hostname }' <deployment name>-nginx-ingress-controller;echo
a3afe672259c511e98e2a0a0d88fda3e-xx.elb.ap-southeast-1.amazonaws.com
部署成功后配置
将站点和oauth服务域名解析到上面部署创建的ELB上。
测试
访问Web站点(如本示例中的http://web.kane.mx
),未授权的情况下,调转到钉钉应用扫码登录界面。使用组织内成员的钉钉扫码授权后,将跳转回Web站点应用,可以正常浏览该域名下的页面。