Your Setup Console

Provisionee Certification Guide

This guide explains the Frustration-Free certification process. The certification process does not replace your feature, security, or performance testing.

Requirements and Getting Started

Before you can begin the certification process, you must provide the following items:

  • One provisionee device
    • Your device must have production-ready firmware already installed. Amazon will not update the firmware on your device.
  • Mobile application for iOS or Android (Wi-Fi Simple Setup solutions only)
    • You must make a Bata or production-ready version of your application available for download by our certification team.
  • Instruction and documentation
    • You must provide detail instructions on the use of your device and application.
  • Product-packaging
    • You must provide production-packaging or appropriate physical production-packaging proofs with FFS-ready barcodes.
    • If you are submitting your device without proper barcode packaging, please get prior approval before shipping your device.

Amazon requires that you ensure the following before you ship your device:

  • Your device is fully tested.
    • You must complete your own testing including QA, unit, integration, feature, and regression testing for your existing functionality. The certification process ensures compliance with FFS device and program requirements. (Please include any test harnesses required to pull logs from your device for lab testing.)
    • You must complete the Self-Certification tests and review the results with Amazon.
  • You have enabled all required skills (not needed for ACK devices)
    • You must complete all tasks necessary to enable any skills needed during certification testing.
    • If needed, please setup a test account with before shipping your device.

Amazon notifies your company's primary contact when your device passes certification testing. Your device remains certified as long as your device remains in compliance with the certification standards set at the time of testing. If your device falls out of compliance, per program requirements, Amazon may disable your device from communicating with our FFS backend service. If your device fails certification testing, Amazon provides a list of failures. You can resubmit your device for certification testing after you have addressed the failures.

Device Details

Compliance with the FFS specification and implementation helps ensure a consistent and secure experience for our customers. Amazon requires that FFS-compatible devices are validated and certified. Exceptions to specific requirements may be possible, so ask your PoC for potential options.

  • Amazon ensures that you have correctly implemented the full TLS security flow within the SDK by testing it against our Device Setup Service (DSS) and looking at the resulting connection details. Security is paramount and this is non-negotiable.
  • If your integration requires an SDK, Amazon ensures that you have integrated with the SDK and have made no unauthorized changes to the SDK.
  • Amazon ensures that your device only requests network credentials for SSIDs that it detects in the immediate vicinity. Requests for other SSIDs are not permitted.
  • Amazon ensures that your implementation successfully provisions your device in 95% of testing attempts at a range of (at least) 30 feet between the provisionee and provisioner devices (including non-Amazon provisioners, if applicable). Amazon completes this testing across a representative blend of provisioner devices currently released. Amazon may also test your device against pre-release devices; however, this does not count as part of the 95% success requirement.
  • Depending on your implementation, Amazon ensures that your mobile application supports Login with Amazon, including the FFS scope. Amazon ensures that all messaging to the customer for permission regarding FFS, and the explanation of why the customer needs to grant permission is clear. Amazon also ensures that your application does not obfuscate the Login with Amazon flow.
  • Amazon ensures that, in the event that the FFS set up flow fails, your device's existing non-FFS set up flow starts up and attempts to set up the device for the customer.

Packaging Details

Amazon verifies that the device's packaging includes the required outer barcode mentioned in the manufacturing document with proper contrast. This verification ensures accurate barcode scanning during the order fulfillment process, which is necessary to properly pre-associate your device with the Amazon customer.

Timeline

  • Amazon performs device certification testing after you have completed your self-certification and submitted it through the developer portal. Please allow 3 weeks in your product development process for Amazon’s certification testing (after submitting your certification results to the developer portal). This time frame is dependent on your product readiness and preparation prior to certification submission.
  • Please reach out to your Amazon point of contact (PoC) for the latest information before certification planning. Due to the volume of testing, you are not permitted to submit the same device for certification more than three times in a 6 month period.

Certification Steps

  1. Select and download the appropriate protocol specific certification test plan below
  2. Self-certify your device
  3. Log into the developer portal and request certification
  4. The Amazon device certification will contact you to schedule certification for your device.
  5. After certification is complete, your device and ASIN will be flagged as eligible for FFS on Amazon.com

Without a certification confirmation from FFS, your devices will not connect to the FFS backend services in production.

Test Plans

The table below lists self-certification test plans for each FFS protocol. Please download the appropriate test plan for the protocol your device implements. While performing self-certification, please run each test case and indicate the pass/fail status in the following table. Amazon reviews test waivers on a case-by-case basis. If you are using the Alexa Connect Kit (ACK) you are able to take advantage of a streamlined certification process for simple setup.

Test Plan Name Version Protocol Link
WSS over Wi-Fi Provisionee 1.0 Wi-Fi Download
WSS over BLE Provisionee (non-ACK) 1.0 Wi-Fi + BLE Download
WSS over BLE Provisionee (ACK) 1.0 Wi-Fi + BLE Download
ZSS Provisionee 1.0 Zigbee Download
BSS Provisionee 1.0 Bluetooth Mesh Download

Document History

Version Date Author Description
1.0 Sept 25, 2019. Amazon. General Availability
1.1 Apr 20, 2020. Amazon. Test case clarification
1.2 Jul 10, 2020. Amazon. Updated test plans
1.3 Aug 07, 2020. Amazon. Updated certification requirements
1.4 Sept 24, 2020. Amazon. Added BSS Certification test cases
1.3 Aug 31, 2020. Amazon. Updated certification requirements

Last updated: Oct 30, 2020