Teleport 쿠버네티스 서비스를 해당 클러스터에서 실행하여 쿠버네티스 클러스터를 Teleport에 등록할 수도 있지만, 클러스터 외부의 Linux 호스트에서 Teleport 쿠버네티스 서비스를 실행할 수도 있습니다. 이는 Teleport 배포를 액세스를 관리하려는 쿠버네티스 클러스터와 분리하고자 할 때 유용합니다.

이 가이드에서는 Teleport 쿠버네티스 서비스를 Teleport에 등록하고 정적 kubeconfig를 사용하여 쿠버네티스 클러스터를 프록시하도록 서비스를 구성합니다.

작동 방식#

이 설정에서 Teleport 쿠버네티스 서비스는 kubeconfig 파일을 사용하여 선택한 쿠버네티스 클러스터의 API 서버에 인증합니다.

사전 요구 사항#

• 실행 중인 Teleport 클러스터. Teleport를 시작하려면 무료 체험판에 가입하거나 데모 환경을 구성하세요.

• tctl and tsh clients.

  Installing `tctl` and `tsh` clients

  1. Teleport 클러스터의 버전을 확인합니다. tctl and tsh clients는 Teleport 클러스터 버전보다 최대 한 개의 메이저 버전까지만 뒤처질 수 있습니다. Proxy Service의 /v1/webapi/find로 GET 요청을 보내고 JSON 쿼리 도구를 사용하여 클러스터 버전을 확인합니다. teleport.example.com:443를 Teleport Proxy Service의 웹 주소로 바꿉니다:

     $ TELEPORT_DOMAIN=teleport.example.com:443
     $ TELEPORT_VERSION="$(curl -s https://$TELEPORT_DOMAIN/v1/webapi/find | jq -r '.server_version')"
     

  2. 사용 중인 플랫폼에 대한 지침에 따라 tctl and tsh clients를 설치합니다:

Mac

     `tctl` and `tsh` clients가 포함된, 서명된 Teleport macOS .pkg 설치 프로그램을 다운로드합니다:
 
     ```code
     $ curl -O https://cdn.teleport.dev/teleport-${TELEPORT_VERSION?}.pkg
     ```

     Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다.
 
     

       Homebrew를 사용하여 Teleport를 설치하는 것은 지원되지 않습니다. Homebrew의
       Teleport 패키지는 Teleport에서 유지 관리하지 않으므로 신뢰성이나 보안을
       보장할 수 없습니다.
     

Windows - Powershell

     ```code
     $ curl.exe -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-windows-amd64-bin.zip
     # Unzip the archive and move the `tctl` and `tsh` clients to your %PATH%
     # NOTE: Do not place the `tctl` and `tsh` clients in the System32 directory, as this can cause issues when using WinSCP.
     # Use %SystemRoot% (C:\Windows) or %USERPROFILE% (C:\Users\<username>) instead.
     ```
 
   

 
   

Linux

     Linux 설치판의 모든 Teleport 바이너리에는 `tctl` and `tsh` clients가 포함되어 있습니다.  RPM/DEB
     패키지 및 i386/ARM/ARM64용 다운로드를 포함한 더 많은 옵션은
     [설치 페이지](../installation/installation.mdx)를 참조하세요.
 
     ```code
     $ curl -O https://cdn.teleport.dev/teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
     $ tar -xzf teleport-v${TELEPORT_VERSION?}-linux-amd64-bin.tar.gz
     $ cd teleport
     $ sudo ./install
     # Teleport binaries have been copied to /usr/local/bin
     ```
   

 

• 액세스하려는 쿠버네티스 클러스터.
• Teleport 쿠버네티스 서비스를 실행할, 자체 인프라에 배포된 Linux 호스트. 이 호스트는 쿠버네티스 클러스터 외부에서 실행할 수 있습니다.
• 워크스테이션에 설치된 kubectl 커맨드 라인 도구.

Teleport cluster에 연결할 수 있는지 확인하려면 tsh login으로 로그인한 다음, 현재 자격 증명으로 tctl 명령을 실행할 수 있는지 확인합니다.

예를 들어, teleport.example.com에 cluster 내 Teleport Proxy Service의 도메인 이름을, email@example.com에 Teleport 사용자 이름을 지정하여 다음 명령을 실행합니다:

$ tsh login --proxy=teleport.example.com --user=email@example.com
$ tctl status
# Cluster  (=teleport.url=)
# Version  (=teleport.version=)
# CA pin   (=presets.ca_pin=)

cluster에 연결하여 tctl status 명령을 실행할 수 있다면, 현재 자격 증명을 사용하여 워크스테이션에서 이후의 tctl 명령을 실행할 수 있습니다. 자체 Teleport cluster를 호스팅하는 경우, 전체 권한을 얻기 위해 Teleport Auth Service를 호스팅하는 컴퓨터에서 tctl 명령을 실행할 수도 있습니다.

1/4단계. kubeconfig 파일 생성#

Teleport 쿠버네티스 서비스는 kubeconfig 파일을 사용하여 쿠버네티스 클러스터에 인증합니다. 이 섹션에서는 kubeconfig 파일을 생성하여 이 가이드의 이후 단계에서 Teleport 쿠버네티스 서비스가 이를 사용하도록 구성할 수 있게 합니다.

컨텍스트가 올바른지 확인하기#

먼저, 로컬 kubectl 명령이 등록하려는 쿠버네티스 클러스터를 가리키도록 구성합니다. 다음 명령을 사용하여 올바른 클러스터가 선택되어 있는지 확인할 수 있습니다.

$ kubectl config get-contexts

다음 명령을 사용하여 context-name에 할당된 클러스터로 전환합니다.

# 예: my-context
$ kubectl config use-context context-name

스크립트 실행#

워크스테이션에서 kubeconfig 파일을 생성하는 데 사용할 Teleport의 get-kubeconfig.sh 스크립트를 다운로드합니다.

$ curl -OL \
https://raw.githubusercontent.com/gravitational/teleport/v(=teleport.version=)/examples/k8s-auth/get-kubeconfig.sh

get-kubeconfig.sh는 쿠버네티스 파드를 가져오고 사용자, 그룹, 다른 서비스 어카운트를 임퍼소네이션할 수 있는 Teleport 쿠버네티스 서비스용 서비스 어카운트를 생성합니다. Teleport 쿠버네티스 서비스는 이 서비스 어카운트를 사용하여 쿠버네티스 클러스터의 리소스에 대한 액세스를 관리합니다. 또한 이 스크립트는 서비스 어카운트 자격 증명을 저장할 쿠버네티스 Secret이 클러스터에 존재하도록 보장합니다.

get-kubeconfig.sh는 또한 배포하는 리소스를 위해 teleport라는 네임스페이스를 생성하지만, 스크립트를 실행하는 셸에서 TELEPORT_NAMESPACE 환경 변수를 지정하여 다른 이름을 선택할 수 있습니다.

리소스를 생성한 후 get-kubeconfig.sh는 스크립트를 실행한 디렉터리에 kubeconfig라는 새 kubeconfig 파일을 작성합니다.

get-kubeconfig.sh 스크립트를 실행합니다.

$ bash get-kubeconfig.sh

다음 메시지가 표시되면 스크립트가 성공한 것입니다.

Done!

kubeconfig 파일을 Teleport 쿠버네티스 서비스를 실행하는 데 사용할 호스트로 이동합니다. 이 가이드에서는 kubeconfig 파일이 /var/lib/teleport/kubeconfig에 있다고 가정합니다.

2/4단계. Teleport 쿠버네티스 서비스 설정#

이 단계에서는 Teleport 쿠버네티스 서비스를 설치하고 생성한 kubeconfig 파일을 사용하여 쿠버네티스 클러스터에 액세스하도록 구성합니다.

조인 토큰 받기#

조인 토큰을 생성하여 Teleport 클러스터와 새 쿠버네티스 서비스 인스턴스 간 신뢰를 구성합니다.

$ tctl tokens add --type=kube --format=text --ttl=1h
(=presets.tokens.first=)

조인 토큰을 join-token에 할당합니다. Teleport 쿠버네티스 서비스를 실행하는 호스트에서 토큰만으로 구성된 /tmp/token 파일을 생성합니다.

$ echo join-token | sudo tee /tmp/token

Teleport 쿠버네티스 서비스 설치#

Teleport 쿠버네티스 서비스를 설치할 호스트에서 다음 명령을 실행합니다.

Linux 서버에 Teleport Agent를 설치하려면:

권장 설치 방법은 클러스터 설치 스크립트입니다. 이 스크립트는 클러스터에 맞는 올바른 버전, 에디션, 설치 모드를 선택합니다.

1. teleport.example.com:443에 Teleport 클러스터의 호스트명과 포트를 할당하되, 스킴(https://)은 포함하지 마십시오.

2. 클러스터의 설치 스크립트를 실행하십시오:

   $ curl "https://teleport.example.com:443/scripts/install.sh" | sudo bash
   

Teleport 쿠버네티스 서비스 구성#

teleport.example.com:443에 Teleport 프록시 서비스 또는 Teleport Cloud 테넌트의 호스트와 포트를 할당합니다. 예: mytenant.teleport.sh:443. Teleport 쿠버네티스 서비스를 실행할 호스트에서 다음 내용으로 /etc/teleport.yaml 파일을 생성합니다.

version: v3
teleport:
  join_params:
    token_name: "/tmp/token"
    method: token
  proxy_server: teleport.example.com:443
auth_service:
  enabled: false
proxy_service:
  enabled: false
ssh_service:
  enabled: false
kubernetes_service:
  enabled: true
  kubeconfig_file: "/var/lib/teleport/kubeconfig"
  labels:
    "region": "us-east-1"

Teleport 쿠버네티스 서비스 시작#

systemd 서비스를 생성하여 호스트가 부팅될 때 the Teleport Kubernetes Service이 자동으로 시작되도록 구성합니다. 지침은 the Teleport Kubernetes Service을 어떻게 설치했는지에 따라 다릅니다.

Package Manager

the Teleport Kubernetes Service을 실행할 호스트에서 Teleport를 활성화하고 시작합니다:

$ sudo systemctl enable teleport
$ sudo systemctl start teleport

TAR Archive

the Teleport Kubernetes Service을 실행할 호스트에서 Teleport용 systemd 서비스 구성을 생성하고, Teleport 서비스를 활성화한 후 Teleport를 시작합니다:

$ sudo teleport install systemd -o /etc/systemd/system/teleport.service
$ sudo systemctl enable teleport
$ sudo systemctl start teleport

systemctl status teleport로 the Teleport Kubernetes Service의 상태를 확인하고 journalctl -fu teleport로 로그를 볼 수 있습니다.

3/4단계. Teleport 사용자에게 액세스 권한 부여#

이 가이드의 이후 단계에서 클러스터에 연결할 수 있도록 Teleport 사용자가 쿠버네티스 클러스터의 리소스에 액세스할 수 있도록 설정합니다.

Teleport를 통해 Kubernetes 클러스터에 인증하려면, Teleport 사용자의 역할이 최소한 하나의 Kubernetes 사용자 또는 그룹으로 접근할 수 있도록 허용해야 합니다.

1. 현재 사용자의 Teleport 역할 목록을 조회합니다. 아래 예제는 JSON 파싱을 위해 jq 유틸리티가 필요합니다.

   $ CURRENT_ROLES=$(tsh status -f json | jq -r '.active.roles | join ("\n")')
   

2. 역할이 접근을 허용하는 Kubernetes 그룹을 조회합니다.

   $ echo "$CURRENT_ROLES" | xargs -I{} tctl get roles/{} --format json | \
     jq '.[0].spec.allow.kubernetes_groups[]?'
   

3. 역할이 접근을 허용하는 Kubernetes 사용자를 조회합니다.

   $ echo "$CURRENT_ROLES" | xargs -I{} tctl get roles/{} --format json | \
     jq '.[0].spec.allow.kubernetes_users[]?'
   

4. 앞의 두 명령 중 하나의 출력이 비어 있지 않다면, 사용자가 최소한 하나의 Kubernetes 사용자 또는 그룹에 접근할 수 있으므로 다음 단계로 진행할 수 있습니다.

5. 두 목록이 모두 비어 있다면, 이 가이드를 위한 목적으로 클러스터의 Kubernetes 리소스를 볼 수 있는 Teleport 역할을 생성합니다.

   다음 내용으로 kube-access.yaml 파일을 생성합니다.

   kind: role
   metadata:
     name: kube-access
   version: v7
   spec:
     allow:
       kubernetes_labels:
         '*': '*'
       kubernetes_resources:
         - kind: '*'
           namespace: '*'
           name: '*'
           verbs: ['*']
       kubernetes_groups:
       - viewers
     deny: {}
   

6. 변경 사항을 적용합니다.

   $ tctl create -f kube-access.yaml
   

인증 공급자에 맞는 적절한 명령을 실행하여 kube-access 역할을 your Teleport user에게 할당하십시오:

Local User

1. 로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:

   $ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")')
   

2. 로컬 사용자를 편집하여 새 역할을 추가합니다:

   $ tctl users update $(tsh status -f json | jq -r '.active.username') \
     --set-roles "${ROLES?},kube-access"
   

3. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

GitHub

1. 텍스트 편집기에서 github 인증 커넥터를 엽니다:

   $ tctl edit github/github
   

2. github 커넥터를 편집하여 teams_to_roles 섹션에 kube-access을 추가합니다.

   이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.

   다음은 예시입니다:

     teams_to_roles:
       - organization: octocats
         team: admins
         roles:
           - access
   +       - kube-access
   

3. 편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.

4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

SAML

1. saml 구성 리소스를 가져옵니다:

   $ tctl get --with-secrets saml/mysaml > saml.yaml
   

   --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 saml.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다.

2. saml.yaml을 편집하여 attributes_to_roles 섹션에 kube-access을 추가합니다.

   이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

   다음은 예시입니다:

     attributes_to_roles:
       - name: "groups"
         value: "my-group"
         roles:
           - access
   +       - kube-access
   

3. 변경 사항을 적용합니다:

   $ tctl create -f saml.yaml
   

4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

OIDC

1. oidc 구성 리소스를 가져옵니다:

   $ tctl get oidc/myoidc --with-secrets > oidc.yaml
   

   --with-secrets 플래그는 spec.signing_key_pair.private_key 값을 oidc.yaml 파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다.

2. oidc.yaml을 편집하여 claims_to_roles 섹션에 kube-access을 추가합니다.

   이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.

   다음은 예시입니다:

     claims_to_roles:
       - name: "groups"
         value: "my-group"
         roles:
           - access
   +       - kube-access
   

3. 변경 사항을 적용합니다:

   $ tctl create -f oidc.yaml
   

4. Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.

5. Kubernetes 클러스터에서 viewers 그룹이 내장 view ClusterRole을 갖도록 구성합니다. Teleport 사용자가 kube-access 역할을 맡아 Kubernetes API 서버로 요청을 보내면, Teleport Kubernetes Service가 viewers 그룹을 가장(impersonate)하여 요청을 프록시합니다.

   다음 내용으로 viewers-bind.yaml 파일을 생성하여, 내장 view ClusterRole을 Teleport 사용자가 접근할 수 있도록 활성화한 viewers 그룹에 바인딩합니다.

   apiVersion: rbac.authorization.k8s.io/v1
   kind: ClusterRoleBinding
   metadata:
     name: viewers-crb
   subjects:
   - kind: Group
     # Bind the group "viewers", corresponding to the kubernetes_groups we assigned our "kube-access" role above
     name: viewers
     apiGroup: rbac.authorization.k8s.io
   roleRef:
     kind: ClusterRole
     # "view" is a default ClusterRole that grants read-only access to resources
     # See: https://kubernetes.io/docs/reference/access-authn-authz/rbac/#user-facing-roles
     name: view
     apiGroup: rbac.authorization.k8s.io
   

6. kubectl로 ClusterRoleBinding을 적용합니다.

   $ kubectl apply -f viewers-bind.yaml
   

4/4단계. 쿠버네티스 클러스터 액세스#

위 구성으로 Teleport를 시작한 후에는 새로 추가된 모든 클러스터를 확인할 수 있어야 합니다.

$ tsh kube ls
Kube Cluster Name                       Labels           Selected
--------------------------------------- ------           --------
my-cluster                              region=us-east-1

클러스터에 액세스하려면 다음 명령을 실행하되, my-cluster를 액세스하려는 클러스터의 이름으로 바꾸세요.

$ tsh kube login my-cluster
Logged into kubernetes cluster "my-cluster". Try 'kubectl version' to test the connection.