Re: [PATCH] Documentation: add instructions to help setup gmail 2FA

From: Junio C Hamano <gitster@pobox.com>
Date: May 27, 2016, 21:06 UTC
Message-ID: <xmqqpos7p5vy.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <1464381597-27634-1-git-send-email-rappazzo@gmail.com>

Michael Rappazzo <rappazzo@gmail.com> writes:

Show 5 quoted lines

> For those who use two-factor authentication with gmail, git-send-email
> will not work unless it is setup with an app-specific password. The
> example for setting up git-send-email for use with gmail will now
> include information on generating and storing the app-specific password.
> ---

Sounds good. We'd need your sign-off in order to be able to use this patch, though.

Show 26 quoted lines

>  Documentation/git-send-email.txt | 13 +++++++++++++
>  1 file changed, 13 insertions(+)
>
> diff --git a/Documentation/git-send-email.txt b/Documentation/git-send-email.txt
> index 771a7b5..edbba3a 100644
> --- a/Documentation/git-send-email.txt
> +++ b/Documentation/git-send-email.txt
> @@ -450,6 +450,19 @@ edit ~/.gitconfig to specify your account settings:
>  		smtpUser = yourname@gmail.com
>  		smtpServerPort = 587
>  
> +If you have multifactor authentication setup on your gmail acocunt, you will
> +need to generate an app-specific password for use with 'git send-email'. Visit
> +https://security.google.com/settings/security/apppasswords to setup an
> +app-specific password.  Once setup, you can store it with the credentials
> +helper:
> +
> +	$ git credential fill
> +	protocol=smtp
> +	host=smtp.gmail.com
> +	username=youname@gmail.com
> +	password=app-password
> +
> +
>  Once your commits are ready to be sent to the mailing list, run the
>  following commands: