AWS Data Exchange User Guide
 

Access Control

To create, update, delete, or list AWS Data Exchange resources, you need permissions to perform the operation and to access the corresponding resources. To perform the operation programmatically, you also need valid access keys.

Overview of Managing Access Permissions to Your AWS Data Exchange Resources

Every AWS resource is owned by an AWS account, and permissions to create or access a resource are governed by permissions policies. An account administrator can attach permissions policies to IAM identities (that is, users, groups, and roles). Some services (such as AWS Lambda) also support attaching permissions policies to resources.

Note

An account administrator (or administrator) is a user with administrator privileges. For more information, see IAM Best Practices in the IAM User Guide.

When granting permissions, you decide who is getting the permissions, the resources they get permissions for, and the specific actions that you want to allow on those resources.

AWS Data Exchange Resources and Operations

In AWS Data Exchange, there are two different kinds of primary resources with different control planes:

  • The primary resources for AWS Data Exchange are data sets and jobs. AWS Data Exchange also supports revisions and assets.

  • To facilitate transactions between providers and subscribers, AWS Data Exchange also uses AWS Marketplace concepts and resources, including products, offers, and subscriptions. You can use the AWS Marketplace Catalog API or the AWS Data Exchange console to manage your products, offers, subscription requests, and subscriptions.

Understanding Resource Ownership

The AWS account owns the resources that are created in the account, regardless of who created the resources. Specifically, the resource owner is the AWS account of the principal entity (that is, the AWS account root user, an IAM user, or an IAM role) that authenticates the resource creation request. The following examples illustrate how this works:

Resource Ownership

Any IAM entity in an AWS account with the right permissions can create AWS Data Exchange data sets. When an IAM entity creates a data set, their AWS account owns the data set. Published data products can contain data sets that are owned only by the AWS account that created them.

To subscribe to an AWS Data Exchange product, the IAM entity will need permissions use AWS Data Exchange, as well as the aws-marketplace:subscribe IAM permission for AWS Marketplace (assuming they pass any related subscription verifications). As a subscriber, your account has read access to entitled data sets, however it does not own the entitled data sets. Any entitled data sets that are exported to Amazon S3 are owned by the subscriber's AWS account.

Managing Access to Resources

This section discusses using IAM in the context of AWS Data Exchange. It doesn't provide detailed information about the IAM service. For complete IAM documentation, see What Is IAM? in the IAM User Guide. For information about IAM policy syntax and descriptions, see AWS IAM Policy Reference in the IAM User Guide.

A permissions policy describes who has access to what. The following section explains the options for creating permissions policies.

Policies attached to an IAM identity are referred to as identity-based policies (IAM polices). Policies attached to a resource are referred to as resource-based policies. AWS Data Exchange supports only identity-based policies (IAM policies).

Identity-Based Policies (IAM Policies)

You can attach policies to IAM identities. For example, you can do the following:

  • Attach a permissions policy to a user or a group in your account – To grant a user permissions to create an AWS Data Exchange resource, like a revision, you can attach a permissions policy to a user or group that the user belongs to.

  • Attach a permissions policy to a role (grant cross-account permissions) – You can attach an identity-based permissions policy to an IAM role to grant cross-account permissions. For example, the administrator in Account A can create a role to grant cross-account permissions to another AWS account (for example, Account B) or an AWS service as follows:

    1. Account A administrator creates an IAM role and attaches a permissions policy to the role that grants permissions on resources in Account A.

    2. Account A administrator attaches a trust policy to the role identifying Account B as the principal who can assume the role.

    3. Account B administrator can then delegate permissions to assume the role to any users in Account B. Doing this allows users in Account B to create or access resources in Account A. The principal in the trust policy can also be an AWS service principal, if you want to grant an AWS service permissions to assume the role.

    For more information about using IAM to delegate permissions, see Access Management in the IAM User Guide.

AWS Data Exchange provides four managed policies:

  • AWSDataExchangeFullAccess

  • AWSDataExchangeSubscriberFullAccess

  • AWSDataExchangeProviderFullAccess

  • AWSDataExchangeReadOnly

The following is an example managed policy, AWSDataExchangeProviderFullAccess. It grants an entity full access to AWS Data Exchange and the permissions required for other related services to perform all provider-related actions on AWS Data Exchange:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "dataexchange: CreateDataSet", "dataexchange: CreateRevision", "dataexchange: Get*", "dataexchange: Update*", "dataexchange: List*", "dataexchange: Delete*" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "dataexchange: CreateJob", "dataexchange: StartJob", "dataexchange: CancelJob" ], "Resource": "*", "Condition": { "dataexchange: JobType": [ "IMPORT_ASSETS_FROM_S3", "IMPORT_ASSET_FROM_SIGNED_URL", "EXPORT_ASSETS_TO_S3", "EXPORT_ASSET_TO_SIGNED_URL" ] } }, { "Effect": "Allow", "Action": [ "s3: GetObject" ], "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "s3: ExistingObjectTag/aws-data-exchange": "true" } } }, { "Action": "s3: GetObject", "Effect": "Allow", "Resource": "arn: aws: s3: : : *aws-data-exchange*" }, { "Action": [ "s3: PutObject", "s3: PutObjectAcl" ], "Effect": "Allow", "Resource": "arn: aws: s3: : : *aws-data-exchange*" }, { "Effect": "Allow", "Action": [ "s3: GetBucketLocation" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "aws-marketplace: ListEntities", "aws-marketplace: DescribeEntity", "aws-marketplace: StartChangeSet", "aws-marketplace: ListChangeSets", "aws-marketplace: DescribeChangeSet", "aws-marketplace: CancelChangeSet", "aws-marketplace: ListAgreementApprovalRequests", "aws-marketplace: GetAgreementApprovalRequest", "aws-marketplace: AcceptAgreementApprovalRequest", "aws-marketplace: RejectAgreementApprovalRequest", "aws-marketplace: UpdateAgreementApprovalRequest" ], "Resource": "*" } ] }
Additional Amazon S3 Permissions

When importing assets from Amazon S3 to AWS Data Exchange you need permissions to write to the AWS Data Exchange service Amazon S3 buckets. Similarly, when exporting assets from AWS Data Exchange to Amazon S3, you need permissions to read from the AWS Data Exchange service Amazon S3 buckets. You can scope these permissions to buckets that contain aws-data-exchange in their name.

For example, the AWSDataExchangeProviderFullAccess managed policy shown previously includes these permissions:

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "s3:GetObject" ], "Resource": "*", "Condition": { "StringEqualsIgnoreCase": { "s3:ExistingObjectTag/aws-data-exchange": "true" } } }, { "Action": "s3:GetObject", "Effect": "Allow", "Resource": "arn:aws:s3:::*aws-data-exchange*" }, { "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Effect": "Allow", "Resource": "arn:aws:s3:::*aws-data-exchange*" }, { "Effect": "Allow", "Action": [ "s3:GetBucketLocation" ], "Resource": "*" } ] }

These permissions allow providers to import and export with AWS Data Exchange. The policy includes the following permissions:

  • s3:putObject and s3:putObjectAcl – These permissions are restricted only to Amazon S3 buckets that contain aws-data-exchange in their name. These permissions allows providers to write to AWS Data Exchange service buckets when importing from Amazon S3.

  • s3:getBucketLocation – This permission on the Amazon S3 buckets from which assets are imported allows providers to optimize import speed. This permission is also needed to use the AWS Data Exchange console when importing.

  • s3:getObject – This permission is restricted to:

    • Amazon S3 objects that are tagged with "aws-data-exchange":"true". This permission allows providers to read the Amazon S3 objects they are importing.

    • Amazon S3 buckets that contain aws-data-exchange in their name. This permission allows providers to write to AWS Data Exchange service buckets when exporting out of AWS Data Exchange to Amazon S3.

For more information about users, groups, roles, and permissions, see Identities (Users, Groups, and Roles) in the IAM User Guide.

Resource-Based Policies

Other services, such as Amazon S3, also support resource-based permissions policies. For example, you can attach a policy to an S3 bucket to manage access permissions to that bucket.

Specifying Policy Elements: Actions, Effects, and Principals

To use AWS Data Exchange, you must be an IAM user with the appropriate permissions defined in a IAM policy.

The following are the most basic policy elements:

  • Resource – In a policy, you use an Amazon Resource Name (ARN) to identify the resource to which the policy applies. All AWS Data Exchange APIs support resource level permissions (RLP), but AWS Marketplace actions don't support RLP. For more information, see AWS Data Exchange Resources and Operations.

  • Action – You use action keywords to identify resource operations that you want to allow or deny.

  • Effect – You specify the effect (allow or deny) when the user requests the specific action. If you don't explicitly grant access to (allow) a resource, access is implicitly denied. You can also explicitly deny access to a resource, which you might do to make sure that a user cannot access it, even if a different policy grants access.

  • Principal – In identity-based policies (IAM policies), the user that the policy is attached to is the implicit principal. For resource-based policies, you specify the user, account, service, or other entity that you want to receive permissions (applies to resource-based policies only). AWS Data Exchange doesn't support resource-based policies.

For more information about IAM policy syntax and descriptions, see AWS IAM Policy Reference in the IAM User Guide.

Specifying Conditions in a Policy

When you grant permissions, you can use the IAM policy language to specify the conditions when a policy should take effect. With AWS Data Exchange, the CreateJob, StartJob, GetJob, CancelJob APIs support conditional permissions. You can provide permissions at the JobType level.

AWS Data Exchange Condition Key Reference

Condition Key Description Type
"dataexchange:JobType":"IMPORT_ASSETS_FROM_S3" Scopes permissions to jobs that import assets from Amazon S3. String
"dataexchange:JobType":"IMPORT_ASSET_FROM_SIGNED_URL" Scopes permissions to jobs that import assets from a signed URL. String
"dataexchange:JobType":"EXPORT_ASSETS_TO_S3" Scopes permissions to jobs that export assets to Amazon S3. String
"dataexchange:JobType":"EXPORT_ASSETS_TO_SIGNED_URL" Scopes permissions to jobs that export assets to a signed URL. String

For more information about specifying conditions in a policy language, see Condition in the IAM User Guide.

To express conditions, you use predefined condition keys. AWS Data Exchange has the JobType condition for APIs. However, there are AWS-wide condition keys that you can use, as appropriate. For a complete list of AWS-wide keys, see Available Keys for Conditions in the IAM User Guide.