Google Directory 연결
Google Directory 소스는 Foundry에서 제공하는 JDBC 드라이버로 외부 시스템의 데이터를 테이블로 탐색하고 수집합니다. Data Connection에서 소스의 연결과 인증을 구성한 뒤, 동기화가 실행할 SQL 질의와 출력 데이터셋을 지정합니다.
이 커넥터는 Beta 단계입니다. 플랫폼 인스턴스에서 제공되지 않을 수 있고 개발 중 기능이 변경될 수 있습니다.
지원 기능
| 기능 | 제공 단계 |
|---|---|
| 원천 데이터 탐색 | Beta |
| 배치 동기화 | Beta |
| 증분 수집 | Beta |
| OAuth 2.0 인증 | Beta |
소스 설정
- Data Connection의 +New Source에서 Google Directory 소스를 선택합니다.
- 신규 연결에는 권장 실행 방식인 Foundry 워커를 선택하고 JDBC URL을 구성합니다. 에이전트 워커는 기존 기능 유지 단계(Legacy)이며 고객 관리 호스트의 자원을 사용하고 OAuth 2.0 인증 코드 흐름을 지원하지 않습니다. 사설망 접근이 필요하면 Foundry 워커에 에이전트 프록시를 연결할 수 있습니다.
- 필수 속성을 모두 입력합니다. 권장 속성은 사용하는 인증 방식과 데이터 범위에 맞게 설정합니다.
- 외부 통신 대상을 허용한 뒤 소스를 저장하고 테이블을 탐색합니다.
속성 이름과 값의 대소문자를 유지합니다. 기본값의 미지정은 설정값이 제시되지 않았다는 뜻이며 인증에 필요하지 않다는 뜻은 아닙니다.
| 속성 | 요구 수준 | 의미와 조건 | 기본값 |
|---|---|---|---|
AuthScheme | 권장 | Google Directory 연결에 사용할 인증 방식입니다. | OAuthJWT |
InitiateOAuth | 권장 | OAuth 액세스 토큰을 발급하거나 갱신하는 절차를 지정합니다. 인증과 승인을 마친 사용자의 접근을 유지하는 데 사용합니다. | GETANDREFRESH |
OAuthClientId | 권장 | 사용자 정의 OAuth 애플리케이션을 만들 때 발급한 client ID입니다. consumer key라고도 하며 OAuth 인증 서버에 애플리케이션을 식별합니다. | 미지정 |
OAuthClientSecret | 권장 | 사용자 정의 OAuth 애플리케이션을 만들 때 발급한 client secret입니다. consumer secret이라고도 하며 OAuth 인증 서버에 애플리케이션을 인증합니다. | 미지정 |
OAuthJWTCert | 권장 | JWT 인증서 저장소입니다. | 미지정 |
OAuthJWTCertType | 권장 | JWT 인증서를 담은 키 저장소의 유형입니다. | GOOGLEJSONBLOB |
OAuthJWTSubject | 권장 | 애플리케이션이 위임된 접근을 요청하는 사용자 subject입니다. | 미지정 |
데이터 수집
동기화 하나에서 테이블을 반환하는 SQL 질의 하나를 실행하고 결과를 Foundry 데이터셋에 저장합니다. 원천 탐색에서 보이는 테이블과 열을 사용해 필요한 범위를 선택합니다. CData 드라이버는 실제 질의 전까지 연결을 지연할 수 있으므로 정적 메타데이터가 보인다는 사실만으로 인증이나 네트워크 연결 성공을 판단하지 않습니다.
외부 통신
연결에 필요한 각 대상에 외부 통신 정책(Egress policy)을 추가합니다. 온프레미스 등 Foundry에서 직접 도달할 수 없는 원천이면 에이전트 프록시 정책을 사용하고, 에이전트 호스트에서도 대상에 도달할 수 있어야 합니다. 조건부 대상은 선택한 인증 방식, 리전과 구성값에 맞게 허용합니다.
| 대상 도메인 또는 주소 | 필요 조건 |
|---|---|
| accounts.google.com | OAuth에 항상 필요합니다. |
| googleapis.com | 항상 필요합니다. |
OAuth 2.0 승인
OAuth 2.0 인증 코드 흐름은 Foundry 워커에서만 지원합니다. 소스에 CallbackUrl을 추가하고 자동으로 표시되는 콜백 URL을 외부 애플리케이션에 등록합니다. 발급한 OAuthClientId와 OAuthClientSecret을 설정한 뒤 소스를 저장하고, 소스 개요의 Authorize로 승인합니다. 갱신과 철회는 소스 개요의 오른쪽 패널에서 수행합니다.
기본적으로 승인 시작, 갱신과 철회에는 소스의 Owner 역할이 필요합니다. Viewer 또는 Editor만 있으면 권한 거부 오류가 발생합니다. ConnectOnOpen=true는 이 인증 방식과 함께 사용할 수 없습니다.