Tenant Additional Options

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



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"}

Important 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 ValueRequiredMnoHub Version2
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
customer_billing_currency_defaultnonenov1.0.34
customer_billing_currency_lockdownnonenov1.0.34
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
2Minimum MnoHub version required

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_passwords" => 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:

# 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.5.8 customer_billing_currency_default V1.0.34

Format: "customer_billing_currency_default" => "AED"

Description: Default billing currency for this tenant when it cannot be determined. Override the Marketplace default.

Default value: none

3.5.9 customer_billing_currency_lockdown V1.0.34

Format: "customer_billing_currency_lockdown" => "AED"

Description: Force the billing currency for this tenant. This will override the currency determined with GeoLoc or the credit card.

Default value: none

3.6 Commission

Coming soon