Skip to content

Commit 95de282

Browse files
committed
user-guide: reword notes about creds and toekn sharing safety in gdrive guide
per #926 (review)
1 parent 1835aa5 commit 95de282

File tree

1 file changed

+12
-11
lines changed

1 file changed

+12
-11
lines changed

public/static/docs/user-guide/setup-google-drive-remote.md

Lines changed: 12 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,10 @@ Drive API connections, and its
4040
6. The newly generated **client ID** and **client secret** should be shown to
4141
you now, and you can always come back to **Credentials** to fetch them.
4242

43-
⚠️ It's safe to share **client ID** and **client secret** among your team. These
44-
credentials are used to
45-
[authorize](https://developers.google.com/drive/api/v2/about-auth) DVC to use
46-
your Google Drive.
43+
⚠️ It should be safe to share **client ID** and **client secret** among your
44+
team. These credentials are only used to generate the
45+
[authorization](#authorization) DVC will later need in order to connect to the
46+
Google Drive.
4747

4848
> Note that Google Drive API has usage limits/quotas per credentials in a
4949
> _project_ (which you can review in the
@@ -103,12 +103,13 @@ $ dvc remote modify mygdfolder gdrive_client_secret <client secret>
103103

104104
On the first usage of a GDrive [DVC remote](/doc/command-reference/remote),
105105
you'll be prompted to visit a web page to generate an access token, which will
106-
require you to sign into the corresponding Google account. The sign-in process
107-
will guide you through granting the necessary access permissions. On success,
108-
the token data will be cached in a Git-ignored directory located in
106+
require you to sign into the corresponding Google account. The
107+
[sign-in process](https://developers.google.com/drive/api/v2/about-auth) will
108+
guide you through granting the necessary access permissions. On success, the
109+
token data will be cached in a Git-ignored directory located in
109110
`.dvc/tmp/gdrive-user-credentials.json`.
110111

111-
⚠️ In order to prevent unauthenticated access to your Google Drive, do not share
112-
access token data with others. Each team member should have
113-
[separate access](https://support.google.com/drive/answer/7166529) to Google
114-
Drive, and generate their own token.
112+
⚠️ In order to prevent unauthenticated access to your Google Drive, **do not
113+
share access token data with others**. Each team member should have [separate
114+
access](https://support.google.com/drive/answer/7166529) to the appropriate
115+
Google Drive resources, and generate their own tokens.

0 commit comments

Comments
 (0)