[PATCH] doc: gitcredentials: introduce OAuth helpers

From: M Hickford via GitGitGadget <gitgitgadget@gmail.com>
Date: May 28, 2023, 19:45 UTC
Message-ID: <pull.1538.git.1685303127237.gitgitgadget@gmail.com>

From: M Hickford <mirth.hickford@gmail.com>

OAuth credential helpers are widely useful but work differently to other credential helpers, so worth introducing in the docs.

Link to relevant projects.

Signed-off-by: M Hickford <mirth.hickford@gmail.com>
---
    gitcredentials: describe OAuth credential helpers
    
    See also discussion
    https://lore.kernel.org/git/CAGJzqskaM80+8+79yUf435tP93Sk8sFu7marCvyimE=2gOKnog@mail.gmail.com/

Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-1538%2Fhickford%2Fhelpers-v1
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-1538/hickford/helpers-v1
Pull-Request: https://github.com/gitgitgadget/git/pull/1538

 Documentation/gitcredentials.txt | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/Documentation/gitcredentials.txt b/Documentation/gitcredentials.txt
index 100f045bb1a..d2a7249d52b 100644
--- a/Documentation/gitcredentials.txt
+++ b/Documentation/gitcredentials.txt
@@ -105,6 +105,19 @@ $ git config --global credential.helper foo
 -------------------------------------------
 
 
+=== OAuth credential helpers
+
+An alternative to entering passwords or personal access tokens is to use an
+OAuth credential helper. Many popular Git hosts support OAuth. The first time
+you authenticate, the helper opens a browser window to the host.
+Subsequent authentication is non interactive.
+
+Two cross-platform open-source OAuth credential helpers are:
+
+* https://github.com/git-ecosystem/git-credential-manager[Git Credential Manager]
+* https://github.com/hickford/git-credential-oauth[git-credential-oauth]
+
+
 CREDENTIAL CONTEXTS
 -------------------
 

base-commit: 79bdd48716a4c455bdc8ffd91d57a18d5cd55baa

-- 
gitgitgadget