Install the Main Service Application in Azure
The Main application is a simple Content Management System that forms the core application for RCL Cloud Services. We will install Main as a web application in a Shared Hosting Plan in Azure.
Prerequisites
Before you install the Main application, make sure that you have completed the following tasks:
- Create an Azure Cloud account
- Create a database
- Create a storage account
- Create a Send Grid account
- Install Identity Service
Install Main
Click on the following button to deploy the application to Azure. By clicking on the 'Deploy to Azure' button, you agree to the Terms of Use for applications developed by Ray Consulting Limited. If you do not agree with the Terms of Use , you should not install or use this application.
In the 'Custom deployment' page , add the following settings
Subscription - select your subscription
Resource Group - select the existing resource group which we created for our database and storage
Location - the location will be set automatically for your resource group
Site Name - set a unique name for your website
Hosting Plan Name - set the name of the hosting plan
Sku - select 'Shared'
Worker Size - select '1'
When you are done, tick the 'agree' box and click the Purchase button.
To view the web app, Click on Resource groups , then click on the resource group
Here, you can see the new hosting plan and web app we just created.
Configure Main
In this section we will configure Main by setting the application settings.
Get the URL of the web application.
In the resource group, click on the web app. In the web app page, click the Overview link and copy the URL link for the next step. Change the link to use http:// and not https://
Add sign-on and security
Open the Identity Service application. Log in to the Admin section and click on the Clients link. In the 'Client Applications' page, click the Create New link
Create a new Client Application for Main. Click the Create button when you are done.
In the Client Applications list, click on the Secrets link to add a Client Secret for Main
Create a Sign In Uri for Main using the URL link you copied from the previous step for the Main website; and add the following text to the end of the link : 'signin-oidc' . Ensure you use 'http://' instead on 'https://' for the Sign In Uri.
In a similar way, create a Sign Out Uri for Main by adding the following text to the end of the Main Url you copied earlier :
'signout-callback-oidc'. Ensure you use 'http://' instead on 'https://' for the Sign Out Uri.
After you complete these steps, Sign-On and security can now be provided by Identity Service for the Main application.
Get the database connection
Main requires a database to store data related to the organization. In this step we will get the connection string for the database.
In the resource group, click on the database, then click on the show database connection string.
Copy the database connection string for ADO.NET
Replace the username and password placeholders with the username and password for your database. Copy this code to a safe location because we will use it to configure our web application settings later on.
Get the storage connection
Main uses a storage account to store files such as images. In this section, we will get the connection string for the storage account.
In the resource group, click the storage account and then click on the Access keys link.
Copy the connection string for 'key1' to a safe location because we will use it to configure our web application settings later on.
Add application settings to the web app
In the resource group, click on the web app
In the web app, scroll down to 'Settings' and click on Application settings
In the 'Application settings' page, scroll down to the App settings section and add the following Key-Value settings:
ASPNETCORE_ENVIRONMENT - set it to Production
DatabaseConnection - add the database connection string we acquired from the previous steps
StorageConnection - add the storage connection string we acquired from the previous steps
IdentityAuthority - set it to the Url of the Identity Service application. **Use 'https://' instead of 'http://'
IdentityClientId - the Client Id that was set for the Main application in Identity Service
IdentityClientSecret - the Secret that was set for the Main application in Identity Service
SiteName - a short name for the site, eg. organization acronym
Ensure the 'Slot setting' is ticked for all the settings. Click the Save button when you are done.
Click the Overview link in the web app and then use the URL link to launch the web application in the browser. Remember to launch your app with 'http://' instead of 'https://'.
Once everything is properly configured , the Main application website will display as follows:
Adding Domain Name
You can add your own domain name to the Main application. In the resources group, select the Main web application. Scroll down to the Settings section and click on the Custom domains link.
Provide the information for your domain and click the OK button.
You can now access your Main application from your own domain.