Skip to content
English
Sign in
Customer Portal
  • There are no suggestions because the search field is empty.

How do I set-up my deployment workstation for MFA-As-Code?

1. Deployment Workstation Setup - Install Visual Studio Code from Microsoft.
  1. Visual Studio Code download home page here.
  2. Visual Studio Code direct download link here.

2. Deployment Workstation Setup - Install Visual Studio Code Extensions From Microsoft.

To enhance your efficiency in installing and maintaining the SurePassID MFA-as-Code system, we recommend installing the following Visual Studio Code extensions. While not all of these extensions may be necessary for your specific setup, they can greatly assist you in streamlining the process. You can easily install these Microsoft extensions directly from within the Visual Studio Code environment. For more info on how to install these extensions see the following link: 
  • Azure Account - Sign-on and subscription management.
  • Azure Developer CLI - This extension makes it easier to create and run Azure Resources.
  • Azure Databases - Create, browse, and update globally distributed, multi-model database.
  • Azure App Service - An Azure App Service management extension for Visual Studio Code.
  • Azure Resources - An extension for viewing and managing Azure resources.
  • .NET Install Tool -This extension installs and manages different versions of the .NET SDK
  • Bicep - Download home page here.
3. Deployment Workstation Set-up - Install Azure Command Level Interface (CLI)
Download home page here.
 
4. Deployment Workstation Set-up - Install OpenSSL for Windows
To format certificates and upload them into the Azure Key Vault, the scripts utilize OpenSSL to merge intermediary certificates with the main certificate. You can use any version of OpenSSL for Windows, or you may choose to build it from the source code if preferred. It is advisable to verify with your team, as they may already have a suitable OpenSSL build available.
 
For convenience on Windows, we recommend downloading OpenSSL from the following website: Win32/Win64 OpenSSL Installer for Windows - Shining Light Productions (slproweb.com). We have consistently experienced reliable performance with the OpenSSL build from this source, but as with any third-party download, it is prudent to follow your organization’s security policies, such as performing a virus scan.
 
5. Deployment Workstation Set-up - Install Git 
 Git Bash is one of the tools included in the Git download. It is used to run the cloud shell scripts to build Azure Infrastructure. You will need to download it and add it as a terminal in in Visual Studio Code. Download home page here.   
 
6. Deployment Workstation Set-up - Add Git Bash Terminal to Visual Studio Code.
  1.    Verify git is installed by opening a command line prompt and typing git --version. 
  2.     Open Visual Studio Code and press and hold Ctrl + ` to open the terminal.
  3.     Open the command palette using Ctrl + Shift + P.
  4.     In the search box type Select Default Profile in the Command Palette and select      it from the dropdown menu.
  5.     Select Git Bash from the options.
  6. To verify, open a new terminal by pressing Ctrl + Shift + ~ (or Cmd + Shift + ~ on macOS). Git Bash should now open as the default terminal.
7. Deployment Workstation Set-up - Install Git Bash zip
When uploading the SurePassID application code, it is important to be aware that Azure SCM requires a specific zip format that is compatible with bzip2 compression. Although there are various zip file tools available, we highly recommend consulting with us for recommendations on the most suitable options to ensure a smooth upload process.
  1. Navigate to this sourceforge page: https://sourceforge.net/projects/gnuwin32/files/zip/3.0/
  2. Download zip-3.0-bin.zip
  3. In the zipped file, in the bin folder, find the file zip.exe.
  4. Extract the file zip.exe to your mingw64 bin folder (for me: C:\Program Files\Git\mingw64\bin)
  5. Navigate to this sourceforge page: https://sourceforge.net/projects/gnuwin32/files/bzip2/1.0.5/
  6. Download bzip2-1.0.5-bin.zip
  7. In the zipped file, in the bin folder, find the file bzip2.dll
  8. Extract bzip2.dll to your mingw64\bin folder (same folder as above: C:\Program Files\Git\mingw64\bin)
8. Deployment Workstation Set-up (optional) - Install json formatting tool.
  1. Run the git-bash shell as an administrator.
  2. Execute the following commands:
    1. mkdir -p "${HOME}/.local/bin"
    2. curl -L -o "${HOME}/.local/bin/jq.exe" \ https://github.com/stedolan/jq/releases/latest/download/jq-win64.exe

9. Download and Run the MFA-As-Code Installer - Run the .exe or .msi installer provided by SurePassID Technical Support. After installation, you will see a directory structure with two high-level folders:

  • App Services - Contains subfolders for each authentication server application available for installation.

  • Private Cloud - Contains subfolders for building and deploying the infrastructure, initializing the system, configuring the database, and deploying the application code.

10. Start the Mfa-As-Code Deployment - You will see a short-cut on the desktop for the MFA-As-Code System Initializer.

11. Start-up Visual Studio Code - Open the Private Cloud folder to begin building and deploying the infrastructure and system.