Search

MachPanel Knowledgebase

INFO:CSP Module Configuration Guide for MachPanel Automation Solution

Mudesira Munir
MachPanel

Summary

This article provides a summary for CSP / Office 365 Configuration for MachPanel Control Server.

  • MachPanel Control Server Setup and Configuration.
  • Service Account Permissions and Other Configuration on Microsoft Partner Center and Microsoft Azure Portal.
  • Adding CSP Profile in MachPanel

Applies To

This article applies to MachPanel build version 6.2.10 and above.

References:

http://assetsprod.microsoft.com/csp-partner-application-overview.pdf
https://docs.microsoft.com/en-us/powershell/partnercenter/secure-app-model?view=partnercenterps-1.5

Overview

MachPanel's Microsoft CSP / Office 365 Module is the only management software that completely wipes out the complexities in Office 365 management by its unified approach. It allows you to significantly reduce your time to manage users, groups, contacts and manipulate plenty of settings via single interface. It is simple, fast and consolidated admin center that allows you to perform numerous action at a time without waiting for any previous one to be completed.

SECTION 1:  INSTALLING PRE-REQUISITES AND POWERSHELL MODULES

For MachPanel to interact with Microsoft CSP / Office 365, there are multiple PowerShell modules required to be installed on MachPanel control server. Apart from PowerShell modules installation, there are other configuration steps involved and host machine environment requirements to complete and these are as follows.

1 - Dot Net Framework 4.5

Microsoft Dot Net Framework 4.5 or above shall be installed on host machine (In most cases it will be already installed on control server)

2 - Set Execution Policy

Execution policy for Windows PowerShell needs to be set to ‘RemoteSigned’ so that remote commands can be executed in shell. To set execution policy, please open windows PowerShell and type below command and then press enter to execute

Set-ExecutionPolicy RemoteSigned

3 - Powershell Modules and their Configuration/Installation

  • Ensure there is no "Microsoft Azure Active Directory Module for Windows PowerShell" v1.1.166.0 or older, Uninstall this if it is installed.
  • Install PowerShell 5.1 if not installed.
    • To check your PowerShell version use command: $PSVersionTable.PSVersion
  • It should be like below or a latest build
     
  • To install: https://www.microsoft.com/en-us/download/details.aspx?id=54616

  • ​Install Module MSOnline using command: Open PowerShell as Administrator

    1. Run Command Get-PackageProvider
      1. See: NuGet, version should be: 2.8.5.208 or latest.
        1. If version is older then 2.8.5.208 run commands:
          1. [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;
          2. Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.208 -Force
        2. Once done, Close PowerShell and Re-open as Administator.
    2. Run commands:
      1. [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;
      2. Install-Module -Name MSOnline
      3. Install-Module -Name PartnerCenter
      4. Import-Module MSOnline
      5. Get-Module
        1. MsOnline version should be >= 1.1.183.17

4 - SharePoint Online Module for Office 365

On the MachPanel Control Server Machine, navigate to: C:\Program Files\MachSol\MachPanel Control Server\Apps\O365\Installers and use the file SharePointOnlineManagementShell_7414-1200_x64_en-us to install SharePoint Online Module for Office 365.

5 - MachPanel O365 Service Installation

To communicate with Microsoft Office 365 a windows service is built that will operate as a bridge between MachPanel and Microsoft Office 365. To install the service please locate “o365install.bat” file inside “C:\Program Files\MachSol\MachPanel Control Server\Apps\O365\Installers” directory.

RUN this file via Windows Shell with administrator privileges or simply right click and RUN AS ADMINISTRATOR.

Once the service is installed, open the services console in windows and locate service with name “MachPanel O365 Service” and make sure it is in Running state.

Note: o365install.bat file should be RUN AS ADMINISTRATOR.

6-SYSTEM REBOOT

Once above steps are completed, reboot the server. System reboot is mandatory step in configuration and must not be skipped.

SECTION 2:  ENABLE CSP MODULE IN MACHPANEL

To enable Microsoft CSP module in MachPanel Control Server, please navigate to Path: Home » System Configuration » Built-in Modules and select “Microsoft CSP” Checkbox as checked and press “Update Configuration” button. For detail see below screenshot of the interface:

 

Once CSP module is enabled, the next step is to add a CSP Profile.

Navigate to: Home » Service Director » Microsoft CSP » Microsoft CSP Profiles

Click on "Add CSP Profile" button.

 

 You will be asked to fill following details: 

SECTION 3:  COLLECTING DETAILS TO ADD CSP PROFILE

Summary of Steps to perform on Microsoft Azure Portal:
  • Go to:  https://portal.azure.com/ and login using your CSP Service Account, then navigate to "Azure Active Directory" >> "App Registrations".
  • Here, either use Existing Application or create "New Registration".
  • Add Redirect URI for your Web Application as: urn:ietf:wg:oauth:2.0:oob
  • Hit Register to register this application.