JDBC 또는 ODBC Single Sign-On 인증 설정 - Amazon Redshift

JDBC 또는 ODBC Single Sign-On 인증 설정

다른 ID 제공업체(idP)를 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. IdP에 대한 서비스 공급자로 AWS 구성에 대한 자세한 내용은 IAM User Guide의 Configuring Your SAML 2.0 IdP with Relying Party Trust and Adding Claims를 참조하세요.

Microsoft Azure AD

Microsoft Azure AD를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음 절차에서는 이를 위해 신뢰 관계를 설정하는 방법을 설명합니다.

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 드라이버를 설치합니다.

    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

AD FS를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음 절차에서는 이를 위해 신뢰 관계를 설정하는 방법을 설명합니다.

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 예제는 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 드라이버를 설치합니다.

    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

Ping Identity를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음 절차에서는 PingOne 포털을 사용하여 이를 위한 신뢰 관계를 설정하는 방법을 설명합니다.

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 예제는 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 드라이버를 설치합니다.

    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

Okta를 IdP(자격 증명 공급자)로 사용하여 Amazon Redshift 클러스터에 액세스할 수 있습니다. 다음 절차에서는 이를 위해 신뢰 관계를 설정하는 방법을 설명합니다.

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 예제는 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 드라이버를 설치합니다.

    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