브라우저 MFA
Teleport v18.11요약
브라우저 MFA를 사용하면 tsh, tctl, Teleport Connect 사용자가 WebAuthn 장치를 사용하여 브라우저에서 MFA 확인을 완료할 수 있습니다. 이 가이드에서는 Teleport 클러스터에서 브라우저 MFA를 활성화하고, 브라우저를 사용하여 Teleport에 사용자를 인증합니다.
브라우저 MFA를 사용하면 tsh, tctl, Teleport Connect 사용자가 WebAuthn 장치를 사용하여
브라우저에서 MFA 확인을 완료할 수 있습니다. 사용자가 등록한 유일한 MFA 장치가 브라우저 기반
장치(예: 패스키 또는 Touch ID)여서 CLI를 통한 인증이 아예 불가능한 경우에 특히 유용합니다.
사용 예시는 다음과 같습니다.
# Login to a cluster
$ tsh login --proxy example.teleport.sh --user alice --mfa-mode=browser
# SSH in to a node
$ tsh ssh --mfa-mode=browser alice@node
# Add a new MFA device
$ tsh mfa add --mfa-mode=browser
# Edit a Teleport resource
$ tctl edit --mfa-mode=browser cluster_auth_preference
이 가이드에서는 Teleport 클러스터에서 브라우저 MFA를 활성화하고, 브라우저를 사용하여 Teleport에 사용자를 인증합니다.
작동 방식#
브라우저 MFA 흐름에서는 사용자가 MFA가 필요한 명령을 실행하지만 브라우저 기반 WebAuthn 장치
(패스키 또는 Touch ID 등)만 등록되어 있습니다. CLI 도구가 Teleport에 MFA 챌린지를 요청한 다음
사용자의 브라우저를 /web/mfa/browser/[request_id] 로 열면, 사용자는 여기에서 챌린지를 완료하라는
안내를 받습니다. 브라우저가 WebAuthn 검증을 수행하고, 응답은 CLI 도구가 생성한 비밀 키로 암호화됩니다.
암호화된 응답은 CLI 도구가 실행하는 로컬 콜백 서버로 전달되며, 콜백 서버는 이를 복호화하여
원래 명령을 완료하는 데 사용합니다.
사전 요구 사항#
- WebAuthn이 구성된 Teleport Cloud 또는 셀프 호스팅 클러스터.
WebAuthn 활성화
WebAuthn 지원을 활성화하려면 cap.yaml 파일을 만들거나
tctl get cluster_auth_preference로 기존 구성을 가져옵니다.
kind: cluster_auth_preference
version: v2
metadata:
name: cluster-auth-preference
spec:
type: local
second_factors: ["webauthn"]
webauthn:
rp_id: example.teleport.sh
구성을 업데이트합니다.
$ tctl create -f cap.yaml
# cluster auth preference has been updated
tsh바이너리가 설치된 머신과 WebAuthn을 지원하는 웹 브라우저.
Mac
`tsh`가 포함된, 서명된 Teleport용 macOS .pkg 설치 프로그램을 다운로드합니다.
Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다:
```code
$ curl -O https://cdn.teleport.dev/teleport-(=teleport.version=).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 tsh.exe to your %PATH%
# NOTE: Do not place tsh.exe 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 바이너리에는 `tsh`가 포함되어 있습니다. 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
```
1/2단계. 구성#
WebAuthn이 구성된 Teleport 클러스터는 추가 구성 없이도 자동으로 브라우저 MFA를 사용할 수 있습니다.
대안: 브라우저 MFA 비활성화
클러스터에서 브라우저 MFA를 허용하지 않으려면 구성에
allow_cli_auth_via_browser: false를 추가합니다.
cap.yaml 파일을 만들거나 tctl get cluster_auth_preference로 기존 구성을 가져옵니다.
kind: cluster_auth_preference
version: v2
metadata:
name: cluster-auth-preference
spec:
type: local
second_factors: ["webauthn"]
webauthn:
rp_id: example.teleport.sh
allow_cli_auth_via_browser: false # disable Browser MFA
구성을 업데이트합니다.
$ tctl create -f cap.yaml
# cluster auth preference has been updated
2/2단계. 브라우저를 통해 인증#
MFA가 필요한 명령을 실행합니다. 예를 들어 tsh를 사용하여 클러스터에 로그인합니다.
$ tsh login --proxy example.teleport.sh --user alice --mfa-mode=browser
# Enter password for Teleport user alice:
# If browser window does not open automatically, open it by clicking on the link:
# http://127.0.0.1:51697/d658314e-68f0-4ad4-be79-0181e6e0dae5
웹 브라우저 창이 자동으로 열립니다. 열리지 않으면 tsh가 출력한 URL을 클릭하거나 복사하여
붙여 넣습니다. 브라우저에서 MFA 검증 과정을 완료하라는 안내가 표시됩니다. 검증에 성공하면
명령을 실행한 쪽이 인증되어 계속 진행할 수 있습니다.
--mfa-mode 플래그는 선택 사항입니다. 생략하면 기본값인 auto로 동작하며,
성공할 때까지 다음 순서대로 각 인증 모드를 시도합니다.
- WebAuthn(사용 가능한 경우 TOTP 포함)
- SSO
- 브라우저 MFA
- TOTP
Windows에서는 CLI 애플리케이션에서 플랫폼 WebAuthn 인증기(Windows Hello 등)를 기본적으로
지원하므로 브라우저 MFA를 자동으로 시도하지 않습니다. Windows에서 브라우저 MFA를 사용하려면
--mfa-mode=browser를 명시적으로 전달합니다.