Amazon Athena ODBC 2.x 릴리스 정보

• SSL 인증서 검증이 기본적으로 활성화됨 - 이제 드라이버가 ID 제공업체에 연결할 때 SSL 인증서 확인을 시행합니다. 유효한 SSL 인증서 없이 로컬 ID 제공업체를 사용하는 경우 연결 문자열에 SSL_Insecure=1을 명시적으로 설정해야 합니다. 자세한 내용은 SSL 비보안(IdP) 섹션을 참조하세요.

• TLS 1.2 이상만 허용 - 이제 드라이버가 ID 제공업체에 대한 TLS 1.0 또는 TLS 1.1 연결을 허용하지 않습니다. 이제 모든 IdP 연결에 TLS 1.2 이상이 필요합니다.

• BrowserSSOOIDC 인증 흐름 업데이트됨 - BrowserSSOOIDC 플러그인은 이제 디바이스 코드 권한 부여 대신 PKCE를 사용한 권한 부여 코드를 사용합니다. OAuth 2.0 콜백 서버에는 새로운 선택적 파라미터 listen_port(기본값 7890)를 사용할 수 있습니다. 네트워크에서 이 포트를 허용 목록에 추가해야 할 수도 있습니다. 기본 범위가 sso:account:access로 변경되었습니다. 자세한 내용은 브라우저 SSO OIDC 섹션을 참조하세요.

• BrowserSSOOIDC - 보안 강화를 위해 디바이스 코드 흐름에서 PKCE를 사용한 권한 부여 코드로 마이그레이션되었습니다.

• BrowserAzureAD - 권한 부여 코드 가로채기 공격을 방지하기 위해 OAuth 2.0 권한 부여 흐름에 PKCE(Proof Key for Code Exchange)가 추가되었습니다.

• BrowserSAML - SAML 토큰 주입 공격을 방지하기 위해 RelayState CSRF 보호가 추가되었습니다.

• 자격 증명 캐시 - v2.1.0.0부터 캐시된 자격 증명이 AWS CLI에서 로컬로 저장된 자격 증명을 보호하는 방식과 일관되게 user-profile/.athena-odbc/ 디렉터리에 일반 텍스트 JSON으로 저장되며 파일 권한은 소유 사용자로 제한됩니다.

• IAM 프로파일 - 기존 Ec2InstanceMetadata와 함께 EcsContainer 및 Environment 자격 증명 소스에 대한 지원이 추가되었습니다.

• 연결 문자열 파서- 적절한 ODBC }} 이스케이프 처리가 구현되었습니다.

• 카탈로그 쿼리 - 스키마 이름과 테이블 패턴에 대한 SQL 식별자 이스케이프가 추가되었습니다.

• ODBC 패턴 매칭 - 정규식 기반 매칭이 직접 ODBC LIKE 와일드카드 매처로 대체되었습니다.

• XML 구문 분석 - SAML 토큰에 대한 재귀 깊이 제한(100개 수준)과 크기 제한(1MB)이 추가되었습니다.

• ADFS 인증 - ADFS 서버 응답에 대한 응답 크기 제한(200KB)이 추가되었습니다.

• 인증 구성 요소에서 특수 요소가 제대로 중화되지 않아 조작된 연결 파라미터를 통해 코드 실행이나 인증 흐름 리디렉션이 발생할 수 있었던 문제가 수정되었습니다. BrowserSSOOIDC, BrowserAzureAD 및 BrowserSAML 플러그인에 영향을 줍니다.

• 쿼리 처리 구성 요소에서 특수 요소가 제대로 중화되지 않아 조작된 테이블 메타데이터를 통해 서비스 거부나 SQL 인젝션이 발생할 수 있었던 문제가 수정되었습니다.

• ID 제공업체에 연결할 때 부적절한 인증서 검증이 수정되었습니다.

• 브라우저 기반 인증 흐름에서 누락된 인증 보안 제어가 수정되었습니다. 여기에는 OAuth용 PKCE, SAML용 CSRF 보호, 안전한 자격 증명 캐싱 및 전용 콜백 포트 바인딩이 포함됩니다.

• 조작된 입력 패턴, 무한 서버 응답 또는 깊게 중첩된 XML 페이로드를 통해 서비스 거부를 유발할 수 있었던 구성 요소 구문 분석 시 제어되지 않는 리소스 소비가 수정되었습니다.

• Power BI 가져오기 모드에서 교차 계정 페더레이션 카탈로그와 함께 SQLColumns 사용 시 UseSingleCatalogAndSchema=1와 SQLTables가 아무 결과도 반환하지 않는 문제가 수정되었습니다.

• 브라우저의 신뢰할 수 있는 ID 전파 인증 플러그인 - 신뢰할 수 있는 ID 전파를 통해 브라우저 기반 OpenID Connect(OIDC) 인증을 지원하는 새 인증 플러그인을 추가했습니다. 이 플러그인은 기본 브라우저를 통해 전체 OAuth 2.0 흐름을 처리하고, JSON 웹 토큰(JWT)을 자동으로 가져오며, 신뢰할 수 있는 ID 전파에 통합되어 원활한 인증 환경을 제공합니다. 플러그인은 단일 사용자 데스크톱 환경을 위해 특별히 설계되었습니다. 신뢰할 수 있는 ID 전파를 활성화하고 사용하는 방법에 대한 자세한 내용은 What is trusted identity propagation?을 참조하세요.

• 향상된 로깅 프레임워크 - 다음을 통해 드라이버의 로깅 메커니즘을 크게 개선했습니다.

  • 기본 0/1 옵션 이상의 보다 세분화된 로그 수준 도입

  • 중복 로그 문 제거

  • 진단 관련 정보를 포함하도록 로깅 프레임워크 최적화

  • 운영 지연을 일으킨 성능 문제 해결

  • 로깅이 활성화된 경우 과도한 로그 파일 생성 감소

• 결과 가져오기 최적화 - 가져오기 크기 파라미터 제한 사항이 스트리밍 및 스트리밍 이외 결과 가져오기 모두에 잘못 적용되는 문제를 수정했습니다. 이제 제한 사항이 스트리밍 이외 결과 가져오기에만 올바르게 적용됩니다.

Amazon Athena ODBC v2.0.5.1 드라이버에는 브라우저 기반 인증 플러그인에 대한 다음과 같은 수정 사항이 포함되어 있습니다.

• 로그인 URL과 스키마 검사에 대한 검증을 구현했습니다.

• Linux에서 시스템 API를 활용하도록 개선된 브라우저 실행 메커니즘으로 안정성과 보안이 향상되었습니다.

• JWT 신뢰할 수 있는 ID 제공업체(TIP) 인증 플러그인 - ODBC 드라이버와의 JWT 신뢰할 수 있는 ID 제공업체(TIP) 통합을 지원하는 새 인증 플러그인을 추가했습니다. 이 인증 유형을 사용하면 외부 ID 제공업체로부터 얻은 JSON 웹 토큰(JWT)을 연결 파라미터로 사용하여 Athena로 인증할 수 있습니다. TIP를 사용하면 ID 컨텍스트가 IAM 역할에 추가되어 AWS 리소스에 대한 액세스를 요청하는 사용자를 식별합니다. TIP 활성화 및 사용에 대한 자세한 내용은 What is Trusted Identity Propagation?을 참조하세요.

• 사용자 지정 SSO 관리자 엔드포인트 지원 - ODBC 드라이버에 사용자 지정 SSO 관리자 엔드포인트에 대한 지원이 추가되었습니다. 이 향상된 기능을 통해 VPC 환경에서 ODBC를 실행할 때 SSO 서비스용 엔드포인트를 지정할 수 있습니다..

• AWS SDK 버전 업데이트 - 드라이버에 사용된 AWS SDK 버전을 2.32.16으로 업데이트하고 릴리스 2.0.5.0의 프로젝트 종속성을 업데이트했습니다.

• 결과 페처 - 이제 드라이버가 쿼리 결과를 다운로드할 방식을 자동으로 선택합니다. 이렇게 하면 대부분의 상황에서 페처를 수동으로 구성할 필요가 없습니다. 자세한 내용은 결과 페처 섹션을 참조하세요.

• Curl 라이브러리가 8.12.1 버전으로 업데이트되었습니다.

• STS에 연결하는 경우의 IAM 프로파일 프록시 구성을 수정했습니다. 해당 수정을 통해 IAM 프로파일을 성공적인 인증에 사용할 수 있게 됩니다.

• 인증 플러그인을 사용하여 IAM 프로파일에 대한 모든 추가 구성 옵션을 읽습니다. 여기에는 영향 받는 플러그인의 잘못된 구성을 해결하기 위해 UseProxyForIdP, SSL_Insecure, LakeformationEnabled 및 LoginToRP가 포함됩니다.

• 라운드 함수가 선택적 두 번째 파라미터를 가져오도록 수정했습니다. 이스케이프 구문이 포함된 쿼리를 실패 없이 처리합니다.

• TIME WITH TIME ZONE 및 TIMESTAMP WITH TIME ZONE 데이터 형식에 대한 열 크기를 수정했습니다. 타임스탬프 및 시간대 데이터 형식이 있는 값이 잘려 보이지 않습니다.

• Linux 및 Mac 플랫폼에서 Okta 인증 플러그인에 대한 MFA 지원을 추가했습니다.

• 이제 Windows에 대해 athena-odbc.dll 라이브러리와 AmazonAthenaODBC-2.x.x.x.msi 설치 프로그램이 모두 서명됩니다.

• 드라이버와 함께 설치된 CA 인증서 cacert.pem 파일을 업데이트했습니다.

• Lambda 카탈로그에 테이블을 나열하는 데 필요한 시간을 개선했습니다. LAMBDA 카탈로그 유형의 경우 ODBC 드라이버가 이제 SHOW TABLES 쿼리를 제출하여 사용 가능한 테이블 목록을 가져올 수 있습니다. 자세한 내용은 쿼리를 사용하여 테이블 나열 섹션을 참조하세요.

• SQL_WCHAR 및 SQL_WVARCHAR를 사용하여 문자열 데이터 유형을 보고하는 UseWCharForStringTypes 연결 파라미터를 도입했습니다. 자세한 내용은 문자열 유형에 WCHAR 사용 섹션을 참조하세요.

• Get-OdbcDsn PowerShell 도구를 사용할 때 발생했던 레지스트리 손상 경고를 수정했습니다.

• 쿼리 문자열 시작 시 주석을 처리하도록 구문 분석 로직을 업데이트했습니다.

• 날짜 및 타임스탬프 데이터 유형에서 이제 연도 필드에 0을 사용할 수 있습니다.

• 문자열 및 복합 데이터 유형의 기본 열 길이를 변경하는 데 사용할 수 있는 연결 파라미터인 StringColumnLength 및 ComplexTypeColumnLength를 추가했습니다. 자세한 내용은 문자열 열 길이 및 복합 유형 열 길이(을)를 참조하세요.

• Linux 및 macOS(Intel 및 ARM) 운영 체제에 대한 지원이 추가되었습니다. 자세한 내용은 Linux 및 macOS(을)를 참조하세요.

• AWS-SDK-CPP가 1.11.245 태그 버전으로 업데이트되었습니다.

• curl 라이브러리가 8.6.0 버전으로 업데이트되었습니다.

• 정밀도 열의 문자열과 유사한 데이터 유형에 대한 결과 세트 메타데이터에서 잘못된 값이 보고되는 문제를 해결했습니다.

• 모든 인터페이스의 ODBC 드라이버 스레드 안전이 개선되었습니다.

• 로깅이 활성화되면 이제 날짜 시간 값이 밀리초 단위로 기록됩니다.

• 브라우저 SSO OIDC 플러그인으로 인증하는 동안 이제 터미널이 열려 사용자에게 디바이스 코드가 표시됩니다.

• 스트리밍 API의 결과를 구문 분석할 때 발생하는 메모리 릴리스 문제가 해결되었습니다.

• 이제 SQLTablePrivileges(), SQLSpecialColumns(), SQLProcedureColumns() 및 SQLProcedures() 인터페이스에 대한 요청이 빈 결과 세트를 반환합니다.

• 브라우저 Azure AD, 브라우저 SSO OIDC 및 Okta 브라우저 기반 인증 플러그인에 파일 캐시 기능이 추가되었습니다.

  Power BI와 같은 BI 도구 및 브라우저 기반 플러그인은 여러 브라우저 창을 사용합니다. 새 파일 캐시 연결 파라미터를 사용하면 임시 보안 인증을 캐시하여 BI 애플리케이션에서 여는 여러 프로세스 간에 재사용할 수 있습니다.

• 이제 애플리케이션에서 명령문이 준비된 후 결과 세트에 대한 정보를 쿼리할 수 있습니다.

• 느린 클라이언트 네트워크에서 사용할 수 있도록 기본 연결 및 요청 시간 제한이 늘어났습니다. 자세한 내용은 연결 제한 시간 및 요청 제한 시간(을)를 참조하세요.

• SSO 및 SSO OIDC에 대한 엔드포인트 재정의가 추가되었습니다. 자세한 내용은 엔드포인트 재정의 섹션을 참조하세요.

• 인증 요청을 위한 URI 인수를 Ping에 전달하는 연결 파라미터가 추가되었습니다. 이 파라미터를 사용하여 Lake Formation 단일 역할 제한을 우회할 수 있습니다. 자세한 내용은 Ping URI 파라미터 섹션을 참조하세요.

• 행 기반 바인딩 메커니즘을 사용할 때 발생하는 정수 오버플로 문제가 수정되었습니다.

• 브라우저 SSO OIDC 인증 플러그인의 필수 연결 파라미터 목록에서 제한 시간이 제거되었습니다.

• SQLStatistics(), SQLPrimaryKeys(), SQLForeignKeys() 및 SQLColumnPrivileges()에 대한 누락된 인터페이스가 추가되고 요청 시 빈 결과 세트를 반환하는 기능이 추가되었습니다.

• Okta 인증 플러그인에 URI 로깅을 추가했습니다.

• 외부 보안 인증 제공업체 플러그인에 기본 역할 파라미터를 추가했습니다.

• AWS 구성 파일의 프로파일 이름에서 프로파일 접두사에 대한 처리를 추가했습니다.

• Lake Formation 및 AWS STS 클라이언트에서 작업할 때 발생한 AWS 리전 사용 문제를 수정했습니다.

• 누락된 파티션 키를 테이블 열 목록에 복원했습니다.

• 누락된 BrowserSSOOIDC 인증 유형을 AWS 프로파일에 추가했습니다.