本文是为Kubernetes中任意应用添加基于oauth2的认证保护的下篇,将图文详解如何使用基于钉钉认证oauth2 proxy为自身本没有认证授权功能的Web站点实现认证及授权。

示例是使用的AWS EKS服务作为K8S环境。鉴于K8S的应用运行时属性,该示例也可以部署在其他云厂商托管的K8S。

示例模块简介 

默认设定 

  • Web站点域名web.kane.mx
  • 认证服务域名oauth.kane.mx

准备AWS EKS环境 

  1. 创建EKS集群。由于Nginx Ingress服务是LoadBalancer类型,EKS创建NLB或ELB对应的targets时需要targets部署在public VPC subnets,所以为了简化部署EKS集群的VPC subnets都选择public subnet。新建的EKS集群允许公开访问。
  2. 本地安装配置kubectl, aws-iam-authenticator用于远程管理集群。
  3. 为集群添加worker节点
  4. 配置Helm部署环境

钉钉应用准备 

  1. 为企业或组织开通钉钉开发平台
  2. 创建一个新的移动应用。回调域名填写<http or https>/<认证服务域名>/oauth2/callback。记录下来应用的appIdappSecret
  3. 创建一个企业内部工作台应用。地址可以随意设置。服务器出口IP设置为EKS集群中工作节点的公网IP或者NAT EIP,取决于工作节点如何访问Internet。并记录下来应用appKeyappSecret

部署示例应用 

  1. 克隆示例部署脚本。
  2. 替换values.yaml中的dingtalk_corpid为工作台应用的appKeydingtalk_corpsecret为工作台应用的appSecret。 由于社区维护的oauth2-proxy charts并不支持dingtalk扩展的SECRET ENV,所以将密钥配置到了configmap中。用于生产环境的话,建议按这个commit使用secret保存应用secret。
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    
    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"]
  3. 替换部署应用的域名为你的域名。
  4. 执行以下命令安装Helm部署依赖。
    helm dep up
  5. 执行以下命令部署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,
    47
    48
    49
    50
    51
    52
    53
    
    affinity: {}
    
    nginx-ingress:
      enabled: false
      controller:
        ingressClass: nginx
        config:
  6. 部署成功后,获取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站点应用,可以正常浏览该域名下的页面。