Concept

The Handyman system provides a user-friendly web portal for customers. This portal allows customers to easily list, track, and create orders.

The portal has the ability to display assets and link orders and documents together.

Handyman can enable the portal for specific customers.

For more information on how the portal functions, please refer to the Connect quick start article here.

Architecture

Components

Identity Server (IDM)

The Identity Server manages user accounts and secures access to the Handyman API. It handles authentication for Handyman-related web applications and is compatible with Oauth 2.0.

Identity Server Web

This web application provides a user interface for actions such as login, logout, password creation and change, and account activation.

Connect Portal

The main web application that extends the functionality of the Handyman system for customers.

Handyman Office Application

A desktop application for Handyman system users to manage Connect access and create Connect administrators.

Handyman Office Database

A database that stores all Handyman data, including customer-related data and Connect-related users and permissions.

Handyman API

An API that exposes the data from the Handyman database for the Connect portal.

User handling

Users of the new Connect portal are stored in GSGroup's new identity provider server (IDM)'s user database. Access to the portal requires a GSGroup account.

The existing Handyman Web application's user handling capabilities are expanded to create GSGroup accounts and store the association between these accounts and the Handyman database.

The new Connect portal will retrieve Handyman data using Handyman's new REST API. The authentication mechanism of Handyman API will be expanded to include the GSGroup Identity server as an identity provider. This will allow Handyman API to access all user claims associated with a GSGroup Identity and implement proper access control at the API level. The existing Handyman WEB logic will not be involved in the data access process.

Connect Infrastructure

Cloud setup

Here is a simplified diagram of the Gsgroup cloud-based infrastructure and how servers are connected to Handyman systems.

On-premise solution