INNORIX Guide | SFTP 계정과 배치 전송을 중앙에서 관리하기

시작하기#

기본 개념#

서버와 스크립트에 분산된 SFTP 전송 정보를 중앙으로 모으기

기존 SFTP 자동 전송 환경에서는 서버마다 별도의 계정과 스크립트를 사용하는 경우가 있습니다.

예를 들어 업무 서버마다 서로 다른 SFTP 서버에 접속하거나, 하나의 SFTP 서버를 사용하더라도 계정별로 접근할 수 있는 경로가 다를 수 있습니다.

Server A
   │
   ├── SFTP Account A
   ├── transfer_a.sh
   └── /data/report
          │
          ▼
       SFTP A


Server B
   │
   ├── SFTP Account B
   ├── transfer_b.sh
   └── /data/backup
          │
          ▼
       SFTP B


Server C
   │
   ├── SFTP Account C
   └── batch_transfer.cmd
          │
          ▼
       SFTP C

이 구조에서는 SFTP 계정과 접속 정보, 파일 경로와 실행 방식이 각각의 서버와 스크립트에 연결되어 있을 수 있습니다.

중앙 관리형 Flow로 전환하면 기존 구성 요소를 연결 환경과 전송 작업으로 나누어 관리할 수 있습니다.

                INNORIX
                   │
        ┌──────────┼──────────┐
        ▼          ▼          ▼
    Connection  Connection  Connection
       SFTP A      SFTP B      SFTP C
        │          │          │
        └──────────┼──────────┘
                   │
                   ▼
             Central Flows
                   │
        ┌──────────┼──────────┐
        ▼          ▼          ▼
      Flow A      Flow B      Flow C
        │          │          │
        └──────────┼──────────┘
                   ▼
                Runs

이렇게 하면 SFTP 연결 정보와 실제 파일 전송 작업을 분리할 수 있습니다.

SFTP 계정과 서버 연결은 Connection을 기준으로 관리하고, 실제로 어떤 파일을 어느 경로로 전송할지는 각각의 Flow에서 구성할 수 있습니다.

관리 구조#

SFTP 계정, 전송 경로와 실행 작업의 역할을 분리하기

기존 배치 작업에서는 하나의 스크립트에 여러 정보가 함께 포함될 수 있습니다.

예를 들어 SFTP 서버 주소와 계정 정보, 원본 경로와 대상 경로, 파일 이름 조건이 하나의 스크립트에 정의되어 있을 수 있습니다.

중앙 관리 환경으로 전환할 때는 이를 역할별로 나누어 구성합니다.

기존 구성	중앙 관리 전환
SFTP 서버 주소	SFTP Connection
계정 정보	연결 인증 정보
접근 가능한 경로	연결 및 대상 경로 설정
원본 서버	Source
전송 파일 경로	Source Path
SFTP 저장 위치	Target Path
전송 스크립트	Flow
배치 스케줄러	실행 조건
서버별 로그	Runs 및 실행 기록

예를 들어 하나의 SFTP 서버에 여러 업무 서버가 파일을 전송하는 경우에도 SFTP 연결 자체와 실제 파일 전송 작업을 구분할 수 있습니다.

                    SFTP Connection
                          │
                Account / Authentication
                          │
              ┌───────────┴───────────┐
              ▼                       ▼
         Report Flow              Backup Flow
              │                       │
              ▼                       ▼
        /daily/report           /daily/backup
              │                       │
              └───────────┬───────────┘
                          ▼
                     SFTP Target

이 구조를 사용하면 동일한 SFTP 연결을 사용하는 여러 작업에서 접속 정보를 반복적으로 관리하는 대신, 연결 환경은 공통으로 관리하고 파일 전송 경로와 실행 조건은 Flow별로 구성할 수 있습니다.

전환 흐름#

기존 계정과 배치 작업을 정리한 뒤 중앙 관리 환경으로 옮기기

SFTP 전송을 중앙 관리로 전환할 때는 기존 계정만 등록하는 것으로 끝나지 않습니다.

현재 어떤 서버가 어떤 계정으로 접속하는지, 각 계정이 어느 경로를 사용하는지, 스크립트가 어떤 조건에서 실행되는지를 함께 확인해야 합니다.

전환 과정은 다음과 같이 구성할 수 있습니다.

기존 SFTP 작업 확인
        │
        ▼
계정·서버 관계 정리
        │
        ▼
SFTP Connection 구성
        │
        ▼
Source·Target 경로 설정
        │
        ▼
파일 처리 조건 적용
        │
        ▼
실행 조건 이전
        │
        ▼
테스트 Run
        │
        ▼
결과 확인
        │
        ▼
중앙 관리 전환

초기에는 모든 서버의 배치 작업을 한 번에 중지하기보다, 하나의 서버 또는 특정 업무 경로를 먼저 Flow로 전환해 결과를 확인할 수 있습니다.

이를 통해 기존 SFTP 배치 작업과 동일한 파일이 예상한 대상 경로에 저장되는지 검증한 뒤 전환 범위를 확대할 수 있습니다.

IT 엔지니어#

계정 정리#

서버별 SFTP 계정과 실제 사용 경로를 먼저 확인하기

중앙 관리로 전환하기 전에 현재 운영 중인 SFTP 계정과 서버의 관계를 정리합니다.

같은 계정을 여러 서버에서 사용하는 경우도 있고, 서버나 업무별로 별도의 계정을 사용하는 경우도 있습니다.

따라서 단순히 계정 목록만 확인하는 것이 아니라 계정이 실제로 어떤 서버와 어떤 전송 작업에 사용되는지 함께 확인합니다.

확인 항목	확인 내용
SFTP 서버	접속 대상 서버
SFTP 계정	현재 사용하는 계정
사용 서버	해당 계정으로 접속하는 시스템
Source 경로	파일을 가져오는 위치
Target 경로	SFTP 서버의 저장 위치
파일 조건	파일명, 확장자, 경로 기준
실행 방식	수동, 일정 또는 파일 조건
기존 스크립트	실제 전송 명령과 처리 방식

[제품UI_서버별 SFTP 계정과 Source·Target 경로를 확인하고 Connection 전환 대상을 정리하는 화면]

이 단계에서 더 이상 사용하지 않는 계정이나 중복된 전송 작업을 함께 확인할 수 있습니다.

예를 들어 두 개의 배치 작업이 동일한 Source와 Target을 사용하면서 실행 시간만 다른 경우에는 실제 업무 흐름을 확인한 뒤 하나의 Flow로 정리하거나 실행 조건만 분리해 구성할 수 있습니다.

연결 전환#

SFTP 서버와 인증 정보를 Connection으로 구성하기

계정과 서버의 관계를 정리한 뒤 기존 스크립트에서 사용하던 SFTP 접속 정보를 Connection으로 구성합니다.

Connection에서는 실제 파일을 전송하는 작업과 분리해 어느 SFTP 서버에 어떤 방식으로 연결할 것인지 관리합니다.

┌────────────────────────┐
│    SFTP Connection     │
│                        │
│ Host                   │
│ Port                   │
│ Authentication         │
│ Access Configuration   │
└────────────┬───────────┘
             │
             ▼
      Connection Check
             │
      ┌──────┴──────┐
      ▼             ▼
   Available      Review
      │             │
      ▼             ▼
    Flow        Connection 수정

연결을 구성한 뒤에는 다음과 같은 기준으로 관리할 수 있습니다.

구성 영역	관리 내용
서버 연결	SFTP 접속 대상 관리
인증 정보	계정별 인증 방식 관리
연결 상태	서버 접근 가능 여부 확인
접근 범위	계정별 사용 경로 확인
공통 연결	여러 Flow에서 사용하는 연결 관리

이렇게 구성하면 계정 정보와 전송 작업을 분리할 수 있으므로, 동일한 SFTP 서버를 사용하는 여러 Flow에서 연결 정보를 각각 스크립트에 포함할 필요가 줄어듭니다.

경로 구성#

기존 스크립트의 파일 선택 기준과 SFTP 저장 위치를 Flow로 이전하기

Connection 구성이 완료되면 실제 전송 작업을 Flow로 구성합니다.

Source에서는 기존 스크립트가 확인하던 파일 경로를 지정하고, Target에서는 SFTP 서버의 저장 위치를 설정합니다.

이 과정에서 기존 스크립트에 포함되어 있던 파일 선택 기준도 함께 이전합니다.

┌──────────────────────┐
│ Source Server        │
│                      │
│ /data/export         │
└───────────┬──────────┘
            │
            ▼
     File Selection
            │
      ┌─────┴─────┐
      │           │
   *.csv       *.xml
      │           │
      └─────┬─────┘
            ▼
       INNORIX Flow
            │
            ▼
┌──────────────────────┐
│ SFTP Target          │
│                      │
│ /partner/incoming    │
└──────────────────────┘

예를 들어 기존 스크립트가 /data/export에서 .csv 파일만 선택해 SFTP 서버의 /partner/incoming으로 전송했다면 동일한 조건을 Flow에서 구성할 수 있습니다.

이때 전송 작업은 다음 두 가지 정보를 명확하게 구분합니다.

구분	설정 내용
Connection	어느 SFTP 서버와 계정으로 연결할지
Flow	어떤 파일을 어느 경로로 전송할지

이 구분을 통해 접속 환경이 변경되는 경우에는 Connection을 확인하고, 특정 업무의 파일 경로나 전송 조건이 변경되는 경우에는 해당 Flow를 조정할 수 있습니다.

실행 이전#

서버별 스크립트 실행을 Flow의 실행 조건으로 옮기기

기존 SFTP 전송 작업이 정기적으로 실행되고 있다면 서버의 작업 스케줄러나 cron에서 설정된 실행 조건을 확인합니다.

이후 동일한 실행 기준을 Flow에 적용합니다.

Server Scheduler
       │
       │ 기존 실행 조건 확인
       ▼
┌─────────────────────┐
│ Execution Condition │
└──────────┬──────────┘
           │
           ├── Date / Time
           ├── File Change
           ├── After Transfer
           └── Manual Run
           │
           ▼
        INNORIX Flow
           │
           ▼
         New Run

기존 작업 방식에 따라 실행 조건을 다르게 구성할 수 있습니다.

기존 작업	Flow 실행 방식
매일 지정 시간	Date/Time
매주 반복 실행	반복 일정
새 파일 생성	파일 감지 또는 Sync
이전 전송 완료 후 실행	After Transfer
운영자 직접 실행	Manual Run

예를 들어 기존에 여러 서버의 cron에서 각각 실행하던 SFTP 스크립트를 Flow의 실행 조건으로 이전하면, 실제 파일 전송 작업과 실행 기준을 같은 관리 환경에서 확인할 수 있습니다.

전환 검증#

테스트 Run으로 기존 SFTP 배치와 동일하게 동작하는지 확인하기

Connection과 Flow를 구성한 뒤에는 기존 스크립트를 바로 중지하기보다 테스트 Run을 통해 결과를 확인합니다.

테스트에서는 실제 파일이 올바른 Source에서 선택되었는지, 지정한 SFTP 계정으로 연결되었는지, 대상 경로에 정상적으로 저장되었는지를 확인합니다.

                 Test Run
                    │
       ┌────────────┼────────────┐
       ▼            ▼            ▼
   Connection    Files       Target Path
     Check       Check          Check
       │            │            │
       └────────────┼────────────┘
                    ▼
               Run Result
                    │
           ┌────────┴────────┐
           ▼                 ▼
        Matched           Adjustment
           │                 │
           ▼                 └──▶ Connection / Flow 수정
      Production
      Transition

전환 전에는 다음 항목을 확인합니다.

확인 항목	확인 내용
Connection	올바른 SFTP 서버와 계정으로 연결되었는지
Source	기존 서버와 파일 경로가 정확한지
파일 수	예상한 파일만 선택되었는지
Total Size	전체 전송량이 예상 범위와 일치하는지
Target Path	지정한 SFTP 경로에 저장되었는지
Status	작업이 정상적으로 완료되었는지

파일 조건이나 대상 경로가 기존 작업과 다르게 처리된 경우에는 해당 Flow를 조정한 뒤 다시 테스트할 수 있습니다.

검증이 완료되면 기존 서버의 스크립트 기반 작업을 순차적으로 중앙 관리형 Flow로 전환합니다.

통합 운영#

여러 SFTP 계정과 전송 작업을 Connection과 Runs에서 함께 관리하기

전환이 완료되면 서버마다 개별적으로 스크립트와 로그를 확인하는 대신, 중앙의 Connection과 Flow, Runs를 기준으로 전송 환경을 관리할 수 있습니다.

                 Connections
                      │
        ┌─────────────┼─────────────┐
        ▼             ▼             ▼
     SFTP A        SFTP B        SFTP C
        │             │             │
        └─────────────┼─────────────┘
                      ▼
                     Flows
                      │
          ┌───────────┼───────────┐
          ▼           ▼           ▼
      Daily Job   Backup Job   Partner Job
          │           │           │
          └───────────┼───────────┘
                      ▼
                     Runs
                      │
          ┌───────────┼───────────┐
          ▼           ▼           ▼
      Completed     Failed      Retrying

Runs에서는 다음과 같은 정보를 확인할 수 있습니다.

확인 항목	확인 내용
Flow	어떤 SFTP 전송 작업인지
Connection	어떤 연결 환경을 사용하는지
Source	파일을 가져온 시스템과 경로
Target	SFTP 서버와 저장 위치
Total Files	처리한 파일 수
Total Size	전체 전송량
Status	완료, 실패 또는 재시도 상태
Started	작업 시작 시간
Completed	작업 완료 시간

문제가 발생한 경우에는 해당 Run의 상세 정보를 기준으로 Connection과 Source, Target 경로를 확인하고 필요한 설정을 조정한 뒤 작업을 다시 실행할 수 있습니다.

전환 완료#

서버별 SFTP 스크립트 운영에서 중앙 관리형 전송 구조로 바꾸기

SFTP 계정과 배치 전송을 중앙 관리로 전환하면 기존 서버별 전송 방식의 목적과 파일 흐름을 유지하면서 관리 구조를 정리할 수 있습니다.

전체 전환 과정은 다음과 같습니다.

서버별 SFTP 계정
        │
        ▼
기존 스크립트 확인
        │
        ▼
계정·경로 관계 정리
        │
        ▼
Connection 구성
        │
        ▼
Flow로 전송 조건 이전
        │
        ▼
실행 조건 설정
        │
        ▼
테스트 Run
        │
        ▼
결과 검증
        │
        ▼
중앙 관리 전환

이 레시피를 적용하면 서버별 SFTP 계정 확인 → Connection 구성 → Source·Target 경로 이전 → 파일 처리 조건 설정 → 실행 방식 전환 → 테스트 Run → 결과 검증 → 중앙 운영까지 하나의 전환 과정으로 구성할 수 있습니다.

이를 통해 기존 스크립트에 함께 포함되어 있던 SFTP 접속 정보와 실제 파일 전송 작업을 분리하고, 여러 서버와 계정에서 실행되던 SFTP 배치 작업을 Connection과 Flow, Runs를 중심으로 중앙에서 관리할 수 있습니다.