1
0
mirror of synced 2025-12-21 02:46:50 -05:00
Files
docs/content/get-started/getting-started-with-git/updating-credentials-from-the-macos-keychain.md
Matt Cooper 443838d786 Update Git over HTTPS recommendations (#20281)
* add Mac bits

* add Linux bits

* add Windows bits

* recommend GCM Core in the update article

* tweaks after viewing the content

* remove 2FA link under GHAE since it doesn't exist

* remove extraneous brew step

* extract a reusable about "next time you clone"

* tips, notes, newlines

* https

* addressed feedback

* fix a link and spacing

* Apply suggestions from code review

* Apply suggestions from code review

* Copy edits to fit style guide

Co-authored-by: jmarlena <6732600+jmarlena@users.noreply.github.com>
Co-authored-by: Jessica Canepa <jmarlena@github.com>
2021-08-05 16:33:57 -07:00

2.5 KiB

title, intro, redirect_from, versions, shortTitle
title intro redirect_from versions shortTitle
Updating credentials from the macOS Keychain You'll need to update your saved credentials in the `git-credential-osxkeychain` helper if you change your{% ifversion not ghae %} username, password, or{% endif %} personal access token on {% data variables.product.product_name %}.
/articles/updating-credentials-from-the-osx-keychain
/github/using-git/updating-credentials-from-the-osx-keychain
/github/using-git/updating-credentials-from-the-macos-keychain
/github/getting-started-with-github/updating-credentials-from-the-macos-keychain
/github/getting-started-with-github/getting-started-with-git/updating-credentials-from-the-macos-keychain
fpt ghes ghae
* * *
macOS Keychain credentials

{% tip %}

Note: Updating credentials from the macOS Keychain only applies to users who manually configured a PAT using the osxkeychain helper that is built-in to macOS.

We recommend you either configure SSH or upgrade to the Git Credential Manager Core (GCM Core) instead. GCM Core can manage authentication on your behalf (no more manual PATs) including 2FA (two-factor auth).

{% endtip %}

{% data reusables.user_settings.password-authentication-deprecation %}

Updating your credentials via Keychain Access

  1. Click on the Spotlight icon (magnifying glass) on the right side of the menu bar. Type Keychain access then press the Enter key to launch the app. Spotlight Search bar
  2. In Keychain Access, search for {% data variables.command_line.backticks %}.
  3. Find the "internet password" entry for {% data variables.command_line.backticks %}.
  4. Edit or delete the entry accordingly.

Deleting your credentials via the command line

Through the command line, you can use the credential helper directly to erase the keychain entry.

$ git credential-osxkeychain erase
host={% data variables.command_line.codeblock %}
protocol=https
> <em>[Press Return]</em>

If it's successful, nothing will print out. To test that it works, try and clone a private repository from {% data variables.product.product_location %}. If you are prompted for a password, the keychain entry was deleted.

Further reading