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

Clarify Accounts vs. Forge, password vs. token

Browse source 
Fixes: https://codeberg.org/fedora/forgejo-deployment/issues/209

Signed-off-by: Nils Philippsen <nils@redhat.com>
This commit is contained in:
Nils Philippsen 2025-10-10 13:18:04 +02:00
commit c063e7a0b8
1 changed files with 12 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -25,8 +25,9 @@ Before you begin, ensure you have the following:
* *Git Installed:* You must have Git installed on your local machine.
* *Fedora Forge Account:* An active user account on the Fedora Forge instance,
authenticated via Fedora Accounts (OpenIDC).
* *Fedora Forge Account:* An active user account on the Fedora Forge instance.
If you have note done so yet, log into Fedora Forge once, authenticating via
OpenIDC on Fedora Accounts, to establish your user account on Fedora Forge.
* *Access Token:* For secure and convenient authentication, it is highly
recommended to generate and use a Access Token instead of relying on your
@ -66,12 +67,14 @@ git clone https://forge.fedoraproject.org/<org>/<repo_name>.git
. When you try to push changes back to this repository, you will prompted for a
username and password:
+
* *Username:* Enter your Fedora Forge username (the same one you use to log in
* *Username:* Enter your Fedora Accounts username (the same one you use to log in
to the web interface).
+
* *Password:* *Instead of your Fedora Account password (which is not used for
Git authentication), enter your Access Token.*
* *Password:* Enter your Fedora Forge Access Token.
+
CAUTION: This is not the same as your Fedora Account password (which is not used for
Git authentication).
----
Username for 'https://forge.fedoraproject.org': your_username
Password for 'https://your_username@forge.fedoraproject.org': <paste_your_access_token_here>
@ -97,8 +100,10 @@ Access Token. Git will then store it in a plain-text file
== Generating a Access Token in Fedora Forge
Using a Access Token is the recommended way to authenticate with Git over
HTTPS. *Remember, you will use your Access Token for Git authentication, not
your Fedora Account password.*
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.