IAM 자격 증명 제공 옵션 - Amazon Redshift
구성 프로필 사용IAM 자격 증명 제공을 위한 JDBC 및 ODBC 옵션자격 증명 공급자 플러그인 사용Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정AD FS에서 JDBC 또는 ODBC Single Sign-On 인증 설정Ping Identity에서 JDBC 또는 ODBC Single Sign-On 인증 설정Okta에서 JDBC 또는 ODBC Single Sign-On 인증 설정

IAM 자격 증명 제공 옵션

JDBC 또는 ODBC 연결에 IAM 자격 증명을 제공하려면 다음 옵션 중 한 가지를 선택합니다.

  • AWS 프로필

    JDBC 또는 ODBC 설정의 형태로 자격 증명 값을 제공하는 방식의 대안으로 이름 있는 프로필에 값을 입력할 수 있습니다. 자세한 내용은 구성 프로필 사용 단원을 참조하십시오.

  • IAM 자격 증명

    AccessKeyID, SecretAccessKey, 그리고 옵션으로 SessionToken에 대한 값을 JDBC 또는 ODBC 설정의 형태로 제공합니다. SessionToken은 임시 자격 증명을 가진 IAM 역할에만 필요합니다. 자세한 내용은 IAM 자격 증명 제공을 위한 JDBC 및 ODBC 옵션 단원을 참조하십시오.

  • 자격 증명 공급자 연동

    자격 증명 공급자 페더레이션을 사용하여 자격 증명 공급자의 사용자가 Amazon Redshift에 인증할 수 있도록 하는 경우 자격 증명 공급자 플러그인의 이름을 지정합니다. 자세한 내용은 자격 증명 공급자 플러그인 사용 단원을 참조하십시오.

    Amazon Redshift JDBC 및 ODBC 드라이버에는 다음 SAML 기반의 자격 증명 페더레이션 자격 증명 공급자를 위한 플러그인이 포함됩니다.

    • Microsoft Active Identity Federation Services(AD FS)

    • PingOne

    • Okta

    • Microsoft Azure Active Directory (Azure AD)

    JDBC 또는 ODBC 설정의 형태로 혹은 프로필을 이용해 플러그인 이름과 관련 값을 입력할 수 있습니다. 자세한 내용은 JDBC 드라이버 버전 2.1 구성 옵션 및 ODBC 드라이버 옵션 구성 단원을 참조하세요.

자세한 내용은 IAM 자격 증명을 사용하도록 JDBC 또는 ODBC 연결 구성 단원을 참조하십시오.

구성 프로필 사용

IAM 자격 증명 옵션과 GetClusterCredentials 옵션은 AWS 구성 파일에서 이름 있는 프로파일의 설정대로 제공할 수 있습니다. 프로필 이름을 제공하려면 Profile JDBC 옵션을 사용합니다. 구성은 홈 디렉터리의 .aws 폴더의 config 또는 credentials 파일에 저장되어 있습니다.

Amazon Redshift JDBC 또는 ODBC 드라이버에 포함된 SAML 기반 자격 증명 공급자 플러그인의 경우 자격 증명 공급자 플러그인 사용의 바로 앞에서 설명한 설정을 사용할 수 있습니다. plugin_name을 사용하지 않으면 다른 옵션은 무시됩니다.

다음 예에서는 2개의 프로파일이 있는 ~/.aws/credentials 파일을 보여줍니다.

[default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

[user2]
aws_access_key_id=AKIAI44QH8DHBEXAMPLE
aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY
session_token=AQoDYXdzEPT//////////wEXAMPLEtc764bNrC9SAPBSM22wDOk4x4HIZ8j4FZTwdQWLWsKWHGBuFqwAeMicRXmxfpSPfIeoIYRqTflfKD8YUuwthAx7mSEI/qkPpKPi/kMcGd
QrmGdeehM4IC1NtBmUpp2wUE8phUZampKsburEDy0KPkyQDYwT7WZ0wq5VSXDvp75YU
9HFvlRd8Tx6q6fE8YQcHNVXAkiY9q6d+xo0rKwT38xVqr7ZD0u0iPPkUL64lIZbqBAz
+scqKmlzm8FDrypNC9Yjc8fPOLn9FX9KSYvKTr4rvx3iSIlTJabIQwj2ICCR/oLxBA==

user2 예시에 대한 자격 증명을 사용하려면 JDBC URL에서 Profile=user2를 지정하십시오.

프로파일 사용에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 구성 및 자격 증명 파일 설정을 참조하세요.

JDBC 드라이버에 대한 프로필 사용에 대한 자세한 내용은 프로파일 지정을 참조하세요.

ODBC 드라이버에 대한 프로필 사용에 대한 자세한 내용은 인증 구성을 참조하세요.

IAM 자격 증명 제공을 위한 JDBC 및 ODBC 옵션

다음 표는 IAM 자격 증명 제공을 위한 JDBC 및 ODBC 옵션을 목록으로 보여줍니다.

옵션

 설명

Iam

 ODBC 연결 문자열 전용. IAM 인증을 사용하려면 1로 설정합니다.

AccessKeyID

SecretAccessKey

SessionToken

 IAM 데이터베이스 인증용으로 구성한 IAM 역할 또는 사용자의 액세스 키 ID 및 비밀 액세스 키. SessionToken은 임시 자격 증명이 있는 IAM 역할에만 필요합니다. SessionToken은 사용자에게 사용되지 않습니다. 자세한 내용은 임시 보안 자격 증명을 참조하십시오.
plugin_name 자격 증명 공급자를 실행하는 완전히 정규화된 클래스 이름. Amazon Redshift JDBC 드라이버에는 SAML 기반의 자격 증명 공급자 플러그인이 포함됩니다. plugin_name을 제공하는 경우, 다른 관련 옵션도 제공할 수 있습니다. 자세한 내용은 자격 증명 공급자 플러그인 사용 단원을 참조하십시오.

Profile

AWS 자격 증명의 프로파일 이름 또는 JDBC에 대한 값을 포함한 config 파일입니다. 자세한 내용은 구성 프로필 사용 단원을 참조하십시오.

자격 증명 공급자 플러그인 사용

Amazon Redshift는 Single Sign-On 인증을 위해 자격 증명 공급자 플러그인을 사용합니다.

Single Sign-On 인증을 지원하기 위해 Amazon Redshift는 Microsoft Azure Active Directory용 Azure AD 플러그인을 제공합니다. 이 플러그인을 구성하는 방법에 대한 자세한 내용은 Microsoft Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정 단원을 참조하십시오.

멀티 팩터 인증 설정

멀티 팩터 인증(MFA)을 지원하기 위해 Amazon Redshift는 브라우저 기반 플러그인을 제공합니다. Okta 및 PingOne용 브라우저 SAML 플러그인과 Microsoft Azure Active Directory용 브라우저 Azure AD 플러그인을 사용합니다.

브라우저 SAML 플러그인의 경우, SAML 인증은 다음과 같이 흐릅니다.

  1. 사용자가 로그인을 시도합니다.

  2. 플러그인은 로컬 서버를 시작하여 로컬 호스트에서 들어오는 연결을 수신합니다.

  3. 플러그인은 웹 브라우저를 시작하여 지정된 Single Sign-On 로그인 URL 페더레이션 자격 증명 공급자 엔드포인트에서 HTTPS를 통해 SAML 응답을 요청합니다.

  4. 웹 브라우저는 링크를 따라 사용자에게 자격 증명을 입력하라는 메시지를 표시합니다.

  5. 사용자가 인증하고 동의하면 연동 자격 증명 공급자 엔드포인트가 HTTPS를 통해 redirect_uri에 표시된 URI에 SAML 응답을 반환합니다.

  6. 웹 브라우저는 SAML 응답과 함께 응답 메시지를 표시된 redirect_uri로 이동합니다.

  7. 로컬 서버는 수신 연결을 수락하고 플러그인은 SAML 응답을 검색하여 Amazon Redshift에 전달합니다.

브라우저 Azure AD 플러그인의 경우, SAML 인증은 다음과 같이 흐릅니다.

  1. 사용자가 로그인을 시도합니다.

  2. 플러그인은 로컬 서버를 시작하여 로컬 호스트에서 들어오는 연결을 수신합니다.

  3. 플러그인은 웹 브라우저를 시작하여 Azure AD oauth2/authorize 엔드포인트로부터 권한 부여 코드를 요청합니다.

  4. 웹 브라우저는 HTTPS를 통해 생성된 링크를 따라 사용자에게 자격 증명을 입력하라는 메시지를 표시합니다. 링크는 테넌트 및 client_id와 같은 구성 속성을 사용하여 생성됩니다.

  5. 사용자가 인증하고 동의하면 Azure AD oauth2/authorize 엔드포인트가 HTTPS를 통해 표시된 redirect_uri에 권한 부여 코드와 함께 응답을 반환하고 보냅니다.

  6. 웹 브라우저는 SAML 응답과 함께 응답 메시지를 표시된 redirect_uri로 이동합니다.

  7. 로컬 서버는 수신 연결 및 플러그인 요청을 수락하고 권한 부여 코드를 검색하고 Azure AD oauth2/token 엔드포인트에 POST 요청을 보냅니다.

  8. Azure AD oauth2/token 엔드포인트는 표시된 redirect_uri에 액세스 토큰이 있는 응답을 반환합니다.

  9. 플러그인은 SAML 응답을 검색하여 Amazon Redshift에 전달합니다.

다음 단원을 참조하십시오.

플러그인 옵션 구성

SAML 기반의 자격 증명 공급자 플러그인을 사용하려면 JDBC 또는 ODBC 옵션을 사용하거나 명명된 프로파일에서 다음 옵션을 지정합니다. plugin_name을 지정하지 않으면 다른 옵션은 무시됩니다.

옵션

 설명
plugin_name

JDBC의 경우 자격 증명 공급자를 실행하는 클래스 이름입니다. 다음 중 하나를 지정하세요.

  • Active Directory Federation Services의 경우

    com.amazon.redshift.plugin.AdfsCredentialsProvider

  • Okta의 경우

    com.amazon.redshift.plugin.OktaCredentialsProvider

  • PingFederate의 경우

    com.amazon.redshift.plugin.PingCredentialsProvider

  • Microsoft Azure Active Directory의 경우

    com.amazon.redshift.plugin.AzureCredentialsProvider

  • SAML MFA의 경우

    com.amazon.redshift.plugin.BrowserSamlCredentialsProvider

  • MFA를 사용하는 Microsoft Azure Active Directory Single Sign-On의 경우

    com.amazon.redshift.plugin.BrowserAzureCredentialsProvider

ODBC의 경우 다음 중 하나를 지정하십시오.

  • Active Directory Federation Services의 경우: adfs

  • Okta의 경우: okta

  • PingFederate의 경우: ping

  • Microsoft Azure Active Directory의 경우: azure

  • SAML MFA의 경우: browser saml

  • MFA를 사용하는 Microsoft Azure Active Directory Single Sign-On의 경우: browser azure ad
idp_host 기업 자격 증명 제공업체 호스트의 이름입니다. 이 이름에 슬래시(/)가 포함되면 안 됩니다. Okta 자격 증명 공급자의 경우 idp_host의 값은 .okta.com으로 끝나야 합니다.

idp_port

자격 증명 공급자가 사용하는 포트. 기본값은 443입니다. Okta의 경우 이 포트를 무시합니다.

preferred_role

SAML 어설션에서 Role 속성에 대한 AttributeValue 요소의 역할 Amazon 리소스 이름(ARN)입니다. 선호되는 역할에 적절한 값을 찾으려면 IdP 관리자에게 문의하십시오. 자세한 내용은 IdP에 대한 SAML 어설션 구성 단원을 참조하십시오.

user

해당되는 경우 도메인을 포함하는 기업 사용자 이름입니다. 예를 들어 Active Directory에서는 domain\username 형식의 도메인 이름이 필수입니다.
비밀번호

기업 사용자의 암호. 이 옵션의 사용은 권장하지 않습니다. 대신 SQL 클라이언트를 사용해 암호를 공급하십시오.

app_id

Okta 애플리케이션을 위한 ID. Okta에만 사용됩니다. Okta application embed link에서 app_id 값 뒤에 amazon_aws가 붙습니다. 이 값을 얻으려면 IdP 관리자에게 문의하십시오. 다음은 애플리케이션 내장 링크의 예입니다. https://example.okta.com/home/amazon_aws/0oa2hylwrpM8UGehd1t7/272

idp_tenant

 Azure AD에 사용되는 테넌트입니다. Azure에서만 사용됩니다.

client_id

Azure AD의 Amazon Redshift 엔터프라이즈 애플리케이션의 클라이언트 ID입니다. Azure에서만 사용됩니다.

Microsoft Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정

Microsoft Azure AD를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음에는 이 목적을 위해 신뢰 관계를 설정하는 방법을 설명하는 절차를 안내합니다. IdP에 대한 서비스 공급자로 AWS 구성에 대한 자세한 내용은 IAM User Guide의 Configuring Your SAML 2.0 IdP with Relying Party Trust and Adding Claims를 참조하세요.

참고

Azure AD를 JDBC와 함께 사용하려면 Amazon Redshift JDBC 드라이버가 버전 1.2.37.1061 이상이어야 합니다. Azure AD를 ODBC와 함께 사용하려면 Amazon Redshift ODBC 드라이버가 버전 1.4.10.1000 이상이어야 합니다.

Microsoft Azure AD Single Sign-On을 사용하여 Amazon Redshift 액세스를 페더레이션하는 방법을 알아봅니다.

Azure AD와 AWS 계정을 서로 신뢰하도록 설정하려면

  1. Azure AD 사용자가 연결할 기존 Amazon Redshift 클러스터를 사용하거나 생성합니다. 연결을 구성하려면 이 클러스터의 특정 속성(예: 클러스터 식별자)이 필요합니다. 자세한 내용은 클러스터 생성 섹션을 참조하세요.

  2. Microsoft Azure 포털에서 AWS에 사용되는 Azure Active Directory, 그룹, 사용자를 설정합니다.

  3. Microsoft Azure 포털에서 Amazon Redshift를 AWS 콘솔에 대한 통합 인증 및 Amazon Redshift에 대한 페더레이션 로그인에 사용할 엔터프라이즈 애플리케이션으로 추가합니다. Enterprise application(엔터프라이즈 애플리케이션)을 선택합니다.

  4. +New application(새 애플리케이션 추가)을 선택합니다. 애플리케이션 추가 페이지가 나타납니다.

  5. 검색 필드에서 AWS를 검색합니다.

  6. [Amazon Web Services(AWS)]와 [추가(Add)]를 차례로 선택합니다. 그러면 AWS 애플리케이션이 생성됩니다.

  7. 관리에서 Single sign-on을 선택합니다.

  8. SAML을 선택합니다. Amazon Web Services(AWS) | SAML -based Sign-on(SAML 기반 로그온) 페이지가 나타납니다.

  9. 예를 선택하여 Set up Single Sign-On with SAML(SAML을 사용하여 Single Sign-On 설정) 페이지로 이동합니다. 이 페이지에는 미리 구성된 Single Sign-On 관련 속성 목록이 나와 있습니다.

  10. Basic SAML Configuration(기본 SAML 구성)에서 편집 아이콘을 선택하고 저장을 선택합니다.

  11. 둘 이상의 애플리케이션에 대해 구성하는 경우 식별자 값을 제공합니다. 예를 들면 https://signin.aws.amazon.com/saml#2를 입력합니다. 두 번째 애플리케이션부터 이 형식을 # 기호와 함께 사용하여 고유한 SPN 값을 지정합니다.

  12. User Attributes and Claims(사용자 속성 및 클레임) 섹션에서 편집 아이콘을 선택합니다.

    기본적으로 고유한 사용자 식별자(UID), 역할, RoleSessionName 및 SessionDuration 클레임은 미리 구성되어 있습니다.

  13. + Add new claim(새 클레임 추가)을 선택하여 데이터베이스 사용자에 대한 클레임을 추가합니다.

    이름(Name)에 DbUser을 입력합니다.

    네임스페이스(Namespace)에https://redshift.amazon.com/SAML/Attributes를 입력합니다.

    소스(Source)에서 속성(Attribute)를 선택합니다.

    소스 속성에서 user.userprincipalname을 선택합니다. 그런 다음 저장(Save)을 선택합니다.

  14. + Add new claim(새 클레임 추가)을 선택하여 AutoCreate에 대한 클레임을 추가합니다.

    Name(이름)에 AutoCreate을 입력합니다.

    네임스페이스(Namespace)에https://redshift.amazon.com/SAML/Attributes를 입력합니다.

    Source(소스)에서Attribute(속성)를 선택합니다.

    소스 속성에서 "true"를 선택합니다. 그런 다음 Save(저장)을 선택합니다.

    여기에서 123456789012는 AWS 계정, AzureSSO는 생성한 IAM 역할, AzureADProvider는 IAM 공급자입니다.

    클레임 이름 값

    고유한 사용자 식별자(이름 ID)

    user.userprincipalname

    https://aws.amazon.com/SAML/Attributes/SessionDuration

    "900"

    https://aws.amazon.com/SAML/Attributes/Role

    arn:aws:iam::123456789012:role/AzureSSO,arn:aws:iam::123456789012:saml-provider/AzureADProvider

    https://aws.amazon.com/SAML/Attributes/RoleSessionName

    user.userprincipalname

    https://redshift.amazon.com/SAML/Attributes/AutoCreate

    "true"

    https://redshift.amazon.com/SAML/Attributes/DbGroups

    user.assignedroles

    https://redshift.amazon.com/SAML/Attributes/DbUser

    user.userprincipalname

  15. 앱 등록 > your-application-name > 인증에서 모바일 및 데스크톱 애플리케이션을 추가합니다. URL을 http://localhost/redshift/로 지정합니다.

  16. SAML Signing Certificate(SAML 서명 인증서) 섹션에서 다운로드를 선택하여 IAM SAML 자격 증명 공급자를 만들 때 사용할 연동 메타데이터 XML 파일을 다운로드하고 저장합니다. 이 파일은 Single Sign-On 페더레이션 자격 증명을 생성하는 데 사용됩니다.

  17. IAM 콘솔에서 IAM SAML 자격 증명 공급자를 만듭니다. 제공하는 메타데이터 문서는 Azure 엔터프라이즈 애플리케이션을 설정할 때 저장한 연동 메타데이터 XML 파일입니다. 자세한 단계는 IAM User Guide의 Creating and Managing an IAM Identity Provider (Console)를 참조하세요.

  18. IAM 콘솔에서 SAML 2.0 연동을 위한 IAM 역할을 만듭니다. 자세한 단계는 IAM User Guide의 Creating a Role for SAML을 참조하세요.

  19. IAM 콘솔에서 SAML 2.0 연동을 위해 생성한 IAM 역할에 연결할 수 있는 IAM 정책을 만듭니다. 자세한 단계는 IAM User Guide의 Creating IAM Policies (Console)를 참조하세요.

    환경에 맞게 다음 정책(JSON 형식)을 수정합니다.

    • us-west-1을 해당 클러스터의 AWS 리전으로 대체합니다.

    • 123456789012를 AWS 계정으로 대체합니다.

    • cluster-identifier를 클러스터 식별자(또는 모든 클러스터의 경우 *)로 대체합니다.

    • dev를 데이터베이스(또는 모든 클러스터의 경우 *)로 대체합니다.

    • AROAJ2UCCR6DPCEXAMPLE을 해당 IAM 역할의 고유 식별자로 대체합니다.

    • example.com은 해당 테넌트 또는 회사 이메일 도메인으로 대체합니다.

    • my_dbgroup은 사용자를 할당할 데이터베이스 그룹으로 대체합니다.

    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "redshift:GetClusterCredentials",
            "Resource": [
                "arn:aws:redshift:us-west-1:123456789012:dbname:cluster-identifier/dev",
                "arn:aws:redshift:us-west-1:123456789012:dbuser:cluster-identifier/${redshift:DbUser}",
                "arn:aws:redshift:us-west-1:123456789012:cluster:cluster-identifier"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:userid": "AROAJ2UCCR6DPCEXAMPLE:${redshift:DbUser}@example.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": "redshift:CreateClusterUser",
            "Resource": "arn:aws:redshift:us-west-1:123456789012:dbuser:cluster-identifier/${redshift:DbUser}"
        },
        {
            "Effect": "Allow",
            "Action": "redshift:JoinGroup",
            "Resource": "arn:aws:redshift:us-west-1:123456789012:dbgroup:cluster-identifier/my_dbgroup"
        },
        {
            "Effect": "Allow",
            "Action": [
                "redshift:DescribeClusters",
                "iam:ListRoles"
            ],
            "Resource": "*"
        }
    ]
}

    이 정책은 다음과 같이 권한을 부여합니다.

    • 첫 번째 섹션에서는 지정된 클러스터에 대한 임시 자격 증명을 얻기 위해 GetClusterCredentials API 작업에 권한을 부여합니다. 이 예에서 리소스는 cluster-identifier로, 데이터베이스 dev가 있으며, 계정 123456789012와 AWS 리전 us-west-1에 있습니다. ${redshift:DbUser} 절은 Azure AD에 지정된 DbUser 값과 일치하는 사용자만 연결하도록 허용합니다.

    • 조건 절은 특정 사용자만 임시 자격 증명을 받도록 적용합니다. 이는 회사 이메일 도메인의 이메일 주소로 식별되는 IAM 계정에서 역할 고유 ID AROAJ2UCCR6DPCEXAMPLE로 지정된 역할을 가진 사용자입니다. 고유 ID에 대한 자세한 내용은 IAM User Guide의 Unique IDs를 참조하세요.

      IdP(이 경우 Azure AD) 설정에 따라 조건 절의 작성 방법이 결정됩니다. 직원의 이메일이 johndoe@example.com인 경우, 먼저 ${redshift:DbUser}를 해당 직원의 사용자 이름 johndoe와 일치하는 수퍼 필드로 설정합니다. 그런 다음 AWS SAML RoleSessionName 필드를 해당 직원의 이메일 johndoe@example.com과 일치하는 수퍼 필드로 설정하여 이 조건을 작동시킵니다. 이 접근 방식을 이용할 때는 다음 사항을 고려하십시오.

      • ${redshift:DbUser}를 직원의 이메일이 되도록 설정한 경우, RoleSessionName과 일치하도록 JSON 예에서 @example.com을 제거합니다.

      • RoleSessionId를 직원의 사용자 이름이 되도록 설정한 경우, RoleSessionName과 일치하도록 예에서 @example.com을 제거합니다.

      • JSON 예제에서 ${redshift:DbUser} 및 RoleSessionName 모두 직원의 이메일로 설정됩니다. 이 JSON 예에서는 Amazon Redshift 데이터베이스 사용자 이름과 @example.com을 사용해 사용자를 로그인하여 클러스터에 액세스합니다.

    • 두 번째 섹션에서는 지정된 클러스터에 dbuser 이름을 만들 수 있는 권한을 부여합니다. 이 JSON 예에서는 생성을 ${redshift:DbUser}로 제한합니다.

    • 세 번째 섹션에서는 사용자가 참여할 수 있는 dbgroup을 지정할 권한을 부여합니다. 이 JSON 예에서는 사용자가 지정된 클러스터의 my_dbgroup 그룹에 참여할 수 있습니다.

    • 네 번째 섹션에서는 사용자가 모든 리소스에 대해 수행할 수 있는 작업에 대한 권한을 부여합니다. 이 JSON 예에서는 사용자가 redshift:DescribeClusters를 호출하여 클러스터 엔드포인트, AWS 리전 및 포트와 같은 클러스터 정보를 가져올 수 있도록 합니다. 또한 사용자가 iam:ListRoles를 호출하여 사용자가 맡을 수 있는 역할을 확인할 수 있도록 합니다.

Microsoft Azure AD에 대한 인증을 위해 JDBC를 설정하려면

  • Azure AD Single Sign-On을 사용하여 JDBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    JDBC 드라이버를 사용하는 클라이언트를 사용하여 Azure AD Single Sign-On으로 연결하거나 Java와 같은 언어를 사용하여 스크립트를 통해 연결할 수 있습니다. 설치 및 구성 정보는 Amazon Redshift용 JDBC 드라이버 버전 2.1 연결 구성 단원을 참조하십시오.

    예를 들어 SQLWorkbench/J를 클라이언트로 사용할 수 있습니다. SQLWorkbench/j를 구성할 때 데이터베이스의 URL은 다음 형식을 사용합니다.

    jdbc:redshift:iam://cluster-identifier:us-west-1/dev

    SQLWorkbench/J를 클라이언트로 사용하는 경우 다음 단계를 수행합니다.

    1. SQL Workbench/J를 시작합니다. [연결 프로파일 선택(Select Connection Profile)] 페이지에서 AzureAuth라는 [프로파일 그룹(Profile Group)]을 추가합니다.

    2. Connection Profile(연결 프로파일)에 Azure를 입력합니다.

    3. 드라이버 관리(Manage Drivers)를 선택하고, Amazon Redshift를 선택합니다. [라이브러리(Library)] 옆에 있는 [폴더 열기(Open Folder)] 아이콘을 선택한 다음 적절한 JDBC .jar 파일을 선택합니다.

    4. 연결 프로파일 선택(Select Connection Profile) 페이지에서 다음과 같이 연결 프로파일에 정보를 추가합니다.

      • 사용자에 Microsoft Azure 사용자 이름을 입력합니다. 이는 Single Sign-On에 사용 중인 Microsoft Azure 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다.

      • 암호에 Microsoft Azure 암호를 입력합니다.

      • 드라이버(Drivers)에서 Amazon Redshift(com.amazon.redshift.jdbc.Driver)를 선택합니다.

      • URL에 jdbc:redshift:iam://your-cluster-identifier:your-cluster-region/your-database-name을 입력합니다.

    5. Extended Properties(확장 속성)를 선택하여 다음 설명과 같이 연결 속성에 추가 정보를 추가합니다.

      Azure AD Single Sign-On 구성의 경우 다음과 같이 추가 정보를 추가합니다.

      • plugin_name에 com.amazon.redshift.plugin.AzureCredentialsProvider를 입력합니다. 이 값은 드라이버에 Azure AD Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

      • idp_tenant에 your-idp-tenant를 입력합니다. Microsoft Azure AD에만 사용됩니다. 이는 Azure AD에 구성된 회사의 테넌트 이름입니다. 이 값은 테넌트 이름이거나 하이픈이 있는 테넌트 고유 ID일 수 있습니다.

      • client_secret에 your-azure-redshift-application-client-secret를 입력합니다. Microsoft Azure AD에만 사용됩니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 암호입니다. 이는 com.amazon.redshift.plugin.AzureCredentialsProvider 플러그인에만 적용됩니다.

      • client_id에 your-azure-redshift-application-client-id를 입력합니다. Microsoft Azure AD에만 사용됩니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 ID(하이픈 포함)입니다.

      MFA를 사용하는 Azure AD Single Sign-On 구성의 경우 다음과 같이 연결 속성에 추가 정보를 추가합니다.

      • plugin_name에 com.amazon.redshift.plugin.BrowserAzureCredentialsProvider를 입력합니다. 이는 드라이버에 MFA를 사용하는 Azure AD Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

      • idp_tenant에 your-idp-tenant를 입력합니다. Microsoft Azure AD에만 사용됩니다. 이는 Azure AD에 구성된 회사의 테넌트 이름입니다. 이 값은 테넌트 이름이거나 하이픈이 있는 테넌트 고유 ID일 수 있습니다.

      • client_id에 your-azure-redshift-application-client-id를 입력합니다. 이 옵션은 Microsoft Azure AD에만 사용됩니다. 이는 MFA를 사용하는 Azure AD Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 ID(하이픈 포함)입니다.

      • listen_port에 your-listen-port를 입력합니다. 로컬 서버가 수신 대기하는 포트입니다. 기본값은 7890입니다.

      • idp_response_timeout에 the-number-of-seconds를 입력합니다. 이는 IdP 서버가 응답을 다시 보낼 때 제한 시간이 지나기 전까지 대기하는 시간(초)입니다. 최소 시간(초)은 10이어야 합니다. 연결 구성이 이 제한 시간보다 어래 걸리면 연결이 중단됩니다.

Microsoft Azure AD에 대한 인증을 위해 ODBC를 설정하려면

  • Azure AD Single Sign-On을 사용하여 ODBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    Amazon Redshift는 Linux, Windows 및 macOS 운영 체제용 ODBC 드라이버를 제공합니다. ODBC 드라이버를 설치하려면 먼저 SQL 클라이언트 도구가 32비트인지, 64비트인지 확인합니다. SQL 클라이언트 도구의 요구 사항에 맞는 ODBC 드라이버를 설치합니다.

    또한 다음과 같이 운영 체제에 맞는 최신 Amazon Redshift OBDC 드라이버를 설치하고 구성합니다.

    Windows의 경우 Amazon Redshift ODBC 드라이버 DSN 설정(Amazon Redshift ODBC Driver DSN Setup) 페이지의 연결 설정(Connection Settings) 아래에 다음 정보를 입력합니다.

    • 데이터 원본 이름(Data Source Name)에 your-DSN을 입력합니다. 이는 ODBC 프로파일 이름으로 사용되는 데이터 원본 이름을 지정합니다.

    • Azure AD Single Sign-On 구성을 위한 Auth type(인증 유형)에서 Identity Provider: Azure AD를 선택합니다. 이는 ODBC 드라이버가 Azure Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • MFA를 사용하는 Azure AD Single Sign-On 구성을 위한 Auth type(인증 유형)에서 Identity Provider: Browser Azure AD를 선택합니다. 이는 ODBC 드라이버가 MFA를 사용하는 Azure Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • 클러스터 ID(Cluster ID)에 your-cluster-identifier를 입력합니다.

    • 리전(Region)에 your-cluster-region을 입력합니다.

    • 데이터베이스(Database)에 your-database-name을 입력합니다.

    • 사용자(User)에 your-azure-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Microsoft Azure 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. 인증 유형(Auth Type)이 자격 증명 공급자: Azure AD(Identity Provider: Azure AD)인 경우에만 이를 사용합니다.

    • 암호(Password)에 your-azure-password를 입력합니다. Auth Type(인증 유형)이 Identity Provider: Azure AD(자격 증명 공급자: Azure AD)인 경우에만 이를 사용합니다.

    • IdP 테넌트에 your-idp-tenant를 입력합니다. 이는 IdP(Azure)에 구성된 회사의 테넌트 이름입니다. 이 값은 테넌트 이름이거나 하이픈이 있는 테넌트 고유 ID일 수 있습니다.

    • Azure 클라이언트 암호에 your-azure-redshift-application-client-secret를 입력합니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 암호입니다.

    • Azure 클라이언트 ID에 your-azure-redshift-application-client-id를 입력합니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 ID(하이픈 포함)입니다.

    • 수신 대기 포트(Listen Port)에 your-listen-port를 입력합니다. 로컬 서버가 수신하는 기본 수신 대기 포트입니다. 기본값은 7890입니다. 이는 브라우저 Azure AD 플러그인에만 적용됩니다.

    • 응답 제한 시간(Response Timeout)에 the-number-of-seconds를 입력합니다. 이는 IdP 서버가 응답을 다시 보낼 때 제한 시간이 지나기 전까지 대기하는 시간(초)입니다. 최소 시간(초)은 10이어야 합니다. 연결 구성이 이 제한 시간보다 어래 걸리면 연결이 중단됩니다. 이 옵션은 브라우저 Azure AD 플러그인에만 적용됩니다.

    macOS 및 Linux에서는 다음과 같이 odbc.ini 파일을 편집합니다.

    참고

    모든 항목은 대/소문자를 구분하지 않습니다.

    • clusterid에 your-cluster-identifier를 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 이름입니다.

    • 리전(region)에 your-cluster-region을 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 AWS 리전입니다.

    • 데이터베이스(database)에 your-database-name을 입력합니다. 이는 Amazon Redshift 클러스터에서 액세스하려는 데이터베이스의 이름입니다.

    • 로캘(locale)에 en-us를 입력합니다. 이는 오류 메시지가 표시되는 언어입니다.

    • iam에 1을 입력합니다. 이 값은 드라이버에 IAM 자격 증명을 사용하여 인증하도록 지정합니다.

    • Azure AD Single Sign-On 구성을 위한 plugin_name에 AzureAD를 입력합니다. 이는 드라이버에 Azure Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

    • MFA를 사용하는 Azure AD Single Sign-On 구성을 위한 plugin_name에 BrowserAzureAD를 입력합니다. 이는 드라이버에 MFA를 사용하는 Azure Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

    • uid에 your-azure-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Microsoft Azure 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. plugin_name이 AzureAD인 경우에만 이를 사용합니다.

    • pwd에 your-azure-password를 입력합니다. plugin_name이 AzureAD인 경우에만 이를 사용합니다.

    • idp_tenant에 your-idp-tenant를 입력합니다. 이는 IdP(Azure)에 구성된 회사의 테넌트 이름입니다. 이 값은 테넌트 이름이거나 하이픈이 있는 테넌트 고유 ID일 수 있습니다.

    • client_secret에 your-azure-redshift-application-client-secret를 입력합니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 암호입니다.

    • client_id에 your-azure-redshift-application-client-id를 입력합니다. 이는 Azure Single Sign-On 구성을 설정할 때 생성한 Amazon Redshift 애플리케이션의 클라이언트 ID(하이픈 포함)입니다.

    • listen_port에 your-listen-port를 입력합니다. 로컬 서버가 수신 대기하는 포트입니다. 기본값은 7890입니다. 이는 브라우저 Azure AD 플러그인에 적용됩니다.

    • idp_response_timeout에 the-number-of-seconds를 입력합니다. 이는 Azure로부터 응답을 기다리는 지정된 시간(초)입니다. 이 옵션은 브라우저 Azure AD 플러그인에 적용됩니다.

    macOS 및 Linux에서는 프로파일 설정을 편집하여 다음 내보내기도 추가합니다.

    export ODBCINI=/opt/amazon/redshift/Setup/odbc.ini
    export ODBCINSTINI=/opt/amazon/redshift/Setup/odbcinst.ini
브라우저 Azure AD 플러그인 문제를 해결하려면

  1. 브라우저 Azure AD 플러그인을 사용하려면 요청에 지정된 회신 URL을 애플리케이션에 대해 구성된 회신 URL과 일치하도록 설정해야 합니다.

    Microsoft Azure 포털에서 SAML을 사용하여 SSO(Single Sign-On) 설정 페이지로 이동합니다. 그런 다음 회신 URL이 http://localhost/redshift/로 설정되어 있는지 확인합니다.

  2. IdP 테넌트 오류가 발생하면 IdP 테넌트 이름이 Microsoft Azure에서 Active Directory를 설정하는 데 처음 사용한 도메인 이름과 일치하는지 확인합니다.

    Windows에서 [Amazon Redshift ODBC DSN 설정(Amazon Redshift ODBC DSN Setup)] 페이지의 [연결 설정(Connection Settings)] 섹션으로 이동합니다. 그런 다음 IdP(Azure)에 구성된 회사의 테넌트 이름이 Microsoft Azure에서 Active Directory를 설정하는 데 처음 사용한 도메인 이름과 일치하는지 확인합니다.

    macOS 및 Linux에서 odbc.ini 파일을 찾습니다. 그런 다음 IdP(Azure)에 구성된 회사의 테넌트 이름이 Microsoft Azure에서 Active Directory를 설정하는 데 처음 사용한 도메인 이름과 일치하는지 확인합니다.

  3. 요청에 지정된 회신 URL이 애플리케이션에 대해 구성된 회신 URL과 일치하지 않는 오류가 발생하는 경우 리디렉션 URI가 회신 URL과 동일한지 확인합니다.

    Microsoft Azure 포털에서 애플리케이션의 앱 등록 페이지로 이동합니다. 그런 다음 리디렉션 URI가 응답 URL과 일치하는지 확인합니다.

  4. 예기치 않은 응답: 무단 오류가 발생하는 경우 모바일 및 데스크톱 애플리케이션 구성을 완료했는지 확인합니다.

    Microsoft Azure 포털에서 애플리케이션의 앱 등록 페이지로 이동합니다. 그런 다음 인증으로 이동하여 http://localhost/redshift/를 리디렉션 URI로 사용하도록 모바일 및 데스크톱 애플리케이션을 구성했는지 확인합니다.

AD FS에서 JDBC 또는 ODBC Single Sign-on 인증 설정

AD FS를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음에는 이 목적을 위해 신뢰 관계를 설정하는 방법을 설명하는 절차를 안내합니다. AD FS에 대한 서비스 공급자로 AWS 구성에 대한 자세한 내용은 IAM User Guide의 Configuring Your SAML 2.0 IdP with Relying Party Trust and Adding Claims를 참조하세요.

AD FS와 AWS 계정을 서로 신뢰하도록 설정하려면

  1. AD FS 사용자가 연결할 기존 Amazon Redshift 클러스터를 사용하거나 생성합니다. 연결을 구성하려면 이 클러스터의 특정 속성(예: 클러스터 식별자)이 필요합니다. 자세한 내용은 클러스터 생성 섹션을 참조하세요.

  2. Microsoft Management Console에서 Amazon Redshift 액세스를 제어하도록 AD FS를 설정합니다.

    1. ADFS 2.0을 선택한 후 Add Relying Party Trust(신뢰 당사자 신뢰 추가)를 선택합니다. Add Relying Party Trust Wizard(신뢰 당사자 신뢰 추가 마법사) 페이지에서 시작을 선택합니다.

    2. Select Data Source(데이터 원본 선택) 페이지에서 Import data about the relying party published online or on a local network(온라인 또는 로컬 네트워크에 게시된 신뢰 당사자에 대한 데이터 가져오기)를 선택합니다.

    3. Federation metadata address (host name or URL)(연동 메타데이터 주소(호스트 이름 또는 URL))에 https://signin.aws.amazon.com/saml-metadata.xml을 입력합니다. 메타데이터 XML 파일은 AWS를 신뢰 당사자로 설명하는 표준 SAML 메타데이터 문서입니다.

    4. 표시 이름 지정 페이지에서 표시 이름에 값을 입력합니다.

    5. Choose Issuance Authorization Rules(발급 권한 부여 규칙 선택) 페이지에서 발급 권한 부여 규칙을 선택하여 모든 사용자가 이 신뢰 당사자에 액세스할 수 있도록 허용하거나 거부합니다.

    6. Ready to Add Trust(신뢰 추가 준비 완료) 페이지에서 설정을 검토합니다.

    7. Finish(완료) 페이지에서 Open the Edit Claim Rules dialog for this relying party trust when the wizard closes(마법사가 닫힐 때 이 신뢰 당사자 신뢰에 대한 클레임 규칙 편집 대화 상자 열기)를 선택합니다.

    8. 컨텍스트(오른쪽 클릭) 메뉴에서 Relying Party Trusts(신뢰 당사자 신뢰)를 선택합니다.

    9. 신뢰 당사자의 경우 컨텍스트(오른쪽 클릭) 메뉴를 열고 Edit Claim Rules(클레임 규칙 편집)를 선택합니다. 클레임 규칙 편집(Edit Claim Rules) 페이지에서 규칙 추가(Add Rule)를 선택합니다.

    10. Claim rule template(클레임 규칙 템플릿)에서 Transform an Incoming Claim(수신 클레임 변환)을 선택한 후 Edit Rule – NameId(규칙 편집 – NameId) 페이지에서 다음을 수행합니다.

      • 클레임 규칙 이름에 NameId를 입력합니다.

      • Incoming claim name(수신 클레임 이름)으로 Windows Account Name(Windows 계정 이름)을 선택합니다.

      • Outgoing claim name(발신 클레임 이름)으로 Name ID(이름 ID)를 선택합니다.

      • Outgoing name ID format(발신 이름 ID 형식)으로 Persistent Identifier(영구 식별자)를 선택합니다.

      • Pass through all claim values(모든 클레임 값 전달)를 선택합니다.

    11. Edit Claim Rules(클레임 규칙 편집) 페이지에서 Add Rule(규칙 추가)를 선택합니다. Select Rule Template(규칙 템플릿 선택) 페이지에서 Claim rule template(클레임 규칙 템플릿)으로 Send LDAP Attributes as Claims(LDAP 속성을 클레임으로 전송)를 선택합니다.

    12. 규칙 구성 페이지에서 다음 작업을 수행합니다.

      • 클레임 규칙 이름에 RoleSessionName을 입력합니다.

      • 속성 저장의 경우 Active Directory를 선택합니다.

      • LDAP Attribute(LDAP 속성)의 경우 이메일 주소를 선택합니다.

      • [발신 클레임 유형(Outgoing Claim Type)]으로 https://aws.amazon.com/SAML/Attributes/RoleSessionName을 선택합니다.

    13. Edit Claim Rules(클레임 규칙 편집) 페이지에서 Add Rule(규칙 추가)를 선택합니다. 규칙 템플릿 선택(Select Rule Template) 페이지에서 클레임 규칙 템플릿(Claim rule template)으로 사용자 지정 규칙을 사용하여 클레임 전송(Send Claims Using a Custom Rule)을 선택합니다.

    14. Edit Rule – Get AD Groups(규칙 편집 – AD 그룹 가져오기) 페이지에서 클레임 규칙 이름에 Get AD Groups(AD 그룹 가져오기)를 입력합니다.

    15. Custom rule(사용자 지정 규칙)에 다음을 입력합니다.

      c:[Type ==
                                    "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname",
                                    Issuer == "AD AUTHORITY"] => add(store = "Active Directory",
                                    types = ("http://temp/variable"), query = ";tokenGroups;{0}",
                                    param = c.Value);

    16. Edit Claim Rules(클레임 규칙 편집) 페이지에서 Add Rule(규칙 추가)를 선택합니다. Select Rule Template(규칙 템플릿 선택) 페이지에서 Claim rule template(클레임 규칙 템플릿)으로 Send Claims Using a Custom Rule(사용자 지정 규칙을 사용하여 클레임 전송)을 선택합니다.

    17. Edit Rule – Roles(규칙 편집 – 역할) 페이지에서 클레임 규칙 이름에 역할을 입력합니다.

    18. Custom rule(사용자 지정 규칙)에 다음을 입력합니다.

      c:[Type == "http://temp/variable", Value =~ "(?i)^AWS-"] => issue(Type = "https://aws.amazon.com/SAML/Attributes/Role", Value = RegExReplace(c.Value, "AWS-", "arn:aws:iam::123456789012:saml-provider/ADFS,arn:aws:iam::123456789012:role/ADFS-"));

      SAML 공급자 및 맡을 역할의 ARN을 적어 둡니다. 이 예에서 arn:aws:iam:123456789012:saml-provider/ADFS는 SAML 공급자의 ARN이고 arn:aws:iam:123456789012:role/ADFS-는 역할의 ARN입니다.

  3. federationmetadata.xml 파일을 다운로드했는지 확인합니다. 문서 내용에 잘못된 문자가 없는지 확인합니다. 이는 AWS와의 신뢰 관계를 구성할 때 사용하는 메타데이터 파일입니다.

  4. IAM 콘솔에서 IAM SAML 자격 증명 공급자를 만듭니다. 제공하는 메타데이터 문서는 Azure 엔터프라이즈 애플리케이션을 설정할 때 저장한 연동 메타데이터 XML 파일입니다. 자세한 단계는 IAM User Guide의 Creating and Managing an IAM Identity Provider (Console)를 참조하세요.

  5. IAM 콘솔에서 SAML 2.0 연동을 위한 IAM 역할을 만듭니다. 자세한 단계는 IAM User Guide의 Creating a Role for SAML을 참조하세요.

  6. IAM 콘솔에서 SAML 2.0 연동을 위해 생성한 IAM 역할에 연결할 수 있는 IAM 정책을 만듭니다. 자세한 단계는 IAM User Guide의 Creating IAM Policies (Console)를 참조하세요. Azure AD 예제는 Microsoft Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정 단원을 참조하십시오.

AD FS에 대한 인증을 위해 JDBC를 설정하려면

  • AD FS Single Sign-On을 사용하여 JDBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    JDBC 드라이버를 사용하는 클라이언트를 사용하여 AD FS Single Sign-On으로 연결하거나 Java와 같은 언어를 사용하여 스크립트를 통해 연결할 수 있습니다. 설치 및 구성 정보는 Amazon Redshift용 JDBC 드라이버 버전 2.1 연결 구성 단원을 참조하십시오.

    예를 들어 SQLWorkbench/J를 클라이언트로 사용할 수 있습니다. SQLWorkbench/j를 구성할 때 데이터베이스의 URL은 다음 형식을 사용합니다.

    jdbc:redshift:iam://cluster-identifier:us-west-1/dev

    SQLWorkbench/J를 클라이언트로 사용하는 경우 다음 단계를 수행합니다.

    1. SQL Workbench/J를 시작합니다. [연결 프로파일 선택(Select Connection Profile)] 페이지에서 [프로파일 그룹(Profile Group)]을 추가합니다(예: ADFS).

    2. Connection Profile(연결 프로파일)에 연결 프로파일 이름을 입력합니다(예: ADFS).

    3. Manage Drivers(드라이버 관리)를 선택하고, Amazon Redshift를 선택합니다. [라이브러리(Library)] 옆에 있는 [폴더 열기(Open Folder)] 아이콘을 선택한 다음 적절한 JDBC .jar 파일을 선택합니다.

    4. Select Connection Profile(연결 프로파일 선택) 페이지에서 다음과 같이 연결 프로파일에 정보를 추가합니다.

      • 사용자에 AD FS 사용자 이름을 입력합니다. 이는 Single Sign-On에 사용 중인 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다.

      • 암호에 AD FS 암호를 입력합니다.

      • 드라이버(Drivers)에서 Amazon Redshift(com.amazon.redshift.jdbc.Driver)를 선택합니다.

      • URL에 jdbc:redshift:iam://your-cluster-identifier:your-cluster-region/your-database-name을 입력합니다.

    5. [확장 속성(Extended Properties)]을 선택합니다. plugin_name에 com.amazon.redshift.plugin.AdfsCredentialsProvider를 입력합니다. 이 값은 드라이버에 AD FS Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

AD FS에 대한 인증을 위해 ODBC를 설정하려면

  • AD FS Single Sign-On을 사용하여 ODBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    Amazon Redshift는 Linux, Windows 및 macOS 운영 체제용 ODBC 드라이버를 제공합니다. ODBC 드라이버를 설치하려면 먼저 SQL 클라이언트 도구가 32비트인지, 64비트인지 확인합니다. SQL 클라이언트 도구의 요구 사항에 맞는 ODBC 드라이버를 설치합니다.

    또한 다음과 같이 운영 체제에 맞는 최신 Amazon Redshift OBDC 드라이버를 설치하고 구성합니다.

    Windows의 경우 Amazon Redshift ODBC 드라이버 DSN 설정(Amazon Redshift ODBC Driver DSN Setup) 페이지의 연결 설정(Connection Settings) 아래에 다음 정보를 입력합니다.

    • 데이터 원본 이름(Data Source Name)에 your-DSN을 입력합니다. 이는 ODBC 프로파일 이름으로 사용되는 데이터 원본 이름을 지정합니다.

    • [인증 유형(Auth type)]에서 [자격 증명 공급자: SAML(Identity Provider: SAML)]을 선택합니다. 이는 ODBC 드라이버가 AD FS Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • 클러스터 ID(Cluster ID)에 your-cluster-identifier를 입력합니다.

    • 리전(Region)에 your-cluster-region을 입력합니다.

    • 데이터베이스(Database)에 your-database-name을 입력합니다.

    • 사용자(User)에 your-adfs-username을 입력합니다. 이는 Single Sign-On에 사용 중인 AD FS 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. 인증 유형(Auth type)이 자격 증명 공급자: SAML(Identity Provider: SAML)인 경우에만 이를 사용합니다.

    • Password(암호)에 your-adfs-password를 입력합니다. Auth type(인증 유형)이 Identity Provider: SAML(자격 증명 공급자: SAML)인 경우에만 이를 사용합니다.

    macOS 및 Linux에서는 다음과 같이 odbc.ini 파일을 편집합니다.

    참고

    모든 항목은 대/소문자를 구분하지 않습니다.

    • clusterid에 your-cluster-identifier를 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 이름입니다.

    • 리전(region)에 your-cluster-region을 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 AWS 리전입니다.

    • 데이터베이스(database)에 your-database-name을 입력합니다. 이는 Amazon Redshift 클러스터에서 액세스하려는 데이터베이스의 이름입니다.

    • 로캘(locale)에 en-us를 입력합니다. 이는 오류 메시지가 표시되는 언어입니다.

    • iam에 1을 입력합니다. 이 값은 드라이버에 IAM 자격 증명을 사용하여 인증하도록 지정합니다.

    • plugin_name의 경우 다음 중 하나를 수행합니다.

      • MFA를 사용하는 Azure AD Single Sign-On 구성에 BrowserSAML을 입력합니다. 이는 ODBC 드라이버가 AD FS에 인증할 때 사용하는 인증 방법입니다.

      • Azure AD Single Sign-On 구성에 ADFS를 입력합니다. 이는 ODBC 드라이버가 Azure AD Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • uid에 your-adfs-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Microsoft Azure 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. plugin_name이 ADFS인 경우에만 이를 사용합니다.

    • pwd에 your-adfs-password를 입력합니다. plugin_name이 ADFS인 경우에만 이를 사용합니다.

    macOS 및 Linux에서는 프로파일 설정을 편집하여 다음 내보내기도 추가합니다.

    export ODBCINI=/opt/amazon/redshift/Setup/odbc.ini
    export ODBCINSTINI=/opt/amazon/redshift/Setup/odbcinst.ini

Ping Identity에서 JDBC 또는 ODBC Single Sign-On 인증 설정

Ping Identity를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음에는 이 목적을 위해 PingOne 포털을 사용하여 신뢰 관계를 설정하는 방법을 설명하는 절차를 안내합니다. Ping Identity에 대한 서비스 공급자로 AWS 구성에 대한 자세한 내용은 IAM User Guide의 Configuring Your SAML 2.0 IdP with Relying Party Trust and Adding Claims를 참조하세요.

Ping Identity와 AWS 계정을 서로 신뢰하도록 설정하려면

  1. Ping Identity 사용자가 연결할 기존 Amazon Redshift 클러스터를 사용하거나 생성합니다. 연결을 구성하려면 이 클러스터의 특정 속성(예: 클러스터 식별자)이 필요합니다. 자세한 내용은 클러스터 생성 섹션을 참조하세요.

  2. Amazon Redshift를 PingOne 포털의 새 SAML 애플리케이션으로 추가합니다. 자세한 단계는 Ping Identity 설명서를 참조하십시오.

    1. 내 애플리케이션으로 이동합니다.

    2. 애플리케이션 추가에서 New SAML Application(새 SAML 애플리케이션)을 선택합니다.

    3. 애플리케이션 이름에 Amazon Redshift를 입력합니다.

    4. Protocol Version(프로토콜 버전)에서 SAML v2.0을 선택합니다.

    5. Category(범주)에서 your-application-category를 선택합니다.

    6. Assertion Consumer Service (ACS)에 your-redshift-local-host-url을 입력합니다. 이는 SAML 어설션이 리디렉션하는 로컬 호스트 및 포트입니다.

    7. Entity ID(개체 ID)에 urn:amazon:webservices를 입력합니다.

    8. 서명(Signing)에서 어설션 서명(Sign Assertion)을 선택합니다.

    9. SSO Attribute Mapping(SSO 속성 매핑) 섹션에서 다음 표와 같이 클레임을 만듭니다.

      애플리케이션 속성 리터럴 값의 자격 증명 브리지 속성

      https://aws.amazon.com/SAML/Attributes/Role

      arn:aws:iam::123456789012:role/Ping,arn:aws:iam::123456789012:saml-provider/PingProvider

      https://aws.amazon.com/SAML/Attributes/RoleSessionName

      이메일

      https://redshift.amazon.com/SAML/Attributes/AutoCreate

      "true"

      https://redshift.amazon.com/SAML/Attributes/DbUser

      이메일

      https://redshift.amazon.com/SAML/Attributes/DbGroups

      "DbGroups" 속성의 그룹에는 @directory 접두사가 포함됩니다. 이를 제거하려면 [자격 증명 브리지(Identity Bridge)]에 [memberOf]를 입력합니다. [함수(Function)]에서 [ExtractByRegularExpression]을 선택합니다. [표현식(Expression)]에서 (.*)[\@](?:.*)를 입력합니다.

  3. Group Access(그룹 액세스)에서 필요한 경우 다음 그룹 액세스를 설정합니다.

    • https://aws.amazon.com/SAML/Attributes/Role

    • https://aws.amazon.com/SAML/Attributes/RoleSessionName

    • https://redshift.amazon.com/SAML/Attributes/AutoCreate

    • https://redshift.amazon.com/SAML/Attributes/DbUser

  4. 필요한 경우 설정을 검토하고 변경합니다.

  5. Initiate Single Sign-On (SSO) URL(시작 Single Sign-On(SSO) URL)을 브라우저 SAML 플러그인의 로그인 URL로 사용합니다.

  6. IAM 콘솔에서 IAM SAML 자격 증명 공급자를 만듭니다. 제공하는 메타데이터 문서는 Ping Identity를 설정할 때 저장한 연동 메타데이터 XML 파일입니다. 자세한 단계는 IAM User Guide의 Creating and Managing an IAM Identity Provider (Console)를 참조하세요.

  7. IAM 콘솔에서 SAML 2.0 연동을 위한 IAM 역할을 만듭니다. 자세한 단계는 IAM User Guide의 Creating a Role for SAML을 참조하세요.

  8. IAM 콘솔에서 SAML 2.0 연동을 위해 생성한 IAM 역할에 연결할 수 있는 IAM 정책을 만듭니다. 자세한 단계는 IAM User Guide의 Creating IAM Policies (Console)를 참조하세요. Azure AD 예제는 Microsoft Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정 단원을 참조하십시오.

Ping Identity에 대한 인증을 위해 JDBC를 설정하려면

  • Ping Identity Single Sign-On을 사용하여 JDBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    JDBC 드라이버를 사용하는 클라이언트를 사용하여 Ping Identity Single Sign-On으로 연결하거나 Java와 같은 언어를 사용하여 스크립트를 통해 연결할 수 있습니다. 설치 및 구성 정보는 Amazon Redshift용 JDBC 드라이버 버전 2.1 연결 구성 단원을 참조하십시오.

    예를 들어 SQLWorkbench/J를 클라이언트로 사용할 수 있습니다. SQLWorkbench/j를 구성할 때 데이터베이스의 URL은 다음 형식을 사용합니다.

    jdbc:redshift:iam://cluster-identifier:us-west-1/dev

    SQLWorkbench/J를 클라이언트로 사용하는 경우 다음 단계를 수행합니다.

    1. SQL Workbench/J를 시작합니다. [연결 프로파일 선택(Select Connection Profile)] 페이지에서 [프로파일 그룹(Profile Group)]을 추가합니다(예: Ping).

    2. 연결 프로파일(Connection Profile)에 your-connection-profile-name을 입력합니다(예: Ping).

    3. Manage Drivers(드라이버 관리)를 선택하고, Amazon Redshift를 선택합니다. [라이브러리(Library)] 옆에 있는 [폴더 열기(Open Folder)] 아이콘을 선택한 다음 적절한 JDBC .jar 파일을 선택합니다.

    4. Select Connection Profile(연결 프로파일 선택) 페이지에서 다음과 같이 연결 프로파일에 정보를 추가합니다.

      • User(사용자)에 PingOne 사용자 이름을 입력합니다. 이는 Single Sign-On에 사용 중인 PingOne 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다.

      • Password(암호)에 PingOne 암호를 입력합니다.

      • 드라이버(Drivers)에서 Amazon Redshift(com.amazon.redshift.jdbc.Driver)를 선택합니다.

      • URL에 jdbc:redshift:iam://your-cluster-identifier:your-cluster-region/your-database-name을 입력합니다.

    5. 확장 속성(Extended Properties)를 선택하고 다음 중 하나를 수행합니다.

      • login_url에 your-ping-sso-login-url을 입력합니다. 이 값은 URL에 Single Sign-On을 로그인하기 위한 인증으로 사용하도록 지정합니다.

      • Ping Identity의 경우 plugin_name에 com.amazon.redshift.plugin.PingCredentialsProvider를 입력합니다. 이 값은 드라이버에 Ping Identity Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

      • Single Sign-On을 사용한 Ping Identity의 경우 plugin_name에 com.amazon.redshift.plugin.BrowserSamlCredentialsProvider를 입력합니다. 이 값은 드라이버에 Ping Identity PingOne과 함께 Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

Ping Identity에 대한 인증을 위해 ODBC를 설정하려면

  • Ping Identity PingOne Single Sign-On을 사용하여 ODBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    Amazon Redshift는 Linux, Windows 및 macOS 운영 체제용 ODBC 드라이버를 제공합니다. ODBC 드라이버를 설치하려면 먼저 SQL 클라이언트 도구가 32비트인지, 64비트인지 확인합니다. SQL 클라이언트 도구의 요구 사항에 맞는 ODBC 드라이버를 설치합니다.

    또한 다음과 같이 운영 체제에 맞는 최신 Amazon Redshift OBDC 드라이버를 설치하고 구성합니다.

    Windows의 경우 Amazon Redshift ODBC 드라이버 DSN 설정(Amazon Redshift ODBC Driver DSN Setup) 페이지의 연결 설정(Connection Settings) 아래에 다음 정보를 입력합니다.

    • 데이터 원본 이름(Data Source Name)에 your-DSN을 입력합니다. 이는 ODBC 프로파일 이름으로 사용되는 데이터 원본 이름을 지정합니다.

    • 인증 유형(Auth type)에서 다음 중 하나를 수행합니다.

      • Ping Identity 구성의 경우 자격 증명 공급자: Ping Federate를 선택합니다. 이는 ODBC 드라이버가 Ping Identity Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

      • Single Sign-On 구성을 사용하는 Ping Identity의 경우 자격 증명 공급자: 브라우저 SAML을 선택합니다. 이는 ODBC 드라이버가 Single Sign-On이 포함된 Ping Identity를 사용하여 인증할 때의 인증 방법입니다.

    • 클러스터 ID(Cluster ID)에 your-cluster-identifier를 입력합니다.

    • 리전(Region)에 your-cluster-region을 입력합니다.

    • 데이터베이스(Database)에 your-database-name을 입력합니다.

    • 사용자(User)에 your-ping-username을 입력합니다. 이는 Single Sign-On에 사용 중인 PingOne 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. 인증 유형(Auth type)이 자격 증명 공급자: PingFederate(Identity Provider: PingFederate)인 경우에만 이를 사용합니다.

    • 암호(Password)에 your-ping-password를 입력합니다. 인증 유형(Auth type)이 자격 증명 공급자: PingFederate(Identity Provider: PingFederate)인 경우에만 이를 사용합니다.

    • 수신 대기 포트(Listen Port)에 your-listen-port를 입력합니다. 로컬 서버가 수신 대기하는 포트입니다. 기본값은 7890입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • 응답 제한 시간(Response Timeout)에 the-number-of-seconds를 입력합니다. 이는 IdP 서버가 응답을 다시 보낼 때 제한 시간이 지나기 전까지 대기하는 시간(초)입니다. 최소 시간(초)은 10이어야 합니다. 연결 구성이 이 제한 시간보다 어래 걸리면 연결이 중단됩니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • 로그인 URL에 your-login-url을 입력합니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    macOS 및 Linux에서는 다음과 같이 odbc.ini 파일을 편집합니다.

    참고

    모든 항목은 대/소문자를 구분하지 않습니다.

    • clusterid에 your-cluster-identifier를 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 이름입니다.

    • 리전(region)에 your-cluster-region을 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 AWS 리전입니다.

    • 데이터베이스(database)에 your-database-name을 입력합니다. 이는 Amazon Redshift 클러스터에서 액세스하려는 데이터베이스의 이름입니다.

    • 로캘(locale)에 en-us를 입력합니다. 이는 오류 메시지가 표시되는 언어입니다.

    • iam에 1을 입력합니다. 이 값은 드라이버에 IAM 자격 증명을 사용하여 인증하도록 지정합니다.

    • plugin_name의 경우 다음 중 하나를 수행합니다.

      • Ping Identity 구성의 경우 BrowserSAML을 입력합니다. 이는 ODBC 드라이버가 Ping Identity에 인증할 때 사용하는 인증 방법입니다.

      • Single Sign-On을 사용하는 Ping Identity 구성에 Ping을 입력합니다. 이는 ODBC 드라이버가 Single Sign-On이 포함된 Ping Identity를 사용하여 인증할 때의 인증 방법입니다.

    • uid에 your-ping-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Microsoft Azure 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. plugin_name이 Ping인 경우에만 이를 사용합니다.

    • pwd에 your-ping-password를 입력합니다. plugin_name이 Ping인 경우에만 이를 사용합니다.

    • login_url에 your-login-url을 입력합니다. 이는 SAML 응답을 반환하는 시작 Single Sign-On URL입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • idp_response_timeout에 the-number-of-seconds를 입력합니다. 이는 PingOne Identity로부터 응답을 기다리는 지정된 시간(초)입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • listen_port에 your-listen-port를 입력합니다. 로컬 서버가 수신 대기하는 포트입니다. 기본값은 7890입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    macOS 및 Linux에서는 프로파일 설정을 편집하여 다음 내보내기도 추가합니다.

    export ODBCINI=/opt/amazon/redshift/Setup/odbc.ini
    export ODBCINSTINI=/opt/amazon/redshift/Setup/odbcinst.ini

Okta에서 JDBC 또는 ODBC Single Sign-on 인증 설정

Okta를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음에는 이 목적을 위해 신뢰 관계를 설정하는 방법을 설명하는 절차를 안내합니다. Okta에 대한 서비스 공급자로 AWS 구성에 대한 자세한 내용은 IAM User Guide의 Configuring Your SAML 2.0 IdP with Relying Party Trust and Adding Claims를 참조하세요.

Okta와 AWS 계정을 서로 신뢰하도록 설정하려면

  1. Okta 사용자가 연결할 기존 Amazon Redshift 클러스터를 사용하거나 생성합니다. 연결을 구성하려면 이 클러스터의 특정 속성(예: 클러스터 식별자)이 필요합니다. 자세한 내용은 클러스터 생성 섹션을 참조하세요.

  2. Amazon Redshift를 Okta 포털의 새 애플리케이션으로 추가합니다. 자세한 단계는 Okta documentation을 참조하십시오.

    • 애플리케이션 추가를 선택합니다.

    • 애플리케이션 추가에서 Create New App(새 앱 생성)을 선택합니다.

    • Create a New Add Application Integration(새 애플리케이션 통합 추가 생성) 페이지의 플랫폼에서 웹을 선택합니다.

    • Sign on method(로그인 방법)에서 SAML v2.0을 선택합니다.

    • 일반 설정 페이지에서 앱 이름에 your-redshift-saml-sso-name을 입력합니다. 이는 애플리케이션 이름입니다.

    • SAML 설정 페이지에서 SSO(Single Sign-On) URL에 your-redshift-local-host-url을 입력합니다. 이는 SAML 어설션이 리디렉션하는 로컬 호스트 및 포트입니다(예: http://localhost:7890/redshift/).

  3. [통합 인증 URL(Single sign on URL)] 값을 [수신자 URL(Recipient URL)] 및 [대상 URL(Destination URL)]로 사용합니다.

  4. Signing(서명)에서 Sign Assertion(어설션 서명)을 선택합니다.

  5. [대상 URI(SP 엔터티 ID)(Audience URI (SP Entity ID))]에 다음 표와 같이 클레임의 urn:amazon:webservices를 입력합니다.

  6. Advanced Settings(고급 설정) 섹션에서 SAML Issuer ID(SAML 발급자 ID)에 your-Identity-Provider-Issuer-ID를 입력합니다. 이는 View Setup Instructions(설정 지침 보기) 섹션에서 찾을 수 있습니다.

  7. Attribute Statements(속성 설명) 섹션에서 다음 표와 같이 클레임을 만듭니다.

    클레임 이름 값

    https://aws.amazon.com/SAML/Attributes/Role

    arn:aws:iam::123456789012:role/Okta,arn:aws:iam::123456789012:saml-provider/Okta

    https://aws.amazon.com/SAML/Attributes/RoleSessionName

    user.email

    https://redshift.amazon.com/SAML/Attributes/AutoCreate

    "true"

    https://redshift.amazon.com/SAML/Attributes/DbUser

    user.email

  8. App Embed Link(앱 포함 링크) 섹션에서 브라우저 SAML 플러그인의 로그인 URL로 사용할 수 있는 URL을 찾습니다.

  9. IAM 콘솔에서 IAM SAML 자격 증명 공급자를 만듭니다. 제공하는 메타데이터 문서는 Okta를 설정할 때 저장한 연동 메타데이터 XML 파일입니다. 자세한 단계는 IAM User Guide의 Creating and Managing an IAM Identity Provider (Console)를 참조하세요.

  10. IAM 콘솔에서 SAML 2.0 연동을 위한 IAM 역할을 만듭니다. 자세한 단계는 IAM User Guide의 Creating a Role for SAML을 참조하세요.

  11. IAM 콘솔에서 SAML 2.0 연동을 위해 생성한 IAM 역할에 연결할 수 있는 IAM 정책을 만듭니다. 자세한 단계는 IAM User Guide의 Creating IAM Policies (Console)를 참조하세요. Azure AD 예제는 Microsoft Azure AD에서 JDBC 또는 ODBC Single Sign-on 인증 설정 단원을 참조하십시오.

Okta에 대한 인증을 위해 JDBC를 설정하려면

  • Okta Single Sign-On을 사용하여 JDBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    JDBC 드라이버를 사용하는 클라이언트를 사용하여 Okta Single Sign-On으로 연결하거나 Java와 같은 언어를 사용하여 스크립트를 통해 연결할 수 있습니다. 설치 및 구성 정보는 Amazon Redshift용 JDBC 드라이버 버전 2.1 연결 구성 단원을 참조하십시오.

    예를 들어 SQLWorkbench/J를 클라이언트로 사용할 수 있습니다. SQLWorkbench/j를 구성할 때 데이터베이스의 URL은 다음 형식을 사용합니다.

    jdbc:redshift:iam://cluster-identifier:us-west-1/dev

    SQLWorkbench/J를 클라이언트로 사용하는 경우 다음 단계를 수행합니다.

    1. SQL Workbench/J를 시작합니다. [연결 프로파일 선택(Select Connection Profile)] 페이지에서 [프로파일 그룹(Profile Group)]을 추가합니다(예: Okta).

    2. 연결 프로파일(Connection Profile)에 your-connection-profile-name을 입력합니다(예: Okta).

    3. Manage Drivers(드라이버 관리)를 선택하고, Amazon Redshift를 선택합니다. [라이브러리(Library)] 옆에 있는 [폴더 열기(Open Folder)] 아이콘을 선택한 다음 적절한 JDBC .jar 파일을 선택합니다.

    4. 연결 프로파일 선택(Select Connection Profile) 페이지에서 다음과 같이 연결 프로파일에 정보를 추가합니다.

      • 사용자에 Okta 사용자 이름을 입력합니다. 이는 Single Sign-On에 사용 중인 Okta 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다.

      • 암호에 Okta 암호를 입력합니다.

      • 드라이버(Drivers)에서 Amazon Redshift(com.amazon.redshift.jdbc.Driver)를 선택합니다.

      • URL에 jdbc:redshift:iam://your-cluster-identifier:your-cluster-region/your-database-name을 입력합니다.

    5. 확장 속성(Extended Properties)를 선택하고 다음 중 하나를 수행합니다.

      • login_url에 your-okta-sso-login-url을 입력합니다. 이 값은 URL에 Single Sign-On을 Okta에 로그인하기 위한 인증으로 사용하도록 지정합니다.

      • Okta Single Sign-On에서 plugin_name에 com.amazon.redshift.plugin.OktaCredentialsProvider를 입력합니다. 이 값은 드라이버에 Okta Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

      • MFA를 사용하는 Okta Single Sign-On에서 plugin_name에 com.amazon.redshift.plugin.BrowserSamlCredentialsProvider를 입력합니다. 이는 드라이버에 MFA를 사용하는 Okta Single Sign-On을 인증 방법으로 사용하도록 지정합니다.

Okta에 대한 인증을 위해 ODBC를 설정하려면

  • Okta Single Sign-On을 사용하여 ODBC를 통해 클러스터에 연결하도록 데이터베이스 클라이언트를 구성합니다.

    Amazon Redshift는 Linux, Windows 및 macOS 운영 체제용 ODBC 드라이버를 제공합니다. ODBC 드라이버를 설치하려면 먼저 SQL 클라이언트 도구가 32비트인지, 64비트인지 확인합니다. SQL 클라이언트 도구의 요구 사항에 맞는 ODBC 드라이버를 설치합니다.

    또한 다음과 같이 운영 체제에 맞는 최신 Amazon Redshift OBDC 드라이버를 설치하고 구성합니다.

    Windows의 경우 Amazon Redshift ODBC 드라이버 DSN 설정(Amazon Redshift ODBC Driver DSN Setup) 페이지의 연결 설정(Connection Settings) 아래에 다음 정보를 입력합니다.

    • 데이터 원본 이름(Data Source Name)에 your-DSN을 입력합니다. 이는 ODBC 프로파일 이름으로 사용되는 데이터 원본 이름을 지정합니다.

    • 인증 유형(Auth type)에서 다음 중 하나를 수행합니다.

      • Okta Single Sign-On 구성에서 Identity Provider: Okta를 선택합니다. 이는 ODBC 드라이버가 Okta Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

      • MFA를 사용하는 Okta Single Sign-On 구성에서 Identity Provider: Browser SAML을 선택합니다. 이는 ODBC 드라이버가 MFA를 사용하는 Okta Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • 클러스터 ID(Cluster ID)에 your-cluster-identifier를 입력합니다.

    • 리전(Region)에 your-cluster-region을 입력합니다.

    • 데이터베이스(Database)에 your-database-name을 입력합니다.

    • 사용자(User)에 your-okta-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Okta 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. Auth type(인증 유형)이 Identity Provider: Okta(자격 증명 공급자: Okta)인 경우에만 이를 사용합니다.

    • 암호(Password)에 your-okta-password를 입력합니다. 인증 유형(Auth type)이 자격 증명 공급자: Okta(Identity Provider: Okta)인 경우에만 이를 사용합니다.

    macOS 및 Linux에서는 다음과 같이 odbc.ini 파일을 편집합니다.

    참고

    모든 항목은 대/소문자를 구분하지 않습니다.

    • clusterid에 your-cluster-identifier를 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 이름입니다.

    • 리전(region)에 your-cluster-region을 입력합니다. 이는 생성된 Amazon Redshift 클러스터의 AWS 리전입니다.

    • 데이터베이스(database)에 your-database-name을 입력합니다. 이는 Amazon Redshift 클러스터에서 액세스하려는 데이터베이스의 이름입니다.

    • 로캘(locale)에 en-us를 입력합니다. 이는 오류 메시지가 표시되는 언어입니다.

    • iam에 1을 입력합니다. 이 값은 드라이버에 IAM 자격 증명을 사용하여 인증하도록 지정합니다.

    • plugin_name의 경우 다음 중 하나를 수행합니다.

      • MFA를 사용하는 Okta Single Sign-On 구성에 BrowserSAML을 입력합니다. 이는 ODBC 드라이버가 MFA가 포함된 Okta Single Sign-On을 사용하여 인증할 때의 인증 방법입니다.

      • Okta Single Sign-On 구성에 Okta를 입력합니다. 이는 ODBC 드라이버가 Okta Single Sign-On을 사용하여 인증할 때 사용하는 인증 방법입니다.

    • uid에 your-okta-username을 입력합니다. 이는 Single Sign-On에 사용 중인 Okta 계정의 사용자 이름으로, 인증하려는 클러스터에 대한 권한이 있습니다. plugin_name이 Okta인 경우에만 이를 사용합니다.

    • pwd에 your-okta-password를 입력합니다. plugin_name이 Okta인 경우에만 이를 사용합니다.

    • login_url에 your-login-url을 입력합니다. 이는 SAML 응답을 반환하는 시작 Single Sign-On URL입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • idp_response_timeout에 the-number-of-seconds를 입력합니다. 이는 PingOne으로부터 응답을 기다리는 지정된 시간(초)입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    • listen_port에 your-listen-port를 입력합니다. 로컬 서버가 수신 대기하는 포트입니다. 기본값은 7890입니다. 이는 브라우저 SAML 플러그인에만 적용됩니다.

    macOS 및 Linux에서는 프로파일 설정을 편집하여 다음 내보내기도 추가합니다.

    export ODBCINI=/opt/amazon/redshift/Setup/odbc.ini
    export ODBCINSTINI=/opt/amazon/redshift/Setup/odbcinst.ini