키 페어 인증: 문제 해결
키 페어 인증: 문제 해결 (Key Pair Authentication: Troubleshooting)
이 문서는 Snowflake 키 페어 인증을 사용할 때 발생하는 일반적인 문제와 해결 방법을 설명해요.
본문
공통 오류 및 해결 방법
키가 올바르지 않거나 형식이 잘못됨
- 증상: "Incorrect RSA private key file" 또는 "invalid key" 오류.
- 원인: 프라이빗 키가 잘못된 형식이거나 손상됨.
- 해결: 프라이빗 키가 PKCS#8 형식(및 암호화된 키는 PEM 형식)인지 확인하세요. 올바르지 않으면 키 페어 인증 문서의 지침에 따라 키를 다시 생성하세요.
암호(passphrase)가 틀림
- 증상: 암호화된 프라이빗 키를 사용할 때 인증 실패.
- 원인: 키 암호가 잘못됨.
- 해결: 프라이빗 키를 생성할 때 사용한 정확한 암호를 지정하세요. 암호를 모르면 키를 재생성해야 해요.
클라이언트가 키 페어 인증을 지원하지 않음
- 증상: 클라이언트가 키 페어 인증 옵션을 인식하지 못함.
- 원인: 오래된 클라이언트 버전.
- 해결: 클라이언트(SnowSQL, 드라이버, 커넥터)를 최신 버전으로 업데이트하세요.
공개 키가 사용자에게 연결되지 않음
- 증상: "Public key doesn't match" 또는 인증 거부.
- 원인: 사용자에 연결된 공개 키가 프라이빗 키의 짝과 일치하지 않음.
- 해결:
ALTER USER로 올바른 공개 키를 다시 설정하세요. 공개 키가 프라이빗 키와 동일한 키 쌍에서 파생되었는지 확인하세요.
시간 동기화 문제
- 증상: 인증 시 간헐적인 실패.
- 원인: 클라이언트 머신의 시계가 정확하지 않아 토큰 검증에 실패.
- 해결: NTP 등으로 클라이언트 시스템 시간을 정확하게 동기화하세요.
일반적인 확인 사항
- 프라이빗 키 파일의 권한이 안전하게 설정되어 있는지 확인하세요.
- 클라이언트가 올바른 프라이빗 키 파일 경로를 가리키고 있는지 확인하세요.
- 계정에서 키 페어 인증이 지원되는 에디션(Enterprise 이상)을 사용하는지 확인하세요.
도움이 필요하면 Snowflake Support에 연락하세요.