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.