Improve Credentials page with platform-specific integration user guidance#777
Improve Credentials page with platform-specific integration user guidance#777hunterachieng wants to merge 4 commits into
Conversation
Signed-off-by: Hunter Achieng <achienghunter@gmail.com>
Signed-off-by: Hunter Achieng <achienghunter@gmail.com>
| ## Authentication | ||
|
|
||
| Google Drive uses OAuth 2.0 access tokens for API authentication: | ||
| Google Drive supports two credential types in OpenFn: **OAuth2** and a raw **access token**. |
There was a problem hiding this comment.
@hunterachieng this not accurate, the raw access token is the OAuth 2.0 access token, Please revert this back to
Google Drive uses OAuth 2.0 access tokens for API authentication:
There was a problem hiding this comment.
@mtuchi I checked how we can add credentials for Google Drive and it uses both OAuth and you can add a raw access token on the creds page
There was a problem hiding this comment.
@hunterachieng yes it's true you can add raw credential with any adaptor not only googlesheet, Are you saying it's possible to create a long lived access token from google cloud console ?
There was a problem hiding this comment.
No, the token only lives for 1 hour. Should I change and only focus on Oauth2?
There was a problem hiding this comment.
@hunterachieng Yes, i think the way it was before is fine, we can add a foot note saying If you need to test the adaptor locally you, you can generate a 1hour token using gcloud cli
mtuchi
left a comment
There was a problem hiding this comment.
Hey @hunterachieng i left some comments in googledrive adaptor can you work on those and see if also you the other adaptor need the same changes
Signed-off-by: Hunter Achieng <achienghunter@gmail.com>
Signed-off-by: Hunter Achieng <achienghunter@gmail.com>
Short Description
Improved the Credentials page and Google Sheets/Drive adaptor docs with platform-specific integration user guidance, service account recommendations, and updated credential screenshots.
Closes #142
Details
Adds platform-specific integration user guidance to the Credentials page and relevant Google adaptor pages. The Credentials page now links out to Salesforce and Google Sheets for platform-specific advice rather than duplicating content.
The Google Sheets and Google Drive adaptor pages each gain a "Using a Google Service Account" section covering least-privilege scope recommendations and resource sharing, plus updated screenshots for both OAuth and access token credential types.
AI Usage
Please disclose how you've used AI in this work (it's cool, we just want to
know!):
You can read more details in our
Responsible AI Policy