TABLE OF CONTENTS

Introduction

The Non-Secure Socket Layer (HTTP) is the basic communication protocol that both clients and servers must implement in order to be able to communicate, It covers things such as requests and responses, sessions, caching, authentication and more. All these are sent in clear text allowing the network through which the information passes to see the information transmitted. The Secure Socket Layer (SSL/HTTPS) protocol allows the client and server to communicate in an encrypted channel. ManagementStudio can be configured to communicate using wither of the communication channels. This article will describe the steps to switch ManagementStudio from a Non-Secure Socket Layer to a Secure Socker Layer connection (i.e Http to Https website).


Step 1: Import Certificate onto IIS server

  • Click on Start menu, and then search for Run.
  • Type in mmc and Click OK
  • Click File > Add/Remove Snap-in.
  • Select Certificates > Add.

 

Graphical user interface, application

Description automatically generated

 

  • Select Computer Account and then click Next. Select Local Computer and then click Finish. Then close the add standalone snap-in window and the add/remove snap-in window.
  • Click the + to expand the certificates (local computer) console tree and look for the personal directory/folder. Expand the certificates folder.
  • Right-click Personal and select All Tasks > Import.


Graphical user interface, text, application

Description automatically generated

  • Follow the certificate import wizard to import your primary certificate from the .pfx file. When prompted, choose to automatically place the certificates in the certificate stores based on the type of the certificate.
  • A dialog box appears indicating the import was successful. Click OK.

 

Step 2: Enable new Certificate on server

  • On the Start menu, Click Administrative tool-> Internet Information Services (IIS) Manager.
  • In the IIS Manager, Click the server name.
  • Expand site folders.
  • Select the ManagementStudio site.
  • On the Actions panel on the right, click Bindings.
  • In the Site Bindings window, click the site’s Hostname, then click Add. (or Edit if you are updating a certificate binding).
  • Fill out information in the Add site binding window. In the dropdown choose:
  • Https
  • IP address to the IP address of the site or choose all unassigned
  • The port for SSL traffic is usually 443
  • The Host name
  • Enter the recently imported certificate in the SSL Certificate field
  • Click OK.
  • Click Close to close the site Bindings dialog box.
  • The SSL certificate is now installed and the website configured to accept secure connections.
  • In the Actions panel on the right, click Restart to complete the installation process.


Graphical user interface, application

Description automatically generated

 

 

Step 3: Configure and Test ManagementStudio

  • Browse to [IIS Website folder] and open Appsettings.json file using a text editor such as Notepad.
  • Amend the "LocalSiteUrl": "http://MS.ServerName.Com", to the new Https Url. E.g Https://Server1:443.
  • Save the file.
  • Open IIS Manager.
  • Expand the Sites node.
  • Select ManagementStudio website.
  • Click Browse Website link. In the web browser append “/0” to the end of the url (e.g Https://IIS Website folder/0) and press return. This should display the following page.

 

Graphical user interface, application

Description automatically generated

  • This will confirm that the change is working.
  • Launch ManagementStudio.
  • Login using your credentials and the new Url.
  • Once logged on, switch to Administration > Global Settings.
  • Select Site and Email config and amend the Url within the Public Url to the new Url.
  • Click Save Changes.
  • Restart ManagementStudio and login.



Further Support

If you require further support, please visit ManagementStudio's Service Desk at https://support.migrationstudio.com/ to search the knowledge base or create a new support ticket.