Setup miniOrange Access Gateway

A step-by-step guide to installing and configuring miniOrange Access Gateway (MAG) for secure access and authentication.

System Requirements

miniOrange access Gateway server has the following system requirements.

Operating System: Linux or Windows operating system that runs minimum Java 11
CPU Core: 4 Core
RAM: 16GB and above
HDD: 20GB or above
JAVA Environment: jdk11
Server Access Policies: Port 80 (HTTP Port), Port 443 (HTTPS PORT), Port 8181 for MAG dashboard
Database: MongoDB

Install miniOrange Access Gateway

Follow the steps to deploy the miniOrange Access gateway server on your operating system:

Windows Installer
Linux Installer

Pre-Requisites

miniOrange Access Gateway - [Link to download]
Java 11 [Link to download]
MongoDB [Link to download]

Download Required Files:

Set Environment variable for mongodb.
MONGOSH : C:\Program Files\MongoDB\mongosh-2.0.1-win32-x64\bin
Double-click to run the downloaded installer (exe) file.
If your MongoDB path is correctly set, Click Ok.

Click Install

After successful Installation, Click ok.

After installation, you will be directly redirected to below.

Pre-Requisites

miniOrange Access Gateway- [Link to download.]
Java 11 [Link to download]
MongoDB [Link to download]

Download Required Files:

Check MongoDB is installed and in active status.

Run the downloaded installer (sh) file using the command below.

Follow the Step-by-Step Guide given below for Miniorange Access Gateway Setup

1. Sign up with miniOrange Access Gateway

Click here to log into your miniOrange account.

(Don’t have an account? No worries! Click here to create one.)

Open your browser and go to: http://localhost:8181/login
This will take you to the MAG login page.

Enter your credentials just as you would with your miniOrange cloud account.
Click on the Login button.
After successful authentication, you will see the dashboard.

2. Configure Upstream Servers

Upstream servers are your applications where you would like miniOrange Access Gateway to connect and perform Load Balancing, SSO, or MFA.

Click the ADD UPSTREAM button.

Now, Click on Add Upstream Server Group.

Enter the Group Name.
Click on Add Server to add the application's IP address to your upstream group.

Under the Scheme field, select the appropriate scheme from the dropdown.
Provide the Host and IP of the custom application.

To configure multiple Upstream servers, click Add Server again and enter details such as the scheme, IP, and port.

Enable the Load Balancing toggle and select the desired algorithm from the Policy Name dropdown.

Click Save.

3. Add Authentication

miniOrange Access Gateway provides SAML Authentication to configure SSO for your application through miniOrange Identity Provider.

On the left sidebar, select Authentication Providers and then click the Add Authentication Provider button.
Click on Add authentication provider button.

Now click on SAML Authentication.

Enter the Identity provider name and click Save.

4. Add Application

Navigate to Apps on the left sidebar and click on the Add Application button.

Select the Custom App Application.

Enter the details according to the table below:

Application Name	Any identifier for your Application
Application Type	Select the purpose for the app creation (Proxy, Header based, etc)
Hostname	The URL through which your users will access the application.
Port	80
Force Redirect	Enable this if you want to auto-redirect.
Redirect To	Enter the path you want to redirect when accessing only the specified host.

Click on next.
Under Advanced Options, enable SSL if required for secure access.

Now enter the SSL Port.

Select and upload the SSL certificate. We support three types of certificates.

Click on next.
Review the default routes.

Select the upstream group from the dropdown.

Choose the Interceptors and Authentication ID from the dropdown.

Click on Save.

Download the SP Metadata from the configured application and upload it to miniOrange .Please refer to this guide on setting up SAML Apps on miniOrange.