

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengakses Layanan AWS Marketplace Pengukuran dan Hak APIs
<a name="saas-integration-metering-and-entitlement-apis"></a>

Bagian ini menguraikan proses integrasi dengan AWS Marketplace Metering Service atau AWS Marketplace Entitlement Service, yang digunakan untuk memastikan bahwa penagihan dan pelaporan Anda untuk penggunaan pelanggan atas produk perangkat lunak sebagai layanan (SaaS) Anda akurat. Diasumsikan bahwa Anda telah mengirimkan produk langganan SaaS atau produk kontrak SaaS yang telah diterbitkan ke negara bagian terbatas. Dalam keadaan terbatas, Anda dapat menggunakan akun pengujian untuk memverifikasi konfigurasi dan fungsi yang tepat tetapi produk Anda tidak tersedia untuk umum. 

**catatan**  
Jika produk SaaS Anda terintegrasi dengan layanan AWS terkelola lain yang menangani pengukuran dengan cara yang berbeda (seperti Amazon SageMaker Ground Truth, atau AWS WAF), maka Anda tidak perlu berintegrasi dengan layanan pengukuran AWS Marketplace. Pengukuran untuk produk Anda seharusnya hanya terjadi dalam satu sistem untuk menghindari penagihan ganda pelanggan Anda.

**Topics**
+ [Mengkonfigurasi pengukuran untuk penggunaan dengan langganan SaaS](metering-for-usage.md)
+ [Memeriksa hak menggunakan AWS Marketplace Entitlement Service](checking-entitlements.md)
+ [Daftar periksa integrasi produk SaaS](aws-marketplace-integration-checklist.md)

 *Untuk informasi tentang pengaturan AWS CLI, bersama dengan kredensialnya, lihat [Mengonfigurasi AWS CLI dalam Panduan](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html) Pengguna.AWS Command Line Interface * [Jika Anda baru mengenal AWS Python SDK, lihat Boto 3 Quickstart.](https://boto3.readthedocs.io/en/latest/guide/quickstart.html) 

# Mengkonfigurasi pengukuran untuk penggunaan dengan langganan SaaS
<a name="metering-for-usage"></a>

Untuk langganan perangkat lunak sebagai layanan (SaaS), Anda meteran untuk semua penggunaan, dan kemudian pelanggan ditagih AWS berdasarkan catatan pengukuran yang Anda berikan. Untuk kontrak SaaS, Anda hanya meteran untuk penggunaan di luar hak kontrak pelanggan. Bagian berikut memberikan informasi tentang cara mengonfigurasi pengukuran untuk penggunaan dengan produk SaaS. 

Ketika aplikasi Anda mengukur penggunaan untuk pelanggan, aplikasi Anda menyediakan AWS dengan jumlah penggunaan yang masih harus dibayar. Pengukur aplikasi Anda untuk dimensi harga yang Anda tentukan saat membuat produk, seperti gigabyte yang ditransfer atau host dipindai dalam jam tertentu. Misalnya, jika Anda mengenakan biaya berdasarkan jumlah data yang dikirim ke aplikasi Anda, Anda dapat mengukur jumlah data dan mengirim catatan pengukuran yang sesuai satu jam sekali. AWS menghitung tagihan pelanggan menggunakan data pengukuran bersama dengan harga yang Anda berikan saat Anda membuat produk Anda.

Untuk produk yang mendukung Perjanjian Bersamaan, pengukuran beroperasi pada tingkat lisensi daripada tingkat produk. Setiap catatan penggunaan harus menyertakan a `LicenseArn` untuk mengidentifikasi perjanjian spesifik mana yang berlaku untuk penggunaan. `LicenseArn`Ini diperoleh dari respons `ResolveCustomer` API selama pendaftaran SaaS. Hal ini memungkinkan pembeli untuk mempertahankan beberapa perjanjian aktif untuk produk yang sama, dengan penggunaan dilacak dan ditagih secara terpisah per perjanjian.

**catatan**  
Secara opsional, Anda dapat membagi penggunaan di seluruh properti yang Anda lacak. Properti ini diekspos ke pembeli sebagai tag. Tag ini memungkinkan pembeli untuk melihat biaya mereka dibagi menjadi penggunaan oleh nilai tag. Misalnya, jika Anda mengenakan biaya oleh pengguna, dan pengguna memiliki `Department` properti, Anda dapat membuat alokasi penggunaan dengan tag yang memiliki kunci`Department`, dan satu alokasi per nilai. Ini tidak mengubah harga, dimensi, atau total penggunaan yang Anda laporkan, tetapi memungkinkan pelanggan Anda untuk melihat biaya mereka berdasarkan kategori yang sesuai dengan produk Anda. Untuk informasi selengkapnya, lihat [Penandaan terukur vendor (Opsional)](#saas-vendor-metered-tagging).

**Topics**
+ [Meter setiap jam](#metering-hourly)
+ [Konfigurasikan produk Anda untuk penggunaan meter](#configure-application-for-meter-usage)
+ [Penandaan terukur vendor (Opsional)](#saas-vendor-metered-tagging)

## Meter setiap jam
<a name="metering-hourly"></a>

Kami menyarankan Anda melaporkan penggunaan setiap jam untuk semua pelanggan Anda dalam batch hingga 25 sekaligus. AWS Ini memberi pelanggan visibilitas granular sebanyak mungkin ke dalam penggunaan dan biaya mereka. Jika Anda menggabungkan penggunaan dalam periode waktu lebih dari satu jam (misalnya, satu hari), perhatikan pertimbangan berikut.
+ AWS hanya dapat menagih pelanggan untuk penggunaan produk Anda setelah menerima catatan pengukuran dari Anda. Anda bertanggung jawab untuk memastikan bahwa catatan pengukuran produk Anda berhasil dikirim dan diterima. Anda dapat menggunakan AWS CloudTrail untuk memverifikasi catatan atau catatan yang Anda kirim akurat. Anda juga dapat menggunakan informasi untuk melakukan audit dari waktu ke waktu. Untuk informasi selengkapnya, lihat [Pencatatan panggilan AWS Marketplace API dengan AWS CloudTrail](cloudtrail-logging.md). 
+ Jika ini adalah SaaS dengan model harga “Berlangganan” (bukan model penetapan harga “Kontrak” atau “Kontrak dengan Konsumsi”), maka pembeli dapat berhenti berlangganan kapan saja. Ketika pembeli memulai tindakan berhenti berlangganan ini, penjual akan menerima `unsubscribe-pending` [pemberitahuan](saas-notification.md#saas-sns-subscription-message-body) dan memiliki waktu 1 jam untuk mengirimkan semua penggunaan yang tidak dilaporkan sebelum pemberitahuan akhir. `unsubscribe-success` Apa pun setelah pemberitahuan kedua tidak akan dihormati. Dua model harga lainnya memiliki durasi yang ditetapkan berdasarkan waktu berlangganan dan pembeli tidak dapat berhenti berlangganan selama itu. Mereka hanya dapat mematikan autorenewal. Pemberitahuan yang sama dikirim pada akhir durasi itu jika tidak autorenewing.
+ Untuk produk dengan Perjanjian Bersamaan: Pemberitahuan berhenti berlangganan dan jendela 1 jam berlaku per perjanjian individu, bukan per produk. Jika pembeli membatalkan salah satu dari beberapa perjanjian aktif, Anda dapat melanjutkan pengukuran terhadap lisensi aktif yang tersisa. Hanya penggunaan untuk perjanjian yang dibatalkan yang harus diserahkan dalam jangka waktu 1 jam setelah menerima `unsubscribe-pending` pemberitahuan untuk lisensi khusus tersebut.
+ Jika Anda tidak mengirim catatan pengukuran setiap jam dan ada aplikasi atau pemadaman jaringan, catatan Anda akan tertinggal lebih jauh. Hal ini dapat mengakibatkan penggunaan yang tidak dilaporkan jika aplikasi atau pemadaman jaringan dipulihkan setelah langganan berakhir.
+ Bahkan jika tidak ada gunanya melaporkan, Anda dapat terus mengirim catatan pengukuran setiap jam dan mencatat jumlah 0 jika tidak ada gunanya melaporkan untuk jam itu. Perhatikan bahwa setelah Anda melaporkan penggunaan dimensi oleh pembeli, 0 atau lebih, Anda tidak dapat mengubah catatan tersebut. Oleh karena itu adalah praktik terbaik untuk melaporkan penggunaan untuk jam sebelumnya. Penggunaan yang dilaporkan terlihat di konsol [AWS Billing and Cost](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/billing-what-is.html) Management pembeli selama siklus penagihan. Konsol menunjukkan setiap dimensi produk Anda dalam item baris terpisah dengan jumlah total unit yang dikonsumsi dan total biaya untuk item baris yang dikonsumsi untuk siklus penagihan itu atau sejauh ini, bahkan jika harga dimensi adalah \$10 per unit. Jika diaktifkan, [Laporan Biaya dan Penggunaan AWS (CUR)](https://docs.aws.amazon.com/cur/latest/userguide/what-is-data-exports.html) menunjukkan detail ini termasuk tarif per unit. Laporan ini tidak diperbarui secara real time.
+ Selama penerbitan, tim AWS Marketplace Operasi akan menguji bahwa aplikasi SaaS berhasil mengirimkan catatan pengukuran sebelum mengizinkan produk dipublikasikan. Biasanya, tim akan melakukan pendaftaran tiruan SaaS dan mengonfirmasi bahwa catatan pengukuran diterima.

**catatan**  
Jika produk SaaS Anda terintegrasi dengan layanan AWS terkelola lain yang menangani pengukuran dengan cara yang berbeda (seperti Amazon SageMaker Ground Truth, atau AWS WAF), maka Anda tidak perlu berintegrasi dengan layanan pengukuran AWS Marketplace. Pengukuran untuk produk Anda seharusnya hanya terjadi dalam satu sistem untuk menghindari penagihan ganda pelanggan Anda. Perhatikan bahwa AWS Marketplace tidak menerbitkan AWS WAF produk baru saat ini.

## Konfigurasikan produk Anda untuk penggunaan meter
<a name="configure-application-for-meter-usage"></a>

 Anda menggunakan `BatchMeterUsage` operasi di AWS Marketplace Metering Service untuk mengirimkan catatan pengukuran ke. AWS Ingatlah hal-hal berikut ini: 
+  Kami mengharuskan penjual untuk menggunakan batching dengan menggunakan `BatchMeterUsage` operasi. 
+  Kami menghapus duplikasi permintaan pengukuran pada jam tersebut. 
  + Untuk produk Perjanjian Non-Konkuren: Permintaan dideduplikasi per. product/customer/hour/dimension. For Concurrent Agreements products: Requests are deduplicated per license/customer/hour/dimension
  + Anda selalu dapat mencoba lagi permintaan apa pun, tetapi jika Anda mengukur untuk jumlah yang berbeda, jumlah asli ditagih. Untuk produk Perjanjian Bersamaan: mencoba kembali dengan yang sama `LicenseArn` aman dan mengikuti aturan deduplikasi standar. Namun, beralih antara `ProductCode` dan `LicenseArn` untuk jendela penggunaan yang sama akan menyebabkan penagihan duplikat.
  +  Jika Anda mengirim beberapa permintaan untuk hal yang samacustomer/dimension/hour, catatan tidak digabungkan. 
+ Penjual dapat mengirim catatan pengukuran dengan stempel waktu hingga 6 jam sebelumnya jika pelanggan berlangganan produk Anda. Jika pelanggan berhenti berlangganan, penjual harus mengirim catatan pengukuran dalam waktu 1 jam setelah pelanggan berhenti berlangganan. 
+ `BatchMeterUsage`muatan tidak boleh melebihi 1MB. Pilih jumlah catatan penggunaan yang akan dikirim dalam `BatchMeterUsage` permintaan sehingga Anda tidak melebihi ukuran muatan.
+  *Layanan Pengukuran AWS Marketplace tersedia di [AWS Marketplace titik akhir dan kuota yang Wilayah AWS tercantum dalam Referensi](https://docs.aws.amazon.com/general/latest/gr/aws-marketplace.html) Umum.AWS * Secara default, Wilayah AS Timur (Virginia N.) diaktifkan untuk produk pengukuran SaaS saat Anda meminta produk Anda. Jika Anda berniat menggunakan Wilayah lain, hubungi tim [https://aws.amazon.com/marketplace/management/contact-us/](https://aws.amazon.com/marketplace/management/contact-us/). Untuk informasi selengkapnya, lihat [BatchMeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_BatchMeterUsage.html). 
+ Perjanjian bersamaan: Satu pelanggan mungkin memiliki beberapa perjanjian aktif untuk produk Anda. Setiap perjanjian memiliki keunikan `LicenseArn` dan penggunaan dilacak secara terpisah per lisensi. Tinjau integrasi baru untuk Perjanjian Bersamaan [di sini](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements). Untuk implementasi baru, masing-masing `UsageRecord` harus menyertakan `LicenseArn` bidang untuk mengidentifikasi perjanjian mana yang berlaku untuk penggunaan. `LicenseArn`Ini diperoleh dari respons `ResolveCustomer` API.

**catatan**  
Untuk implementasi yang ada: Saat Anda bermigrasi dari pengukuran berbasis produk ke pengukuran berbasis lisensi, jangan kirim catatan pengukuran dengan keduanya `LicenseArn` dan `ProductCode` untuk pelanggan yang sama dalam jam yang sama. Ini akan menghasilkan penagihan duplikat. Jangan sertakan `ProductCode` pada tingkat permintaan. `LicenseArn`Di masing-masing `UsageRecord` mengidentifikasi produk dan perjanjian spesifik.

Untuk contoh kode, lihat [Contoh kode untuk integrasi produk SaaS](saas-code-examples.md).

### Contoh: Pemindaian host
<a name="host-scanning-example"></a>

 Produk Anda menganalisis perangkat keras komputasi untuk kerentanan keamanan yang diketahui. Pelanggan secara manual memulai atau menjadwalkan pemindaian instans Amazon Elastic Compute Cloud (Amazon EC2) mereka. Saat produk Anda melakukan pemindaian ini, itu menghitung jumlah host unik yang dipindai setiap jam. Dalam contoh ini, produk Anda menggunakan kategori **Host**. Anda dapat mendeklarasikan beberapa dimensi untuk jenis host yang dipindai. Misalnya, Anda dapat membebankan harga yang berbeda untuk host kecil, menengah, dan besar. 

### Contoh: Analisis log
<a name="log-analysis-example"></a>

 Produk SaaS Anda mencerna log yang dihasilkan oleh produk pelanggan, tren pelaporan, dan anomali. Saat pelanggan mengunggah log ke produk Anda, Anda mengukur jumlah data yang diterima dalam megabyte, gigabyte, atau terabyte. Pada menit kesepuluh setiap jam, pekerjaan cron membaca penggunaan ini untuk setiap pelanggan selama satu jam sebelumnya. Pekerjaan membangun laporan batch dan menggunakan `BatchMeterUsage` operasi untuk mengirimkannya ke AWS. Dalam contoh ini, produk Anda menggunakan kategori **Data**. Produk Anda juga dapat mengukur jumlah data log yang disimpan selama satu jam tertentu. Dalam hal ini, produk Anda dapat mengukur sepanjang dua dimensi: data yang diterima dalam satu jam dan total data yang disimpan dalam satu jam. Anda dapat terus mengukur data yang disimpan hingga pelanggan menghapus data ini atau kedaluwarsa. 

## Penandaan terukur vendor (Opsional)
<a name="saas-vendor-metered-tagging"></a>

Penandaan yang diukur vendor membantu Vendor Perangkat Lunak Independen (ISVs) memberi pembeli wawasan yang lebih terperinci tentang penggunaan perangkat lunak mereka dan dapat membantu mereka melakukan alokasi biaya.

Ada banyak cara untuk menandai penggunaan perangkat lunak pembeli. Salah satu caranya adalah dengan terlebih dahulu bertanya kepada pembeli Anda apa yang ingin mereka lihat dalam alokasi biaya mereka. Kemudian Anda dapat membagi penggunaan di seluruh properti yang Anda lacak untuk akun pembeli. Contoh properti termasuk`Account ID`,, `Business Unit``Cost Centers`, dan metadata relevan lainnya untuk produk Anda. Properti ini diekspos ke pembeli sebagai tag. Dengan menggunakan tag, pembeli dapat melihat biayanya dibagi menjadi penggunaan berdasarkan nilai tag di Konsol AWS Penagihan ([https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/)). Penandaan yang diukur vendor tidak mengubah harga, dimensi, atau total penggunaan yang Anda laporkan. Hal ini memungkinkan pelanggan Anda untuk melihat biaya mereka berdasarkan kategori yang sesuai dengan produk Anda.

**catatan**  
Pengukuran tingkat lisensi Perjanjian Serentak saat ini tidak didukung untuk produk penandaan meteran vendor (VMT). Jika produk Anda menggunakan VMT, lanjutkan menggunakan pengukuran `ProductCode` berbasis standar.

Dalam kasus penggunaan umum, pembeli berlangganan produk Anda dengan satu Akun AWS. Pembeli juga memiliki banyak pengguna yang terkait dengan langganan produk yang sama. Anda dapat membuat alokasi penggunaan dengan tag yang memiliki kunci`Account ID`, dan kemudian mengalokasikan penggunaan untuk setiap pengguna. Dalam hal ini, pembeli dapat mengaktifkan `Account ID` tag di konsol Billing and Cost Management mereka dan menganalisis penggunaan pengguna individu.

### Pengalaman penjual
<a name="saas-vendor-metered-tag-seller"></a>

Penjual dapat menggabungkan catatan pengukuran untuk sumber daya dengan kumpulan tag yang sama alih-alih menggabungkan penggunaan untuk semua sumber daya. Misalnya, penjual dapat membuat catatan pengukuran yang mencakup ember yang berbeda dari. `UsageAllocations` Setiap bucket mewakili `UsageQuantity` satu set tag, seperti `AccountId` dan`BusinessUnit`. 

Dalam diagram berikut, **Resource 1** memiliki satu set `AccountId` dan `BusinessUnit` tag yang unik, dan muncul di **Rekaman Pengukuran** sebagai entri tunggal. 

**Resource 2** dan **Resource 3** keduanya memiliki `AccountId` tag yang sama`2222`,, dan `BusinessUnit` tag yang sama,`Operations`. Akibatnya, mereka digabungkan menjadi satu `UsageAllocations` entri dalam **Rekaman Pengukuran**.

![\[Diagram yang menunjukkan bagaimana tag metering vendor menggabungkan data penggunaan. Tiga sumber daya (Sumber Daya 1, 2, dan 3) dengan berbeda AccountIds dan BusinessUnits dikonsolidasikan ke dalam Rekaman Pengukuran tunggal dengan UsageAllocations dikelompokkan oleh AccountId dan BusinessUnit sebelum dikirim ke AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/id_id/marketplace/latest/userguide/images/seller-vendor-meter-tag.png)


Penjual juga dapat menggabungkan sumber daya tanpa tag menjadi satu `UsageAllocation` dan mengirimkannya sebagai salah satu entri di`UsageAllocations`.

Batasan meliputi:
+ Jumlah tag — 5
+ Ukuran `UsageAllocations` (kardinalitas) — 2.500
+ Ukuran permintaan maksimal - 1 MB 

Validasi meliputi:
+ Karakter diperbolehkan untuk kunci tag dan nilai — a-zA-Z 0-9\$1 -= . \$1:\$1 /@
+ Tag maksimum di seluruh `UsageAllocation` daftar - 5
+ Dua tidak `UsageAllocations` dapat memiliki tag yang sama (yaitu, kombinasi yang sama dari kunci tag dan nilai). Jika itu masalahnya, mereka harus menggunakan hal yang sama`UsageAllocation`.
+ Jumlah `AllocatedUsageQuantity` `UsageAllocation` harus sama dengan`UsageQuantity`, yang merupakan penggunaan agregat.
+ Ukuran muatan maksimum tidak boleh lebih dari 1 MB. Ini termasuk kunci atribut input (misalnya,`UsageRecords`,`AllocatedUsageQuantity`, tag).
**catatan**  
Untuk memastikan bahwa Anda tidak melanggar batas payload, buat objek permintaan sampel dengan ukuran maksimum berdasarkan kebutuhan bisnis, ubah objek menjadi string JSON, dan dapatkan ukuran dalam byte. Pastikan bahwa satu panggilan API tidak akan melanggar batas 1 MB. Sebagai contoh. jika permintaan dengan 1 `UsageRecord` memiliki ukuran maksimum 200 KB, jangan mengirim lebih dari 5 `UsageRecords` sebagai bagian dari permintaan (200KB\$1 5 = 1MB).

### Pengalaman pembeli
<a name="saas-vendor-metered-tag-buyer"></a>

Tabel berikut menunjukkan contoh pengalaman pembeli setelah pembeli mengaktifkan tag `AccountId` dan `BusinessUnit` vendor. 

Dalam contoh ini, pembeli dapat melihat penggunaan yang dialokasikan dalam **Laporan Penggunaan Biaya** mereka. Tag yang diukur vendor menggunakan awalan. `“aws:marketplace:isv”` Pembeli dapat mengaktifkannya di Billing and Cost Management, **di bawah Tag Alokasi Biaya AWS, tag alokasi** **biaya yang dihasilkan**.

Baris pertama dan terakhir dari **Laporan Penggunaan Biaya** relevan dengan apa yang dikirim Penjual ke Layanan Pengukuran (seperti yang ditunjukkan dalam [Pengalaman penjual](container-metering-meterusage.md#container-vendor-metered-tag-seller) contoh).


**Laporan Penggunaan Biaya (Sederhana)**  

| ProductCode  | Pembeli | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` | 
| --- | --- | --- | --- | --- | --- | 
| xyz | 111122223333 | Jaringan: per (GB) diperiksa  | 70 | 2222 | Operasi | 
| xyz | 111122223333 | Jaringan: per (GB) diperiksa  | 30 | 3333 | Keuangan | 
| xyz | 111122223333 | Jaringan: per (GB) diperiksa  | 20 | 4444 | IA | 
| xyz | 111122223333 | Jaringan: per (GB) diperiksa  | 20 | 5555 | Pemasaran | 
| xyz | 111122223333 | Jaringan: per (GB) diperiksa  | 30 | 1111 | Pemasaran | 

Untuk contoh kode, lihat [`BatchMeterUsage`dengan contoh kode penandaan alokasi penggunaan (Opsional)](saas-code-examples.md#saas-batchmeterusage-tagging).

# Memeriksa hak menggunakan AWS Marketplace Entitlement Service
<a name="checking-entitlements"></a>

 Jika produk Anda adalah produk kontrak SaaS, produk Anda memanggil AWS Marketplace Entitlement Service untuk mengambil hak pelanggan menggunakan API. [GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html) Produk Anda harus memverifikasi penggunaan selanjutnya pada akun tersebut terhadap Layanan AWS Marketplace Hak. Misalnya, jika pelanggan memberikan 10 pengguna pada akun, produk Anda harus memeriksa Layanan AWS Marketplace Hak untuk hak atas kapasitas tersebut. 

Untuk memverifikasi hak pelanggan atas produk Anda, gunakan `GetEntitlements` operasi di Layanan AWS Marketplace Hak. Layanan AWS Marketplace Hak hanya tersedia di Wilayah AS Timur (Virginia N.), dapat diakses melalui `entitlement.marketplace.us-east-1.amazonaws.com` atau. `entitlement-marketplace.us-east-1.api.aws`

 `GetEntitlements`menerima ID akun AWS pelanggan, pengenal pelanggan, ARN lisensi, dan dimensi sebagai filter. `ProductCode`adalah parameter yang diperlukan. Operasi mengembalikan daftar hak paginasi. Hasilnya memiliki `ExpirationDate` bidang yang menunjukkan periode waktu minimum yang sah untuk hak tersebut. Jika pelanggan telah mengatur perpanjangan otomatis, tanggal di ExpirationDate lapangan adalah tanggal perpanjangan.

Untuk contoh kode, lihat [Contoh kode untuk integrasi produk SaaS](saas-code-examples.md).

## Mengambil hak atas tindakan pengguna
<a name="retrieving-entitlement-on-user-actions"></a>

 Contoh berikut dapat membantu Anda lebih memahami proses pengambilan hak atas tindakan pengguna. 

### Contoh: Produk berbasis pengguna
<a name="example-user-based-application"></a>

 Anda menawarkan produk yang memungkinkan sejumlah akun ada untuk pelanggan tertentu. Pelanggan dapat mengunjungi dasbor untuk menyediakan pengguna baru (misalnya, untuk menetapkan kredensi). Ketika pelanggan memberikan pengguna baru, produk Anda menelepon `GetEntitlements` untuk memverifikasi bahwa kapasitas itu ada. Jika tidak, Anda dapat menghubungi Layanan AWS Marketplace Pengukuran untuk menagih pengguna tambahan. 

### Contoh: Produk penyimpanan data
<a name="example-data-storage-application"></a>

 Anda menawarkan produk yang memungkinkan pelanggan untuk menyimpan sejumlah data dalam bentuk terenkripsi atau tidak terenkripsi. Pelanggan dapat melihat dasbor yang menampilkan jumlah data yang ada dan dialokasikan dalam produk Anda. Dasbor Anda mengambil jumlah alokasi melalui. `GetEntitlements` 

# Daftar periksa integrasi produk SaaS
<a name="aws-marketplace-integration-checklist"></a>

Sebelum produk perangkat lunak sebagai layanan (SaaS) Anda ditayangkan, Anda harus memverifikasi bahwa Anda telah menyelesaikan konfigurasi yang diperlukan. Anda dapat menggunakan daftar periksa integrasi SaaS berikut untuk memverifikasi bahwa Anda telah menyelesaikan konfigurasi yang diperlukan.


|  **Kategori**  |  **Persyaratan**  | 
| --- | --- | 
| Akses  | Mengirimkan formulir pendaftaran penjual dengan AWS akun yang diinginkan untuk AWS Marketplace digunakan.  | 
| Akses  | Menyelesaikan pendaftaran penjual, termasuk syarat dan ketentuan, rekening bank, dan formulir pajak W8 atau W9.  | 
| Akses  | Peran lintas akun yang dikonfigurasi untuk AWS Marketplace akun terdaftar.  | 
| Produk  | Menyelesaikan formulir permintaan produk di Portal Manajemen AWS Marketplace.  | 
| Produk  |  AWS Akun yang disediakan IDs untuk pengujian di tab Catatan dari wizard Buat produk di AMMP. | 
| Produk  | Menyediakan URL EULA dalam format.txt di tab Produk.  | 
| Produk  | Menerima kode produk Anda dan informasi topik Amazon SNS dari. AWS Marketplace | 
| Produk  | Berlangganan topik Amazon SNS dan membuat antrian Amazon SQS untuk berlangganan topik Amazon SNS.  | 
| Solusi Penagihan  | Divalidasi Anda dapat mengirim catatan pengukuran ke BatchMeterUsage operasi setiap jam untuk lisensi di setiap pelanggan untuk produk langganan SaaS. Dapat mengirim catatan pengukuran untuk penggunaan tambahan oleh setiap pelanggan untuk produk kontrak SaaS.  | 
| Solusi Penagihan  | Divalidasi Anda dapat memverifikasi hak pelanggan dari AWS Marketplace Layanan Hak untuk produk kontrak SaaS.  | 
| Solusi Penagihan  | Divalidasi bahwa biaya muncul seperti yang diharapkan pada tagihan yang dihasilkan untuk akun pengujian.  | 
| Solusi Penagihan  | Diuji untuk situasi seperti pelanggan tidak valid IDs dan langganan yang dibatalkan.  | 
| Produk  | Mengirimkan permintaan produk kembali ke AWS Marketplace penerbitan.  | 
| Pendaftaran  | Menerapkan halaman pendaftaran HTTPS yang dapat menerima permintaan HTTP POST.  | 
| Pendaftaran  | Divalidasi Anda dapat menerima pendaftaran pelanggan baru.  | 
| Pendaftaran  | Divalidasi Anda tidak menyimpan token pendaftaran dalam cookie.  | 
| Pendaftaran  | Divalidasi yang Anda gunakan ResolveCustomer untuk mendapatkanProductCode,CustomerAWSAccountId, dan LicenseArn dari AWS token.  | 
| Pendaftaran  | Divalidasi Anda dapat menyelesaikan token pendaftaran yang diterima dari AWS tanpa penundaan.  | 
| Pendaftaran  | Diuji bahwa Anda tidak diblokir untuk mendaftar dengan alamat layanan email seperti Gmail.  | 
| Pendaftaran  | Diuji bahwa Anda dapat menerima pendaftaran yang tidak lengkap dan beberapa upaya pendaftaran.  | 
| Langganan  | Uji yang dapat Anda tangani unsubscribe-pending dan unsubscribe-success pesan.  | 
| Langganan  |  Divalidasi bahwa Anda mengirim catatan pengukuran akhir dalam waktu satu jam setelah menerima pesan. `unsubscribe-pending`   | 
| Keamanan  | Akun AWS root yang divalidasi tidak memiliki kunci API, memiliki kata sandi yang kuat, dan dikaitkan dengan perangkat otentikasi multi-faktor perangkat keras (MFA). Semua akses administratif adalah melalui identitas yang dibuat dengan AWS Identity and Access Management (IAM). Tidak ada akun bersama.  | 
| Keamanan  | Memvalidasi bahwa peran IAM digunakan untuk semua akses Amazon Elastic Compute Cloud (Amazon EC2) terprogram. Kredenal tidak dikodekan ke dalam skrip, header, atau kode sumber.  | 
| Keamanan  | Divalidasi Anda mempertahankan pencatatan dan konsolidasi log yang komprehensif.  | 
| Keamanan  | Terverifikasi bahwa Anda memiliki batas subnet publik dan pribadi yang didefinisikan dengan baik yang mengisolasi layanan aplikasi dan akses ke database dan sistem file. Definisi kelas data berbeda yang membatasi data sensitif dan memisahkan data publik dan pribadi.  | 
| Keamanan  | Diverifikasi bahwa Anda memiliki enkripsi data pribadi dalam perjalanan dan saat istirahat dengan rotasi kunci terjadwal.  | 
| Keamanan  | Divalidasi Anda memiliki alat insiden keamanan dan akses di tempat dan latihan respons insiden yang dijadwalkan secara rutin yang mengakomodasi penyelidikan dan pemulihan tepat waktu.  | 
| Keandalan  | Terverifikasi sistem beradaptasi dengan perubahan permintaan, meningkatkan dan menurunkan skala sesuai kebutuhan, dan menggunakan penyeimbangan beban untuk memastikan kinerja tinggi. Sistem ini juga menyediakan caching berbasis tepi sesuai kebutuhan.  | 
| Keandalan  | Waktu pemulihan dan tujuan titik yang divalidasi ditentukan, dan pemulihan bencana dijadwalkan secara berkala. Kegagalan komponen adalah penyembuhan diri melalui pemicu dan pemberitahuan otomatis.  | 