Concept

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

The portal can display assets and link orders and documents together.

Handyman can enable the portal for specific customers.

For more information on the portal's functions, please refer to the Handyman Portal 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 logging in and out, creating and changing passwords, and activating accounts.

Handyman 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 Portal access and create Portal administrators.

Handyman Office Database

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

Handyman API

An API that exposes the data from the Handyman database for the Handyman Portal.

User handling

The new Handyman Portal's users 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 Handyman 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.

Handyman Portal Infrastructure

Cloud setup

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

On-premise solution