ECommerce Site Integration

Introduction:

This documentation provides a step-by-step guide for integrating the Skill-mine Admin Portal's Authentication and user flow with the existing e-commerce site. The integration involves creating client details in the Skill-mine Admin Portal, setting up the authentication flow, mapping the client details, and handling user details and authentication tokens on the e-commerce site.

Table of Contents:

1. Overview

   • 1.1 Purpose

   • 1.2 Scope

2. Integration Steps

   • 2.1 Creating Client Details in Skillmine Admin Portal

   • 2.2 Setting Up Authentication Flow

   • 2.3 Mapping Client Details with E-commerce Site

   • 2.4 Handling Authentication and User Details

3. Conclusion

1. Overview:

1.1 Purpose: The purpose of this documentation is to guide the integration process between the Skillmine Admin Portal's authentication system and the e-commerce site. By following these steps, users can use their Skillmine credentials to access the e-commerce site, and user details can be utilized for a personalized shopping experience.

1.2 Scope: This documentation covers the integration process from creating client details in the Skillmine Admin Portal to handling user authentication tokens and user details on the e-commerce site.

2. Integration Steps:

2.1 Creating Client Details in Skillmine Admin Portal:

• Access the Skillmine Admin Portal and log in with admin credentials.

• Navigate to the client management section and create a new client for the e-commerce site.

• Record the client details, including the client ID and client secret, as they will be needed for the integration.

Refer:

Client Settings

2.2 Setting Up Authentication Flow:

• In the Skillmine Admin Portal, configure the authentication flow for the e-commerce site.

• Define the redirect URLs for login and registration.

• Set up the required scopes for the e-commerce site's access to user details.

Refer:

Blueprints

2.3 Mapping Client Details with E-commerce Site:

• On the e-commerce site's back-end, implement the necessary APIs to communicate with the Skillmine Admin Portal.

• Store the client ID and client secret securely in the e-commerce site's configuration.

2.4 Handling Authentication and User Details:

• On the e-commerce site's front-end, implement the "Sign In" and "Sign Up" buttons to initiate authentication.

• When a user clicks on "Sign In," call the login authorization (Authz) URL provided by the Skillmine Admin Portal. Redirect the user to the Skillmine login page for authentication.

• When a user clicks on "Sign Up," call the register Authz URL to redirect the user to the Skillmine registration page.

Refer: To get an Authz Url

https://app.gitbook.com/o/WmU7K1Ap0jU5CUI6kbtJ/s/NHJr75kSc6HL16U7k3F6/flow-settings#flow-overview

• Upon successful registration or login, the Skillmine authentication will redirect the user back to the e-commerce site's specified redirect URL, providing an authentication token.

• Implement a handle/token URL on the e-commerce site's back-end to handle the authentication token securely.

• Retrieve the user details from the Skillmine Admin Portal using the token and store them securely on the e-commerce site's server.

• Use the retrieved user details to personalize the user's shopping experience on the e-commerce site.

3. Conclusion:

By completing the integration steps outlined in this documentation, the e-commerce site will be successfully connected to the Skillmine Admin Portal's authentication system. Users will be able to register, login, and access the e-commerce site using their Skillmine credentials. The e-commerce site can also use the token provided by Skillmine to retrieve user details and personalize the user experience. Ensure that all sensitive data is handled securely to maintain the privacy and security of user information.