Skip to content

Model Quick Reference

The following table provides a quick overview of all persistent types supported by the Marketplace specification.

Persistent Resources

Type Brief Description
IdentityProvider Marketplace instance-level configuration parameters allowing user authentication against an external authority using OpenID Connect authentication flows.
User A distinct person or system with some degree of access or interest to a Marketplace instance.
(User) Identity IdentityProvider-specific information pertaining to a given User.
(User) Platform Declaration of a compatible external Product runtime environment maintained by the User.
Group A named collection of Users for purposes of batch Role assignment.
(Group) Member Essentially a "join" record signifying a given User’s placement within a Group.
Role A named set of permissions.
(Role) Appointment The granting of a single Role to a single User or Group. (It is a polymorphic type.)
JsonWebToken An RFC 7519 JSON Web Token issued to permit access by a given Identity to a Marketplace instance as a bearer token.
License A known software or content license type, required to create Product records.
Product Declaration of a Platform-compatible executable in the form of key metadata. Does not directly provide a reference to an executable image.
(Product) License The offering of a given Product via the terms of a specific License.
(Product) Screenshot Optional graphical images for illustrating Product features to Users.
(Product) Build Defines the reference to a specific version of an image of a given Product. Images must be hosted such that the Marketplace and its Users have read-only network access, at minimum.
(Product Build) Dependency Known dependencies that are needed to run a given Build of a service.
(Product Build) Exposure The standardized Interfaces capabilities provided by a given Product Build.
(Product Build Exposure) Parameter States that configuration parameter of the given name is required at runtime to successfully provide the Interface of the Exposure.
(Product Build) Configuration The runtime constraints of a Build that need to be known by a Platform for execution.
(Product Build Configuration) Task A container entry point and associated constraints that must be run as part of a Configuration profile.
Interface Marketplace-wide declaration of a standardized – or at least conventionalized – computational integration point. They are not constraints to HL7 standards.
(Interface) Surrogate Marketplace-wide statement that the referenced substitute Interface provides compatible capabilities of the given base Interface. Useful for defining new versions of an Interface that are backwards compatible with older versions.
Entitlement An user-acquired/owned instance of a ProductLicense, also defining activation data specific to the instance. (Note: Groups may not own Entitlements, but may Claim them.)
Claim Polymorphic type representing a user or group usage of an Entitlement against the limits of the underlying License.
Voucher A unique bearer token that may be redeemed for an Entitlement to a defined ProductLicense. The redeeming party may keep the Entitlement for themselves, or assigned it to another User.
Attempt Audit record of a User or Group trying to authorize usage of given Product. Used for reporting and fraud detection.

Non-Persistant Resources

A small number of a utility functions are provided that have no directly persistent model in the underlying data store.

Type Brief Description
Authorization (Not a model type but several endpoints in the API) A set of behavioral calls for clients to dynamically verify that a User or Group is allowed access to a Product via any Entitlement and Product graph pathway, subject to the semantics of all supported Licenes types, restrictions, and additional business policies.
Status A service health check providing the server datetime, session status, and other metadata.