scseely/commercial-marketplace-samples

Various samples demonstrating commercial marketplace related scenarios.

Microsoft Commercial Marketplace samples index

This is a list of repositories of samples we find useful in understanding Microsoft Commercial Marketplace concepts. Please submit a pull request if there is a sample you have developed, or find that you think that may benefit the community by adding a section under the relevant offer type with a short description and a link to the sample repo.

Likewise, if there is a sample you wish existed, please add it to our Issues.

If you are here, you may also be interested in Partner Center training. We have weekly office hours for business and development. Join us live or review a recording:

• Business office hours
• Developer office hours

Check out the online learning pages suggested articles, videos, webinar recordings and more.

SaaS offers

Clients for Fulfillment and Metering APIs

We are using an Open API Specification (OAS) document (previously known as Swagger) for generating open source community API clients targeting different programming languages. Currently the following are available (all in preview).

There are packages for some client libraries as personal efforts for convenience, published at the appropriate package repositories. They are listed below. They are unsupported and personal.

• OAS document for Fulfillment API v2 and Metering service API, https://github.com/microsoft/commercial-marketplace-openapi
• Client library for .NET, https://github.com/microsoft/commercial-marketplace-client-dotnet, NuGet
• Client library for Java, https://github.com/microsoft/commercial-marketplace-client-java
• Client library for Python, https://github.com/microsoft/commercial-marketplace-client-python, PyPi
• Client library for Node.js, https://github.com/microsoft/commercial-marketplace-client-node, NPMJS- Metering, NPMJS- SaaS
• Client library for Go (coming soon), https://github.com/microsoft/commercial-marketplace-sdk-go

Basic integration and manual onboarding sample (a.k.a. Contoso sample)

Some solutions require out-of-band or manual on-boarding steps, such as validating a customer, running scripts manually for deploying resources needed for a new customer etc. This sample uses email notifications for a new customer, or any changes on the subscription status made outside of the solution code.

GitHub repo

Single Page Application sample demonstrating client side Azure Active Directory Single Sign on

This sample addresses a very narrow case to demonstrate the AAD SSO on the client side, with a server side component calling the marketplace APIs.

GitHub repo

Sample for customer registration, provisioning and subscription management (a.k.a. Microsoft Commercial Marketplace transactable SaaS offer SDK)

The sample code provides a framework for excercising the commercial marketplace billing system, including the SaaS Fulfillment API (v2) and Marketplace Metering Service API. This sample code demonstrates how a typical SaaS platform interacts with the marketplace APIs in order to provision subscriptions for customers, enable logging, and manage commercial marketplace subscriptions. It provides both a customer registration experience and a web interface for the publisher to manage the customer subscriptions.

GitHub repo

Azure application offers - Azure managed applications

Custom metering, retrieving "resourceId" for a subscription

There are multiple approaches when a managed application needs to post usage to metering service. This set of notes and samples go through those approaches, and explain the relationship between them.

GitHub repo

Using a secret from the publisher's Azure Key Vault

There are scenarios when the publisher wants to share a secret during the deployment of a Managed Application. This sample demonstrates a technique sharing secrets during the deployment.

GitHub repo

Azure application offers - Solution Template Offers

• Overview
• Azure QuickStart Templates
• MS Build 2018 Presentation: Building Solution Templates and Managed Applications for the Azure Marketplace

Azure virtual machine offers

This sample shows how to build a Virtual Machine for Linux or Windows and demonstrates the basic steps required to make the image ready for the Microsoft Commercial Marketplace.

GitHub repo

Lead management integration samples

• HubSpot Integration

Online learning resources

Online learning resources are available to include key articles, webinars, videos and more.