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

What is 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.

What is identity Server Web?

This web application provides a user interface for logging in and out, creating and changing passwords, and activating accounts.

What is Handyman Portal?

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

What is handyman Office Application?

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

What is handyman Office Database?

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

What is the 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 GSG Handyman's new identity provider server (IDM)'s user database. Access to the portal requires a GSG Handyman account.

The existing Handyman Web application's user-handling capabilities are expanded to create GSG Handyman 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 GSG Handyman Identity server as an identity provider. This will allow Handyman API to access all user claims associated with a GSG Handyman Identity and implement proper access control at the API level. The existing Handyman WEB logic will not be involved in the data access.

What is 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