2025년 Node.js Driver 릴리스 정보¶

새로운 기능과 업데이트¶

• workloadIdentityAzureClientId 구성 옵션을 추가하여 WORKLOAD_IDENTITY 인증에 대해 Azure 클라이언트를 사용자 지정할 수 있게 했습니다.

• authenticator=WORKLOAD_IDENTITY`에 대한 :codenowrap:`workloadIdentityImpersonationPath 구성 옵션을 추가하여 워크로드가 서비스 계정 가장을 사용할 수 있도록 했습니다.

버그 수정 사항¶

• PUT 작업이 잘못된 :codenowrap:`smkId`를 사용하여 파일을 암호화하는 회귀를 수정했습니다.

새로운 기능과 업데이트¶

• 새로운 인증서 해지 목록(CRL) 확인 메커니즘을 구현했습니다.

  CRLs를 활성화하면 TLS 핸드셰이크 프로세스 동안 해지된 인증서를 확인하여 보안이 개선됩니다. 자세한 내용은 `인증서 해지 확인 방법으로 OCSP를 CRL로 바꾸기<https://community.snowflake.com/s/article/Replacing-OCSP-with-CRL-as-the-method-of-certificate-revocation-checking>`_ 기술 자료 문서를 참조하세요.

  이 기능은 기본적으로 비활성화되어 있습니다. 이 기능 활성화에 대한 내용은 인증서 해지 목록(CRL) 옵션 섹션을 참조하세요. 프로덕션에서 이 기능을 활성화하기 전에 권고 모드에서 이 기능을 테스트하는 것이 좋습니다.

버그 수정 사항¶

• 쿼리 결과 청크를 다운로드할 때 디버그 로그를 개선했습니다.

• :codenowrap:`getResultsFromQueryId()`의 오류 처리 누락을 수정했습니다.

• 스테이지 바인딩을 사용할 때 null 값이 ``””``로 잘못 변환되는 문제를 수정했습니다.

• ``Bind``의 입력을 확장했습니다.

새로운 기능과 업데이트¶

• AWS, Azure, Google Cloud, Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.

  • workloadIdentityProvider 연결 매개 변수를 추가했습니다.

  • WORKLOAD_IDENTITY 을 authenticator 연결 매개 변수 값에 추가했습니다.

• QUERY_TAG 세션 매개 변수를 설정하기 위해 queryTag 연결 매개 변수를 추가했습니다.

버그 수정 사항¶

• 만료된 OAuth 액세스 토큰에 연결할 때 발생하는 네트워크 오류를 수정했습니다.

• RFC 6749 섹션 3.1.2와 호환되도록 후행 /(슬래시)를 제거하여 리디렉션 URI에 대한 OAuth 인증 코드 값을 수정했습니다.

• GET 명령의 오류를 개선했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• useVirtualUrl=true 일 때 Google Cloud Platform(GCP) XML API 사용 시 발생하는 문제를 수정했습니다.

• .toml 구성 파일에 대한 권한 확인을 수정했습니다.

• 외부 브라우저 인증을 사용할 때 프로세스가 종료되지 않도록 연결을 생성한 후 처리되지 않는 리소스를 수정했습니다.

• 인증 코드 흐름에서 oauthEnableSingleUseRefreshTokens 의 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없습니다.

버그 수정 사항¶

• 버전 2.1.1에 도입된 TypeScript 오류를 수정했습니다.

비공개 미리 보기(PrPr) 기능¶

AWS, Azure, GCP 및 Kubernetes 플랫폼에서 워크로드 ID 페더레이션에 대한 지원을 추가했습니다.

면책 조항:

• 이 기능은 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 환경 변수를 true 로 설정해야만 액세스할 수 있습니다.

• 이 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.

• 이 PrPr 기능은 지원 대상에서 제외됩니다. 그러나 제품 및 엔지니어링 팀이 PrPr 단계에서 지원할 수 있습니다.

• 참여 및 설명서는 계정 팀에 문의하십시오.

새로운 기능과 업데이트¶

• 클라이언트 자격 증명 인증을 위한 토큰 캐싱을 제거했습니다.

버그 수정 사항¶

• Util.getProxyFromEnv 가 HTTPS를 잘못 가정하여 HTTP 트래픽(포트 80)에 대해 HTTP_PROXY 값이 무시되는 문제를 수정했습니다.

• getQueryResponse 가 null 응답을 반환하는 사례를 처리하여 가끔 발생하는 중단을 방지하도록 extractQueryStatus 를 개선했습니다.

• 코어 인스턴스에 ErrorCode 를 추가했습니다.

추가 참고 사항¶

• 이 릴리스에는 개발을 위한 TypeScript가 도입되었습니다. npm 패키지에는 드라이버 사용자에게 예상되는 호환성 문제가 없는 컴파일된 JavaScript 코드가 포함되어 있습니다.

새로운 기능과 업데이트¶

• OAuth 2.0 승인 코드 플로우 및 OAuth 2.0 클라이언트 자격 증명 플로우에 대한 지원이 추가되었습니다.

  • OAuth 2.0 승인 코드 플로우의 경우:

    • oauthClientId, oauthClientSecret, oauthAuthorizationUrl, oauthTokenRequestUrl 및 oauthScope 매개 변수를 추가했습니다.

    • 매개 변수 인증자에 대한 OAUTH_AUTHORIZATION_CODE 매개 변수를 추가했습니다.

  • OAuth 2.0 클라이언트 자격 증명 플로우의 경우:

    • oauthClientId, oauthClientSecret, oauthTokenRequestUrl 및 oauthScope 매개 변수를 추가했습니다.

    • 매개 변수 인증자에 대한 OAUTH_CLIENT_CREDENTIALS 매개 변수를 추가했습니다.

• 가상 스타일 도메인에 대한 지원이 추가되었습니다.

• 토큰 캐싱 개선을 포함하여 Linux용 파일 기반 자격 증명 캐시를 구현하고 개선했습니다.

버그 수정 사항¶

• 없음

비공개 미리 보기(PrPr) 기능¶

• 프로그래밍 방식 액세스 토큰 인증에 대한 지원을 구현했습니다.

면책 조항:

• 이 기능은 SF_ENABLE_EXPERIMENTAL_AUTHENTICATION 환경 변수를:codenowrap:true 로 설정해야 액세스할 수 있습니다.

• 이러한 기능은 프로덕션이 아닌 데이터에만 사용해야 합니다.

• 이러한 PrPr 기능은 지원팀에서 담당하지 않습니다. 그러나 제품 및 엔지니어링 팀은 PrPr 단계에서 이용할 수 있습니다.

• 참여 및 설명서는 계정 팀에 문의하십시오.

새로운 기능과 업데이트¶

• Axios를 버전 1.8.2+로 업그레이드했습니다.

버그 수정 사항¶

• 간편 로깅 구성 파일에 대한 액세스를 확인할 때 사용 시간 확인(TOCTOU) 경쟁 조건을 수정했습니다. 자세한 내용은 CVE-2025-46328 섹션을 참조하십시오.

• OCSP 응답 캐시 항목이 올바르게 새로 고쳐지지 않는 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 없음

버그 수정 사항¶

• 파일 업로드 오류에 대한 약속 거부 문제를 수정했습니다.

새로운 기능과 업데이트¶

• 리전별 Google Cloud Storage 엔드포인트에 대한 지원을 추가했습니다.

• GCS 에 대한 프로토콜이 없는 엔드포인트를 위한 지원을 추가했습니다.

• 다음 종속성을 업데이트했습니다.

  • azure/storage-blob을 버전 12.26.x로 업데이트

  • aws-sdk/client-s3에서 버전 3.726.0으로 업데이트

  • smithy/node-http-handler를 버전 4.0.1로 업데이트

버그 수정 사항¶

• 인증이 EXTERNALBROWSER 또는 USERNAME_PASSWORD_MFA 로 설정된 경우 토큰 캐싱 파일 권한 및 소유자 확인을 수정했습니다. 자세한 내용은 CVE-2025-24791 섹션을 참조하십시오.

• 타입 정의 파일에서 FileAndStageBindStatement 유형을 수정했습니다.

• HttpClient 에서 요청 중단 및 일관되지 않은 요청 메서드와 관련된 문제를 수정했습니다.

• GCS 버킷으로 요청을 보내는 데 사용되는 프록시 구성 설정 관련 문제를 수정했습니다.