This is an automated email from the ASF dual-hosted git repository.

Bukama pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-dist-tool.git


The following commit(s) were added to refs/heads/master by this push:
     new cdbdcfe  Add additional information how to create/use API-token (#191)
cdbdcfe is described below

commit cdbdcfe870ac4a8a430536fb74e172d4ce5e54e1
Author: Matthias Bünger <[email protected]>
AuthorDate: Tue Nov 3 21:27:40 2026 +0100

    Add additional information how to create/use API-token (#191)
---
 README.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/README.md b/README.md
index eaf36c0..6cd0a9f 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,10 @@ anonymously. Without the token the two reports still build, 
but come out empty.
 3. Navigate to **Security** (or go directly to 
`https://ci-maven.apache.org/user/<your-username>/security/`).
 4. Under **API Token**, click **Add new Token**, give it a name, and click 
**Generate**.
 5. Copy the generated token — it will not be shown again.
+6. Press **Save** to store generated token.
+
+To verify the created token got stored correctly, log out and in again and 
check if the token is listed on the **Security** page.
+If the token did not get stored, hit **Terminate all sessions**. This will log 
you out. Then repeat the steps above.
 
 #### Setting the Environment Variable
 
@@ -61,6 +65,21 @@ export API_TOKEN=$(echo -n 'your-username:your-api-token' | 
base64)
 
 You can add this to your shell profile (`~/.bashrc`, `~/.zshrc`, etc.) for 
persistence.
 
+On Windows, you can use the following CMD command to encode it:  
+
+```
+powershell 
"[convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes(\"your-username:your-api-token\"))"
+```
+
+After encoding store it in your environment variables using the following CMD 
command:
+
+```
+setx API_TOKEN your-Base64-encoded-token /m
+```
+
+Alternatively, configure the variable through the graphical interface.
+Navigate to `Settings` → `System` → `About` → `Advanced system settings` → 
`Environment Variables`, or search for `Environment Variables` using the 
Windows search bar.
+
 #### Usage
 
 - **Local build with site reports:** `mvn verify site` — the reports use 
`API_TOKEN` to fetch data from Jenkins.

Reply via email to