Skip to content

Open Source Framework for authentication and access management

License

Notifications You must be signed in to change notification settings

MetheaX/Methea-Framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Methea-Framework

Methea is a framework providing authentication and access management for your Spring Boot Application with minimum configuration, specifically for RESTful Webservice with JWE. No need to deal with users and permission stuffs.

Methea also provide UI Management Tool which is allows you to control & configure your system. (Under Developement)

Methea build on top of following frameworks:

  1. Spring Boot
  2. JWT
  3. JWE

Building from sources

Pre-requires

  • Java 17 or above JDK as JAVA_HOME
  • Maven as its build tool.
  • Keystore generator

How to build

  • Simply by checkout source code from our repository and using maven command mvn clean install to build framework.

Support with Spring Boot 3.1.0 and later version of Spring Boot.

Overview Structure

  • Account - refer to company or organization
  • Group - refer to department/team in organization
  • JWTConfig - use for config JWT properties, such as expire datetime
  • Permission - Bind with roles & resources
  • Public Permission - Public resources must map into this table
  • Resource - All endpoint in this systems
  • Role - User role
  • User - User information

Usages

I. Integration into webservice application

  1. Adding dependency to your spring boot application

    <dependency>
        <groupId>io.github.metheax</groupId>
        <artifactId>auth</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </dependency>
    
  2. Config datasource of your choice

    • Please note that currently, we're testing only with PostgreSQL
  3. Adding spring-boot components scan

      @SpringBootApplication(scanBasePackages = {"io.github.metheax", "your-reverse-domain"})
      @EnableJpaRepositories(basePackages = {"io.github.metheax", "your-reverse-domain"})
      @EntityScan(basePackages = {"io.github.metheax", "your-reverse-domain"})
      public class MetheaHostApplication {
         public static void main(String[] args) {
             SpringApplication.run(WebServiceApplication.class, args);
         }
      }`
    
  4. Load pre-define data into your database

    INSERT INTO public.core_account (account_id, created_date_time, created_user, status, updated_date_time, updated_user, account_address, account_code, account_email, account_name, account_name_oth) VALUES ('68bcf443-1b0c-49ff-877e-8650477383e8', '2021-06-13 10:57:36.711763', 'System', 'A', '2021-07-10 15:18:42.808053', 'admin', 'Phnom Penh, Cambodia.', 'METHEA', 'methea@localhost.com', 'Methea LLC.', 'មេធា');
    INSERT INTO public.core_group (group_id, created_date_time, created_user, status, updated_date_time, updated_user, group_code, group_name, group_name_oth, remarks, account_id) VALUES ('366a7028-b623-49b0-8988-d711647051a5', '2021-06-13 10:57:36.729797', 'System', 'A', '2021-06-13 10:57:36.729797', 'System', 'M_SYS_ADMIN', 'System Admin', 'អេតមីនប្រព័ន្ធ', null, '68bcf443-1b0c-49ff-877e-8650477383e8');
    INSERT INTO public.core_resource (resource_id, created_date_time, created_user, status, updated_date_time, updated_user, resource_name) VALUES ('ad5ea55c-547a-4537-8797-e3714c64d8a3', '2021-06-13 10:57:36.748761', 'System', 'A', '2021-06-13 10:57:36.748761', 'System', '/**');
    INSERT INTO public.core_role (role_id, created_date_time, created_user, status, updated_date_time, updated_user, role_code, name, name_oth) VALUES ('33525a14-0ebc-4a3e-ada5-bd3ef94c9495', '2021-06-13 10:57:36.742761', 'System', 'A', '2021-06-13 10:57:37.016415', 'System', 'ROLE_ADMIN', 'Admin', 'អេតមីន');
    INSERT INTO public.core_user (user_id, created_date_time, created_user, status, updated_date_time, updated_user, email, first_name, first_name_oth, frc_usr_rst_pwd, identity_code, last_name, last_name_oth, password, phone, username, group_id) VALUES ('c6eff227-d496-486c-a72c-db2f92e06faa', '2021-06-13 10:57:37.015455', 'System', 'A', '2021-06-13 10:57:37.015455', 'System', 'admin@localhost.com', 'Admin', 'អេតមីន', 'N', '639691', 'Admin', 'អេតមីន', 'Gp/lBVv1VTKk3DLGiENtX4Ow1xLEUqIDRBpa+zuTJWT3IIqfC4m0SB1tpVDo1+BQHFnY90XmvbJE1JAMDfRSmA$vkDevdjMM9v+/BonOi6HX/+v3Syh5mrSMXssz5707LSlOrCiIj3O7Q50bg7mLeCl6GYKhad7GGQi7CKvP1KqnbvtS2eZMFevVHsYHsQD2UeMQqiP7nAQ1z12ZHMNc5QckXZgUPMqetTzhJMzDduJ9+nOrC3HlqSo43VoMg0k+EA', '+85569639691', 'admin', '366a7028-b623-49b0-8988-d711647051a5');
    INSERT INTO public.core_user_roles (user_id, role_id) VALUES ('c6eff227-d496-486c-a72c-db2f92e06faa', '33525a14-0ebc-4a3e-ada5-bd3ef94c9495');
    INSERT INTO public.core_permission (permission_id, created_date_time, created_user, status, updated_date_time, updated_user, resource_id, role_id) VALUES ('bdee9930-cbde-4e62-96d8-91df821a698b', '2021-06-13 10:57:36.763762', 'System', 'A', '2021-06-13 10:57:36.763762', 'System', 'ad5ea55c-547a-4537-8797-e3714c64d8a3', '33525a14-0ebc-4a3e-ada5-bd3ef94c9495');
  5. Generate keystore for access token and refresh token

    • We recommend using KeyStore Explorer to generate key store
    • Place keystore under resources directory as resources/keystore
    • Use below configuration in your application.properties or application.yml
    keystore-token-file= classpath:keystore/test.pfx
    keystore-token-password= 12345
    keystore-token-alias= test
    keystore-key-token-password= 12345
    
    keystore-refresh-token-file= classpath:keystore/test.pfx
    keystore-refresh-token-password= 12345
    keystore-refresh-token-alias= test
    keystore-key-refresh-token-password= 12345
  6. Sample project

Support

If you encounter any issues regarding this project, please create a GitHub Issue. Email me kuylim.tith@outlook.com If you need special support or customize for your organization.