SFTP
Secure File Transfer 프로토콜(SFTP)은 보안 셸(SSH) 데이터 스트림을 통해 데이터 액세스 및 데이터 전송을 처리하는 FTP의 보안 버전입니다.
2026년 3월에 도입된 커넥터 네임스페이스 업데이트의 일환으로, 새로 생성되는 프로젝트에서는 SFTP V1 및 SFTP V2 커넥터가 각각 SFTP V3 및 SFTP V4 로 제공됩니다. 이 업데이트된 버전들은 플랫폼 전반에 도입된 새로운 네임스페이스 규칙을 따릅니다.
기존 계정과 프로젝트는 하위 호환성을 유지하기 위해 계속해서 SFTP V1 및 SFTP V2 를 표시하고 사용할 것입니다. 기존 연동 기능에는 아무런 영향이 없으며, 현재 설정된 계정이나 프로젝트에 대한 변경 사항도 없습니다.
새로 생성된 프로젝트의 경우, 업데이트된 커넥터 버전인 SFTP V3 및 SFTP V4 만 사용할 수 있습니다.
- 워크플로 및 플로우 서비스에서 SFTP 커넥터를 위한 별도의 계정을 만드세요. 또한 SFTP V1 계정과 SFTP V2 계정의 이름은 고유해야 합니다.
- 이 커넥터의 비공개 링크를 사용하여 비공개 VPC에서 연결을 설정할 수 있습니다.
- ‘Deploy Anywhere’ 통합 기능의 SFTP 커넥터에서는 공개 키 인증이 지원되지 않습니다.
워크플로우 조치
파일 업로드: SFTP 서버에 특정 파일을 업로드합니다.
파일 다운로드: SFTP 서버에서 특정 파일을 다운로드합니다.
파일 추가: 특정 로컬 파일을 SFTP 서버의 기존 파일에 추가합니다.
디렉터리 제거: SFTP 서버에서 지정한 디렉터리를 삭제합니다.
디렉터리 만들기: 디렉터리 만들기: SFTP 서버의 지정된 위치에 디렉터리를 만듭니다.
파일 및 폴더 목록 가져오기: SFTP 서버의 지정된 디렉터리에서 파일 및 폴더 목록을 검색합니다.
파일 삭제: SFTP 서버에서 특정 파일을 삭제합니다.
심볼릭 링크 만들기: 특정 파일의 심볼릭 링크를 만듭니다.
파일 또는 폴더 이름 바꾸기: FTP 서버에서 특정 파일 또는 폴더의 이름을 바꿉니다.
소유권 변경: 특정 파일 또는 폴더의 소유권을 변경합니다.
파일 또는 폴더 권한 변경: 특정 파일 또는 폴더의 권한을 변경합니다.
그룹 소유권 변경: 특정 파일 또는 폴더의 그룹 권한을 변경합니다.
플로우 서비스 작업
cd: 원격 SFTP 서버의 작업 디렉터리를 변경합니다.
chgrp: 하나 이상의 원격 파일에 대한 그룹 소유권을 변경합니다.
chmod: 하나 이상의 원격 파일에 대한 권한을 변경합니다.
chown: 하나 이상의 원격 파일의 소유 사용자를 변경합니다.
get: 원격 SFTP 서버에서 특정 파일을 검색합니다.
ls: 권한 및 소유권 등의 세부 정보를 포함하여 지정된 원격 디렉터리의 파일을 나열합니다. 디렉터리를 지정하지 않으면 현재 원격 디렉터리에 있는 파일을 나열합니다.
mkdir: 새 원격 디렉터리를 만듭니다.
put: 원격 SFTP 서버로 파일을 전송합니다.
pwd: SFTP 서버에 원격 작업 디렉터리를 표시합니다.
이름 바꾸기: 원격 SFTP 서버의 파일 또는 디렉터리 이름을 변경합니다.
rm: SFTP 서버에서 하나 이상의 원격 파일을 제거합니다.
rmdir: SFTP 서버에서 하나 이상의 원격 디렉터리를 삭제합니다.
심볼릭 링크: 특정 파일의 이전 경로와 새 경로 사이에 심볼릭 링크를 만듭니다.
자주 묻는 질문
SFTP 커넥터용 계정을 만드는 방법은 무엇인가요?
에 SFTP용 계정을 추가하려면 webMethods Integration :
- SFTP 작업을 캔버스로 끌어다 놓고 작업을 두 번 클릭합니다.
- SFTP 서버에 연결 필드 옆에 있는 '+'를 클릭합니다. 계정 추가 창이 계정 구성 필드와 함께 나타납니다:
- 계정 이름 : SFTP 계정의 이름입니다.
- 호스트 : 호스트: SFTP 서버의 호스트 또는 IP 주소입니다.
- 포트 : 연결하려는 포트 번호입니다.
다음을 사용하여 연결 만들기 : 연결 설정에 사용할 로그인 유형입니다.
로그인 유형으로 로그인 자격 증명을 선택하면 여기에 표시되는 필드가 나열됩니다:
- 사용자 이름 : SFTP 서버의 사용자 이름을 지정합니다.
- 비밀번호 : 지정된 SFTP 서버 사용자 아이디와 연결된 비밀번호를 입력합니다.
- 알고리즘 키 : 연결에 사용되는 기본 전송 계층 알고리즘 키를 명시적으로 재정의할 키를 지정합니다.
- 서버 호스트 키 : 연결에 사용되는 기본 전송 계층 서버 호스트 키를 명시적으로 재정의할 호스트 키를 지정합니다.
- 암호 : 연결에 사용되는 기본 전송 계층 암호를 명시적으로 재정의할 암호를 지정합니다.
- Hmacs : 연결에 사용되는 기본 전송 계층 (H)MAC을 명시적으로 재정의할 (H)MAC 알고리즘을 지정합니다.
- 압축 : 압축: 연결에 사용되는 기본 전송 계층 압축을 명시적으로 재정의할 압축 알고리즘을 지정합니다.
- 준비 시간 초과 : 보안 SSH 연결을 설정하는 데 걸리는 시간(밀리초)을 지정합니다. 기본값은 20000밀리초(20초)입니다.
- 재시도 : 재시도: 보안 SSH 연결을 설정하기 위해 재시도할 최대 횟수를 지정합니다. 이 필드의 기본값은 2입니다.
- 재시도 계 수: 재시도 계수: 재시도 사이의 시간을 계산할 시간 계수를 지정합니다. 이 필드의 기본값은 2입니다.
- 재시도 최소 시간 초과 : 서버가 재시도 시도 사이에 대기할 시간(밀리초)을 지정합니다. 이 필드의 기본값은 2000(2초)입니다.
- 연결 유지 간격 : SSH 수준의 킵얼라이브 패킷을 서버로 전송할 빈도(밀리초)를 지정합니다. 이 옵션을 비활성화하고 세션을 무기한으로 유지하려면 이 필드에 '0'을 지정하세요. 이 필드의 기본값은 0입니다. 예를 들어 이 필드에 값을 3000으로 설정하면 서버가 3초마다 킵얼라이브 패킷을 수신한다는 의미입니다.
- 연결 유지 횟수 최대 : 연결 세션을 중지하기 전에 서버로 전송할 수 있는 응답이 없는 SSH 수준의 연결 유지 패킷의 연속 횟수를 지정합니다. 이 필드의 기본값은 3입니다. 그러나 이 필드는 연결 유지 간격 필드와 함께 사용할 수 있습니다. 예를 들어 연결 유지 간격을 2000(2초)으로 설정하고 연결 유지 횟수를 최대 3으로 설정하면 서버는 연결을 유지하기 위해 2초마다 최대 3회까지 연결 유지 패킷을 수신합니다. 패킷이 세 번 연속 응답되지 않으면 연결 세션이 끊어집니다.
로그인 유형으로 SSH 키를 선택하면 여기에 표시되는 필드가 나열됩니다:
- 사용자 이름 : SFTP 서버의 사용자 이름을 지정합니다.
- SSH 키 : 지정한 사용자 아이디와 연결된 SSH 키의 경로를 입력합니다.
- 암호 구문 : 지정한 사용자 아이디와 연결된 SSH 키의 암호 구문을 입력합니다.
- 알고리즘 키 : 연결에 사용되는 기본 전송 계층 알고리즘 키를 명시적으로 재정의할 키를 지정합니다.
- 서버 호스트 키 : 연결에 사용되는 기본 전송 계층 서버 호스트 키를 명시적으로 재정의할 호스트 키를 지정합니다.
- 암호 : 연결에 사용되는 기본 전송 계층 암호를 명시적으로 재정의할 암호를 지정합니다.
- Hmacs : 연결에 사용되는 기본 전송 계층 (H)MAC을 명시적으로 재정의할 (H)MAC 알고리즘을 지정합니다.
- 압축 : 압축: 연결에 사용되는 기본 전송 계층 압축을 명시적으로 재정의할 압축 알고리즘을 지정합니다.
준비 시간 초과 : 보안 SSH 연결을 설정하는 데 걸리는 시간(밀리초)을 지정합니다. 기본값은 20000밀리초(20초)입니다.
- 재시도 : 재시도: 보안 SSH 연결을 설정하기 위해 재시도할 최대 횟수를 지정합니다. 이 필드의 기본값은 2입니다.
- 재시도 계 수: 재시도 계수: 재시도 사이의 시간을 계산할 시간 계수를 지정합니다. 이 필드의 기본값은 2입니다.
- 재시도 최소 시간 초과 : 서버가 재시도 시도 사이에 대기할 시간(밀리초)을 지정합니다. 이 필드의 기본값은 2000(2초)입니다.
- 연결 유지 간격 : SSH 수준의 킵얼라이브 패킷을 SSH 서버로 전송할 빈도(밀리초)를 지정합니다. 이 옵션을 비활성화하고 세션을 무기한으로 유지하려면 이 필드에 '0'을 지정하세요. 이 필드의 기본값은 0입니다. 예를 들어 이 필드에 값을 3000으로 설정하면 서버가 3초마다 킵얼라이브 패킷을 수신한다는 의미입니다.
- 연결 유지 횟수 최대 : 연결을 끊기 전에 서버로 보낼 수 있는 응답이 없는 연속 SSH 수준의 연결 유지 패킷의 수를 지정합니다. 이 필드의 기본값은 3입니다. 그러나 이 필드는 연결 유지 간격 필드와 함께 사용할 수 있습니다. 예를 들어 연결 유지 간격 필드를 2000(2초)으로 설정하고 연결 유지 횟수 최대 필드를 3으로 설정하면 2초마다 최대 3회까지 서버가 연결 유지 패킷을 수신하여 연결을 유지한다는 의미입니다. 패킷에 연속으로 세 번 응답하지 않으면 연결이 자동으로 끊어집니다.
그런 다음 저장을 클릭합니다. SFTP 커넥터의 계정이 생성됩니다.
SFTP 계정에 대한 오류와 함께 Flow 서비스 실행이 실패하는 이유는 무엇인가요? 호스트 키가 변경되었나요?
SFTP 계정을 만든 후 호스트 키가 변경된 경우, 트랜잭션 실패를 방지하기 위해 계정을 수동으로 업데이트하여 최신 호스트 키를 가져오세요.
워크플로용 SFTP 커넥터의 파일 다운로드( v6 ) 작업에서 사용할 수 있는 다양한 다운로드 방법에는 어떤 것이 있나요?
SFTP 커넥터의 파일 다운로드( v6 ) 작업을 통해 원격 SFTP 서버에서 특정 파일을 다운로드할 수 있습니다. 이 조치에서 사용할 수 있는 방법은 여기에 나열되어 있습니다:
FastGet
FastGet 방법은 원격 서버에서 대용량 파일을 전송하는 데 사용됩니다. 전체 파일이 아닌 파일 청크를 일괄 전송하여 처리량을 높이는 데 중점을 둡니다.
다운로드 방법으로 FastGet 을 선택하면 화면에 다음 필드가 나타납니다:
- 청크 크기 : 워크플로 SFTP 커넥터와 원격 SFTP 서버 간의 데이터 전송을 위한 배치 크기(바이트 단위)를 지정합니다. 기본값은 4096바이트입니다.
- 동시성 : 이 필드에는 동시에 허용할 배치 전송의 수를 지정합니다. 이 필드의 기본값은 1입니다.
참고: 청크 크기, 동시성 및 워크플로 런타임 필드에 구성된 값이 파일 다운로드를 완료하기에 충분하지 않은 경우 워크플로에서 시간 초과 오류가 발생할 수 있습니다. 파일이 800MB이고 청크 크기, 동시성 및 워크플로 런타임이 각각 4096, 1분 및 3분으로 설정된 경우 다운로드가 완료되기 전에 시간 초과가 발생할 수 있습니다.가져오기
Get 메서드는 관련 디렉토리로 이동하여 SFTP 프로토콜을 사용하여 지정된 파일을 원격 서버에서 로컬 시스템으로 전송하는 데 사용됩니다.
추가 정보
| SFTP V1 | 세부사항 |
|---|---|
| 선호하는 키 교환 알고리즘 |
|