Are you frustrated with the “authentication failed” error on git while trying to connect to a SquareSpace site in Developer Mode?
I know how you feel: I was pulling my hair out over this same problem a few short weeks ago. It was particularly annoying because I had connected successfully in the past, and I was using the very same credentials that worked back then.
Fortunately for you, I discovered the fix, and it’s pretty darn simple. Ready to get back to work?
The secret to getting SquareSpace’s git working again after an authentication failed error
Start your timer: you should be able to follow these steps and get successfully connected in a couple of minutes! ?
1. Generate a SquareSpace app password for git.
- From your SquareSpace account dashboard, hover over your initials in the top righthand corner of the page. In the menu that appears, click on Account & Security.
- In the Account & Security modal window, click “App Passwords”.
- Click the “Generate Password” link
- A new window will pop up asking you to verify your account password. Enter it and click Continue.
- Choose a label for your new password (I called mine “git”). Click Continue.
- Your new app password appears on the screen. Make sure you save a copy of it now; you will not be able to access it again later!
2. Attempt to connect to SquareSpace’s git server again, but this time, use your newly generated app password instead of your SquareSpace account password.
Wondering why the “sudden” change in the ability to authenticate?
Have you recently turned on two-factor authentication for your SquareSpace account? The need for an app password is related to 2FA. Git (ie: the binary itself) isn’t set up to work with normal two-factor authentication—where you enter a one-time passcode to verify your identity—so generating an app password that bypasses this step is necessary.
Did this fix your git authentication problem? Let me know in the comments!