Guide: Generating and Registering Google OAuth Refresh Token

[rlho]

Guide: Generating and Registering Google OAuth Refresh Token

This document outlines the process of generating a Google OAuth Refresh token and registering it as a GitHub Environment Secret for the booking-app project.

Prerequisites

• Appropriate permissions to modify GitHub Secrets
• A Google account with the email booking-app@itp.nyu.edu

Steps

1. Run the Script

1. Navigate to the booking-app/scripts directory( https://github.com/ITPNYU/booking-app/tree/main/booking-app/scripts
   ) in the repository on terminal

2. Run scripts for the required environment.

Upon execution, it will display a URL in the console.

2. Obtain the Refresh Token

1. Ensure you are logged in to the Google account associated with booking-app@itp.nyu.edu.

2. Copy the URL displayed by the script and paste it into your web browser.

3. You will be redirected to a Google authorization page. Click "Continue" to proceed.
   
   

4. After authorization, you will receive a Refresh token. Copy this token.
   

   Note: If you encounter any errors during this process, it may indicate issues with the Client ID or Client Secret in the script. Review the script configuration to ensure these are set correctly.

3. Update GitHub Secrets

1. Go to the GitHub repository settings for the booking-app project.
   

2. Navigate to the Secrets section.

3. Look for the GOOGLE_REFRESH_TOKEN secret.
   

4. Update the secret with the new Refresh token you obtained.

   Important: There are separate GOOGLE_REFRESH_TOKEN secrets for each environment (dev, stg, prod). Ensure you update the correct one corresponding to the environment used in the script.

4. Redeploy Google Action

1. Access the Google Actions console.

2. Find the Action deployed to the target environment (dev, stg, or prod).
   

3. Trigger a "Rerun script" operation for the Action to apply the changes.
   

Video

https://drive.google.com/file/d/1e8t9fNkA6YTAqqGzeZln538QZDO_a6Wg/view?usp=sharing