어댑터 공통 설정

개요

어댑터는 AnyLink의 핵심 컴포넌트로서 다양한 프로토콜을 AnyLink 내부 표준 포맷으로 변환하여 시스템 간 연계를 처리합니다.

현재 지원하는 프로토콜은 다음과 같습니다.

TCP: 소켓 기반의 전문 통신에 사용됩니다.
HTTP: HTTP 기반 API 연계에 사용됩니다.
FTP: 파일 전송 및 파일 기반 연계에 사용됩니다.
FILE: 로컬 파일 시스템 기반의 입출력 처리에 사용됩니다.
DB: 데이터베이스 연동 및 SQL 실행에 사용됩니다.

어댑터 구성

어댑터는 다음과 같은 계층 구조로 구성됩니다.

어댑터

각 프로토콜별 통신을 담당하는 최상위 구성 요소입니다.
- 프로토콜별로 TCP, HTTP, FTP, FILE, DB 어댑터가 존재합니다.
- 엔드포인트 그룹과 엔드포인트를 관리합니다.
엔드포인트 그룹

어댑터 하위에서 여러 엔드포인트 그룹, 엔드포인트를 그룹으로 관리하는 컴포넌트입니다.
- 라우팅 기능을 제공합니다.
- 로드밸런싱 용도로 활용할 수 있습니다.
엔드포인트

엔드포인트 그룹에 속하며 실제 통신을 처리하는 컴포넌트입니다.
- 외부 요청을 수신하는 인바운드 방식과 외부 시스템으로 요청을 전송하는 아웃바운드 방식을 지원합니다.
- 하나의 어댑터 아래에 여러 엔드포인트를 구성할 수 있습니다.

어댑터 설정

어댑터와 하위 구성 요소인 엔드포인트 그룹, 엔드포인트는 AnyLink WebAdmin의 [구성관리] > [프로토콜 관리] 메뉴에서 관리할 수 있습니다.

AnyLink WebAdmin의 메뉴 구성 및 사용 방법은 "AnyLink 관리자 안내서"의 메인 메뉴 구성을 참고합니다.

프로토콜 관리 화면이 열리면 등록된 어댑터 목록이 표시됩니다. 왼쪽 어댑터 목록 영역에는 어댑터가 트리 형식으로 표시되며, 하위 엔드포인트 그룹과 엔드포인트를 계층 구조로 확인할 수 있습니다. 오른쪽 탭 편집기 영역에는 어댑터 목록 테이블이 표시됩니다.

어댑터 목록에서 특정 어댑터를 선택하면, 탭 편집기 영역에 선택한 어댑터의 상세 화면이 표시됩니다. 어댑터 상세 화면은 기본 정보 영역과 하단의 [엔드포인트 그룹], [엔드포인트], [변경 이력] 탭으로 구성됩니다.

각 탭에서 어댑터에 속한 엔드포인트 그룹 목록, 엔드포인트 목록과 어댑터에 추가, 수정, 삭제된 리소스의 이력을 확인할 수 있습니다.

화면 하단의 [편집] 버튼을 클릭하여 편집 모드로 전환한 후, 설정 정보를 수정할 수 있습니다.

어댑터 생성

어댑터 목록 영역에서 최상단의 ALL을 우클릭하거나 더보기 버튼(⋮)을 클릭하면 컨텍스트 메뉴가 표시됩니다.

메뉴에서 원하는 프로토콜을 선택하면 화면 오른쪽 탭 편집기 영역에 어댑터 생성 화면이 표시됩니다.

다음은 어댑터의 공통 설정 항목에 대한 설명입니다. (*: 필수 설정 항목)

항목	설명
어댑터 아이디 *	어댑터의 고유 식별자입니다. 영문, 숫자 및 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.
어댑터 이름	어댑터의 표시 이름을 입력합니다. 2~32자 이내로 입력해야 하며, 한글, 영문, 숫자 및 다음 특수문자를 사용할 수 있습니다. 미입력 시 아이디 값으로 자동 설정됩니다. * 언더스코어(_), 하이픈(-), 대괄호([]), 중괄호({}), 괄호(()), 쉼표(,), 콜론(:)
어댑터 종류	선택한 프로토콜이 표시됩니다.
설명	생성할 어댑터에 대한 설명을 입력합니다.

항목

설명

어댑터 아이디 *

어댑터의 고유 식별자입니다. 영문, 숫자 및 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.

어댑터 이름

어댑터의 표시 이름을 입력합니다. 2~32자 이내로 입력해야 하며, 한글, 영문, 숫자 및 다음 특수문자를 사용할 수 있습니다. 미입력 시 아이디 값으로 자동 설정됩니다.

* 언더스코어(_), 하이픈(-), 대괄호([]), 중괄호({}), 괄호(()), 쉼표(,), 콜론(:)

어댑터 종류

선택한 프로토콜이 표시됩니다.

설명

생성할 어댑터에 대한 설명을 입력합니다.

설정 항목을 입력하고 화면 하단의 [생성] 버튼을 클릭하면 하면 [배포 사유 입력] 다이얼로그가 표시됩니다.

입력한 배포 사유는 어댑터의 배포 이력에서 확인할 수 있습니다.

어댑터가 생성되면 어댑터 목록 영역에 생성된 어댑터가 추가되고 탭 편집기 영역에 해당 어댑터의 상세 화면이 표시됩니다.

엔드포인트 그룹 설정

엔드포인트 그룹은 어댑터 상세 화면에서 관리할 수 있습니다. 어댑터 목록에서 원하는 어댑터를 클릭하면 상세 화면이 표시됩니다.

화면 하단의 [편집] 버튼을 클릭하여 편집 모드로 전환한 후, [엔드포인트 그룹] 탭에서 설정 정보를 수정하고 [저장] 버튼을 클릭합니다.

엔드포인트 그룹 생성

엔드포인트 그룹을 생성하려면 어댑터 상세 화면의 [엔드포인트 그룹] 탭에서 [+ 생성] 버튼을 클릭하거나, 어댑터 목록에서 특정 어댑터를 우클릭하거나 더보기 버튼(⋮)을 클릭하면 표시되는 컨텍스트 메뉴에서 [엔드포인트 그룹 생성] 메뉴를 선택합니다.

[엔드포인트 그룹 생성] 탭이 표시되면 설정 항목을 입력하고 [생성] 버튼을 클릭합니다.

다음은 엔드포인트 그룹 설정 항목에 대한 설명입니다.

항목	설명
엔드포인트 그룹 아이디 *	생성할 엔드포인트 그룹의 고유 식별자입니다. 영문, 숫자, 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.
엔드포인트 그룹 이름	엔드포인트 그룹의 표시 이름을 입력합니다. 미입력 시 아이디 값으로 자동 설정됩니다.
라우팅 방식	엔드포인트 그룹으로 요청이 들어왔을 때 요청을 전달할 엔드포인트를 결정합니다. None: 라우팅 기능을 사용하지 않습니다. 관리 목적으로만 사용됩니다. Round Robin: 등록된 엔드포인트에 요청을 순차적으로 분배합니다.
설명	생성할 엔드포인트 그룹에 대한 설명을 입력합니다.

항목

설명

엔드포인트 그룹 아이디 *

생성할 엔드포인트 그룹의 고유 식별자입니다. 영문, 숫자, 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.

엔드포인트 그룹 이름

엔드포인트 그룹의 표시 이름을 입력합니다. 미입력 시 아이디 값으로 자동 설정됩니다.

라우팅 방식

엔드포인트 그룹으로 요청이 들어왔을 때 요청을 전달할 엔드포인트를 결정합니다.

None: 라우팅 기능을 사용하지 않습니다. 관리 목적으로만 사용됩니다.
Round Robin: 등록된 엔드포인트에 요청을 순차적으로 분배합니다.

설명

생성할 엔드포인트 그룹에 대한 설명을 입력합니다.

엔드포인트 설정

엔드포인트는 어댑터 상세 화면에서 관리할 수 있습니다. 어댑터 목록에서 원하는 어댑터를 클릭하면 상세 화면이 표시됩니다.

화면 하단의 [편집] 버튼을 클릭하여 편집 모드로 전환한 후, [엔드포인트] 탭에서 설정 정보를 수정하고 [저장] 버튼을 클릭합니다.

엔드포인트 생성

엔드포인트 생성 시 먼저 통신 방향을 선택해야 합니다. 엔드포인트는 외부 요청을 수신하는 인바운드 방식과 외부 시스템으로 요청을 전송하는 아웃바운드 방식을 지원합니다.

엔드포인트 생성 화면으로 이동하려면 어댑터 목록에서 특정 어댑터 또는 어댑터의 엔드포인트 그룹을 우클릭하거나 더보기 버튼(⋮)을 클릭하여 [엔드포인트 생성] 메뉴를 선택하고 통신 방향에 따라 하위 컨텍스트 메뉴에서 [Inbound] 또는 [Outbound]를 선택합니다.

또는 어댑터 상세 화면의 [엔드포인트] 탭에서 [+ Inbound 생성] 또는 [+ Outbound 생성] 버튼을 클릭합니다.

엔드포인트의 상세 설정에 대해서는 각 프로토콜별 어댑터 장을 참고합니다.