Configuring the Weavy Management Portal

This page describes the configuration options for the Weavy Portal. These are saved as <appSettings /> entries in the web.config file.

Custom domain

If you don’t need to configure a custom domain for the deployed Weavy installations or if you are evaluating Weavy, you can leave the value for CustomDomain blank. The site will be then be accessible on the standard https://*.azurewebsites.net url. Also, you will not need to configure the SSL settings, as these are only needed if you use a custom domain. You can always change the configuration in a later stage and configure the deployed sites to use a custom domain.

Azure AD Authentication Settings

Configure these settings if you are using Azure AD for authentication in the Portal. If you are using Google Identity Platform, these settings should be left blank.

<add key="AADInstance" value="" />
<add key="AADClientId" value="" />
<add key="AADPostLogoutRedirectUrl" value="" />
<add key="AADTenant" value="" />
Name Description
AADInstance Should be https://login.microsoftonline.com/{0} for the global Azure AD.
AADClientId The Application ID of your Azure AD app.
AADPostLogoutRedirectUrl The url to the portal application (e.g. https://portal.domain.com/).
AADTenant The name of your Azure AD tenant (e.g. domain.com or name.onmicrosoft.com).

Google Identity Authentication Settings

Configure these settings if you are using Google Identity for authentication in the Portal. If you are using Azure AD authentication, these settings should be left blank.

<add key="GoogleAuthAllowedDomains" value="" />
<add key="GoogleAuthClientID" value="" />
<add key="GoogleAuthClientSecret" value="" />
Name Description
GoogleAuthAllowedDomains The email domains that are allowed to login to the Portal.
Separate multiple domains with comma (e.g. "company.com" or "company.com,weavy.com").
GoogleAuthClientID The client id of the Google OAuth App.
GoogleAuthClientSecret The client secret of the Google OAuth App.

SMTP and Mail Settings

Configure the SMTP and email settings that deployed Weavy installations should use.

<add key="SmtpServer" value="" />
<add key="SmtpPort" value="" />
<add key="SmtpUserName" value="" />
<add key="SmtpPassword" value="" />
<add key="SmtpSSL" value="" />
<add key="SmtpSender" value="" />
Name   Description
SmtpServer required The server to use.
SmtpPort required The port to use.
SmtpUserName   The username to use.
SmtpPassword   The password to use.
SmtpSSL   If deployed Weavy installations should use SSL/TLS when connecting to the SMTP server (true/false or 1/0).
SmtpSender required The from address to use when sending emails.

Azure Configuration Settings

Configure Azure settings.

<add key="AzureSubscriptionID" value="" />
<add key="AppServiceTier" value="" />
<add key="AppServiceSize" value="" />
<add key="DefaultRegion" value="" />
<add key="MaxSitesPerHostingPlan" value="400" />
<add key="TenantDomain" value="" />
Name   Description
AzureSubscriptionID required The ID of the Azure subscription where resources should be created and maintained.
AppServiceTier required Defines, together with the AppServicePlanSize, the tier and size of the App Service Plan. Recommended: PremiumV2.
AppServiceSize required Defines, together with the AppServicePlanTier, the tier and size of the App Service Plan. Recommended: P1v2, P2v2 or P3v2.
DefaultRegion required The Azure location to deploy to (see possible locations).
MaxSitesPerHostingPlan required A number indicating how many apps to add per app service plan before creating an additional one. (default: 400).
TenantDomain required The tenant domain of your Azure AD.

Azure Service Principal Settings

Settings for the service principal used to access Azure resources.

<add key="SaTenantId" value="" />
<add key="SaClientId" value="" />
<add key="SaClientSecret" value="" />
Name   Description
SaTenantId required The tenant id of the Azure AD.
SaClientId required The client id of the Azure AD application serving as service principal.
SaClientSecret required The client secret of the Azure AD application serving as service principal.

Azure SQL Settings

Settings for Azure SQL.

<add key="DatabaseAdminUsername" value="" />
<add key="DatabaseAdminPassword" value="" />
<add key="SqlDatabaseEdition" value="" />
<add key="SqlDatabaseServiceObjective" value="" />
Name   Description
DatabaseAdminUsername required The admin username for deployed Azure SQL Servers.
DatabaseAdminPassword required The admin password for deployed Azure SQL Servers.
SqlDatabaseEdition required Defines, together with the SqlDatabaseServiceObjective the edition and service objective (DTU) of the database.
List of possible values (not all are applicable). Recommended: Basic or Standard.
SqlDatabaseServiceObjective required Defines, together with the SqlDatabaseEdition the edition and service objective (DTU) of the database.
List of possible values (not all are applicable). Recommended: Basic or S1.

SSL Settings

Configure settings for SSL.

<add key="SslCertificateAsBase64String" value="" />
<add key="SslCertificatePassword" value="" />
<add key="SslThumbprint" value="" />
Name   Description
SslCertificateAsBase64String * required A base64 encoded string of the .pfx file (wildcard SSL certificate).
SslCertificatePassword * required The password that goes with the certificate.
SslThumbprint * required The thumbprint of the wildcard SSL certificate to use when configuring SSL for App Services.

* SSL settings are only required if you specify a value for CustomDomain.

Storage Account Setting

Defines the storage account to use.

<add key="StorageAccountConnectionString" value="" />
Name   Description
StorageAccountConnectionString required The connection string for the storage account used for saving database backups, packages, assets etc.

Whitelabel Settings

Settings for the whitelabeller.

<add key="SupportUrl" value="" />
<add key="SupportEmail" value="" />
<add key="ApplicationName" value="" />
Name Description
SupportUrl The support url to display in Weavy.
SupportEmail The support email address to display in Weavy.
ApplicationName The application/product name you want to display in Weavy.

Notification Hub Settings

Configure the hub settings if you are using the mobile apps (iOS/Android), otherwise leave blank.

<add key="NotificationHubConnection" value="" />
<add key="NotificationHubPath" value="" />
<add key="MessengerNotificationHubConnection" value="" />
<add key="MessengerNotificationHubPath" value="" />
Name Description
NotificationHubConnection The connection string for the notification hub.
NotificationHubPath The notification hub path.
MessengerNotificationHubConnection The connection string for the Messenger notification hub.
MessengerNotificationHubPath The messenger notification hub path.

Misc Settings

Some miscellaneous settings.

<add key="WhiteLabelSecret" value="" />
<add key="CustomDomain" value="" />    
<add key="DefaultThemeColor" value="" />
<add key="ReservedHostnames" value="" />
<add key="PrefixForResources" value="" />
<add key="NotifyEmail" value="" />
Name   Description
WhiteLabelSecret required A string that identifies you as a valid white label reseller. Will be supplied to you by the Weavy team.
CustomDomain   The domain to use when deploying sites (e.g. <uniquename>.<CustomDomain>).
DefaultThemeColor   The default theme color to use when deploying new Weavy installations.
ReservedHostnames   A list of subdomains separated with comma (,) that are reserved and should not be used.
Example: if the custom domain is company.com and you are already using info.company.com and file.company.com internally, the value should be "info,file" to prevent these being used when creating Weavy installations
PrefixForResources required The prefix to use when creating web apps and databases.
NotifyEmail required The email address to use for sending administrative notifications originating from the portal.