Amazon Keyspaces 자격 증명 기반 정책 예제 - Amazon Keyspaces(Apache Cassandra용)

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon Keyspaces 자격 증명 기반 정책 예제

기본적으로 IAM 사용자 및 역할은 Amazon Keyspaces 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 콘솔, CQLSH 또는AWS API를 사용해 작업을 수행할 수 없습니다.AWS CLI IAM 관리자는 지정된 리소스에서 특정 API 태스크를 수행할 수 있는 권한을 사용자와 역할에게 부여하는 IAM 정책을 생성해야 합니다. 그런 다음 관리자는 해당 권한이 필요한 IAM 사용자 또는 그룹에 이러한 정책을 연결해야 합니다.

이러한 예제 JSON 정책 문서를 사용하여 IAM 자격 증명 기반 정책을 생성하는 방법을 알아보려면 IAM 사용 설명서JSON 탭에서 정책 생성을 참조하세요.

정책 모범 사례

ID 기반 정책에 따라 계정에서 사용자가 Amazon Keyspaces 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. 자격 증명 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따르세요.

  • AWS 관리형 정책으로 시작하고 최소 권한을 향해 나아가기 - 사용자 및 워크로드에 권한 부여를 시작하려면 많은 일반 사용 사례에 대한 권한을 부여하는 AWS 관리형 정책을 사용합니다. 관리형 정책은 AWS 계정에서 사용할 수 있습니다. 사용 사례에 고유한 AWS 고객 관리형 정책을 정의하여 권한을 줄이는 것이 좋습니다. 자세한 내용은 IAM 사용 설명서AWS managed policies(관리형 정책) 또는 AWS managed policies for job functions(직무에 대한 관리형 정책)를 참조하세요.

  • 최소 권한 적용 – IAM 정책을 사용하여 권한을 설정하는 경우 작업을 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 최소 권한으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. IAM을 사용하여 권한을 적용하는 방법에 대한 자세한 내용은 IAM 사용 설명서에 있는 Policies and permissions in IAM(IAM의 정책 및 권한)을 참조하세요.

  • IAM 정책의 조건을 사용하여 액세스 추가 제한 – 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어 SSL을 사용하여 모든 요청을 전송해야 한다고 지정하는 정책 조건을 작성할 수 있습니다. 특정 AWS 서비스(예: AWS CloudFormation)를 통해 사용되는 경우에만 서비스 작업에 대한 액세스 권한을 부여할 수도 있습니다. 자세한 내용은 IAM 사용 설명서IAM JSON 정책 요소: 조건을 참조하세요.

  • IAM Access Analyzer를 통해 IAM 정책을 검증하여 안전하고 기능적인 권한 보장 – IAM Access Analyzer에서는 IAM 정책 언어(JSON)와 모범 사례가 정책에서 준수되도록 신규 및 기존 정책을 검증합니다. IAM Access Analyzer는 100개 이상의 정책 확인 항목과 실행 가능한 권장 사항을 제공하여 안전하고 기능적인 정책을 작성하도록 돕습니다. 자세한 내용은 IAM 사용 설명서IAM Access Analyzer policy validation(IAM Access Analyzer 정책 검증)을 참조하세요.

  • 다중 인증(MFA) 필요 – 계정에 IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 추가 보안을 위해 MFA를 설정합니다. API 작업을 호출할 때 MFA가 필요하면 정책에 MFA 조건을 추가합니다. 자세한 내용은 IAM 사용 설명서 Configuring MFA-protected API access(MFA 보호 API 액세스 구성)를 참조하세요.

IAM의 모범 사례에 대한 자세한 내용은 IAM 사용 설명서IAM의 보안 모범 사례를 참조하십시오.

아마존 Keyspaces 콘솔 사용

Amazon Keyspaces (Apache Cassandra용) 콘솔에 액세스하는 데 특정 권한이 필요하지 않습니다. 의 Amazon Keyspaces 리소스에 대한 세부 정보를 나열하고 보려면 최소한 읽기 전용 권한이 필요합니다AWS 계정. 최소 필수 권한보다 더 제한적인 자격 증명 기반 정책을 만들면 콘솔이 해당 정책에 연결된 개체(IAM 사용자 또는 역할)에 대해 의도대로 작동하지 않습니다.

사용자가 자신이 권한을 볼 수 있도록 허용

이 예제는 IAM 사용자가 자신의 사용자 자격 증명에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 또는 AWS CLI나 AWS API를 사용하여 프로그래밍 방식으로 이 태스크를 완료할 수 있는 권한이 포함됩니다.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "ViewOwnUserInfo", "Effect": "Allow", "Action": [ "iam:GetUserPolicy", "iam:ListGroupsForUser", "iam:ListAttachedUserPolicies", "iam:ListUserPolicies", "iam:GetUser" ], "Resource": ["arn:aws:iam::*:user/${aws:username}"] }, { "Sid": "NavigateInConsole", "Effect": "Allow", "Action": [ "iam:GetGroupPolicy", "iam:GetPolicyVersion", "iam:GetPolicy", "iam:ListAttachedGroupPolicies", "iam:ListGroupPolicies", "iam:ListPolicyVersions", "iam:ListPolicies", "iam:ListUsers" ], "Resource": "*" } ] }

Amazon Keyspaces 테이블 액세스

다음은 시스템 테이블에 대한 읽기 전용 (SELECT) 액세스 권한을 부여하는 샘플 정책입니다. 모든 샘플에서 Amazon 리소스 이름 (ARN) 의 지역 및 계정 ID를 서비스의 ID로 바꿉니다.

참고

표준 드라이버로 연결하려면 사용자가 최소한 시스템 테이블에SELECT 액세스할 수 있어야 합니다. 대부분의 드라이버는 연결 시 시스템 키스페이스/테이블을 읽습니다.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "cassandra:Select" ], "Resource":[ "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*" ] } ] }

다음 예제 정책은 사용자 테이블에 대한 읽기 전용 액세스를 추가합니다.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "cassandra:Select" ], "Resource":[ "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable", "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*" ] } ] }

다음 샘플 정책은 사용자 테이블에 읽기/쓰기 권한을 할당하고 시스템 테이블에 읽기 권한을 할당합니다.

참고

시스템 테이블은 읽기 전용입니다.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "cassandra:Select", "cassandra:Modify" ], "Resource":[ "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/table/mytable", "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*" ] } ] }

다음 샘플 정책은 사용자가 Keyspaces 테이블을 만들 수 있도록 허용합니다mykeyspace.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "cassandra:Create", "cassandra:Select" ], "Resource":[ "arn:aws:cassandra:us-east-1:111122223333:/keyspace/mykeyspace/*", "arn:aws:cassandra:us-east-1:111122223333:/keyspace/system*" ] } ] }

인증 플러그인을 사용하여 Amazon 키스페이스에 액세스

다음 예에서는 Amazon Keyspaces 인증 플러그인을 사용하여 IAM 역할과 연결된 EC2 인스턴스에서 Amazon 키스페이스에 액세스하여 Amazon Keyspaces 테이블을 쿼리하는 애플리케이션을 실행합니다. 애플리케이션은 지정된 고객orders ID에 대해 호출된 테이블의 모든 주문을 반환합니다.

이 예에는 다음 단계가 포함됩니다.

  1. Amazon Keyspaces 키스페이스와 테이블을 생성하고 레코드를 삽입합니다.

  2. EC2 인스턴스를 시작하고 IAM 역할에 연결합니다.

    EC2 인스턴스에 Amazon Keyspaces 테이블에 대한 권한을 부여하는 IAM 정책을 정의합니다.

  3. EC2 인스턴스에 샘플 코드를 배포하고 실행하여 Amazon Keyspaces 테이블을 쿼리합니다.

샘플 테이블 생성

시작하려면 키스페이스와 테이블을 만들고 레코드를 삽입하세요. orders테이블을 생성하려면 Amazon Keyspaces 콘솔의 CQL 편집기를 사용하거나 cqlsh를 사용할 수 있습니다. 자세한 내용은 설치 및 사용cqlshAmazon Keyspaces (Apache Cassandra용) 에 연결을 참조하세요.

먼저 다음 테이블 스키마를 사용하여 키스페이스와 테이블을 생성합니다.

create keyspace acme with replication = {'class': 'SimpleStrategy', 'replication_factor' : 1 }; create table acme.orders ( customer_id text, order_timestamp timestamp, order_id uuid, primary key (customer_id, order_timestamp)) with clustering order by (order_timestamp desc);

그런 다음 테이블에 주문 레코드를 몇 개 삽입합니다.

insert into acme.orders (customer_id, order_timestamp, order_id) values ('1234', toTimestamp(now()), uuid()); insert into acme.orders (customer_id, order_timestamp, order_id) values ('1234', toTimestamp(now()), uuid()); insert into acme.orders (customer_id, order_timestamp, order_id) values ('1234', toTimestamp(now()), uuid()); insert into acme.orders (customer_id, order_timestamp, order_id) values ('1234', toTimestamp(now()), uuid());

IAM 역할에 연결된 EC2 인스턴스 시작

애플리케이션을 실행할 EC2 인스턴스와 연결될 IAM 역할을 생성합니다.

다음 문서를 파일에 저장합니다iam-keyspaces-ec2-role.json.

{ "Version":"2012-10-17", "Statement":{ "Effect":"Allow", "Principal":{ "Service":"ec2.amazonaws.com" }, "Action":"sts:AssumeRole" } }

EC2 인스턴스에orders 테이블에 대한 읽기 전용 액세스 권한을 부여하려면 다음 IAM 정책을 생성하십시오. Amazon 리소스 이름 (ARN) 의 지역 및 계정 ID를 Amazon Keyspaces 계정의 지역 및 계정 ID로 바꿉니다.

{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":"cassandra:Select", "Resource":[ "arn:aws:cassandra:us-east-2:111122223333:/keyspace/acme/table/orders", "arn:aws:cassandra:us-east-2:111122223333:/keyspace/system*" ] } ] }

다음 문서를 파일에 저장합니다iam-keyspaces-ec2-policy.json.

참고

드라이버가 클러스터 메타데이터를 검색하려면 이system 키스페이스에 액세스해야 하므로 정책에 키스페이스에 대한 권한을 포함해야 합니다.

EC2 인스턴스를 시작하고 생성된 IAM 역할을 인스턴스에 연결하려면 IAM 역할로 인스턴스 시작의 단계를 따르세요. 역할을 기존 EC2 인스턴스에 연결하려면 IAM 역할 연결을 참조하십시오.

참고

이 예에서는 Java가 사전 설치된 Amazon Linux AMI를 선택하십시오. 기존 Amazon Linux 인스턴스를 사용하는 경우 Java가 설치되어 있는지 확인하거나 명령을 사용하여 이 단계를sudo yum install java-11-amazon-corretto-headless 완료하십시오.

코드 배포 및 실행

Amazon Keyspaces 테이블을 쿼리하는 코드를 배포하고 실행하려면 다음 단계를 사용하십시오.

  1. 에서 샘플 코드를 GitHub 다운로드합니다.

  2. 아파치 메이븐을 사용하여 샘플 코드를 컴파일합니다.

  3. JAR 파일을 EC2 인스턴스에 복사하고 애플리케이션을 실행합니다.

이 예제에서는 Amazon Keyspaces 인증 플러그인을 구현하는 샘플 애플리케이션을 사용하여 IAM 역할을 사용하여 테이블에 액세스합니다. 자체 코드에서, 먼저 의 단계에 따라 플러그인을 통합해야아파치 카산드라용 4.x DataStax Java 드라이버와 SigV4 인증 플러그인을 사용하여 아마존 키스페이스에 연결하는 방법에 대한tep-by-step 자습서 합니다.

GitHub 리포지토리에서 샘플을 다운로드한 후 다음 명령을 사용하여 Apache Maven 버전 3.6.3 이상을 사용하여 코드를 컴파일합니다.

mvn package

그러면target 디렉터리에 포함된 모든 종속성이 포함된 다음 JAR 파일이 생성됩니다.

aws-sigv4-auth-cassandra-java-driver-examples-1.0.0.jar

이 JAR 파일을 샘플 코드 디렉터리에cassandra_truststore.jks 있는 파일과 함께 EC2 인스턴스에 복사합니다. 그런 다음 다음 명령을 사용하여 애플리케이션을 실행합니다. AWS 리전을us-east-2 사용 중인 리전으로 교체합니다.

java -Djavax.net.ssl.trustStore=./cassandra_truststore.jks \ -Djavax.net.ssl.trustStorePassword=amazon -jar \ aws-sigv4-auth-cassandra-java-driver-examples-1.0.0.jar \ us-east-2 cassandra.us-east-2.amazonaws.com 1234

이 명령을 실행하면 이전에 테이블에 삽입한 레코드가 생성됩니다. 애플리케이션은 IAM 역할 세션에 할당된 임시 자격 증명과 IAM 정책에 정의된 읽기 전용 권한을 사용하여 테이블에 액세스했습니다.

태그를 기반으로 한 Amazon Keyspaces 리소스 액세스

자격 증명 기반 정책의 조건을 사용하여 태그를 기반으로 Amazon Keyspaces 리소스에 대한 액세스를 제어할 수 있습니다. 이러한 정책은 계정 내 키스페이스와 테이블의 가시성을 제어합니다. 참고로 시스템 테이블에 대한 태그 기반 권한은AWS SDK를 사용하여 요청할 때 카산드라 드라이버 및 개발자 도구를 통한 카산드라 쿼리 언어 (CQL) API 호출과 다르게 작동합니다.

  • 태그 기반 액세스를 사용할 때AWS SDK로 요청을List 보내고Get 리소스를 요청하려면 호출자에게 시스템 테이블에 대한 읽기 권한이 있어야 합니다. 예를 들어Select 작업을 통해 시스템 테이블에서 데이터를 읽으려면GetTable 작업 권한이 필요합니다. 호출자에게 특정 테이블에 대한 태그 기반 액세스 권한만 있는 경우 시스템 테이블에 대한 추가 액세스가 필요한 작업은 실패합니다.

  • 기존 카산드라 드라이버 동작과의 호환성을 위해 카산드라 드라이버 및 개발자 도구를 통해 CQL (Cassandra Query Language) API 호출을 사용하여 시스템 테이블에서 작업을 수행할 때는 태그 기반 인증 정책이 적용되지 않습니다.

다음 예에서는 테이블에 해당 사용자의 사용자 이름 값이Owner 포함된 경우 해당 사용자에게 테이블을 볼 수 있는 권한을 부여하는 정책을 만드는 방법을 보여 줍니다. 이 예제에서는 시스템 테이블에 대한 읽기 권한도 부여합니다.

{ "Version":"2012-10-17", "Statement":[ { "Sid":"ReadOnlyAccessTaggedTables", "Effect":"Allow", "Action":"cassandra:Select", "Resource":[ "arn:aws:cassandra:us-east-2:111122223333:/keyspace/myKeyspace/table/*", "arn:aws:cassandra:us-east-2:111122223333:/keyspace/myKeyspace/system*" ], "Condition":{ "StringEquals":{ "aws:ResourceTag/Owner":"${aws:username}" } } } ] }

이 정책을 계정의 IAM 사용자에게 연결할 수 있습니다. 라는 사용자가 Amazon Keyspaces 테이블을richard-roe 보려고 하면 테이블에Owner=richard-roe 또는 태그를 지정해야 합니다owner=richard-roe. 그렇지 않으면 액세스가 거부됩니다. 조건 키 이름은 대소문자를 구분하지 않기 때문에 태그 키 OwnerOwnerowner 모두와 일치합니다. 자세한 정보는 IAM 사용 설명서IAM JSON 정책 요소: 조건을 참조하세요.

다음 정책은 테이블에 해당 사용자의 사용자 이름 값이Owner 포함된 경우 사용자에게 태그가 있는 테이블을 생성할 수 있는 권한을 부여합니다.

{ "Version": "2012-10-17", "Statement": [ { "Sid": "CreateTagTableUser", "Effect": "Allow", "Action": ["cassandra:Create", "cassandra:TagResource"], "Resource": "arn:aws:cassandra:us-east-2:111122223333:/keyspace/mykeyspace/table/*", "Condition": { "ForAnyValue:StringEquals" : {"aws:RequestTag/Owner": "${aws:username}"} } ] }