AWS 管理ポリシーを使用したアクションの許可すべてのリソースに対するアクションの許可特定のリソースに対するアクションの許可特定のaws:ResourceTag条件キーを使用したアクションの許可リソースのタグの管理リソースのタグを管理するアクセス許可の付与リソースに特定のタグがある場合にのみ、リソースのタグを管理するアクセス許可を付与する請求書送信タスクを開始するときにタグを要求する検証証拠オペレーション

AWS Marketplace Compliance API のアクセスコントロール

AWS Marketplace Compliance API を使用して、販売者のコンプライアンスを管理できます AWS Marketplace。ただし、まず、ユーザーまたはロールが呼び出す API 機能にアクセスできることを確認します。

AWS Identity and Access Management (IAM) を使用してユーザーとロールを作成し、エンドユーザーに制限されたアクセス許可を付与するポリシーを割り当てます。ポリシーは、ユーザーまたはロールが AWS Marketplace Compliance API を通じてリソースに対して実行できるアクションを定義します。

注記

で製品を販売するには AWS Marketplace、を販売者アカウントとして設定 AWS アカウントする必要があります。 AWS Marketplace 販売者になる方法の詳細については、「販売者ガイド」の「販売者としての開始方法」を参照してください。 AWS Marketplace

トピック

AWS 管理ポリシーを使用したアクションの許可
すべてのリソースに対するアクションの許可
特定のリソースに対するアクションの許可
特定のaws:ResourceTag条件キーを使用したアクションの許可
リソースのタグの管理
リソースのタグを管理するアクセス許可の付与
リソースに特定のタグがある場合にのみ、リソースのタグを管理するアクセス許可を付与する
請求書送信タスクを開始するときにタグを要求する
検証証拠オペレーション

AWS 管理ポリシーを使用したアクションの許可

によって管理されるポリシーを使用して AWS 、ユーザーまたはロールにアクセス許可を付与できます。

で請求書の送信を操作するには AWS Marketplace、IAM AWSMarketplaceSellerFullAccess 管理ポリシーを使用できます。このポリシーには、他のアクセス許可に加えて、 AWS Marketplace Compliance API アクションへのフルアクセスが含まれます。詳細については、「 Seller AWS Marketplace Guide」の「 Policies and permissions for AWS Marketplace Sellers」および「AWS managed policies for AWS Marketplace Sellers」を参照してください。

または、独自の IAM ポリシーを作成して、 AWS マネージドポリシーで利用可能なものよりも細かく制御することもできます。以下のトピックを使用して、独自の IAM ポリシーを作成します。

すべてのリソースに対するアクションの許可

リソースは、アクションが実行できるオブジェクトです。Compliance 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": "*"
    }
  ]
}

Compliance API で使用できるすべてのアクションの詳細については、「サービス認可リファレンス」のAWS Marketplace 「コンプライアンスのアクション、リソース、および条件キー」を参照してください。

特定のリソースに対するアクションの許可

リソースレベルのアクセス許可を使用して、すべてのリソースではなく、特定のリソースに対するアクションを許可できます。これを行うには、IAM ポリシーのでリソースの Amazon リソースネーム (ARN) Resource を指定します。

次の例では、特定の請求書送信タスクに対して 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"
        }
      }
    }
  ]
}

リソースのタグの管理

請求書送信タスクや発行された税金請求書など、既存の 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。
- Value (文字列) – (必須) タグの値。正規表現パターン: ^([\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"
    }
  ]
}

リソースのタグを管理するアクセス許可の付与

ユーザーまたはロールがすべての Compliance API リソースでタグを追加、削除、一覧表示できるようにするには、次の IAM ポリシーが必要です。


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

リソースに特定のタグがある場合にのみ、リソースのタグを管理するアクセス許可を付与する

ユーザーまたはロールに、特定のタグを持つ Compliance 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 Compliance 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 管理ポリシーを使用したアクションの許可

IAM 管理ポリシーには、他のアクセス許可に加えて、7 AWSMarketplaceSellerFullAccess つの検証アクセス許可がすべて含まれています。詳細については、「 Seller AWS Marketplace Guide」の「AWS managed policies for AWS Marketplace sellers」を参照してください。

すべての検証オペレーションへのフルアクセスを許可する

ユーザーまたはロールにすべての検証オペレーションへのフルアクセスを許可するには、次の 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"
      ]
    }
  ]
}

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

デプロイ API へのアクセス

Discovery API へのアクセス