t0xic0der/forge-documentation
1
0
Fork 0
forked from forge/documentation
Code Pull requests Activity

http-auth: make access token instructions chronological

Browse source 
You need an access token before you can clone/push to the repository, so
it makes more sense for that section to be first
This commit is contained in:
Maxwell G 2025-12-09 18:44:50 -06:00 • committed by Akashdeep Dhar
commit e8ab12fb9b
1 changed files with 24 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

48
modules/ROOT/pages/using_http_auth.adoc
View file

@ -34,6 +34,30 @@ Before you begin, ensure you have the following:
Fedora Account credentials directly for Git operations. See the section
below on "Generating an Access Token."
== Generating an Access Token in Fedora Forge
Using an Access Token is the recommended way to authenticate with Git over
HTTPS.
CAUTION: Remember, you will use your Access Token for Git authentication, not
your Fedora Account password.
. Go to `https://forge.fedoraproject.org/` and log in using your Fedora Account.
. Click on your *profile picture/icon* in the top-right corner.
. Select *"Settings"* from the dropdown menu.
. In the left-hand navigation sidebar, click on *"Applications"*.
. Under the "Access Tokens" section, click the *"Generate Token"* button.
. *Token Name:* Give your token a descriptive name (e.g., `my-laptop-git`).
. *Token Permissions:* Select the permissions you want to grant to this
token. For general cloning and pushing, you will typically just need: Read
and Write on Repository.
. Click the *"Generate Token"* button.
. Your new Access Token will be displayed. *Copy this token immediately and store it securely.* You will not be able to see it again once you leave this page. Treat it like a password.
== Procedure: Cloning a Repository via HTTPS
Follow these steps to clone a repository using HTTPS:
@ -134,30 +158,6 @@ For more information about Git credential helpers and other available options,
see the official Git documentation: https://git-scm.com/docs/gitcredentials
====
== Generating an Access Token in Fedora Forge
Using an Access Token is the recommended way to authenticate with Git over
HTTPS.
CAUTION: Remember, you will use your Access Token for Git authentication, not
your Fedora Account password.
. Go to `https://forge.fedoraproject.org/` and log in using your Fedora Account.
. Click on your *profile picture/icon* in the top-right corner.
. Select *"Settings"* from the dropdown menu.
. In the left-hand navigation sidebar, click on *"Applications"*.
. Under the "Access Tokens" section, click the *"Generate Token"* button.
. *Token Name:* Give your token a descriptive name (e.g., `my-laptop-git`).
. *Token Permissions:* Select the permissions you want to grant to this
token. For general cloning and pushing, you will typically just need: Read
and Write on Repository.
. Click the *"Generate Token"* button.
. Your new Access Token will be displayed. *Copy this token immediately and store it securely.* You will not be able to see it again once you leave this page. Treat it like a password.
== Troubleshooting and Tips
* *"Authentication failed" error:*