Autenticação no Kubernetes com Dex: aperte LDAP

Hoje, examinarei os detalhes da configuração da autenticação no Kubernetes usando o Dex em conjunto com o LDAP e também mostrarei como você pode adicionar usuários estáticos ao Dex. 

Neste artigo, não abordarei os princípios básicos do Dex, mas continuarei instalando e configurando o LDAP imediatamente. Você pode se familiarizar com os princípios do Dex neste artigo .

O que nós fazemos:

  1. Instale o OpenLDAP e configure o suporte ao STARTTLS nele. 
  2. Descrevemos a estrutura do diretório LDAP da nossa organização .
  3. Ative o suporte ao OIDC (OpenID Connect) nos servidores kube-api .
  4. Obtenha o certificado SAN para os domínios que o Dex usará .
  5. Instale Dex e Dex-auth, onde descrevemos o diretório LDAP e os usuários estáticos
  6. Iremos gerar o kubeconfig do nosso usuário para trabalhar com o cluster .
  7. Configure a autenticação RBAC para grupos e usuários no cluster .

Então vamos.



Vou mostrar um exemplo de um cluster Kubernetes pronto com o Helm versão 3 e o Ingress, além de três nomes de domínio.

Instale e configure o servidor OpenLDAP


Usaremos o OpenLDAP como LDAP na distribuição do ubuntu 18.04. 
O nome do nosso servidor: openldap.dtln.cloud. 

  1. Estamos conectados ao servidor e iniciamos a instalação do OpenLDAP. Durante a instalação, seremos solicitados a definir uma senha:

    sudo apt update 
    sudo apt install slapd ldap-utils
    

  2. Reconfigurando o OpenLDAP para o nosso domínio:

    sudo dpkg-reconfigure slapd 
    

  3. Escolha Não :


  4. Digite o nome do domínio:


  5. Digite o nome da organização:


  6. Repita a entrada da senha:


  7. Incluímos suporte para STARTTLS. Colocamos os pacotes necessários:

    sudo apt install gnutls-bin ssl-cert
    

  8. CA-:

    sudo sh -c "certtool --generate-privkey > /etc/ssl/private/cakey.pem"
    

  9. /etc/ssl/ca.info:

    cn = DTLN Company
    ca
    cert_signing_key
    

  10. CA-a , :

    sudo certtool --generate-self-signed --load-privkey /etc/ssl/private/cakey.pem --template /etc/ssl/ca.info --outfile /etc/ssl/certs/cacert.pem
    sudo certtool --generate-privkey --bits 1024 --outfile /etc/ssl/private/openldap_key.pem
    

  11. /etc/ssl/openldap.info:

    organization = DTLN Company
    cn = openldap.dtln.cloud
    tls_www_server
    encryption_key
    signing_key
    expiration_days = 3650
    

  12. :

    sudo certtool --generate-certificate --load-privkey /etc/ssl/private/openldap_key.pem --load-ca-certificate /etc/ssl/certs/cacert.pem --load-ca-privkey /etc/ssl/private/cakey.pem --template /etc/ssl/openldap.info --outfile /etc/ssl/certs/openldap.pem
    

  13. OpenLDAP STARTTLS. certinfo.dif:

    dn: cn=config
    add: olcTLSCACertificateFile
    olcTLSCACertificateFile: /etc/ssl/certs/cacert.pem
    -
    add: olcTLSCertificateFile
    olcTLSCertificateFile: /etc/ssl/certs/openldap.pem
    -
    add: olcTLSCertificateKeyFile
    olcTLSCertificateKeyFile: /etc/ssl/private/openldap_key.pem
    

  14. :

    sudo ldapmodify -Y EXTERNAL -H ldapi:/// -f certinfo.dif
    

  15. :

    sudo chgrp openldap /etc/ssl/private/openldap_key.pem
    sudo chmod 0640 /etc/ssl/private/openldap_key.pem
    sudo gpasswd -a openldap ssl-cert
    sudo systemctl restart slapd.service
    

  16. , /etc/ldap/ldap.conf :

    TLS_CACERT /etc/ssl/certs/cacert.pem
    

  17. STARTTLS:

    ldapwhoami -H ldap://openldap.dtln.cloud -x -ZZ
    

    :



    :


LDAP-


  1. , x , Kubernetes. content.ldif:

    dn: ou=People,dc=openldap,dc=dtln,dc=cloud
    objectClass: organizationalUnit
    ou: People
    dn: cn=jane,ou=People,dc=openldap,dc=dtln,dc=cloud
    objectClass: person
    objectClass: inetOrgPerson
    sn: doe
    cn: jane
    mail: janedoe@openldap.dtln.cloud
    userpassword: foo_password
    
    dn: cn=john,ou=People,dc=openldap,dc=dtln,dc=cloud
    objectClass: person
    objectClass: inetOrgPerson
    sn: doe
    cn: john
    mail: johndoe@openldap.dtln.cloud
    userpassword: bar_password
    
    # Group definitions.
    
    dn: ou=Groups,dc=openldap,dc=dtln,dc=cloud
    objectClass: organizationalUnit
    ou: Groups
    
    dn: cn=admins,ou=Groups,dc=openldap,dc=dtln,dc=cloud
    objectClass: groupOfNames
    cn: admins
    member: cn=jane,ou=People,dc=openldap,dc=dtln,dc=cloud
    
    dn: cn=developers,ou=Groups,dc=openldap,dc=dtln,dc=cloud
    objectClass: groupOfNames
    cn: developers
    member: cn=jane,ou=People,dc=openldap,dc=dtln,dc=cloud
    member: cn=john,ou=People,dc=openldap,dc=dtln,dc=cloud
    

  2. Expanda a estrutura descrita com o comando:

    ldapadd -x -D cn=admin,dc=openldap,dc=dtln,dc=cloud -W -f content.ldif
    

  3. Verifique se nossos usuários estão no diretório:

    ldapwhoami -vvv -h openldap.dtln.cloud -p 389 -D cn=john,ou=People,dc=openldap,dc=dtln,dc=cloud -x -w bar_password -ZZ
    ldapwhoami -vvv -h openldap.dtln.cloud -p 389 -D cn=jane,ou=People,dc=openldap,dc=dtln,dc=cloud -x -w foo_password -ZZ
    

Conectamos suporte ao OpenID Connect


Vamos para a configuração do cluster Kubernetes. 

Usamos o domínio dex.ash.dtln.cloud para acessar o servidor da API Dex e o login.ash.dtln.cloud para acessar o cluster.

Implementamos o cluster sem os instaladores kubeadm ou kops, para que a configuração do OIDC possa ser imediatamente adicionada à unidade systemd. Em outros casos, a configuração é melhor feita usando esses utilitários.

  1. Editamos a unidade /etc/systemd/system/kube-apiserver.service e adicionamos os parâmetros de inicialização à seção ExecStart :

    --oidc-client-id=dex-k8s-authenticator \
    --oidc-groups-claim=groups \
    --oidc-username-claim=email \
    --oidc-issuer-url=https://dex.ash.dtln.cloud/ \
    
  2. Reiniciamos nossas APIs, verifique se elas aumentaram:

    sudo systemctl daemon-reload
    sudo systemctl restart kube-apiserver
    sudo systemctl status kube-apiserver
    

Crie um certificado de vários domínios


Agora vá para o cluster Kubernetes. 

  1. Instalamos o cert-manager usando o Helm: 

    helm repo add jetstack https://charts.jetstack.io
    helm repo update
    helm install cert-manager --namespace kube-system jetstack/cert-manager --version v0.13.0
    

  2. Descrevemos a solicitação de um certificado SAN para nossos domínios em cert.yml:

    ---
    apiVersion: cert-manager.io/v1alpha2
    kind: ClusterIssuer
    metadata:
      name: letsencrypt-dex
    spec:
      acme:
        email: kubernetes@dataline.ru
        server: https://acme-v02.api.letsencrypt.org/directory
        privateKeySecretRef:
          name: letsencrypt-key-dex
        solvers:
        - http01:
            ingress:
              class: nginx
    ---
    apiVersion: cert-manager.io/v1alpha2
    kind: Certificate
    metadata:
      name: auth-dex
      namespace: kube-system
    spec:
      secretName: cert-auth-dex
      issuerRef:
        kind: ClusterIssuer
        name: letsencrypt-dex
      commonName: dex.ash.dtln.cloud
      dnsNames:
      - dex.ash.dtln.cloud
      - login.ash.dtln.cloud
    

  3. Nós executamos o comando:

    kubectl apply -f cert.yaml
    

  4. Agora, examinamos o status da nossa solicitação de certificado com os seguintes comandos: 

    kubectl get certificates --all-namespaces
    kubectl get challenges --all-namespaces
    

  5. Estamos aguardando confirmação, o processo pode levar algum tempo:



Instalar Dex


Para Dex, precisamos de ca.crt, ca.key do servidor principal. Geralmente eles estão no diretório / etc / kubernetes / pki /
Também precisamos do certificado CA anterior com o OpenLDAP que geramos, localizado no caminho /etc/ssl/certs/cacert.pem

  1. Faça o download das fontes dex-authenticator e acesse o diretório:

    git clone git@github.com:mintel/dex-k8s-authenticator.git
    cd dex-k8s-authenticator/
    

  2. Preparamos a configuração para o Dex-auth, colamos o conteúdo do ca.crt copiado anteriormente, é importante observar o recuo:

    ---
    global:
      deployEnv: prod
    dexK8sAuthenticator:
      clusters:
        - name: 'ash.dtln.cloud'
          short_description: "k8s cluster"
          description: "Kubernetes cluster"
          issuer: https://dex.ash.dtln.cloud/
          k8s_master_uri: https://kubernetes.dtln.cloud:6443 # url or ip
          client_id: dex-k8s-authenticator
          static_context_name: false
          client_secret: acDEgDEcIg7RX0U7A9hlW2pGGraHDuMAZ4qFEKg2fUHHxr8
          redirect_uri: https://login.ash.dtln.cloud/callback
          k8s_ca_pem: |
            -----BEGIN CERTIFICATE-----
            #   ca.crt
            -----END CERTIFICATE-----
    ingress:
      enabled: true
      annotations:
        kubernetes.io/ingress.class: nginx
        kubernetes.io/tls-acme: "true"
      path: /
      hosts:
        - login.ash.dtln.cloud
      tls:
        - secretName: cert-auth-dex
          hosts:
            - login.ash.dtln.cloud
    
    

  3. Traduzimos o conteúdo do cacert.pem para base64 para adicioná-lo à configuração:

    cacert.pem | base64
    

  4. Dex, . staticPasswords bcrypt:

    ---
    global:
      deployEnv: prod
    tls:
      certificate: |-
        -----BEGIN CERTIFICATE-----
        # ca.crt
        -----END CERTIFICATE-----
      key: |-
        -----BEGIN RSA PRIVATE KEY-----
        # ca.key
        -----END RSA PRIVATE KEY-----
    ingress:
      enabled: true
      annotations:
        kubernetes.io/ingress.class: nginx
        kubernetes.io/tls-acme: "true"
      path: /
      hosts:
        - dex.ash.dtln.cloud
      tls:
        - secretName: cert-auth-dex
          hosts:
            - dex.ash.dtln.cloud
    serviceAccount:
      create: true
      name: dex-auth-sa
    config:
      issuer: https://dex.ash.dtln.cloud/
      storage:
        type: kubernetes
        config:
          inCluster: true
      web:
        http: 0.0.0.0:5556
      frontend:
        theme: "coreos"
        issuer: "kube-dtln"
        issuerUrl: "https://login.ash.dtln.cloud"
      expiry:
        signingKeys: "6h"
        idTokens: "24h"
      logger:
        level: debug
        format: json
      oauth2:
        responseTypes: ["code", "token", "id_token"]
        skipApprovalScreen: true
    
      connectors:
      - type: ldap
        id: ldap
        name: LDAP
        config:
          insecureNoSSL: false
          insecureSkipVerify: false
          startTLS: true #   
          rootCAData: |-
            # cacert.pem  base64 
            # 
         
          host: openldap.dtln.cloud:389
          usernamePrompt: Email Address
          userSearch:
            baseDN: ou=People,dc=openldap,dc=dtln,dc=cloud
            filter: "(objectClass=person)"
            username: mail
            idAttr: DN
            emailAttr: mail
            nameAttr: cn
          groupSearch:
            baseDN: ou=Groups,dc=openldap,dc=dtln,dc=cloud
            filter: "(objectClass=groupOfNames)"
    
            userMatchers:
            - userAttr: DN
              groupAttr: member
    
            nameAttr: cn
    
      staticClients:
      - id: dex-k8s-authenticator
        name: Kubernetes Dev Cluster
        secret: 'acDEgDEcIg7RX0U7A9hlW2pGGraHDuMAZ4qFEKg2fUHHxr8'
        redirectURIs:
          - https://login.ash.dtln.cloud/callback
    
      enablePasswordDB: True
    
      staticPasswords:
        #       base64
      - email: "admin@dtln.cloud"
        # bcrypt hash of the string "password"
        hash: "$2a$10$2b2cU8CPhOTaGrs1HRQuAueS7JTT5ZHsHSzYiFPm1leZck7Mc8T4W"
        username: "admin"
        userID: "08a8684b-db88-4b73-90a9-3cd1661f5466"
    
    

  5. dex dex-auth- :

    helm install dex --namespace kube-system --values dex.yaml charts/dex
    helm install dex-auth --namespace kube-system --values dex-auth.yml charts/dex-k8s-authenticator
    


kubeconfig


  1. , pod’. login.ash.dtln.cloud. , mail- . 

    static- mail:


  2.  Dex-auth. C kubeconfig-. :


  3. Agora tente acessar o cluster e obtenha um erro. É isso mesmo, nosso usuário não tem direitos, então vamos à configuração do RBAC.



Configuramos a autorização RBAC


  1. Por exemplo, atribuímos o usuário estático à função de sistema administrador de cluster e os usuários do grupo de desenvolvedores à função de visualização, que permite apenas a visualização de recursos. Em seguida, o conteúdo do arquivo crb.yml deve ser assim:

    ---
    apiVersion: rbac.authorization.k8s.io/v1beta1
    kind: ClusterRoleBinding
    metadata:
      name: dex-admin
      namespace: kube-system
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: cluster-admin
    subjects:
    - kind: User
      name: "admin@dtln.cloud"
    
    ---
    apiVersion: rbac.authorization.k8s.io/v1beta1
    kind: ClusterRoleBinding
    metadata:
      name: dex-developers
      namespace: kube-system
    roleRef:
      apiGroup: rbac.authorization.k8s.io
      kind: ClusterRole
      name: view
    subjects:
    - kind: Group
      name: "developers"
    

  2. Alterne para o contexto principal e aplique o arquivo yaml criado ao cluster:

    kubectl config set-context default
    kubectl apply -f crb.yml
    

  3. Examinamos os contextos disponíveis e voltamos ao nosso usuário:

    kubectl config get-contexts
    kubectl config set-context johndoe-ash.dtln.cloud
    

Isso completa a configuração do Dex em conjunto com o OpenLDAP.

Algumas dicas para o final:

  • Se surgirem problemas, a primeira coisa a verificar é a formatação dos arquivos yaml e preste atenção ao recuo. 
  • As barras nos endereços devem corresponder aos exemplos. 
  • pod’ Dex, Dex-auth, kube-api .

All Articles