View a markdown version of this page

AWS Marketplace Discovery API에 대한 액세스 제어 - AWS Marketplace
IAM 권한서비스 연결 역할크로스 계정 액세스

AWS Marketplace API 참조가 재구성되었습니다. 지원되는 API 작업에 대한 자세한 내용은 AWS Marketplace API 참조를 참조하세요.

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

AWS Marketplace Discovery API에 대한 액세스 제어

Discovery API는 인증 및 권한 부여에 AWS Identity and Access Management (IAM)을 사용합니다. 모든 AWS 고객은 적절한 IAM 권한을 구성하여 Discovery API를 호출할 수 있습니다.

Discovery API 작업을 호출하려면 사용자에게 다음 권한이 있어야 합니다.

  • GetListing - 목록에 대한 정보를 검색할 수 있는 권한을 부여합니다.

  • GetProduct - 제품에 대한 정보를 검색할 수 있는 권한을 부여합니다.

  • GetOffer - 제안에 대한 정보를 검색할 수 있는 권한을 부여합니다.

  • GetOfferTerms - 제안에 대한 조건을 검색할 수 있는 권한을 부여합니다.

  • GetOfferSet - 제안 세트에 대한 정보를 검색할 수 있는 권한을 부여합니다.

  • ListPurchaseOptions - 구매자가 사용할 수 있는 구매 옵션을 나열할 수 있는 권한을 부여합니다.

  • ListFulfillmentOptions - 제품의 이행 옵션을 나열할 수 있는 권한을 부여합니다.

  • SearchListings - 제품 목록을 검색할 수 있는 권한을 부여합니다.

  • SearchFacets - 필터링 목록에 대한 패싯 값을 검색할 수 있는 권한을 부여합니다.

IAM 권한

Discovery API 작업을 호출하려면 IAM 보안 주체(사용자 또는 역할)에 적절한 aws-marketplace 권한이 있어야 합니다. Discovery API는 리소스 수준 권한을 지원하므로 IAM 정책의 특정 리소스 유형에 대한 액세스 범위를 지정할 수 있습니다.

다음 IAM 정책은 리소스 수준 범위를 지정하여 모든 Discovery API 작업에 대한 액세스 권한을 부여합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "aws-marketplace:GetListing",
                "aws-marketplace:GetProduct",
                "aws-marketplace:GetOffer",
                "aws-marketplace:GetOfferTerms",
                "aws-marketplace:GetOfferSet",
                "aws-marketplace:ListPurchaseOptions",
                "aws-marketplace:ListFulfillmentOptions",
                "aws-marketplace:SearchFacets",
                "aws-marketplace:SearchListings"
            ],
            "Resource": [
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/product/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/listing/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offer/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/offerSet/*",
                "arn:aws:aws-marketplace:::catalog/<catalog-name>/purchaseOption/*"
            ]
        }
    ]
}

를 적절한 카탈로그 식별자(예: AWSMarketplace)<catalog-name>로 바꿉니다.

리소스 ARN 형식

다음 표에는 Discovery API 작업에 사용되는 리소스 유형과 해당 ARN 형식이 나와 있습니다.

리소스 유형 ARN 형식 사용처
제품 arn:aws:aws-marketplace:::catalog/catalog-name/product/product-id GetProduct, ListFulfillmentOptions
목록 arn:aws:aws-marketplace:::catalog/catalog-name/listing/listing-id GetListing, SearchListings, SearchFacets
제안 arn:aws:aws-marketplace:::catalog/catalog-name/offer/offer-id GetOffer, GetOfferTerms
제안 세트 arn:aws:aws-marketplace:::catalog/catalog-name/offerSet/offerSet-id GetOfferSet
구매 옵션 arn:aws:aws-marketplace:::catalog/catalog-name/purchaseOption/purchaseOption-id ListPurchaseOptions

특정 리소스로 작업 범위 지정

Get 작업(GetListing, GetProduct, GetOffer, GetOfferTerms, GetOfferSet) 및 ListFulfillmentOptions 작업의 경우 와일드카드를 사용하는 대신 특정 리소스 IDs로 액세스 범위를 축소할 수 있습니다. 예를 들어 단일 목록으로 액세스를 제한하려면

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-marketplace:GetListing",
            "Resource": "arn:aws:aws-marketplace:::catalog/AWSMarketplace/listing/listing-id"
        }
    ]
}

이 패턴은 모든 Get 작업 및 ListFulfillmentOptions에서 작동합니다. 리소스 유형과 ID를 적절히 바꿉니다.

  • arn:aws:aws-marketplace:::catalog/catalog-name/product/product-id

  • arn:aws:aws-marketplace:::catalog/catalog-name/listing/listing-id

  • arn:aws:aws-marketplace:::catalog/catalog-name/offer/offer-id

  • arn:aws:aws-marketplace:::catalog/catalog-name/offerSet/offerSet-id

SearchListings, SearchFacets 및 ListPurchaseOptions 작업은 여러 항목에서 작동하므로 단일 리소스로의 범위 조정을 지원하지 않습니다. 이러한 작업에는 다음 와일드카드 ARN 패턴을 사용합니다.

  • SearchListings 및 SearchFacets의 경우: arn:aws:aws-marketplace:::catalog/catalog-name/listing/*

  • ListPurchaseOptions의 경우: arn:aws:aws-marketplace:::catalog/catalog-name/purchaseOption/*

서비스 연결 역할

Discovery API는 서비스 연결 역할을 사용하지 않습니다. 모든 액세스는 표준 IAM 정책을 통해 제어됩니다.

크로스 계정 액세스

IAM 역할을 사용하여 Discovery API에 대한 교차 계정 액세스 권한을 부여할 수 있습니다. 적절한 Discovery API 권한을 사용하여 대상 계정에서 역할을 생성한 다음 소스 계정에서 역할을 수임합니다.