github-mirror/rclone
2
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2024-11-23 03:17:28 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

update drive.md

Browse Source 
* Updates OAuth consent screen instructions to include adding scopes for backup purposes (create, edit and delete files).
* Updates instructions to keep app in testing mode (appropriate for most users). The previous instructions suggested this, but we don't need to "publish" the app at all in order to proceed with this step.
This commit is contained in:
Simmon Li (he/him) 2023-01-25 23:47:46 -05:00 committed by Nick Craig-Wood
parent dc5d5de35c
commit 82e2801aae
1 changed files with 22 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
docs/content/drive.md
View File

@ -1508,9 +1508,15 @@ to the next step; if not, click on "CONFIGURE CONSENT SCREEN" button
(near the top right corner of the right panel), then select "External"
and click on "CREATE"; on the next screen, enter an "Application name"
("rclone" is OK); enter "User Support Email" (your own email is OK);
enter "Developer Contact Email" (your own email is OK); then click on "Save" (all other data is optional).
Click again on "Credentials" on the left panel to go back to the
"Credentials" screen.
enter "Developer Contact Email" (your own email is OK); then click on
"Save" (all other data is optional). You will also have to add some scopes,
including `.../auth/docs` and `.../auth/drive` in order to be able to edit,
create and delete files with RClone. You may also want to include the
`../auth/drive.metadata.readonly` scope. After adding scopes, click
"Save and continue" to add test users. Be sure to add your own account to
the test users. Once you've added yourself as a test user and saved the
changes, click again on "Credentials" on the left panel to go back to
the "Credentials" screen.
(PS: if you are a GSuite user, you could also select "Internal" instead
of "External" above, but this will restrict API use to Google Workspace
@ -1523,24 +1529,24 @@ then select "OAuth client ID".
8. It will show you a client ID and client secret. Make a note of these.
(If you selected "External" at Step 5 continue to "Publish App" in the Steps 9 and 10.
(If you selected "External" at Step 5 continue to Step 9.
If you chose "Internal" you don't need to publish and can skip straight to
Step 11.)
9. Go to "Oauth consent screen" and press "Publish App"
9. Go to "Oauth consent screen" and confirm that your intended email is shown
as a test user, and that "Publishing status" is shown as "Testing".
10. Click "OAuth consent screen", then click "PUBLISH APP" button and
confirm, or add your account under "Test users".
10. Provide the noted client ID and client secret to rclone.
11. Provide the noted client ID and client secret to rclone.
Be aware that, due to the "enhanced security" recently introduced by
Google, you are theoretically expected to "submit your app for verification"
and then wait a few weeks(!) for their response; in practice, you can go right
ahead and use the client ID and client secret with rclone, the only issue will
be a very scary confirmation screen shown when you connect via your browser
for rclone to be able to get its token-id (but as this only happens during
the remote configuration, it's not such a big deal).
Be aware that, due to the "enhanced security" introduced by Google, you are
theoretically expected to "submit your app for verification" and then wait a
few weeks(!) for their response; in practice, if you keep your app in testing,
then you can go right ahead and use the client ID and client secret with rclone,
the only issue will be a very scary confirmation screen shown when you connect
via your browser for rclone to be able to get its token-id (but as this only
happens during the remote configuration, it's not such a big deal). Because we
anticipate that we will be the only user on this client-id, testing should be
sufficient for most use cases.
(Thanks to @balazer on github for these instructions.)