Maven Authentication Guide: Difference between revisions

From RetroMC
Jump to navigation Jump to search
(Created page with "__NOTOC__ = Adding GitHub Credentials to Maven = == Purpose == This guide is intended for '''RetroMC developers''' who need to configure their '''local development environments''' to access '''private RetroMC artifacts''' published via '''GitHub Packages'''. These credentials allow Maven to authenticate against GitHub in order to: * Download private RetroMC dependencies * Publish internal artifacts where required * Build and test RetroMC projects locally without authe...")
 
No edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:Server internals]] [[Category:Guides]] [[Category:Developing]]
__NOTOC__
__NOTOC__
= Adding GitHub Credentials to Maven =
= Adding GitHub Credentials to Maven =
Line 4: Line 5:
== Purpose ==
== Purpose ==


This guide is intended for '''RetroMC developers''' who need to configure their '''local development environments''' to access '''private RetroMC artifacts''' published via '''GitHub Packages'''.
This guide is intended for '''RetroMC developers''' who need to configure their '''local development environments''' to access '''private RetroMC artifacts''' published via '''our SonaType RetroMC mirror'''.


These credentials allow Maven to authenticate against GitHub in order to:
These credentials allow Maven to authenticate against GitHub in order to:
Line 14: Line 15:


== Prerequisites ==
== Prerequisites ==
* A GitHub account
* A RetroMC Sonatype developer account (Requested from JohnyMuffin)
* Access to the relevant GitHub organisation/repositories
* Access to the relevant GitHub organisation/repositories
* Maven installed locally
* Maven installed locally


== Step 1: Open GitHub Developer Settings ==
== Step 1: Add the SonaType credentials to Maven ==
 
# Log in to GitHub
# Click your profile picture (top-right)
# Go to '''Settings'''
# Navigate to '''Developer settings'''
# Select '''Personal access tokens'''
# Click '''Tokens (classic)'''
# Click '''Generate new token → Generate new token (classic)'''
 
[[File:Maven1.png|800px|center|Generate a new classic personal access token]]
 
== Step 2: Configure the Token ==
 
Fill in the following fields:
 
=== Token details ===
* '''Note:''' Use something descriptive, for example:
  * <code>Maven Main Computer</code>
* '''Expiration:'''
  * Choose a reasonable expiry date like one year (do not use ''No expiration'' under any circumstances)
 
=== Required scopes ===
Select only the scopes below:
 
* <code>repo</code> – Required for private repositories
* <code>write:packages</code>
* <code>read:packages</code>
 
Leave all other scopes unchecked unless explicitly required.
 
[[File:Maven2.png|800px|center|Selecting the required token scopes]]
 
Click '''Generate token''' once complete.
 
== Step 3: Copy the Token (Important) ==
 
GitHub will display the token '''once only'''.
 
'''⚠️ Copy it immediately and store it securely.'''
 
If you lose the token, it must be revoked and regenerated.
 
[[File:Maven3.png|800px|center|Copy the generated token]]
 
== Step 4: Add the Token to Maven ==


Open (or create) the following file:
Open (or create) the following file:
Line 83: Line 39:
     <servers>
     <servers>
         <server>
         <server>
             <id>github</id>
             <id>johnymuffin-nexus-retromc</id>
             <username>YOUR_GITHUB_USERNAME</username>
             <username>YOUR_SONATYPE_USERNAME</username>
             <password>PASTE_TOKEN_HERE</password>
             <password>YOUR_SONATYPE_PASSWORDE</password>
         </server>
         </server>
     </servers>
     </servers>
Line 96: Line 52:


Replace:
Replace:
* <code>YOUR_GITHUB_USERNAME</code> with your GitHub username
* <code>YOUR_SONATYPE_USERNAME</code> with your Legacy Minecraft Sonatype Nexus Repository username
* <code>PASTE_TOKEN_HERE</code> with the generated token
* <code>YOUR_SONATYPE_PASSWORDE</code> with the Legacy Minecraft Sonatype Nexus Repository token


[[File:Maven4.png|800px|center|Maven settings.xml configuration]]
[[File:Maven4.png|800px|center|Maven settings.xml configuration]]


== Step 5: Verify ==
== Step 2: Verify ==


You should now be able to:
You should now be able to:
* Deploy artifacts to GitHub Packages
* Deploy artifacts to Sonatype
* Download packages from private repositories
* Download packages from private repositories
* Run Maven builds without authentication errors
* Run Maven builds without authentication errors

Latest revision as of 02:26, 5 January 2026


Adding GitHub Credentials to Maven

Purpose

This guide is intended for RetroMC developers who need to configure their local development environments to access private RetroMC artifacts published via our SonaType RetroMC mirror.

These credentials allow Maven to authenticate against GitHub in order to:

  • Download private RetroMC dependencies
  • Publish internal artifacts where required
  • Build and test RetroMC projects locally without authentication errors

This setup is required for local development on projects that depend on private RetroMC packages.

Prerequisites

  • A RetroMC Sonatype developer account (Requested from JohnyMuffin)
  • Access to the relevant GitHub organisation/repositories
  • Maven installed locally

Step 1: Add the SonaType credentials to Maven

Open (or create) the following file:

~/.m2/settings.xml

On Windows, this is typically:

C:\Users\<your-username>\.m2\settings.xml

Add the following configuration: 

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">

    <servers>
        <server>
            <id>johnymuffin-nexus-retromc</id>
            <username>YOUR_SONATYPE_USERNAME</username>
            <password>YOUR_SONATYPE_PASSWORDE</password>
        </server>
    </servers>

</settings>



Replace:

  • YOUR_SONATYPE_USERNAME with your Legacy Minecraft Sonatype Nexus Repository username
  • YOUR_SONATYPE_PASSWORDE with the Legacy Minecraft Sonatype Nexus Repository token
Maven settings.xml configuration
Maven settings.xml configuration

Step 2: Verify

You should now be able to:

  • Deploy artifacts to Sonatype
  • Download packages from private repositories
  • Run Maven builds without authentication errors

If authentication fails:

  • Confirm the <id> matches your repository id
  • Ensure the token includes read:packages and write:packages
  • Ensure you have access to the desired repository on GitHub
  • Check the token has not expired

Security Notes

  • Never commit settings.xml to Git
  • Do not share tokens in screenshots, logs, or chat
  • Revoke tokens immediately if exposed
Retrieved from "https://wiki.retromc.org/index.php?title=Maven_Authentication_Guide&oldid=10265"