OpenRIMS-RPM - Installation Part 2: Difference between revisions

Revision as of 18:14, 7 August 2023

OpenRIMS uses OATH2[1] to allow authenticate using Google login. For each deployment, the Google Authentication need to be configured separately.

The Google guide is available here for additional reference and detail:

Here are the steps to perform:

Use a Google account to access the Google Cloud Console
Create a Project unless you already have one
Access APIs & Services for that Project
Navigate to Credentials
Create Oauth Client ID
Choose Web Application
Add Authorized Redirection URI e.g. https://openrims.msh.org/login/oauth2/code/google
After clicking Create a Client Secret and a Client ID will be created. You need both for the below configuration of OpenRIMS.

After configuration it will be necessary to copy Client ID and Client secret to the application.properties

## OATH2

spring.security.oauth2.client.registration.google.client-id=client_id

spring.security.oauth2.client.registration.google.client-secret=client_secret

[1]

@@ Line 1: / Line 1: @@
-'''This Article is Work in Progress!'''
+== Google Authentication Explained ==
+OpenRIMS uses OATH2[1] to allow authenticate using Google login. For each deployment, the Google Authentication need to be configured separately.
+The Google guide is available here for additional reference and detail:
+https://developers.google.com/identity/sign-in/web/sign-in and https://developers.google.com/adwords/api/docs/guides/authentication
+Here are the steps to perform:
+# Use a Google account to access the Google Cloud Console
+# Create a Project unless you already have one
+# Access APIs & Services for that Project
+# Navigate to Credentials
+# Create Oauth Client ID
+# Choose Web Application
+# Add Authorized Redirection URI e.g. <code>https://openrims.msh.org/login/oauth2/code/google</code>
+# After clicking Create a Client Secret and a Client ID will be created. You need both for the below configuration of OpenRIMS.
+After configuration it will be necessary to copy Client ID and Client secret to the application.properties
+<code>## OATH2</code>
+<code>spring.security.oauth2.client.registration.google.client-id=client_id</code>
+<code>spring.security.oauth2.client.registration.google.client-secret=client_secret</code>
-== Google Authentication Explained ==
-# The Google Console
+[1]
-# Generating the Secret ID etc.