소스 생성과 연결 설정
소스(Source)는 Foundry와 외부 시스템의 연결을 나타냅니다. Postgres 데이터베이스, S3 버킷, Linux 파일시스템, SAP 인스턴스와 REST API 등이 연결 대상이 될 수 있습니다.
소스를 만들기 전에는 네트워크 경로와 인증 정보를 준비합니다. JDBC 드라이버나 인증서가 필요한 시스템이라면 해당 파일도 준비해야 합니다. 연결을 마친 뒤에는 Data Connection 화면에서 동기화를 구성하여 원하는 데이터를 수집할 수 있습니다.
1. 네트워크 경로 확인
외부 시스템이 Foundry에서 직접 접근 가능한 네트워크에 있고 Foundry의 연결을 받아들일 수 있다면 직접 연결 외부 통신 정책을 구성합니다. 클라우드 Foundry에서는 클라우드 서비스나 SaaS가 대표적인 경우입니다.
별도 네트워크에 있는 시스템에는 Data Connection 에이전트가 필요하며 다음 두 경로를 확보해야 합니다.
- 에이전트 호스트에서 외부 시스템으로 가는 경로.
- 에이전트 호스트에서 Foundry로 가는 경로.
원천 시스템에서 Foundry로 직접 외부 방향 연결을 시작하는 경로는 필요하지 않습니다. 에이전트가 두 대상에 연결을 시작합니다.
필요한 경우 에이전트 준비
Foundry 워커와 에이전트 프록시 정책을 사용하면 에이전트는 네트워크 프록시 역할을 하고 연산은 Foundry에서 수행합니다. 기존 에이전트 워커는 네트워크와 연산을 모두 에이전트 호스트에서 처리합니다.
새 시스템을 추가할 때는 에이전트가 그 시스템에 접근할 수 있는지 확인합니다. 조직의 구성에 따라 에이전트 호스트의 외부 통신 허용, 대상 시스템의 인바운드 허용, 중간 방화벽 규칙과 프록시 설정 등이 필요할 수 있습니다. 기존 에이전트 워커에서 인증서가 필요하면 에이전트의 신뢰 저장소에 적용합니다.
에이전트의 프록시 설정은 Data Connection에서 관리할 수 있습니다. Foundry 워커의 대상 시스템 인증서는 아래의 소스 인증서 설정으로 관리합니다.
외부 통신 정책 구성
Foundry 워커 소스에는 트래픽 경로를 정하는 외부 통신 정책이 필요합니다. Control Panel의 Network egress에서 대상에 맞는 정책을 선택합니다.
| 대상 시스템 | 사용할 정책 |
|---|---|
| Foundry에서 직접 접근 가능 | 직접 연결 정책 |
| Foundry와 별도 네트워크에 위치 | 에이전트 프록시 정책 |
외부 통신을 구성하려면 플랫폼 인스턴스의 Information security officer 역할이 필요합니다. 역할은 Control Panel의 Enrollment permissions에서 확인할 수 있으며, 이 화면을 보려면 Enrollment administrator 역할이 필요합니다.
Network egress가 보이지 않거나 정책을 구성할 권한이 없다면 플랫폼 관리자에게 필요한 정책과 권한을 요청합니다.
2. 인증 정보 준비
일반적으로 대상 시스템에 인증할 사용자 이름과 비밀번호 등의 인증 정보가 필요합니다. Foundry에서 수행할 작업에 필요한 범위로 권한을 제한한 전용 서비스 계정을 사용하는 것이 권장됩니다.
조직의 서비스 계정 발급 절차에 따라 계정을 준비하고, 소스를 구성할 때 입력할 인증 정보를 확보합니다.
3. Data Connection에서 소스 생성
조직이 역할 기반 소스 생성을 활성화했다면 Create Data Connection sources 작업을 포함한 조직 역할이 필요합니다. 기본 동작과 설정 범위는 소스 생성 권한에서 설명합니다.
- 탐색 막대에서 Data Connection을 엽니다.
- Sources 탭을 선택합니다.
- 오른쪽 위의 New source를 선택합니다.
- 연결할 외부 시스템에 맞는 소스 유형을 선택합니다.
- 오른쪽 아래의 Continue를 선택합니다.
새 소스는 Foundry 워커에서 실행하도록 구성됩니다. 기존 에이전트 워커 연결을 옮기려면 워커 전환 절차를 사용합니다.
이름과 프로젝트 지정
소스 이름과 저장할 프로젝트를 선택합니다. 소스마다 프로젝트를 하나씩 만드는 구성이 권장되며, 같은 소스에서 파생되는 데이터셋의 권한도 함께 관리하기 쉽습니다.
Create source and continue를 선택합니다.
외부 통신 정책 선택
다음 설정 화면에서 Use existing policy를 선택하고 미리 만든 정책 이름을 검색합니다.
4. 소스 유형별 상세 설정
연결 URL, 클라우드 리전과 인증 방식 등의 값을 입력합니다. 필요한 항목은 선택한 커넥터에 따라 다릅니다.
JDBC 드라이버
JDBC 소스는 드라이버 업로드와 사용할 Java 클래스의 지정이 필요할 수 있습니다. 기존 에이전트 워커 방식에서는 에이전트가 필요한 드라이버를 사용할 수 있도록 준비해야 합니다.
인증서
인증서의 역할에 따라 입력이 다릅니다.
| 연결 조건 | 필요한 인증서 |
|---|---|
| 자체 서명 인증서 등으로 TLS를 제공하는 시스템 | 외부 서버를 신뢰하기 위한 서버 인증서 |
| Foundry 클라이언트의 신원 증명을 요구하는 mTLS 시스템 | 클라이언트 인증서와 개인 키 |
Foundry 워커 소스에서는 인증서를 소스 자체에 적용합니다.
- Certificates 카드를 펼칩니다.
- Add certificate를 선택합니다. 인증서가 아직 준비되지 않았다면 먼저 Create new certificate를 사용합니다.
- 소스에 연결할 클라이언트 인증서와 서버 인증서 번들을 선택합니다.
이전 방식의 인증서를 사용하던 소스는 Connection details 아래쪽의 More options에서 Configure server certificates (legacy) 또는 Configure client certificates and private key (legacy)를 선택할 수 있습니다.
에이전트 워커 연결은 소스 대신 에이전트에 인증서를 추가합니다. 서버 인증서와 클라이언트 인증서의 차이 및 오류 확인은 연결 문제 조사에서 설명합니다.
인증 정보 입력과 저장
준비한 인증 정보를 입력한 뒤 오른쪽 아래의 Save를 선택합니다. 저장 후에는 배치 동기화 등을 구성하여 데이터를 가져올 수 있습니다.
연결 확인
소스 페이지 오른쪽 패널의 Preview로 연결이 성립하는지 확인합니다. 연결이 예상대로 동작하지 않으면 소스 터미널, 외부 통신 로그와 인증서 진단을 사용합니다.