InfoGrab DocsInfoGrab Docs

JetBrains SFTP

요약

PyCharm, GoLand, IntelliJ와 같은 JetBrain의 IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. 이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 보여줍니다.

PyCharm, GoLand, IntelliJ와 같은 JetBrain의 IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. IDE에 Teleport를 통합하면 타사 클라이언트를 사용하지 않고도 원격 머신과 파일을 주고받을 수 있습니다.

이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 보여줍니다.

작동 방식#

JetBrains IDE는 로컬 SSH 클라이언트를 사용하여 원격 서버에 접근할 수 있습니다. Teleport를 사용하면 로컬 SSH 클라이언트가 Teleport에서 발급한 OpenSSH 인증서를 사용하여 Teleport로 보호되는 Linux 서버에 연결하도록 지시하는 구성을 생성할 수 있습니다.

사전 요구사항#

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

  • `tsh` client.

    Installing \`tsh\` client
    1. Teleport 클러스터의 버전을 확인합니다. `tsh` client는 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. 사용 중인 플랫폼에 대한 지침에 따라 `tsh` client를 설치합니다:

Mac

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

     Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다.
 
     
Warning
       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 \`tsh\` client to your %PATH%
     # NOTE: Do not place the \`tsh\` client 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\` client가 포함되어 있습니다.  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
     ```
   

 
  • PyCharm, IntelliJ, GoLand 등의 JetBrains IDE. JetBrains IDE의 전체 목록은 Products를 참조하세요.
  • 하나 이상의 Teleport SSH 서비스 인스턴스. 아직 설정하지 않았다면 시작 가이드를 참조하여 방법을 알아보세요.

1/3단계. 최초 설정#

로컬 SSH 클라이언트를 서버에 접근할 수 있도록 구성합니다. 이때 --proxy 플래그에는 Teleport 프록시 서비스의 주소를 지정합니다(예: Teleport Cloud 사용자의 경우 mytenant.teleport.sh).

# 프록시에 로그인:
$ tsh login --proxy proxy.foo.example.com --user alice

# 프록시용 OpenSSH 구성 생성:
$ tsh config --proxy proxy.foo.example.com

생성된 구성 스니펫을 아래 경로에 있는 SSH 구성 파일에 추가합니다.

$HOME/.ssh/config

%UserProfile%\.ssh\config

<div class="admonition warning"><div class="admonition-title">Warning</div>

Windows에서 PowerShell을 사용하여 SSH 구성을 작성하는 경우, 일반적인 셸 리디렉션은 파일을 잘못된 인코딩으로 작성할 수 있습니다. 올바르게 작성되도록 하려면 다음을 시도하세요.

  ```code
  $ tsh.exe config | out-file .ssh\config -encoding utf8 -append
  ```

다음 명령을 사용하여 원하는 서버에 연결할 수 있어야 합니다. 이때 user는 서버에서 사용하고자 하는 사용자 이름으로 바꿉니다.

$ ssh user@[server name].[cluster name]
Teleport Cloud 앞서 생성한 SSH 구성은 SSH 클라이언트가 `tsh proxy ssh`를 실행하여 Teleport 클러스터의 서버에 접근하도록 지시합니다. 하지만 `yourtenant.teleport.sh`의 Teleport 프록시 서비스에 대해 `ssh` 명령을 실행하면 오류가 발생합니다.
Note

오류를 방지하려면 OpenSSH 서버의 기본 포트 번호(22)를 포함하세요. 자세한 내용은 OpenSSH 가이드를 참조하세요. OpenSSH 서버에 연결하는 예시:

$ ssh -p 22 user@[server name].[cluster name]

2/3단계. JetBrains IDE 구성#

IDE를 연 후 Tools -> Deployment -> Browse Remote Host로 이동합니다.

Deployment

그런 다음 왼쪽 상단 모서리의 더하기 기호를 클릭하여 새 서버를 추가합니다.

Add server

새 서버의 이름을 입력합니다.

New Deployment

위 그림에서와 같이 SSH configuration 옆의 점 세 개를 클릭합니다.

SSH Configuration

왼쪽 상단의 더하기 기호를 클릭하여 새 구성을 만들고 다음을 입력합니다.

Authentication type으로는 OpenSSH config and authentication agent를 선택합니다. 그런 다음 Test Connection을 클릭할 수 있습니다.

Successfully Connected

3/3단계. 원격 호스트 탐색#

SSH 구성 창을 닫으면 IDE에서 Remote Host 메뉴가 표시됩니다.

Browse window

Note

Teleport의 인증서는 비교적 빨리 만료되며, 만료 후 SSH 시도는 다음과 같은 오류와 함께 실패합니다.

alice@proxy.foo.example.com: Permission denied (publickey).
ERROR: exit status 255

kex_exchange_identification: Connection closed by remote host

이 오류가 표시되면 tsh login을 다시 실행하여 로컬 인증서를 갱신하세요.

다음 단계#

OpenSSH 클라이언트 사용#

이 가이드는 tsh config를 사용합니다. 추가 정보는 전용 가이드를 참조하세요.

추가 자료#

JetBrains SFTP

Teleport v18.9
원문 보기
요약

PyCharm, GoLand, IntelliJ와 같은 JetBrain의 IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. 이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 보여줍니다.

PyCharm, GoLand, IntelliJ와 같은 JetBrain의 IDE는 SFTP 프로토콜을 사용하여 원격 서버의 파일을 탐색, 복사, 편집할 수 있습니다. IDE에 Teleport를 통합하면 타사 클라이언트를 사용하지 않고도 원격 머신과 파일을 주고받을 수 있습니다.

이 가이드는 Teleport와 JetBrains IDE를 사용하여 SFTP로 파일에 접근하는 방법을 보여줍니다.

작동 방식#

JetBrains IDE는 로컬 SSH 클라이언트를 사용하여 원격 서버에 접근할 수 있습니다. Teleport를 사용하면 로컬 SSH 클라이언트가 Teleport에서 발급한 OpenSSH 인증서를 사용하여 Teleport로 보호되는 Linux 서버에 연결하도록 지시하는 구성을 생성할 수 있습니다.

사전 요구사항#

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

  • `tsh` client.

    Installing \`tsh\` client
    1. Teleport 클러스터의 버전을 확인합니다. `tsh` client는 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. 사용 중인 플랫폼에 대한 지침에 따라 `tsh` client를 설치합니다:

Mac

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

     Finder에서 `pkg` 파일을 더블 클릭하여 설치를 시작합니다.
 
     
Warning
       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 \`tsh\` client to your %PATH%
     # NOTE: Do not place the \`tsh\` client 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\` client가 포함되어 있습니다.  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
     ```
   

 
  • PyCharm, IntelliJ, GoLand 등의 JetBrains IDE. JetBrains IDE의 전체 목록은 Products를 참조하세요.
  • 하나 이상의 Teleport SSH 서비스 인스턴스. 아직 설정하지 않았다면 시작 가이드를 참조하여 방법을 알아보세요.

1/3단계. 최초 설정#

로컬 SSH 클라이언트를 서버에 접근할 수 있도록 구성합니다. 이때 --proxy 플래그에는 Teleport 프록시 서비스의 주소를 지정합니다(예: Teleport Cloud 사용자의 경우 mytenant.teleport.sh).

# 프록시에 로그인:
$ tsh login --proxy proxy.foo.example.com --user alice

# 프록시용 OpenSSH 구성 생성:
$ tsh config --proxy proxy.foo.example.com

생성된 구성 스니펫을 아래 경로에 있는 SSH 구성 파일에 추가합니다.

$HOME/.ssh/config

%UserProfile%\.ssh\config

<div class="admonition warning"><div class="admonition-title">Warning</div>

Windows에서 PowerShell을 사용하여 SSH 구성을 작성하는 경우, 일반적인 셸 리디렉션은 파일을 잘못된 인코딩으로 작성할 수 있습니다. 올바르게 작성되도록 하려면 다음을 시도하세요.

  ```code
  $ tsh.exe config | out-file .ssh\config -encoding utf8 -append
  ```

다음 명령을 사용하여 원하는 서버에 연결할 수 있어야 합니다. 이때 user는 서버에서 사용하고자 하는 사용자 이름으로 바꿉니다.

$ ssh user@[server name].[cluster name]
Teleport Cloud 앞서 생성한 SSH 구성은 SSH 클라이언트가 `tsh proxy ssh`를 실행하여 Teleport 클러스터의 서버에 접근하도록 지시합니다. 하지만 `yourtenant.teleport.sh`의 Teleport 프록시 서비스에 대해 `ssh` 명령을 실행하면 오류가 발생합니다.
Note

오류를 방지하려면 OpenSSH 서버의 기본 포트 번호(22)를 포함하세요. 자세한 내용은 OpenSSH 가이드를 참조하세요. OpenSSH 서버에 연결하는 예시:

$ ssh -p 22 user@[server name].[cluster name]

2/3단계. JetBrains IDE 구성#

IDE를 연 후 Tools -> Deployment -> Browse Remote Host로 이동합니다.

Deployment

그런 다음 왼쪽 상단 모서리의 더하기 기호를 클릭하여 새 서버를 추가합니다.

Add server

새 서버의 이름을 입력합니다.

New Deployment

위 그림에서와 같이 SSH configuration 옆의 점 세 개를 클릭합니다.

SSH Configuration

왼쪽 상단의 더하기 기호를 클릭하여 새 구성을 만들고 다음을 입력합니다.

Authentication type으로는 OpenSSH config and authentication agent를 선택합니다. 그런 다음 Test Connection을 클릭할 수 있습니다.

Successfully Connected

3/3단계. 원격 호스트 탐색#

SSH 구성 창을 닫으면 IDE에서 Remote Host 메뉴가 표시됩니다.

Browse window

Note

Teleport의 인증서는 비교적 빨리 만료되며, 만료 후 SSH 시도는 다음과 같은 오류와 함께 실패합니다.

alice@proxy.foo.example.com: Permission denied (publickey).
ERROR: exit status 255

kex_exchange_identification: Connection closed by remote host

이 오류가 표시되면 tsh login을 다시 실행하여 로컬 인증서를 갱신하세요.

다음 단계#

OpenSSH 클라이언트 사용#

이 가이드는 tsh config를 사용합니다. 추가 정보는 전용 가이드를 참조하세요.

추가 자료#