AWS data-exchange documentation change
Summary
Updated the product publishing workflow with new steps, including creation in AWS Marketplace Management Portal, product ID generation, data sensitivity settings, and added allowlist configuration for access control.
Security assessment
The changes introduce documentation for the 'allowlist' feature (step 'To configure allowlist'), which enables providers to restrict product visibility to specific AWS accounts. This is a security feature for access control. However, there's no evidence this addresses a specific security vulnerability; it appears to be a new capability rather than a fix.
Diff
diff --git a/data-exchange/latest/userguide/publish-data-product.md b/data-exchange/latest/userguide/publish-data-product.md index 6140c3baa..c552d7a7f 100644 --- a//data-exchange/latest/userguide/publish-data-product.md +++ b//data-exchange/latest/userguide/publish-data-product.md @@ -161 +161 @@ This deletes the revision and all of its assets. This action cannot be undone. -After you've created at least one data set and finalized a revision with assets, you're ready to publish that data set as a part of a product. For more information, see [Product best practices in AWS Data Exchange](./product-details.html). Make sure that you have all required details about your product and offer. +After you've created at least one data set and finalized a revision with assets, you're ready to publish that data set as a part of a product. For more information, see [Product best practices in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/product-details.html). Make sure that you have all required details about your product and offer. @@ -163 +163 @@ After you've created at least one data set and finalized a revision with assets, -###### To publish a new product +###### To create a new product listing @@ -165 +165 @@ After you've created at least one data set and finalized a revision with assets, - 1. In the left navigation pane of the [AWS Data Exchange console](https://console.aws.amazon.com/dataexchange), under **Publish data** , choose **Products**. + 1. Sign in to your seller AWS account and go to the [AWS Marketplace Management Portal](https://console.aws.amazon.com/marketplace). @@ -167 +167 @@ After you've created at least one data set and finalized a revision with assets, - 2. From **Products** , choose **Publish new product** to open the **Publish new product** wizard. + 2. In the top menu, go to **Products** and then choose **Data Products**. @@ -169 +169 @@ After you've created at least one data set and finalized a revision with assets, - 3. In the **Product visibility** section, choose your product's **Product visibility options** and **Sensitive information** configuration, and then choose **Next**. For more information, see [Product visibility in AWS Data Exchange](./product-visibility.html) and [Sensitive categories of information in AWS Data Exchange](./sensitive-information.html). + 3. Choose **Create data product**. @@ -171 +171 @@ After you've created at least one data set and finalized a revision with assets, - 4. In the **Add data** section, under **Owned data sets** , select the check boxes next to the data sets you want to add, and then choose **Add selected**. + 4. To get started with a data product, you'll initiate the listing process by setting the product name, adding optional resource tags for organization, and generating the product ID. The product ID is used to track your product throughout its lifecycle. @@ -173,7 +173 @@ After you've created at least one data set and finalized a revision with assets, -###### Note - -The data sets you choose must have a finalized revision. Data sets without finalized revisions can't be added. - - 1. Go to **Selected data sets** to review your selections. - -You can review the **Name** of the data set, the **Type** of data set, and the timestamp of when the data set was **Last updated**. + 5. Under **Product name** , enter a unique product name that will be displayed to buyers at the top of the product listing page and in search results. @@ -181 +175 @@ You can review the **Name** of the data set, the **Type** of data set, and the t - 2. Go to **Select revision access rules** , choose the revision access rules that you want to set for data sets included in this product, and then choose **Next**. For more details, see [Revision access rules in AWS Data Exchange](./best-practices-revisions.html). + 6. (Optional) Under **Tags** , enter any tags you want to associate with the product. For more information, see [Tagging AWS resources](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html). @@ -183 +177 @@ You can review the **Name** of the data set, the **Type** of data set, and the t - 5. In the **Define product** section, under **Product overview** , enter information about your product, including the **Product name** , **Product logo** , **Support contact** information, and **Product categories**. + 7. Under **Product ID and code** , choose **Generate product ID and code**. @@ -185 +179 @@ You can review the **Name** of the data set, the **Type** of data set, and the t -For more information, see [Product best practices in AWS Data Exchange](./product-details.html). + 8. Choose **Continue to product details**. You'll start the process of adding detailed product information. @@ -187 +180,0 @@ For more information, see [Product best practices in AWS Data Exchange](./produc - 6. (Optional) In the **Define product** section, under **Data dictionaries and samples – optional** , choose a data set by selecting the option button next to the data set name and then choose **Edit**. @@ -189 +181,0 @@ For more information, see [Product best practices in AWS Data Exchange](./produc - 1. In the **Edit** dialog box, under **Upload data dictionary** , choose **Add file** to upload a new data dictionary. @@ -191 +182,0 @@ For more information, see [Product best practices in AWS Data Exchange](./produc -You can choose one data dictionary, in .csv format, with a maximum size of 1 MB. @@ -193 +184 @@ You can choose one data dictionary, in .csv format, with a maximum size of 1 MB. - 2. Choose a saved data dictionary from your computer, and then choose **Open**. +###### To provide product information @@ -195 +186 @@ You can choose one data dictionary, in .csv format, with a maximum size of 1 MB. -The data dictionary .csv file appears on the **Edit** dialog box. +When listing your data product in AWS Marketplace, providing comprehensive and accurate product information is crucial. Use the **Provide product information** step to capture essential details about your offering such as product categories and support information. @@ -197 +188 @@ The data dictionary .csv file appears on the **Edit** dialog box. -###### Note + 1. Enter information about your product. For more details, see [AWS Data Exchange product details](https://docs.aws.amazon.com/data-exchange/latest/userguide/prod-details-over.html). @@ -199 +190 @@ The data dictionary .csv file appears on the **Edit** dialog box. -Your data dictionary must conform to the AWS Data Exchange data dictionary template. If you don’t have a saved data dictionary to upload, you can choose either the **blank data dictionary template** link or the **example data dictionary** link in the AWS Data Exchange console. + 2. Choose **Next** to move to the next step. @@ -201 +191,0 @@ Your data dictionary must conform to the AWS Data Exchange data dictionary templ - 3. Choose **Data dictionary preview** to preview it. @@ -203 +192,0 @@ Your data dictionary must conform to the AWS Data Exchange data dictionary templ - 4. Under **Samples - optional** , choose **Upload samples** , choose a sample from your computer, and then choose **Open**. @@ -205 +193,0 @@ Your data dictionary must conform to the AWS Data Exchange data dictionary templ -The samples appear on the **Edit** dialog box. @@ -207 +195 @@ The samples appear on the **Edit** dialog box. -###### Note +###### To add data sets @@ -209 +197 @@ The samples appear on the **Edit** dialog box. -You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv format can be previewed. + 1. Choose the AWS Region in which the data sets are located. @@ -211 +199 @@ You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv fo - 5. Enter a description for each sample that will be visible on the product detail page. + 2. In the **Owned data sets** section, select the check boxes next to the data sets you want to add. The data sets you choose must have a finalized revision. Data sets without finalized revisions can't be added. @@ -213 +201 @@ You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv fo - 6. Choose **Save**. + 1. Go to **Added data sets** to review your selections. @@ -215 +203 @@ You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv fo - 7. Under **Product definition** , enter a **Short description** and a **Long description** of your product. + 2. You can review the **Name** of the data set, the **Type** of data set, and the timestamp of when the data set was **Last updated**. @@ -217 +205 @@ You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv fo -If you want to use a template for your long description, select **Apply template** , choose your template type, and then fill out the template with your specific product details. + 3. Go to **Revision access rule settings** , choose the revision access rules that you want to set for data sets included in this product. For more details, see [Revision access rules in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/best-practices-revisions.html). @@ -219 +207 @@ If you want to use a template for your long description, select **Apply template - 8. Choose **Next**. + 3. (Optional) In the **Data dictionaries** section, select a data set and choose **Add dictionary**. @@ -221 +209 @@ If you want to use a template for your long description, select **Apply template - 9. Configure your offer. + 1. Choose **Upload data dictionary** to upload a new data dictionary. @@ -223 +211 @@ If you want to use a template for your long description, select **Apply template - * If you're creating a public offer, in the **Add public offer** section, configure your offer. All AWS Data Exchange products with visibility set to **Public** require a public offer. +You can choose one data dictionary, in .csv format, with a maximum size of 1 MB. @@ -225 +213 @@ If you want to use a template for your long description, select **Apply template - 1. Choose your **Pricing and access duration** options for the subscription. + 2. Choose a saved data dictionary from your computer, and then choose **Open**. Your data dictionary must conform to the AWS Data Exchange data dictionary template. If you don't have a saved data dictionary to upload, you can choose either the **blank data dictionary template** link or the **example data dictionary** link in the AWS Data Exchange console. For more details, see [Data dictionaries in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/data-dictionaries-pro.html). @@ -227 +215 @@ If you want to use a template for your long description, select **Apply template - 2. Choose your US sales tax settings, data subscription agreement (DSA), and refund policy. + 4. (Optional) Under **Data samples** , choose **Add sample** and select the data set to which you want to provide samples. @@ -229 +217 @@ If you want to use a template for your long description, select **Apply template - 3. (Optional) Set **Subscription verification** , which enables you to control who can subscribe to this product. For more information, see [Subscription verification for providers in AWS Data Exchange](./subscription-verification-pro.html). + 1. Select **Upload data sample** and select a data set a sample from your computer, and then choose **Open**. @@ -231 +219 @@ If you want to use a template for your long description, select **Apply template - 4. Choose your **Offer auto-renewal** option. For more information, see [Creating an offer for AWS Data Exchange products](./prepare-offers.html). + 2. (Optional) Enter a description for each sample that will be visible on the product detail page. @@ -233 +221 @@ If you want to use a template for your long description, select **Apply template - 5. Choose **Next**. + 3. Choose **Add sample**. You can upload up to 10 samples with a maximum size of 50 MB. Samples in .csv format can be previewed. For more details, see [Sample data in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/samples-pro.html). @@ -235 +223 @@ If you want to use a template for your long description, select **Apply template - * If you're creating a private offer, configure the offer details in the **Add custom offer** section. + 5. In the **Revision access rule settings** section, choose the revision access rules that you want to set for data sets included in this product. For more details, see [Revision access rules in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/best-practices-revisions.html). @@ -237 +225 @@ If you want to use a template for your long description, select **Apply template - 1. In the **Subscriber account information** section, add at least one subscriber account to which you want to extend the offer. + 6. In the **Data sensitivity information settings** section, choose your product's **Sensitive information** configuration, and then choose **Next**. For more information, see [Sensitive categories of information in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/sensitive-information.html). @@ -239 +226,0 @@ If you want to use a template for your long description, select **Apply template - 2. Choose your **Pricing and access duration** options for the subscription. @@ -241 +227,0 @@ If you want to use a template for your long description, select **Apply template - 3. Choose the **Offer expiration date** by which the subscriber must accept the offer. @@ -243 +228,0 @@ If you want to use a template for your long description, select **Apply template - 4. Choose your US sales tax settings, data subscription agreement (DSA), and refund policy. @@ -245 +230 @@ If you want to use a template for your long description, select **Apply template - 5. Choose your **Offer auto-renewal** option. For more information, see [Creating an offer for AWS Data Exchange products](./prepare-offers.html). +###### To configure allowlist @@ -247 +232 @@ If you want to use a template for your long description, select **Apply template - 6. Choose **Next**. +Before submitting your product, you'll need to specify which AWS accounts can access it. This optional step controls the initial visibility of your product, limiting access to your own account and any specifically authorized AWS accounts you add to the allowlist. @@ -249 +234 @@ If you want to use a template for your long description, select **Apply template - 10. In the **Review & publish** section, review your product information and then expand the **Product page preview** to see how it will look after it’s published. + 1. Enter the AWS account IDs you want to access your product. @@ -251 +236 @@ If you want to use a template for your long description, select **Apply template - 11. If you're sure that you want to make the product and public offer visible and available to everyone, choose **Publish**. + 2. Choose **Submit** to submit your product. Your product will have the **Limited visibility** status and will only be visible to the AWS account that created the product and other allow-listed AWS accounts. You can view and test your product listing while it's in **Limited visibility** status. @@ -256 +241 @@ If you want to use a template for your long description, select **Apply template -You've now completed the manual portion of publishing a data product with a public offer. AWS Data Exchange prepares and publishes your product. On the **Product overview** page, the status of your product is **Awaiting approval** and then changes to **Published** after it's published. +For more information on statuses, see [Product visibility in AWS Data Exchange](https://docs.aws.amazon.com/data-exchange/latest/userguide/product-visibility.html).