View a markdown version of this page

AWS Marketplace 규정 준수 API에 대한 액세스 제어 - AWS Marketplace
AWS 관리형 정책을 사용하여 작업 허용모든 리소스에 대한 작업 허용특정 리소스에 대한 작업 허용특정 aws:ResourceTag 조건 키를 사용하여 작업 허용리소스의 태그 관리리소스의 태그를 관리할 수 있는 권한 부여리소스에 특정 태그가 있는 경우에만 리소스의 태그를 관리할 수 있는 권한 부여인보이스 제출 작업을 시작할 때 태그 요구확인 증거 작업

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

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

AWS Marketplace 규정 준수 API에 대한 액세스 제어

AWS Marketplace 규정 준수 API를 사용하여에서 판매자 규정 준수를 관리할 수 있습니다 AWS Marketplace. 그러나 먼저 사용자 또는 역할이 호출하려는 API 기능에 액세스할 수 있는지 확인합니다.

AWS Identity and Access Management (IAM)를 사용하여 사용자 및 역할을 생성하고 최종 사용자에게 제한된 권한을 부여하는 정책을 할당합니다. 정책은 사용자 또는 역할이 AWS Marketplace 규정 준수 API를 통해 리소스에 대해 수행할 수 있는 작업을 정의합니다.

참고

제품을 판매하려면 AWS Marketplace를 판매자 계정으로 설정해야 AWS 계정 합니다. AWS Marketplace 판매자가 되는 방법에 대한 자세한 내용은 AWS Marketplace 판매자 안내서의 판매자로 시작하기를 참조하세요.

AWS 관리형 정책을 사용하여 작업 허용

에서 관리하는 정책을 사용하여 사용자 또는 역할에 권한을 AWS 부여할 수 있습니다.

에서 인보이스 제출 작업을 AWS Marketplace수행하려면 다른 권한 외에도 AWS Marketplace 규정 준수 API 작업에 대한 전체 액세스를 포함하는 AWSMarketplaceSellerFullAccess IAM 관리형 정책을 사용할 수 있습니다. 자세한 내용은 AWS Marketplace 판매자 안내서의 판매자에 대한 정책 및 권한과 AWS Marketplace 판매자에 대한 AWS 관리형 정책을 참조하세요. AWS Marketplace

또는 자체 IAM 정책을 생성하여 AWS 관리형 정책에서 사용할 수 있는 것보다 더 세부적으로 제어할 수 있습니다. 다음 주제를 사용하여 자체 IAM 정책을 생성합니다.

모든 리소스에 대한 작업 허용

리소스는 작업이 수행할 수 있는 객체입니다. 규정 준수 API에는 다음과 같은 리소스 유형이 있습니다.

  • InvoiceSubmissionTask - 인보이스 제출 작업은 판매자가 제출한 인보이스의 처리를 추적합니다 AWS Marketplace.

  • IssuedTaxInvoice - 판매자를 대신하여 발급한 AWS Marketplace 세금 계산서입니다.

  • VerificationEvidence - 확인 중인 특정 확인 범주 및 주제에 대한 확인 데이터를 포함합니다.

사용자 또는 역할이 인보이스 제출 작업 작업에 대한 전체 액세스 권한을 허용하려면 다음 IAM 정책을 추가할 수 있습니다. 이 정책을 사용하면 사용자 또는 역할이 모든 리소스()에서 모든 인보이스 제출 작업 작업을 사용할 수 있습니다"*".

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartInvoiceSubmissionTask",
        "aws-marketplace:GetInvoiceSubmissionTask",
        "aws-marketplace:ListInvoiceSubmissionTasks",
        "aws-marketplace:ListPayables"
      ],
      "Resource": "*"
    }
  ]
}

사용자 또는 역할이 발행된 세금 계산서 작업에 대한 전체 액세스 권한을 허용하려면 다음 IAM 정책을 추가할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ListIssuedTaxInvoices",
        "aws-marketplace:GetIssuedTaxInvoice"
      ],
      "Resource": "*"
    }
  ]
}

사용자 또는 역할이 확인 작업에 대한 모든 액세스 권한을 허용하려면 다음 IAM 정책을 추가할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:CreateVerificationEvidence",
        "aws-marketplace:UpdateVerificationEvidence",
        "aws-marketplace:GetVerificationEvidence",
        "aws-marketplace:ListVerificationEvidence",
        "aws-marketplace:StartVerification",
        "aws-marketplace:GetVerification",
        "aws-marketplace:ListVerifications"
      ],
      "Resource": "*"
    }
  ]
}

규정 준수 API에 사용할 수 있는 모든 작업에 대한 자세한 내용은 서비스 승인 참조의 규정 AWS Marketplace 준수에 사용되는 작업, 리소스 및 조건 키를 참조하세요.

특정 리소스에 대한 작업 허용

리소스 수준 권한을 사용하여 모든 리소스 대신 특정 리소스에 대한 작업을 허용할 수 있습니다. 이렇게 하려면 IAM 정책의에서 리소스Resource의 Amazon 리소스 이름(ARN)을 지정합니다.

다음 예시에서는 특정 인보이스 제출 작업에 대한 GetInvoiceSubmissionTask 작업을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetInvoiceSubmissionTask"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:catalog/example-catalog/invoice-submission-task/example-task-id"
      ]
    }
  ]
}

다음 예시에서는 발행된 특정 세금 계산서에 대한 GetIssuedTaxInvoice 작업을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetIssuedTaxInvoice"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:catalog/AWSMarketplace/issued-tax-invoice/example-invoice-id"
      ]
    }
  ]
}

다음 예시에서는 특정 확인 증거 리소스에 대한 GetVerificationEvidence 작업을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetVerificationEvidence"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:verification-type/business-verification/verification-evidence/evidence-a1b2c3d4e5f6g"
      ]
    }
  ]
}

특정 aws:ResourceTag 조건 키를 사용하여 작업 허용

개별 ARNs. 리소스에 태그를 추가하면 태그를 기반으로 해당 리소스에 대한 액세스를 제어할 수 있습니다.

예를 들어 다음 IAM 정책은 태그 키가 product-team 이고 태그 값이 인 모든 인보이스 제출 작업 리소스("*")에 대한 GetInvoiceSubmissionTask 작업을 허용합니다team-xyz.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetInvoiceSubmissionTask"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/product-team": "team-xyz"
        }
      }
    }
  ]
}

마찬가지로 다음 IAM 정책은 태그 키가 Department 이고 태그 값이 인 발급된 세금 인보이스 리소스("*")에 대한 GetIssuedTaxInvoice 작업을 허용합니다Tax.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetIssuedTaxInvoice"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/Department": "Tax"
        }
      }
    }
  ]
}

다음 IAM 정책은 태그 키가 Department 이고 태그 값이 인 모든 확인 증거 리소스("*")에 대한 GetVerificationEvidence 작업을 허용합니다Compliance.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetVerificationEvidence"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/Department": "Compliance"
        }
      }
    }
  ]
}

리소스의 태그 관리

인보이스 제출 작업 및 발행된 세금 인보이스와 같은 기존 규정 준수 API 리소스에서 태그를 추가, 나열 및 제거할 수 있습니다.

리소스에 태그 추가

리소스에 태그를 추가하려면 TagResource API 작업을 사용합니다.

요청

POST /TagResource HTTP/1.1
Content-type: application/json

{
  "ResourceArn": "string",
  "Tags": [
    {
      "Key": "string",
      "Value": "string"
    }
  ]
}

요청 파라미터에는 다음이 포함됩니다.

  • ResourceArn(문자열) - 리소스의 (필수) ARN입니다.

  • 태그(객체 배열) - (필수) 각 태그 키와 값을 지정하는 객체 목록입니다. 허용되는 객체 수: 1~50개.

    • 키(문자열) - (필수) 태그의 이름입니다. 정규식 패턴: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$. 문자 길이: 1~128.

    • 값(문자열) - (필수) 태그의 값입니다. 정규식 패턴: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$. 문자 길이: 0~256.

리소스에서 태그 제거

리소스에서 태그 또는 태그 목록을 제거하려면 UntagResource API 작업을 사용합니다.

요청

POST /UntagResource HTTP/1.1
Content-type: application/json

{
  "ResourceArn": "string",
  "TagKeys": [
    "string"
  ]
}

요청 파라미터에는 다음이 포함됩니다.

  • ResourceArn(문자열) - 리소스의 (필수) ARN입니다.

  • TagKeys(문자열 배열) - (필수) 제거할 태그의 키 이름 목록입니다.

리소스의 모든 태그 나열

리소스의 모든 태그를 나열하려면 ListTagsForResource API 작업을 사용합니다.

요청

POST /ListTagsForResource HTTP/1.1
Content-type: application/json

{
  "ResourceArn": "string"
}

응답

{
  "ResourceArn": "string",
  "Tags": [
    {
      "Key": "string",
      "Value": "string"
    }
  ]
}

리소스의 태그를 관리할 수 있는 권한 부여

사용자 또는 역할이 모든 규정 준수 API 리소스에 태그를 추가, 제거 및 나열하도록 허용하려면 다음 IAM 정책이 필요합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": "*"
    }
  ]
}

리소스에 특정 태그가 있는 경우에만 리소스의 태그를 관리할 수 있는 권한 부여

사용자 또는 역할이 특정 태그가 있는 규정 준수 API 리소스에 태그를 추가, 제거 및 나열하도록 허용할 수 있습니다. 다음 IAM 정책은 태그 키가 product-team 이고 태그 값이 인 모든 리소스("*")에서 이러한 작업을 허용합니다team-xyz.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:TagResource",
        "aws-marketplace:UntagResource",
        "aws-marketplace:ListTagsForResource"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:ResourceTag/product-team": "team-xyz"
        }
      }
    }
  ]
}

인보이스 제출 작업을 시작할 때 태그 요구

StartInvoiceSubmissionTask 작업과 함께 aws:RequestTag 및 aws:TagKeys 조건 키를 사용하여 인보이스 제출 작업이 생성될 때 태그 지정을 적용할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartInvoiceSubmissionTask"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:RequestTag/product-team": "team-xyz"
        },
        "ForAllValues:StringEquals": {
          "aws:TagKeys": [
            "product-team"
          ]
        }
      }
    }
  ]
}

확인 증거 작업

AWS Marketplace 규정 준수 API는 확인 증거 및 확인 프로세스를 관리하기 위한 작업을 제공합니다. IAM 정책을 사용하여 이러한 작업에 대한 액세스를 제어할 수 있습니다.

확인 작업을 위한 IAM 작업

확인 작업에 사용할 수 있는 IAM 작업은 다음과 같습니다. 모든 작업은 aws-marketplace 네임스페이스를 사용합니다.

증거 관리 작업

  • aws-marketplace:CreateVerificationEvidence - 새 확인 증거를 생성합니다.

  • aws-marketplace:UpdateVerificationEvidence - 기존 확인 증거를 업데이트합니다.

  • aws-marketplace:GetVerificationEvidence - 확인 증거의 세부 정보를 가져옵니다.

  • aws-marketplace:ListVerificationEvidence - 확인 증거 리소스를 나열합니다.

확인 프로세스 작업

  • aws-marketplace:StartVerification - 증거를 제출하고 데이터 공유를 활성화합니다.

  • aws-marketplace:GetVerification - 자세한 확인 상태를 가져옵니다.

  • aws-marketplace:ListVerifications - 모든 확인 상태를 나열합니다.

리소스 유형

VerificationEvidence 리소스에는 특정 확인 범주 및 확인 대상에 대한 확인 데이터가 포함되어 있습니다. 이 리소스의 ARN 형식은 다음과 같습니다.

arn:aws:aws-marketplace:region:account-id:verification-type/type-value/verification-evidence/evidence-id

다음은 비즈니스 확인을 위한 ARN의 예입니다.

arn:aws:aws-marketplace:us-east-1:123456789012:verification-type/business-verification/verification-evidence/evidence-a1b2c3d4e5f6g

VerificationType 조건 키 사용

aws-marketplace:VerificationType 조건 키는 유형별로 확인 프로세스 작업을 필터링합니다. 이 조건 키는 다음 작업에 적용됩니다.

  • StartVerification

  • GetVerification

  • ListVerifications

이 조건 키의 유효한 값은 다음과 같습니다.

  • BusinessVerification

참고

검증 유형이 리소스 ARN에 이미 인코딩되어 있으므로 증거 관리 작업(CreateVerificationEvidence, UpdateVerificationEvidence, GetVerificationEvidence, ListVerificationEvidence)은이 조건 키를 사용하지 않습니다.

AWS 관리형 정책을 사용하여 작업 허용

AWSMarketplaceSellerFullAccess IAM 관리형 정책에는 다른 권한 외에도 7개의 확인 권한이 모두 포함됩니다. 자세한 내용은 AWS Marketplace 판매자 안내서의 AWS Marketplace 판매자를 위한 AWS 관리형 정책을 참조하세요.

모든 확인 작업에 대한 전체 액세스 허용

모든 확인 작업에 대한 사용자 또는 역할의 전체 액세스를 허용하려면 다음 IAM 정책을 추가할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:CreateVerificationEvidence",
        "aws-marketplace:UpdateVerificationEvidence",
        "aws-marketplace:GetVerificationEvidence",
        "aws-marketplace:ListVerificationEvidence",
        "aws-marketplace:StartVerification",
        "aws-marketplace:GetVerification",
        "aws-marketplace:ListVerifications"
      ],
      "Resource": "*"
    }
  ]
}

비즈니스 확인 증거에 대한 읽기 전용 액세스 허용

사용자 또는 역할이 비즈니스 확인 증거에 대한 읽기 전용 액세스를 허용하려면 ARN 기반 필터링을 사용하여 특정 확인 유형에 대한 액세스를 제한할 수 있습니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetVerificationEvidence",
        "aws-marketplace:ListVerificationEvidence"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:*:123456789012:verification-type/business-verification/verification-evidence/*"
      ]
    }
  ]
}

유형별 확인 프로세스 작업 제한

확인 프로세스 작업을 특정 확인 유형으로 제한하려면 aws-marketplace:VerificationType 조건 키를 사용합니다. 다음 예제에서는 비즈니스 확인을 위해서만 확인 프로세스 작업을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:StartVerification",
        "aws-marketplace:GetVerification",
        "aws-marketplace:ListVerifications"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws-marketplace:VerificationType": "BusinessVerification"
        }
      }
    }
  ]
}

특정 확인 증거 리소스에 대한 작업 허용

특정 확인 증거 리소스에 대한 작업을 허용하려면 IAM 정책의 Resource 요소에 리소스의 ARN을 지정합니다. 다음 예시에서는 특정 확인 증거 리소스에 대한 모든 증거 관리 작업을 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:GetVerificationEvidence",
        "aws-marketplace:UpdateVerificationEvidence"
      ],
      "Resource": [
        "arn:aws:aws-marketplace:us-east-1:123456789012:verification-type/business-verification/verification-evidence/evidence-id"
      ]
    }
  ]
}