[Bug] DB Connection 연결 테스트 시 SSH 터널에서 authenticationMethods 오류 발생 (Key Pair 구성인데 Password 경로로 처리됨)

[Avokene]

[Bug] DB Connection 연결 테스트 시 SSH 터널에서 authenticationMethods 오류 발생 (Key Pair 구성인데 Password 경로로 처리됨)

환경 (Environment)

• QueryPie 버전: V11 (11.6.2-151a452)
• 배포 형태: Docker (컨테이너: querypie-app-1)
• QueryPie 서버 위치: Private subnet (172.20.0.88)
• 대상 DB: AWS RDS (MySQL, 포트 3306), SSL 강제(VERIFY_IDENTITY)
• SSH Bastion: 별도 VPC, 사설 IP 10.2.0.246 (VPC Peering으로 연결됨)

증상 (Summary)

DB Connection 생성 화면에서 "연결 테스트(Test Connection)" 버튼을 누르면 다음 오류가 발생합니다.

[ENGINE] At least one authentication method should be specified. (Parameter 'authenticationMethods')

이 오류는 DB 인증이 아니라 SSH 터널 생성 단계에서 발생합니다.

재현 절차 (Steps to Reproduce)

1. DB Connection을 생성한다 (MySQL, RDS 호스트, 포트 3306).
2. DB 인증: Username/Password 방식, Secret Store는 QueryPie(내부 저장).
3. "SSL / SSH 설정"에서:
   • SSL 사용 체크 + SSL 구성 선택 (aws-global-bundle, RDS CA 번들)
   • SSH 사용 체크 + SSH 구성 선택 (BASTION)
4. SSH 구성(BASTION)은 인증 유형 = Key Pair, 호스트/포트/사용자/개인키 입력 완료.
5. "연결 테스트" 클릭.

기대 동작 (Expected Behavior)

SSH 구성이 Key Pair 방식이므로, QueryPie 엔진이 키 페어 기반으로 SSH 터널 인증 정보를 생성하고, bastion을 경유해 RDS로 연결되어야 함.

실제 동작 (Actual Behavior)

엔진이 SSH 터널 인증 정보를 Password 방식(CreatePasswordConnectionInfo) 으로 생성하려 시도함. Key Pair 구성이라 SSH 비밀번호는 입력하지 않았으므로 인증 수단(authenticationMethods)이 빈 배열이 되어 System.ArgumentException 발생.

엔진 로그 / 스택트레이스 (Engine Log)

docker logs querypie-app-1 에서 추출:

System.ArgumentException: At least one authentication method should be specified. (Parameter 'authenticationMethods')
   at Renci.SshNet.ConnectionInfo..ctor(String host, Int32 port, String username, ProxyTypes proxyType, String proxyHost, Int32 proxyPort, String proxyUsername, String proxyPassword, AuthenticationMethod[] authenticationMethods)
   at Renci.SshNet.ConnectionInfo..ctor(String host, Int32 port, String username, AuthenticationMethod[] authenticationMethods)
   at QueryPie.Core.Vendors.Sessions.Tunneling.SshNetTunnelFactory.CreatePasswordConnectionInfo(SshTunnelRequest request) in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/Tunneling/SshNetTunnelFactory.cs:line 79
   at QueryPie.Core.Vendors.Sessions.Tunneling.SshNetTunnelFactory.CreateConnectionInfo(SshTunnelRequest request) in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/Tunneling/SshNetTunnelFactory.cs:line 71
   at QueryPie.Core.Vendors.Sessions.Tunneling.SshNetTunnelFactory.CreateAsync(SshTunnelRequest request, CancellationToken cancellationToken) in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/Tunneling/SshNetTunnelFactory.cs:line 20
   at QueryPie.Core.Vendors.Sessions.Tunneling.PooledSshTunnelManager.CreateEntryAsync(SshTunnelRequest request, CancellationToken cancellationToken) in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/Tunneling/PooledSshTunnelManager.cs:line 142
   at QueryPie.Core.Vendors.Sessions.Tunneling.PooledSshTunnelManager.LeaseAsync(SshTunnelRequest request, CancellationToken cancellationToken) in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/Tunneling/PooledSshTunnelManager.cs:line 66
   at QueryPie.Core.Vendors.Sessions.VendorSession.PrepareConnectivity() in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/VendorSession.cs:line 1121
   at QueryPie.Core.Vendors.Sessions.VendorSession.CreateAndOpenCriticalConnectionAsync() in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/VendorSession.cs:line 533
   at QueryPie.Core.Vendors.Sessions.VendorSession.CreateAndOpenUnmanagedConnectionAsync() in /src/apps/engine/querypie-core/QueryPie.Core/Vendors/Sessions/VendorSession.cs:line 561
   at QueryPie.Core.Hosting.Applications.GrpcWeb.Services.Engine.Admin.Once.Session.AdminOnceSessionServiceImpl.Test(TestRequest request, ServerCallContext context) in /src/apps/engine/querypie-core/QueryPie.Core/Hosting/Applications/GrpcWeb/Services/Proto/Engine/Admin/Once/Session/AdminOnceSessionService.cs:line 69

분석 (Analysis)

스택트레이스의 SshNetTunnelFactory.CreatePasswordConnectionInfo 호출이 핵심입니다.

• SSH 구성은 Key Pair 유형으로 등록되어 있음.
• 그러나 엔진은 SSH 터널 인증 정보를 Password 경로(CreatePasswordConnectionInfo)로 생성하려 함.
• 그 결과 Renci.SshNet.ConnectionInfo 생성자에 authenticationMethods가 빈 배열로 전달되어 예외 발생.

즉, SSH 구성의 인증 유형(Key Pair)이 엔진의 터널 생성 로직에 올바르게 반영되지 않는 것으로 보입니다.

추가 확인 사항 (Additional Notes)

• 동일한 개인키(RSA PEM 형식, -----BEGIN RSA PRIVATE KEY-----)로 QueryPie 서버에서 bastion으로 SSH 직접 접속은 정상 성공함:

  ssh -i Bastion.pem [계정명]@10.2.0.246 "echo OK"
  OK
  

  → 키 파일, 사용자명, 호스트, 네트워크 경로 모두 정상.
• 따라서 키 자체나 네트워크 문제가 아니며, QueryPie 엔진이 Key Pair SSH 구성을 Password 방식으로 처리하는 동작이 원인으로 의심됨.

질문 / 요청 (Questions)

1. Key Pair 유형 SSH 구성인데 엔진이 CreatePasswordConnectionInfo 경로를 타는 것이 정상 동작인지, 버그인지 확인 요청.
2. 11.6.2 버전에서 SSH 터널 + Key Pair 인증 관련 알려진 이슈가 있는지 확인 요청.
3. 해결 방법 또는 워크어라운드 안내 요청.

[jk-kim0]

@Avokene 안녕하세요, 기술지원 담당하는 JK 김정겸입니다. 문의 주신 것에 대한 확인이 다소 늦었습니다. 관련 내용을 확인하여 곧 다시 답변드리겠습니다.

문의 주신 내용은 11.6.2 버전에서, DAC 에서 ssh tunnel 기능을 사용할 때, public key 인증 방식으로 설정한 경우, ssh tunnel 연결에 실패하는 문제 현상에 대한 건입니다. 버그 리포팅 주셔서 고맙습니다.

[jk-kim0]

@Avokene 11.6.2 버전의 제품에서, DAC 를 위한 ssh tunnel 기능을 사용할 때, public key 인증 방식이 오동작하는 버그가 있었습니다.

해당 버그가 11.6.3 버전에서 해결된 상태입니다. 다음 문서를 참조하여, 11.6.3 버전으로 업그레이드하거나, 신규 설치하여 사용하시면 되겠습니다.

• 업그레이드 가이드 : QueryPie ACP Community Edition 업그레이드 방법
• 출시된 버전에 대한 정보를 이곳에서 확인할 수 있습니다 : 제품 버전

감사합니다~

[Avokene]

안녕하세요,, 내용확인하였습니다. 지원 감사드리며 11.6.3 버전에서는 정상 연결되는 것 확인하였습니다. 감사합니다. 김동윤 드림 2026년 6월 1일 (월) 오후 7:34, JK ***@***.***>님이 작성:

…

@Avokene <https://github.com/Avokene> 11.6.2 버전의 제품에서, DAC 를 위한 ssh tunnel 기능을 사용할 때, public key 인증 방식이 오동작하는 버그가 있었습니다. 해당 버그가 11.6.3 버전에서 해결된 상태입니다. 다음 문서를 참조하여, 11.6.3 버전으로 업그레이드하거나, 신규 설치하여 사용하시면 되겠습니다. - 업그레이드 가이드 : QueryPie ACP Community Edition 업그레이드 방법 <https://docs.querypie.com/ko/installation/querypie-acp-community-edition/how-to-upgrade-querypie-acp-community-edition> - 출시된 버전에 대한 정보를 이곳에서 확인할 수 있습니다 : 제품 버전 <https://docs.querypie.com/ko/installation/product-versions> 감사합니다~ — Reply to this email directly, view it on GitHub <#15?email_source=notifications&email_token=ANNDXLMOEYQLYNQIUKUDGOT45VL2VA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZRGM2DCOBTUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSWGM33PORSXEX3DNRUWG2Y#discussioncomment-17134183>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ANNDXLLSBLXZHWNU3F6PPLL45VL2VAVCNFSM6AAAAACZO4HG7OVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTOMJTGQYTQMY> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/ANNDXLKUHVP42R4DLHSZDND45VL2VA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZRGM2DCOBTUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSVGM33PORSXEX3JN5ZQ> and Android <https://github.com/notifications/mobile/android/ANNDXLLFZ6KS2H23OXLOSJT45VL2VA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCNZRGM2DCOBTUZZGKYLTN5XKO3LFNZ2GS33OUVSXMZLOOSXGM33PORSXEX3BNZSHE33JMQ>. Download it today! You are receiving this because you were mentioned.Message ID: ***@***.*** com>