Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In addition to the tenant regular options, additional setup can be done through the metadata parameter

Image Modified


Table of Contents
stylenone


1 - Preamble

Tenant options control how Maestrano will behave for your Marketplace.

Most options are visible and self explanatory, but to enable further customisation, the metadata option has been added, which can easily by extended.

It can be set as a list of key/value pairs like: {"kpi_enabled"=>true, "host"=>"http://localhost:7000"}

Warning
titleImportant Note

This article list options as of 12th of May 2017. We are in the process of refactoring how options are managed so this list is likely to change in the coming months.

2 - Options summary

OptionDefault ValueRequired
General configuration
hostapp.tenant_domainyes1
App Management
can_manage_appsfalseno
app_managementmarketplaceno
Platform features
kpi_enabledfalseno
pull_disabledfalseno
push_disabledfalseno
Security
deny_old_passwordsfalseno
password_archiving_count0no
Pricing & Billing
price_listnoneno
invoicing_currencyUSDno
platform_fee_strategynoneno
platform_fee_apps_count_activation2no
platform_fee_price_cents2000no
platform_fee_price_centsUSDno

organization_initial_credit

noneno

1The default is likely to be incorrect

3 - Options details

3.1 General configuration

3.1.1 - host

Format: "host" => https://mybiz.com

Description: The host parameter is used as a replacement for the domain if not defined

Default value: app.tenant_domain

3.2 App Management

3.2.1 - can_manage_apps

Format: "can_manage_apps" => true || false

Description: Describe if the app catalog can be managed at the tenant level.

Default value: false

3.2.2 - app_management

Format: "app_management" => 'tenant' || 'marketplace'

Description: Describe how the app catalog is retrieved in the marketplace.

  • If marketplace, all apps in the marketplace (MnoHub) are returned
  • If tenant, apps needs to be manually added to the tenant.

Default value: 'marketplace'

3.3 Platform features

3.3.1 - kpi_enabled

Format: "kpi_enabled" => true || false

Description: Set whether or not Kpis should be enabled for the tenant

Default value: false

3.3.2 - pull_disabled

Format: "pull_disabled" => true || false

Description: Control whether data should be pulled from applications. Overridden at the app level

Default value: false

3.3.3 - push_disabled

Format: "push_disabled" => true || false

Description: Control whether data should be pushed applications. Overridden at the app level

Default value: false

3.4 Security

3.4.1 - deny_old_passwords

Format: "deny_old_password" => true || false

Description: Control whether user can reuse an old password or not

Default value: false

3.4.2 - password_archiving_count

Format: "password_archiving_count" => 0

Description: Control how many passwords should be enabled to prevent reuse when deny_old_passwords is used

Default value: 0

3.5 Pricing

3.5.1 - price_list

Format: "price_list" => {hash of prices}

Description: Allow to override the price of hosted apps.

Default value: none

Example:

Code Block
languageruby
# Base price of $20 and $10/user
{
  app_nid: {
    base: {
      cents: 2000,
      currency: "AUD" # Optional: defaults to "USD"
    },
    licence: {
      cents: 1000,
      currency: "AUD" # Optional: defaults to "USD"
    }
  } 
}


3.5.2 - invoicing_currency


Format: "invoicing_currency" => "USD"

Description: Currency used for invoicing on this tenant

Default value: "USD"

3.5.3 - platform_fee_strategy

Format: "platform_fee_strategy" => "orga_relation" || "user"

Description: Define if the platform fee licence will be applied to each user inside an organization and aggregated by organizations (orga_relation) or if the platform fee is per user and aggregated by tenant (user)

Default value:  none

3.5.4 - platform_fee_apps_count_activation

Format: "platform_fee_apps_count_activation" => 1

Description: The minimun required application to activate the platform licence

Default value: 2

3.5.5 - platform_fee_price_cents

Format: "platform_fee_price_cents" => 20

Description: The price in cents of the platform usage per month per user

Default value: 2000

3.5.6 - platform_fee_price_currency

Format: "platform_fee_currency" => "USD"

Description: The currency of the price of the platform usage per month per user

Default value: "USD"

3.5.7 - organization_initial_credit

Format: "organization_initial_credit" => {"cents" => 1000, "currency" => "AUD"}

Description: Initial credit added at Organization creation

Default value: nil

3.6 Commission

Coming soon