Slack 접근 요청 플러그인 실행
Teleport v18.9이 가이드는 Teleport에서 접근 요청 메시지를 받도록 Slack을 설정하는 방법을 설명합니다. Teleport Enterprise Cloud에서는 Teleport가 the Slack integration를 대신 관리하며, Teleport 웹 UI에서 the Slack integration를 등록할 수 있습니다.
이 가이드는 Teleport에서 접근 요청 메시지를 받도록 Slack을 설정하는 방법을 설명합니다.
이 통합은 Teleport Cloud에서 호스팅됩니다
Teleport Enterprise Cloud에서는 Teleport가 the Slack integration를 대신 관리하며, Teleport 웹 UI에서 the Slack integration를 등록할 수 있습니다.
Teleport 웹 UI로 이동하여 왼쪽 사이드바에서 Add New를 클릭한 다음 Integration을 클릭하십시오:

"Select Integration Type" 메뉴에서 사용할 통합의 타일을 클릭하십시오. 통합을 설정하는 방법에 대한 지침과 함께 통합을 구성하는 데 사용할 수 있는 양식이 있는 페이지가 표시됩니다.
작동 방식#
Teleport의 Slack 통합은 개인 및 채널에 접근 요청을 알립니다. 사용자는 접근 요청을 승인하거나 거부할 수 있는 Teleport 클러스터에 로그인하도록 안내되어, 생산성을 저해하지 않고 보안 모범 사례를 구현하는 것이 더 쉬워집니다.

다음은 Teleport의 Slack 플러그인을 통해 접근 요청을 전송하는 예시입니다:
전제 조건#
-
실행 중인 Teleport Enterprise 클러스터. Teleport를 시작하려면 무료 체험판에 가입하거나 데모 환경을 구성하세요.
-
tctlandtshclients.Installing `tctl` and `tsh` clients
-
Teleport 클러스터의 버전을 확인합니다.
tctlandtshclients는 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')" -
사용 중인 플랫폼에 대한 지침에 따라
tctlandtshclients를 설치합니다:
-
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
```
권장: Machine & Workload Identity를 구성하여 플러그인에 수명이 짧은
Teleport 자격 증명을 제공하십시오. 이 가이드를 따르기 전에, 인프라에서
tbot 바이너리를 실행하도록 Machine & Workload Identity
배포 가이드를 먼저 따르십시오.
- 앱을 만들고 워크스페이스에 설치할 Slack 관리자 권한. Slack 프로필에 프로필 사진 아래 "Workspace Owner" 또는 "Workspace Admin" 배너가 있어야 합니다.
- Slack 플러그인을 실행할 Linux 호스트 또는 Kubernetes 클러스터.
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/8단계. RBAC 리소스 정의#
Slack 플러그인을 설정하기 전에 Teleport 클러스터에서 역할 접근 요청을 활성화해야 합니다.
이 가이드에서는 내장 editor 역할을 요청할 수 있는 editor-requester 역할과,
editor 역할에 대한 요청을 검토할 수 있는 editor-reviewer 역할을
정의합니다.
다음 내용으로 editor-request-rbac.yaml라는 파일을 생성합니다:
kind: role
version: v7
metadata:
name: editor-reviewer
spec:
allow:
review_requests:
roles: ['editor']
---
kind: role
version: v7
metadata:
name: editor-requester
spec:
allow:
request:
roles: ['editor']
thresholds:
- approve: 1
deny: 1
정의한 역할을 생성합니다:
$ tctl create -f editor-request-rbac.yaml
role 'editor-reviewer' has been created
role 'editor-requester' has been created
Web UI를 사용하여 역할을 생성하고 편집할 수도 있습니다. Access -> Roles로 이동하여 Create New Role을 클릭하거나 편집할 기존 역할을 선택하십시오.
본인에게 editor-reviewer 역할을 할당하여, editor-requester 역할을 가진
사용자의 요청을 검토할 수 있도록 허용합니다.
인증 공급자에 맞는 적절한 명령을 실행하여 editor-reviewer 역할을
your Teleport user에게 할당하십시오:
Local User
-
로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:
$ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")') -
로컬 사용자를 편집하여 새 역할을 추가합니다:
$ tctl users update $(tsh status -f json | jq -r '.active.username') \ --set-roles "${ROLES?},editor-reviewer" -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
GitHub
-
텍스트 편집기에서
github인증 커넥터를 엽니다:$ tctl edit github/github -
github커넥터를 편집하여teams_to_roles섹션에editor-reviewer을 추가합니다.이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.
다음은 예시입니다:
teams_to_roles: - organization: octocats team: admins roles: - access + - editor-reviewer -
편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.
-
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
SAML
-
saml구성 리소스를 가져옵니다:$ tctl get --with-secrets saml/mysaml > saml.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을saml.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다. -
saml.yaml을 편집하여attributes_to_roles섹션에editor-reviewer을 추가합니다.이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
attributes_to_roles: - name: "groups" value: "my-group" roles: - access + - editor-reviewer -
변경 사항을 적용합니다:
$ tctl create -f saml.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
OIDC
-
oidc구성 리소스를 가져옵니다:$ tctl get oidc/myoidc --with-secrets > oidc.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을oidc.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다. -
oidc.yaml을 편집하여claims_to_roles섹션에editor-reviewer을 추가합니다.이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
claims_to_roles: - name: "groups" value: "my-group" roles: - access + - editor-reviewer -
변경 사항을 적용합니다:
$ tctl create -f oidc.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
editor-requester 역할을 가진 myuser라는 사용자를 생성합니다. 이 사용자는
editor 역할을 요청하지 않으면 클러스터 구성을 편집할 수 없습니다:
$ tctl users add myuser --roles=editor-requester
tctl은 초대 URL을 터미널에 출력합니다. 해당 URL을 방문하여 myuser로 처음
로그인하고, Teleport 클러스터에 구성된 대로 자격 증명을
등록합니다.
이 가이드의 뒷부분에서는 myuser가 editor 역할을 요청하도록 하여, Teleport
플러그인을 사용해 요청을 검토할 수 있습니다.
2/8단계. Teleport Slack 플러그인 사용자 정의#
플러그인에 필요한 권한은 프리셋 access-plugin 역할에 구성되어 있습니다. 플러그인의 자격 증명을 생성하려면 Machine ID 봇 사용자 또는 일반 Teleport 사용자를 정의합니다.
아직 Machine ID 봇을 설정하지 않았다면, 인프라에서 tbot 바이너리를
실행하려면 배포 가이드를
참고하십시오.
다음으로, Machine ID 봇이 access-plugin 역할에 대한 자격 증명을 생성할 수
있도록 허용합니다. tctl을 사용하여 이 작업을 수행할 수 있으며, my-bot을
사용자의 봇 이름으로 바꾸십시오:
$ tctl bots update my-bot --add-roles access-plugin
모든 Teleport 사용자와 마찬가지로, Teleport Auth Service는 수명이 짧은 TLS
자격 증명을 발급하여 access-plugin 사용자를 인증합니다. 이 경우에는
access-plugin 역할과 사용자를 가장(impersonate) 하여 자격 증명을 수동으로
요청해야 합니다.
자체 호스팅 Teleport Enterprise 배포를 실행 중이고 Auth Service 호스트에서
tctl을 사용하는 경우, 이미 가장(impersonation)
권한을 보유하고 있습니다.
사용자에게 access-plugin에 대한 가장 권한을 부여하려면, 다음 YAML 문서를
access-plugin-impersonator.yaml라는 파일에 추가하여 access-plugin이라는
사용자와 access-plugin-impersonator라는 역할을 정의합니다:
kind: user
metadata:
name: access-plugin
spec:
roles: ['access-plugin']
version: v2
---
kind: role
version: v7
metadata:
name: access-plugin-impersonator
spec:
allow:
impersonate:
roles:
- access-plugin
users:
- access-plugin
사용자와 역할을 생성합니다:
$ tctl create -f access-plugin-impersonator.yaml
user "access-plugin" has been created
role "access-plugin-impersonator" has been created
Web UI를 사용하여 역할을 생성하고 편집할 수도 있습니다. Access -> Roles로 이동하여 Create New Role을 클릭하거나 편집할 기존 역할을 선택하십시오.
access-plugin 역할과 사용자에 대한 자격 증명을 생성하는 데 사용할 사용자에게
이 역할을 할당합니다:
인증 공급자에 맞는 적절한 명령을 실행하여 access-plugin-impersonator 역할을
your Teleport user에게 할당하십시오:
Local User
-
로컬 사용자의 역할을 쉼표로 구분된 목록으로 가져옵니다:
$ ROLES=$(tsh status -f json | jq -r '.active.roles | join(",")') -
로컬 사용자를 편집하여 새 역할을 추가합니다:
$ tctl users update $(tsh status -f json | jq -r '.active.username') \ --set-roles "${ROLES?},access-plugin-impersonator" -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
GitHub
-
텍스트 편집기에서
github인증 커넥터를 엽니다:$ tctl edit github/github -
github커넥터를 편집하여teams_to_roles섹션에access-plugin-impersonator을 추가합니다.이 역할에 매핑해야 할 팀은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 팀은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 팀이어야 합니다.
다음은 예시입니다:
teams_to_roles: - organization: octocats team: admins roles: - access + - access-plugin-impersonator -
편집기에서 파일을 저장하고 닫아 변경 사항을 적용합니다.
-
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
SAML
-
saml구성 리소스를 가져옵니다:$ tctl get --with-secrets saml/mysaml > saml.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을saml.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 saml.yaml 파일을 삭제해야 합니다. -
saml.yaml을 편집하여attributes_to_roles섹션에access-plugin-impersonator을 추가합니다.이 역할에 매핑해야 할 속성은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
attributes_to_roles: - name: "groups" value: "my-group" roles: - access + - access-plugin-impersonator -
변경 사항을 적용합니다:
$ tctl create -f saml.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
OIDC
-
oidc구성 리소스를 가져옵니다:$ tctl get oidc/myoidc --with-secrets > oidc.yaml--with-secrets플래그는spec.signing_key_pair.private_key값을oidc.yaml파일에 추가한다는 점에 유의하십시오. 이 키에는 민감한 값이 포함되어 있으므로, 리소스를 업데이트한 직후 oidc.yaml 파일을 삭제해야 합니다. -
oidc.yaml을 편집하여claims_to_roles섹션에access-plugin-impersonator을 추가합니다.이 역할에 매핑해야 할 클레임은 조직의 역할 기반 액세스 제어(RBAC)를 어떻게 설계했는지에 따라 달라집니다. 다만, 해당 그룹은 여러분의 사용자 계정을 포함해야 하며 조직 내에서 가능한 한 가장 작은 그룹이어야 합니다.
다음은 예시입니다:
claims_to_roles: - name: "groups" value: "my-group" roles: - access + - access-plugin-impersonator -
변경 사항을 적용합니다:
$ tctl create -f oidc.yaml -
Teleport 클러스터에서 로그아웃한 다음 다시 로그인하여 새 역할을 적용합니다.
이제 access-plugin 역할과 사용자에 대한 서명된 인증서를 생성할 수 있게
됩니다.
3/8단계. 접근 플러그인 아이덴티티 내보내기#
플러그인에 Teleport 아이덴티티 파일 접근 권한을 부여합니다. 유출되더라도 위험이 적은 단기 아이덴티티 파일을 생성하기 위해 Machine ID를 사용하는 것을 권장하지만, 데모 배포에서는 tctl로 더 오래 지속되는 아이덴티티 파일을 생성할 수 있습니다:
the plugin에서 필요로 하는 자격 증명을 생성하는 output으로 tbot을
구성하세요. the plugin가 Teleport API에 접근하므로, 사용해야 할 올바른
output 유형은 identity입니다.
이 가이드에서는 directory destination을 사용합니다. 이는 이러한
자격 증명을 디스크의 지정된 디렉터리에 기록합니다. 이 디렉터리가 tbot이
실행되는 Linux 사용자에 의해 쓰기 가능하고, the plugin가 실행되는
Linux 사용자에 의해 읽기 가능한지 확인하세요.
identity output을 추가하도록 tbot 구성을 수정하세요.
Linux 서버에서 tbot을 실행하는 경우, directory output을 사용하여
identity 파일을 /opt/machine-id 디렉터리에 기록하세요:
services:
- type: identity
destination:
type: directory
# For this guide, /opt/machine-id is used as the destination directory.
# You may wish to customize this. Multiple outputs cannot share the same
# destination.
path: /opt/machine-id
Kubernetes에서 tbot을 실행하는 경우, identity 파일을 대신 Kubernetes secret에
기록하세요:
services:
- type: identity
destination:
type: kubernetes_secret
name: teleport-plugin-slack-identity
tbot을 백그라운드 서비스로 운영하는 경우, 재시작하세요. tbot을
one-shot 모드로 실행하는 경우, 지금 실행하세요.
이제 /opt/machine-id 아래에 identity 파일 또는 teleport-plugin-slack-identity이라는
이름의 Kubernetes secret이 보일 것입니다. 여기에는 the plugin가 Teleport Auth
Service에 인증하는 데 필요한 개인 키와 서명된 인증서가 담겨 있습니다.
모든 Teleport 사용자와 마찬가지로, access-plugin가 Teleport 클러스터에 연결하려면
서명된 자격 증명이 필요합니다. tctl auth sign 명령을 사용하여 이러한 자격 증명을
요청합니다.
다음 tctl auth sign 명령은 access-plugin 사용자를 impersonate하여 서명된 자격
증명을 생성하고, 로컬 디렉터리에 identity 파일을 작성합니다:
$ tctl auth sign --user=access-plugin --out=identity
plugin는 TLS를 통해 Teleport Auth Service의 gRPC 엔드포인트에 연결합니다.
identity 파일 identity에는 TLS 자격 증명과 SSH 자격 증명이 모두 포함됩니다.
plugin는 SSH 자격 증명을 사용하여 Proxy Service에 연결하며, Proxy Service는
Auth Service로의 리버스 터널 연결을 설정합니다. plugin는 이 리버스 터널과
TLS 자격 증명을 함께 사용하여 Auth Service의 gRPC 엔드포인트에 연결합니다.
Certificate Lifetime
기본적으로 tctl auth sign은 비교적 짧은 수명을 가진 인증서를 생성합니다.
프로덕션 배포의 경우, 플러그인의 인증서를 프로그래밍 방식으로 발급하고 갱신하기
위해 Machine
& Workload Identity를 사용하는 것을 권장합니다.
자세히 알아보려면 Machine & Workload Identity 시작
가이드를 참조하세요.
기존 자격 증명보다 더 오래 유효한 인증서는 발급할 수 없다는 점에 유의하세요.
예를 들어, 1000시간 TTL을 가진 인증서를 발급하려면 최소 1000시간 동안 유효한
세션으로 로그인되어 있어야 합니다. 즉, 사용자는 최소 1000시간(60000분)의
max_session_ttl을 허용하는 역할을 가지고 있어야 하며, 로그인 시 --ttl을
지정해야 합니다:
$ tsh login --proxy=teleport.example.com --ttl=60060
Linux 서버에서 plugin를 실행하는 경우, plugin의 인증서 파일을 저장할 데이터 디렉터리를 생성합니다:
$ sudo mkdir -p /var/lib/teleport/plugins/api-credentials
$ sudo mv identity /var/lib/teleport/plugins/api-credentials
Kubernetes에서 plugin를 실행하는 경우, Teleport identity 파일이 포함된 Kubernetes secret을 생성합니다:
$ kubectl -n teleport create secret generic --from-file=identity teleport-plugin-slack-identity
Teleport 자격 증명이 만료되면 tctl auth sign 명령을 다시 실행하여 갱신해야
합니다.
4/8단계. Teleport Slack 플러그인 설치#
Download
Access Request Plugin은 amd64 및 arm64 Linux 바이너리로 다운로드할 수 있습니다.
ARCH를 필요한 버전으로 교체하세요.
$ curl -L -O https://cdn.teleport.dev/teleport-access-slack-v(=teleport.plugin.version=)-linux-ARCH-bin.tar.gz
$ tar -xzf teleport-access-slack-v(=teleport.plugin.version=)-linux-ARCH-bin.tar.gz
$ cd teleport-access-slack
$ sudo ./install
바이너리가 설치되었는지 확인합니다:
$ teleport-slack version
teleport-slack v(=teleport.plugin.version=) git:teleport-slack-v(=teleport.plugin.version=)-fffffffff go(=teleport.golang=)
Docker Image
$ docker pull public.ecr.aws/gravitational/teleport-plugin-slack:(=teleport.plugin.version=)
다음 명령을 실행하여 플러그인이 설치되었는지 확인합니다:
$ docker run public.ecr.aws/gravitational/teleport-plugin-slack:(=teleport.plugin.version=) version
teleport-slack v(=teleport.plugin.version=) (=teleport.golang=)
사용 가능한 태그 목록은 Amazon ECR Public Gallery를 참조하세요.
From Source
소스에서 설치하려면 git과 go가 설치되어 있어야 합니다. Go가 설치되어 있지
않다면 Go downloads page를 방문하세요.
$ git clone https://github.com/gravitational/teleport -b branch/v(=teleport.major_version=)
$ cd teleport/integrations/access/slack
$ git checkout v(=teleport.plugin.version=)
$ make build/teleport-slack
teleport-slack 바이너리를 PATH로 이동합니다.
바이너리가 설치되었는지 확인합니다:
$ teleport-slack version
teleport-slack v(=teleport.plugin.version=) git:teleport-slack-v(=teleport.plugin.version=)-fffffffff go(=teleport.golang=)
Helm Chart
Helm이 Teleport Helm 리포지토리에 호스팅된 차트를 설치할 수 있도록 허용합니다:
$ helm repo add teleport (=teleport.helm_repo_url=)
원격 리포지토리에서 차트 캐시를 업데이트합니다:
$ helm repo update
5/8단계. Slack 앱 등록#
Slack용 접근 요청 플러그인은 Teleport Auth Service에서 접근 요청 이벤트를 받아 이를 Slack 메시지로 형식화하고 Slack API로 전송하여 워크스페이스에 게시합니다. 이 작동을 위해 Slack API에 새 앱을 등록해야 합니다.
앱 만들기#
https://api.slack.com/apps를 방문하여 새 Slack 앱을 만듭니다. "Create an App"을 클릭한 다음 "From scratch"를 클릭합니다. 아래와 같이 양식을 작성합니다:

"App Name"은 "Teleport"여야 합니다. "Development Slack Workspace" 드롭다운을 클릭하고 접근 요청 메시지를 보고 싶은 워크스페이스를 선택합니다.
스코프가 있는 OAuth 토큰 생성#
다음으로 Slack API에 인증하도록 애플리케이션을 구성합니다. 플러그인이 Slack API에 제시할 OAuth 토큰을 생성하여 이 작업을 수행합니다.
OAuth 스코프를 사용하여 플러그인을 가능한 좁은 권한으로 제한합니다. Slack 플러그인은 워크스페이스에 메시지를 게시해야 합니다. 또한 Auth Service에서 적절한 Teleport 사용자에게 접근 요청 알림을 보내기 위해 사용자 이름과 이메일 주소를 읽어야 합니다.
앱을 만든 후 Slack 웹사이트에서 구성 옵션을 지정할 수 있는 콘솔이 열립니다. "Features" 아래 사이드바 메뉴에서 "OAuth & Permissions"을 클릭합니다.
"Scopes" 섹션으로 스크롤하고 다음 각 스코프에 대해 "Add an OAuth Scope"를 클릭합니다:
chat:writeincoming-webhookusers:readusers:read.email
결과는 다음과 같아야 합니다:

플러그인에 대한 스코프를 구성한 후 OAuth & Permissions 페이지 상단으로 스크롤하여 "OAuth Tokens for Your Workspace" 섹션을 찾고 "Install to Workspace"를 클릭합니다. 이전에 Slack 플러그인에 대해 구성한 권한 요약이 표시됩니다.
"Where should Teleport post?"에서 플러그인이 게시할 기본 채널로 "Slackbot"을 선택합니다. 플러그인은 직접 메시지를 보낼 때 여기에 게시합니다. 이 가이드 후반에 플러그인이 다른 채널에도 게시하도록 구성합니다.
이 양식을 제출하면 "Tokens for Your Workspace" 아래 "OAuth & Permissions" 탭에서 OAuth 토큰을 볼 수 있습니다:

이 토큰은 Slack 플러그인을 구성할 때 나중에 사용합니다.
6/8단계. Teleport Slack 플러그인 구성#
이 시점에서 Teleport Slack 플러그인은 Teleport 클러스터와 Slack API와 통신하는 데 필요한 자격 증명을 가지고 있습니다. 이 단계에서는 이러한 자격 증명을 사용하도록 Slack 플러그인을 구성합니다. 또한 접근 요청 업데이트를 받을 때 올바른 Slack 채널에 알리도록 플러그인을 구성합니다.
구성 파일 만들기#
Teleport Slack 플러그인은 TOML 형식의 구성 파일을 사용합니다. 다음 명령을 실행하여 기본 구성을 생성합니다(플러그인은 구성 파일이 /etc/teleport-slack.toml에 있지 않으면 실행되지 않습니다):
$ teleport-slack configure | sudo tee /etc/teleport-slack.toml > /dev/null
결과는 아래와 같은 구성 파일이어야 합니다:
<div class="admonition note"><div class="admonition-title">Note</div><p>이 섹션의 내용은 원문 문서를 참조하세요. (<code>teleport-slack.toml</code>)</p></div>
Slack Helm Chart는 YAML 값 파일을 사용하여 플러그인을 구성합니다.
로컬 워크스테이션에서 다음 예시를 기반으로 teleport-slack-helm.yaml 파일을 만듭니다:
<div class="admonition note"><div class="admonition-title">Note</div><p>이 섹션의 내용은 원문 문서를 참조하세요. (<code>teleport-slack-helm.yaml</code>)</p></div>
구성 파일 편집#
Teleport Slack 플러그인에 대해 만들어진 구성 파일을 열고 다음 필드를 업데이트합니다:
[teleport]
Slack 플러그인은 이 섹션을 사용하여 Teleport 클러스터에 연결합니다:
Executable or Docker
addr: Teleport Proxy Service 또는 Teleport Enterprise Cloud 계정의 호스트명과
HTTPS 포트를 입력합니다(예: teleport.example.com:443 또는
mytenant.teleport.sh:443).
identity: 앞서 내보낸 identity 파일의 경로를 입력합니다.
client_key, client_crt, root_cas: 이 구성에서는 사용하지 않으므로
주석 처리합니다.
Helm Chart
address: Teleport Proxy Service 또는 Teleport Enterprise Cloud 테넌트의 호스트명과
HTTPS 포트를 입력합니다(예: teleport.example.com:443 또는
mytenant.teleport.sh:443).
identitySecretName: identitySecretName 필드에 앞서 생성한 Kubernetes secret의
이름을 입력합니다.
identitySecretPath: identitySecretPath 필드에 Kubernetes secret 내 identity
파일의 경로를 입력합니다. 위 지침을 따랐다면 identity가 됩니다.
Linux 서버에서 실행되는 tbot 바이너리를 사용하여 플러그인에 자격 증명을
제공하는 경우, identity 값이 tbot이 생성하도록 구성한 신원 파일의 경로인
/opt/machine-id/identity와 동일한지 확인하십시오.
플러그인이 만료된 자격 증명으로 Teleport Auth Service에 연결을 시도하지 않도록 신원 파일을 주기적으로 다시 로드하도록 플러그인을 구성하십시오.
구성의 teleport 섹션에 다음을 추가하십시오:
refresh_identity = true
[slack]
token: https://api.slack.com/apps를 열고, 이전에 만든 Slack 앱을 찾아 "OAuth & Permissions" 탭으로 이동하여 "Bot User OAuth Token"을 복사하고 이 필드에 붙여넣습니다.
[role_to_recipients]
role_to_recipients 맵은 사용자가 특정 역할에 대한 접근을 요청할 때 Slack 플러그인이 알릴 채널을 구성합니다. Slack 플러그인이 Auth Service에서 접근 요청을 받으면 요청된 역할을 조회하고 알릴 Slack 채널을 식별합니다.
다음은 role_to_recipients 맵의 예시입니다. 각 값은 단일 문자열 또는 문자열 배열일 수 있습니다:
[role_to_recipients]
"*" = "admin-slack-channel"
"dev" = ["dev-slack-channel", "admin-slack-channel"]
"dba" = "alex@gmail.com"
Helm Chart에서 role_to_recipients 필드는 roleToRecipients라고 하며 키는 문자열이고 값은 문자열 배열인 다음 형식을 사용합니다:
roleToRecipients:
"*": ["admin-slack-channel"]
"dev":
- "dev-slack-channel"
- "admin-slack-channel"
"dba": ["alex@gmail.com"]
role_to_recipients 맵에서 각 키는 Teleport 역할 이름입니다. 각 값은 알릴 Slack 채널(또는 채널들)을 구성합니다. 각 문자열은 Slack 채널 이름(사용자의 직접 메시지 채널 포함) 또는 Slack 사용자의 이메일 주소여야 합니다. 수신자가 이메일 주소인 경우 Slack 플러그인은 해당 이메일 주소를 사용하여 직접 메시지 채널을 조회합니다.
role_to_recipients 맵에는 "*" 항목도 포함되어야 합니다. 주어진 역할 이름과 일치하는 다른 항목이 없는 경우 플러그인이 이를 조회합니다. 위의 예에서 dev와 dba 외의 역할 요청은 admin-slack-channel 채널에 알립니다.
제안된 검토자
사용자는 접근 요청을 만들 때 검토자를 제안할 수 있습니다:
$ tsh request create --roles=dbadmin --reviewers=alice@example.com,ivan@example.com
접근 요청에 제안된 검토자가 포함된 경우 Slack 플러그인은 이를 알릴 채널 목록에 추가합니다. 제안된 검토자가 이메일 주소인 경우 플러그인은 해당 주소의 직접 메시지 채널을 조회하여 해당 채널에 메시지를 게시합니다.
role_to_recipients 구성에 다음을 추가하여 사용자가 editor 역할을 요청할 때 알리도록 Slack 플러그인을 구성합니다(TELEPORT_USERNAME을 이전에 editor-reviewer 역할을 할당한 사용자로 교체):
[role_to_recipients]
"*" = "access-requests"
"editor" = "TELEPORT_USERNAME"
roleToRecipients:
"*": "access-requests"
"editor": "TELEPORT_USERNAME"
Slack 워크스페이스에 access-requests 채널을 만들거나 "*" 키의 값을 기존 채널로 변경합니다.
Slack 앱 초대#
접근 요청을 받을 때 Slack 플러그인이 알릴 채널을 구성한 후 플러그인이 해당 채널에 게시할 수 있도록 해야 합니다.
이미 플러그인이 Slackbot으로 직접 메시지를 보내도록 구성했습니다. role_to_recipients 맵에 언급된 다른 채널의 경우 해당 채널에 플러그인을 초대해야 합니다. 각 채널로 이동하여 메시지 상자에 /invite @teleport를 입력합니다.
7/8단계. Slack 앱 테스트#
Teleport가 실행 중이고 Slack 앱을 만들었으며 플러그인이 구성된 후 플러그인을 실행하고 워크플로를 테스트할 수 있습니다.
플러그인을 시작합니다:
$ teleport-slack start
모든 것이 정상적으로 작동하면 로그 출력은 다음과 같아야 합니다:
$ teleport-slack start
INFO Starting Teleport Access Slack Plugin 7.2.1: slack/app.go:80
INFO Plugin is ready slack/app.go:101
플러그인을 실행합니다:
$ docker run -v <path-to-config>:/etc/teleport-slack.toml public.ecr.aws/gravitational/teleport-plugin-slack:(=teleport.version=) start
플러그인을 설치합니다:
$ helm upgrade --install teleport-plugin-slack teleport/teleport-plugin-slack --values teleport-slack-helm.yaml
플러그인 로그를 확인하려면 다음 명령을 사용합니다:
$ kubectl logs deploy/teleport-plugin-slack
teleport-slack-helm.yaml에서 log.severity를 DEBUG로 설정하고 위의 helm upgrade ... 명령을 다시 실행하여 디버그 로그를 활성화할 수 있습니다. 그런 다음 다음 명령으로 플러그인을 재시작할 수 있습니다:
$ kubectl rollout restart deployment teleport-plugin-slack
다음 단계에 따라 접근 요청을 만들고 플러그인이 예상대로 작동하는지 확인합니다.
접근 요청 만들기#
As an Admin
Teleport 관리자는 tctl을 사용하여 다른 사용자를 위한 Access Request를 생성할 수 있습니다:
$ tctl request create myuser --roles=editor
As a User
사용자는 tsh를 사용하여 Access Request를 생성하고 승인된 역할로 로그인할 수 있습니다:
$ tsh request create --roles=editor
Seeking request approval... (id: 8f77d2d1-2bbf-4031-a300-58926237a807)
From the Web UI
사용자는 Web UI에서 "Identity"로 이동하여 "Access Requests"를 클릭한 다음 "New Request"를 클릭하여 액세스를 요청할 수 있습니다:

이전에 요청을 검토하도록 구성한 사용자는 Slack에서 "Teleport"로부터 Teleport Web UI의 링크를 방문하여 요청을 승인하거나 거부할 수 있는 직접 메시지를 받아야 합니다.
요청 해결#
Access Request 메시지를 받으면 링크를 클릭하여 Teleport로 이동한 후 요청을 승인하거나 거부하십시오:

명령줄에서 검토하기
명령줄에서도 Access Request를 검토할 수 있습니다:
As an Admin
# Replace REQUEST_ID with the id of the request
$ tctl request approve REQUEST_ID
$ tctl request deny REQUEST_ID
As a User
# Replace REQUEST_ID with the id of the request
$ tsh request review --approve REQUEST_ID
$ tsh request review --deny REQUEST_ID
요청이 해결되면 Slack 봇은 요청이 승인되었는지 거부되었는지에 따라 접근 요청의 Slack 메시지에 ✅ 또는 ❌ 이모지 반응을 추가합니다.
Slack 플러그인이 채널에 접근 요청 알림을 게시하면 채널에 접근할 수 있는 누구든지 알림을 보고 링크를 따라갈 수 있습니다. 사용자가 접근 요청을 검토하려면 Teleport 역할을 통해 권한이 부여되어야 하지만, 올바른 사용자가 올바른 요청을 검토하고 있는지 확인하기 위해 Teleport 감사 로그를 확인해야 합니다.
접근 요청 검토를 감사할 때 Teleport Web UI에서 Access Request Reviewed 유형의 이벤트를 확인합니다.
8/8단계. systemd 설정#
이 섹션은 Linux 호스트에서 Teleport Slack 플러그인을 실행하는 경우에만 관련이 있습니다.
프로덕션에서는 systemd와 같은 init 시스템을 통해 Teleport 플러그인 데몬을 시작하는 것이 좋습니다. 다음은 systemd용 권장 Teleport 플러그인 서비스 유닛 파일입니다:
<div class="admonition note"><div class="admonition-title">Note</div><p>이 섹션의 내용은 원문 문서를 참조하세요. (<code>teleport-slack.service</code>)</p></div>
이 파일을 /usr/lib/systemd/system/ 또는 systemd에서 지원하는 다른 유닛 파일 로드 경로에 teleport-slack.service로 저장합니다.
플러그인을 활성화하고 시작합니다:
$ sudo systemctl enable teleport-slack
$ sudo systemctl start teleport-slack
문제 해결#
이 섹션의 내용은 원문 문서를 참조하세요. (access-plugin-troubleshooting.mdx)