1. TadpoleHub Agent에 대하여.

TadpoleHub Agent 는 클라이언트 툴(CLI, MySQL Workbench, DataGrip, DBeaver 등)로 데이터베이스(MySQL, MariaDB, 호환데이터베이스 AWS Aurora등, MongoDB)를 사용할 수 있도록 해주는 프로그램입니다. 프락시 서버 방식으로 사용자 컴퓨터에서 직접 데이터베이스에 접속할수 없는 상황에서 테드폴디비허브 서버를 통해 데이터베이스를 접속하도록 해줍니다.

전체 그림

image-20240107-120744.png

 

테드폴허브에서 제공하는 에이전트를 설치하세요. 에이전트가 프락시 서버 역할을 하고 있습니다.
사용자는

  1. 자신의 컴퓨터에 설치된 테드폴허브 에이전트(프락시 서버)가 MySQL 서버라고 생각하고 접속하면

  2. 에이전트(프락시 서버)가 테드폴디비허브 프락시 서버에 접속하여 정상(권한 검사, 감사로그 저장 등…) 사용자라면

  3. 실제 MySQL로 접속하여

  4. 사용자가 요청한 쿼리의 결과를 리턴합니다.

사전 조건

  • 테스트는 Windows 10과 Mac(Intel, silicon, 실제로는 intel 빌드)에서 테스트 되었습니다.

 

제약 조건

  • compression protocol 모드를 지원하지 않습니다.

  • SSL protocol 을 지원하지 않습니다.
    사용하는 클라이언트에서 제약사항을 확인해야합니다. (하단에 툴의 설정 방법이 있습니다)

  • 테드폴디비허브의 컬럼 마스킹, 결제, 명령어 차단, 오브젝트 권한관리 기능, 데이터변경행수값등은 지원하지 않습니다.

다운로드

테드폴디비허브에서 메뉴 → 도움말 → Tadpole DB Hub에 대하여에서 다운로드 받으십시오.

image-20240107-124509.png

 

실행환경에 맞추어 다운로드하여 설치하십시오.

실행하면 시스템 트레이에 아이콘이 보입니다..

테드폴허브 아이콘을 클릭하면 팝업창이 나옵니다.

 

  1. 로그인 : 사용하기 위해서는 로그인 해야합니다.

     

이름

내용

비고

이름

내용

비고

테드폴디비허브 URL

접속하고자 하는 테드폴디비허브 URL

 

아이디

사용자 아이디

 

패스워드

사용자 패스워드

 

아이피

로컬 컴퓨터 아이피

테드폴디비허브 어드민이 허락한 아이피(설정하지 않았다면 모두 허용)

  1. 프록시 서버 목록 : 접속 가능한 서버의 목록이 나옵니다.

서버에 정상 접속하면 접속 가능한 프록시 정보가 나옵니다.
아래의 정보라면 다음과 같습니다.

이름

내용

비고

이름

내용

비고

테드폴디비허브 URL

접속한 테드폴디비허브 정보

 

그룹 이름

테드폴디비허브 상의 그룹 이름

 

표시 이름

테드폴디비허브 상의 표시 이름

 

접속 포트

사용자 에이전트 데이터베이스 접속 포트

접속포트 30400 포트라 가정하면, 사용자는 IP는 127.0.01 포트는 30400 으로 데이터베이스 접속을 시도합니다. (주의: localhost로는 접속이 안될수 있습니다.)

실제 서버

실제 사용하게 될 데이터베이스 정보

 

예를 들어 사용자가 DataGrip으로 MySQL 127.0.0.1:3306/tadpoledbhub 데이터베이스를 에이전트로 접속 하고 싶다면 아래 처럼 30400 포트로 접속을 하면 실제로는 3306으로 접속하게 됩니다.

 

접속 방법은 다음과 같습니다.

프로그램

 내용

프로그램

 내용

MySQL CLI

5.x : mysql -uroot -ptadpole  -h 127.0.0.1 -P 20401 --skip-ssl
8.x : mysql -uroot -p -h 127.0.0.1 -P 20401 --ssl-mode=DISABLED

MySQL Workbench

(주의: localhost로는 접속이 안될수 있습니다.) 127.0.0.1로 접속하세요.

 

DataGrip

(주의: localhost로는 접속이 안될수 있습니다.) 127.0.0.1로 접속하세요.

 

 

<span id="pageNum"/>