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
Option | Default Value | Required | MnoHub Version2 |
---|---|---|---|
General configuration | |||
host | app.tenant_domain | yes1 | |
App Management | |||
can_manage_apps | false | no | |
app_management | marketplace | no | |
Platform features | |||
kpi_enabled | false | no | |
pull_disabled | false | no | |
push_disabled | false | no | |
Security | |||
deny_old_passwords | false | no | |
password_archiving_count | 0 | no | |
Pricing & Billing | |||
customer_billing_currency_default | none | no | v1.0.34 |
customer_billing_currency_lockdown | none | no | v1.0.34 |
price_list | none | no | |
invoicing_currency | USD | no | |
platform_fee_strategy | none | no | |
platform_fee_apps_count_activation | 2 | no | |
platform_fee_price_cents | 2000 | no | |
platform_fee_price_cents | USD | no | |
| none | no |
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