SFTP 설정 방법 안내

생성자 Ashish Chaudhary, 수정일 토, 4 10월 시간: 12:48 PM : Ashish Chaudhary

SFTP - 설정 방법 안내

SFTP - 설정 방법 안내

호스팅 및 인증

고객님의 SFTP 폴더는 별도의 SFTP 서버(AWS 기반)에 개별적으로 호스팅됩니다. 각 고객마다 전용 계정이 제공되며, 본인 폴더에 직접 접근할 수 있습니다. 키 기반 인증방식을 지원하므로, 공개키와 개인키를 생성하신 후 공개 키 항목에 공개키를 입력해주셔야 합니다. 공개키는 openSSH RSA 형식이어야 합니다. 키 생성 방법은 아래 SFTP 서버용 공개 SSH 키 생성 방법 을 참고해주세요.

설정

생성하신 공개키를 공개 키 항목에 입력해 주세요. 필요에 따라 사용자 이름 항목도 수정하실 수 있습니다. 사용자 이름 은(는) 반드시 영문자, 숫자 또는 밑줄(_)로 시작해야 하며, 3~100자 이내여야 합니다. 영문자, 숫자, 밑줄, @, 마침표(.), 하이픈(-)을 사용할 수 있습니다.
설정이 완료되면 사용자 이름, Spotnana 도메인 URL, 그리고 포트 번호 값을 안전한 곳에 보관해 주세요. 이 정보는 조직 내에서 파일 전송을 설정하는 담당자가 추후 필요로 하게 됩니다.
참고: SFTP 폴더 설정이 완료된 후에도 해당 값들은 관리메뉴에서 다시 확인하실 수 있습니다.
파일 업로드 보고서를 받을 이메일 주소를 SFTP 이메일 알림 란에 입력해 주세요. 자세한 내용은 아래 보고 및 오류 처리 를 참고하세요.
연결 버튼을 클릭하세요.

공개키가 추가되면, 초기 상태는 미인증으로 표시됩니다. 실제 파일이 폴더에 업로드되기 전까지 OBT 화면에 이 상태가 표시됩니다. 업로드할 파일은 테스트 파일이거나 실제 HR 피드, 또는 커스텀 필드 파일 등 지원되는 형식이면 어떤 파일이든 가능합니다. 또한, 공개키를 변경할 경우에도 상태가 다시 미인증 으로 초기화되며, 다음 파일이 업로드될 때까지 유지됩니다.

SFTP 폴더를 삭제하려면 연결 해제버튼을 클릭하세요. 폴더가 삭제되며, 추후 다시 설정하려면 위에서 안내한 모든 정보를 처음부터 다시 입력하셔야 합니다.

업로드 주기 및 일정 관리

파일 업로드의 주기와 일정은 고객님께서 직접 정하실 수 있습니다. 저희 시스템은 파일이 SFTP 폴더에 업로드되는 즉시 파일 처리를 시작합니다. 즉, 파일을 업로드하시면 바로 처리가 진행됩니다.

각 레코드 유형별(예: 사용자, 커스텀 필드, 법인 등) 권장 업로드 주기 및 일정에 대한 자세한 내용은 레코드 유형별 SFTP 안내서의 업로드 주기 및 일정 관리

보고 및 오류 처리

업로드된 파일 정보를 바탕으로 내부 보고서를 생성하여, 설정 단계에서 입력하신 SFTP 이메일 알림 주소로 전송해 드립니다. 각 파일별로 다음과 같은 내용이 포함됩니다:

파일 업로드 실패 사유(잘못된 형식, 누락된 컬럼명 등)
파일 내 특정 행이 업로드되지 못한 사유. 저희 시스템은 부분 업데이트를 지원하지 않으며, 특정 컬럼에 오류가 있거나 필수 항목이 누락된 행은 전체 업로드에서 제외됩니다.
업로드 상태(대기 중, 성공, 실패)

보고서 내용을 참고하여 오류를 직접 해결하실 수 있습니다. 만약 해결이 어려우시면 기술 지원팀에 문의해 주세요.

변경되거나 추가가 필요한 레코드만 포함된 증분 파일도 업로드가 가능한가요?
- 네
SFTP 또는 수동 업로드 방식에 상관없이, 사용하지 않는 선택 컬럼도 파일에 반드시 포함해야 하나요?
- 아니요

SFTP 서버용 공개 SSH 키 생성 방법

아래 안내에 따라 저희에게 제공하실 공개 SSH 키를 생성하실 수 있습니다.

형식

타입: 문자열
길이 제한: 최대 2048자

패턴

^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

SSH 키 생성

SSH 키를 생성하려면 Windows에서는 명령 프롬프트, macOS·Linux·UNIX에서는 터미널에서 아래 명령어를 실행해 주세요:

ssh-keygen -t rsa -b 4096 -f key_name

여기서

-t : 암호화 방식
-b : 키 길이(비트 단위)
-f : 키 파일 이름

샘플 키

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

레코드 유형별 안내

SFTP를 통해 특정 레코드 유형을 업로드하는 방법은 아래 항목별 안내를 참고해 주세요: