model_driven_api 3.4.0 → 3.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ecd0e3a3b7a279fb9a68b6ac3fe513ada2aa9875807cc672fa5a8f4d690fb1d
-  data.tar.gz: 926640daa632265835dc91e24d4062ed3678c91972aa5d6de53c2c8939511c4d
+  metadata.gz: cc68530c0b5f4519866a975cea9ea23207cec6dc83aad73cd6a61da041760fee
+  data.tar.gz: 5789f8c2a515b3385a6c53da9392fbc21fdb599aa247a9968b5a8a2f6b03f326
 SHA512:
-  metadata.gz: aa235f9c25f6abcb48d724f68f9a726bf38c1dd90bd7aab6c292fdf78ecab4df142f806337b6782595ba19484481d230020880e2376ed44f62d207f736026acd
-  data.tar.gz: 984146f876ba9b9267855f9099a316641efbd65131191e680e933ccbeb013d3bac51ec287c41e9a886a815f312866f579fcf0a8d3cb795e7b1b6538960b5e058
+  metadata.gz: b58dc845ec1c3d228228e4f0527d8dcb0c82ebe9bf92cd1df86615cd9137a4c93539b076d1c8bb673feb8b6bc68daa7e4b332357995aabc11bb4c297b17dd372
+  data.tar.gz: cbbabc3bb858b9d83d10bc01617f147c1cb9402a6ce65db269b9a41639ea8fedb16ccaed7f5c86dbde3c7a7c98c19f50d552804f6538d0dd33aa3b96a77cf38b

data/README.md

@@ -1 +1,66 @@
 This is part of Thecore framework: https://github.com/gabrieletassoni/thecore/tree/release/3
+
+## Authorization
+
+It's enabled to LDAP (Active Directory and othe LDAP Based local service) and to oauth2 (Google Workspace and Microsoft Entra ID) services.
+
+### 📘 Register OAuth Apps
+
+To use OAuth2 for authentication, you need to register your application with the OAuth provider (Google or Microsoft). Follow these steps, which are specific to each provider and aimed at a demo frontend application running on `http://localhost:5173`.
+ 
+#### ✅ Google OAuth Client Setup
+ 
+Go to: https://console.cloud.google.com/apis/credentials
+Create OAuth 2.0 Client ID
+Choose Web Application
+Add to “Authorized JavaScript Origins”:
+http://localhost:5173
+Add to “Authorized redirect URIs” (used by Google, not backend):
+http://localhost:5173 (for frontend access only)
+Save your Client ID
+ 
+ 
+#### ✅ Microsoft Entra ID OAuth Setup
+ 
+Go to https://portal.azure.com
+Microsoft Entra ID → App registrations → New registration
+Set redirect URI to http://localhost:5173 (type: SPA)
+Note the:
+Application (client) ID
+Directory (tenant) ID
+Under Authentication tab:
+Add platform: “Single-page application”
+Add http://localhost:5173 to Redirect URIs
+
+### Save your Client ID and Tenant ID
+You will need these IDs to configure the backend.
+
+### 📘 Configure OAuth in Thecore
+To configure OAuth in Thecore backend, you need to set the following environment variables in your `.env` file or `environmet:` configuration in docker-compose.yml:
+
+```plaintext
+# OAuth Configuration
+# Microsoft OAuth
+ENTRA_CLIENT_ID: "your-client-id"
+ENTRA_CLIENT_SECRET: "your-client-secret"
+ENTRA_TENANT_ID: "your-tenant-id"
+
+# Google OAuth
+GOOGLE_CLIENT_ID: "your-client-id.apps.googleusercontent.com"
+GOOGLE_CLIENT_SECRET: "your-client-secret"
+```
+
+In the Frontend applciation, you will need to set the following environment variables in your `.env` file:
+
+```plaintext
+# OAuth Configuration
+# Google OAuth
+VITE_GOOGLE_CLIENT_ID=your-client-id
+
+# Microsoft OAuth
+VITE_AZURE_CLIENT_ID=your-client-id
+VITE_AZURE_TENANT_ID=your-tenant-id
+
+# OAuth Callback URLs
+VITE_API_URL=http://yourdomain/api/v2/auth/google_oauth2/callback
+```

data/app/controllers/api/v2/auth/oauth_controller.rb

@@ -0,0 +1,71 @@
+module Api::V2::Auth
+  class OauthController < ActionController::API
+    def callback
+      email = params['email']
+
+      user = User.find_or_create_by(email: email) do |u|
+        u.name = params['given_name']
+        u.surname = params['family_name']
+        u.password = u.password_confirmation = ThecoreAuthCommons.generate_secure_password
+        u.auth_source = params['provider'] # 'google' or 'microsoft'
+        u.admin = true
+      end
+      unless user
+        render json: { error: "User not registered" }, status: :unauthorized
+        return
+      end
+
+      token = JsonWebToken.encode(user_id: user.id)
+
+      if ENV["ALLOW_MULTISESSIONS"] == "false"
+        UsedToken.where(user_id: user.id).update_all(is_valid: false)
+        UsedToken.create!(token: token, user_id: user.id)
+      end
+
+      # redirect_url = "#{ENV['FRONTEND_URL']}?token=#{token}"
+      # redirect_to redirect_url
+      response.set_header("Token", JsonWebToken.encode(user_id: user.id))
+      render json: user, status: :ok
+    end
+
+    def failure
+      render json: { error: "OAuth authentication failed" }, status: :unauthorized
+    end
+
+    def exchange_token
+      provider_token = params[:provider_token]
+      provider = params[:provider] # 'google' or 'microsoft'
+
+      user_info = case provider
+      when 'google'
+        uri = URI("https://www.googleapis.com/oauth2/v3/userinfo")
+        res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+          req = Net::HTTP::Get.new(uri)
+          req["Authorization"] = "Bearer #{provider_token}"
+          http.request(req)
+        end
+        JSON.parse(res.body)
+      when 'microsoft'
+        uri = URI("https://graph.microsoft.com/v1.0/me")
+        res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+          req = Net::HTTP::Get.new(uri)
+          req["Authorization"] = "Bearer #{provider_token}"
+          http.request(req)
+        end
+        JSON.parse(res.body)
+      else
+        return render json: { error: "Unknown provider" }, status: :unprocessable_entity
+      end
+
+      email = user_info["mail"] || user_info["email"] || user_info["userPrincipalName"]
+      user = User.find_by(email: email)
+
+      if user.nil?
+        return render json: { error: "User not registered" }, status: :unauthorized
+      end
+
+      response.set_header("Token", JsonWebToken.encode(user_id: user.id))
+      render json: user, status: :ok
+    end
+  end
+end

data/config/initializers/omniauth.rb

@@ -0,0 +1,20 @@
+Rails.application.config.middleware.use OmniAuth::Builder do
+  provider(
+    :entra_id,
+    {
+      client_id: ENV['ENTRA_CLIENT_ID'],
+      client_secret: ENV['ENTRA_CLIENT_SECRET'],
+      tenant_id: ENV['ENTRA_TENANT_ID'], # Needed for Microsoft
+      scope: 'User.Read',
+      response_type: 'code'
+    }
+  )
+  provider :google_oauth2, ENV['GOOGLE_CLIENT_ID'], ENV['GOOGLE_CLIENT_SECRET'], {
+    scope: 'email,profile',
+    prompt: 'select_account',
+    access_type: 'online'
+  }
+end
+
+OmniAuth.config.allowed_request_methods = [:get, :post]
+OmniAuth.config.silence_get_warning = true

data/config/routes.rb

@@ -1,11 +1,26 @@
 # require 'ransack'
 
 Rails.application.routes.draw do
-    # REST API (Stateless)
-
+    oauth_test = (ENV['ENTRA_CLIENT_ID'].present? && ENV['ENTRA_CLIENT_SECRET'].present? && ENV['ENTRA_TENANT_ID'].present?) || (ENV['GOOGLE_CLIENT_ID'].present? && ENV['GOOGLE_CLIENT_SECRET'].present?)
     scope ENV.fetch("RAILS_RELATIVE_URL_ROOT", "/") do
+        if oauth_test
+            # OmniAuth callbacks need these top-level paths:
+            match '/auth/:provider/callback', to: redirect('/api/v2/auth/%{provider}/callback'), via: [:get, :post]
+            match '/auth/failure', to: redirect('/api/v2/auth/failure'), via: [:get, :post]
+        end
         namespace :api, constraints: { format: :json } do
             namespace :v2 do
+                # Authentication via Oauth2 only if the environment variable is set
+                if oauth_test
+                    namespace :auth do
+                        # Omniauth routes for OAuth2 authentication
+                        match ':provider/callback', to: 'oauth#callback', via: [:get, :post]
+                        get :failure, to: 'oauth#failure'
+                        get ':provider', to: redirect('/auth/%{provider}') # triggers OmniAuth middleware
+                        post :jwt, to: 'oauth#exchange_token' # Optional endpoint to allow frontends to send the OAuth token
+                    end
+                end
+
                 resources :users
 
                 namespace :info do

data/lib/model_driven_api/version.rb

@@ -1,3 +1,3 @@
 module ModelDrivenApi
-  VERSION = "3.4.0".freeze
+  VERSION = "3.4.2".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: model_driven_api
 version: !ruby/object:Gem::Version
-  version: 3.4.0
+  version: 3.4.2
 platform: ruby
 authors:
 - Gabriele Tassoni
@@ -121,6 +121,7 @@ files:
 - app/commands/authenticate_user.rb
 - app/commands/authorize_api_request.rb
 - app/controllers/api/v2/application_controller.rb
+- app/controllers/api/v2/auth/oauth_controller.rb
 - app/controllers/api/v2/authentication_controller.rb
 - app/controllers/api/v2/info_controller.rb
 - app/controllers/api/v2/raw_controller.rb
@@ -131,6 +132,7 @@ files:
 - config/initializers/after_initialize_for_model_driven_api.rb
 - config/initializers/cors_api_thecore.rb
 - config/initializers/knock.rb
+- config/initializers/omniauth.rb
 - config/initializers/time_with_zone.rb
 - config/initializers/wrap_parameters.rb
 - config/routes.rb