커넥션 창의 SSL/SSH 탭은 DB 와의 연결을 암호화하고(SSL/TLS), 바로 접속할 수 없는 DB 에 SSH 서버나 프록시를 거쳐 접속하게 합니다. 암호화와 상대 확인이 왜 다른지, 모드를 어떻게 선택할지는 연결과 실행 대상 의 '보안 연결' 에서 설명합니다. 탭의 항목은 아래에서 설명합니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | SSL/SSH 탭 | 커넥션 창에서 DB에 연결 버튼을 클릭한 뒤에 사용할 수 있습니다. 옆의 숫자는 활성화한 항목(SSL/TLS, SSH Tunnel, 프록시)의 수입니다. |
| 2 | SSL/TLS 스위치 | SSL/TLS 를 활성화합니다. 활성화하면 항목이 펼쳐집니다. SSL 을 지원하는 DBMS 에서 사용합니다. |
| 3 | 모드 칸 | 암호화와 서버 확인을 어디까지 할지 선택합니다. 아래에 선택한 모드의 설명이 보입니다. 처음 활성화하면 Require 모드입니다. |
| 4 | CA 인증서 줄 | 서버 인증서를 확인할 때 믿을 CA 인증서입니다. 업로드 버튼으로 파일을 선택합니다. |
| 5 | 클라이언트 인증서 줄, 클라이언트 키 줄, 클라이언트 키 패스워드 칸 | DB 가 클라이언트 인증서로 사용자를 확인할 때(상호 인증) 넣습니다. 클라이언트 인증서를 지원하는 DBMS 에서만 보입니다. |
- MySQL 과 MariaDB 에는 공개키 조회 허용 항목이 더 있습니다. 물음표 아이콘을 클릭하면 설명이 보입니다.
- 파일을 선택하면 경로가 아니라 파일 내용이 커넥션에 담기고, 줄 옆에 내용 설정됨 표시가 붙습니다. 웹 앱에서도 같은 버튼으로 기기의 파일을 업로드합니다. 인증서를 새로 받으면 다시 업로드하세요. 빨간 버튼으로 삭제합니다.
SSL/TLS 활성화하기
- 커넥션 창에서 SSL/SSH 탭(1)을 엽니다.
- SSL/TLS 스위치(2)를 활성화합니다.
- 모드 칸(3)에서 모드를 선택합니다. 운영 DB 는 Verify Full 모드를 사용하세요. IP 주소나 SSH 터널로 접속하면 Verify CA 모드를 사용합니다.
- 서버를 확인하는 모드이면 DB 서버의 CA 인증서를 CA 인증서 줄(4)에 업로드합니다. 클라우드 DB 는 서비스가 배포하는 CA 묶음 파일을 그대로 사용하면 됩니다.
- 연결 탭의 연결 테스트 버튼으로 접속을 확인하고 저장합니다.
DBMS 마다 선택할 수 있는 것이 다릅니다.
| DBMS | 연결 보안 설정 | 인증서 설정 |
|---|---|---|
| PostgreSQL, MySQL | 다섯 가지 모드를 선택합니다. | 클라이언트 인증서를 사용합니다. |
| MariaDB | Disable, Require, Verify CA, Verify Full 모드를 선택합니다. | 클라이언트 인증서를 사용합니다. |
| SQL Server | Disable, Require, Verify Full 모드를 선택합니다. | 서버 인증서를 검증합니다. |
| Oracle | JDBC URL 에 tcps 프로토콜을 지정합니다. | 클라이언트 인증서를 사용합니다. |
| Snowflake, BigQuery | TLS(HTTPS)로 접속합니다. 이 DBMS 는 항상 TLS(HTTPS)로 암호화해 접속합니다. 끄거나 SSL 모드를 고를 수 없습니다. 안내를 확인합니다. |
- SQL Server 는 인증서를 확인하면 호스트 이름도 늘 확인합니다. IP 나 별칭으로 접속할 때는 속성 탭의
hostNameInCertificate로 인증서의 호스트 이름을 알려 줍니다. - MySQL 5 (Legacy) 드라이버를 선택한 커넥션은 SSL 설정이 드라이버에 전달되지 않습니다. SSL 이 필요하면 기본 드라이버를 사용하세요.
- Oracle 의 호스트 이름 확인은 속성 탭의
oracle.net.ssl_server_dn_match로 정합니다. - DBMS 를 변경했을 때 선택한 모드가 새 DBMS 에 없으면 Require 모드(없으면 목록의 첫 모드)로 변경됩니다.
SSH Tunnel 로 접속하기
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 호스트 칸과 포트 칸 | 거쳐 갈 SSH 서버(배스천 호스트)입니다. 포트는 처음에 22 입니다. |
| 2 | 사용자 칸과 인증 방법 항목 | SSH 서버의 계정입니다. 패스워드 인증과 Public Key 인증 가운데 선택합니다. |
| 3 | 패스워드 칸 | 패스워드 인증에서 넣는 값입니다. Public Key 인증을 선택하면 Private Key 줄과 패스프레이즈 칸이 대신 보입니다. |
| 4 | 포트 포워딩 | 원격 호스트 칸과 원격 포트 칸은 SSH 서버에서 본 DB 의 주소입니다. 비워 두면 연결 탭의 호스트 칸과 포트 칸의 값을 사용합니다. 로컬 포트 칸을 비워 두면 빈 포트를 자동으로 선택합니다. |
| 5 | 고급 | Keep-Alive (초) 칸(처음에 0), 타임아웃 (초) 칸(처음에 30초), 호스트 키 검증 항목(처음에 비활성화)입니다. |
- SSH Tunnel 스위치를 활성화합니다.
- SSH 서버의 주소와 계정(1, 2)을 넣고 인증 방법 항목에 맞게 패스워드 칸이나 Private Key 줄(3)에 값을 넣습니다.
- DB 주소가 SSH 서버에서만 보이는 이름(예: 클라우드 DB 의 내부 엔드포인트)이면 원격 호스트 칸(4)에 DB 주소를 넣습니다.
- 운영 환경이면 호스트 키 검증 항목(5)을 활성화합니다.
- 연결 탭에서 연결 테스트 버튼으로 접속을 확인하고 저장합니다.
- 웹 앱에서는 NeoSQL 서버가 SSH 터널을 엽니다. SSH 서버에 인터넷에서 접속할 수 있어야 합니다.
- 개인 키도 파일 내용이 커넥션에 담깁니다. 웹 앱에서도 업로드할 수 있습니다.
프록시로 접속하기
프록시 스위치를 활성화하면 프록시 서버를 거쳐 DB 에 접속합니다.
| 항목 | 설명 |
|---|---|
| 유형 | SOCKS5(처음 값), SOCKS4, HTTP 가운데 선택합니다 |
| 호스트, 포트 | 프록시 서버의 주소입니다. 포트는 처음에 1080 입니다 |
| 사용자, 패스워드 | 프록시가 인증을 요구할 때 넣습니다 |
무엇이 팀과 함께 사용되는가
계정 프로젝트에서 보안 연결 값은 두 갈래로 저장됩니다.
| 함께 사용하는 값(커넥션 설정) | 팀원마다 따로 넣는 값 |
|---|---|
| SSL/TLS 스위치, 모드 칸, CA 인증서 줄, SSH 서버의 주소, 포트 포워딩 항목과 고급 항목의 설정, 프록시의 유형 칸과 주소 | SSH 의 사용자 칸, 패스워드 칸, Private Key 줄, 패스프레이즈 칸, 프록시의 사용자 칸, 패스워드 칸 |
- 클라이언트 인증서 줄과 클라이언트 키 줄은 연결 탭의 사용자 칸, 패스워드 칸처럼 커넥션에 하나만 저장되어 팀이 함께 사용합니다.
- 로컬 프로젝트는 모든 비밀값이 기기의 OS 보안 저장소에 저장됩니다. 저장 위치는 연결과 실행 대상 의 '접속 정보가 저장되는 곳' 에서 설명합니다.
주의할 점
- Require 모드는 암호화만 하고 상대가 진짜 DB 서버인지 확인하지 않습니다. 운영 DB 에는 CA 인증서를 넣고 Verify CA 모드 이상을 사용하세요.
- 호스트 키 검증 항목이 비활성화되어 있으면 SSH 서버가 변경되어도 알아채지 못합니다.
- SSL 은 SSL/TLS 스위치로 정하세요. URL 이나 속성 탭에 SSL 키를 넣으면 안내가 표시되고, 스위치를 활성화하면 스위치 쪽의 설정이 앞섭니다.
- Databricks 는 늘 TLS 로 접속하므로 SSL/TLS 를 활성화할 필요가 없습니다. 활성화하면 모드 대신 이 DBMS 는 항상 TLS(HTTPS)로 암호화해 접속합니다. 끄거나 SSL 모드를 고를 수 없습니다. 안내가 보입니다.
관련 화면
- 연결과 실행 대상: 암호화와 상대 확인의 차이, 모드를 선택하는 기준입니다.
- 커넥션 만들기와 수정: 커넥션 창의 다른 탭입니다.
- 운영 DB 를 안전하게 연결하기: 보안 연결과 프로파일로 운영 DB 를 연결하는 순서입니다.
- DBMS 별 참고: DBMS 마다 다른 SSL 지원입니다.