Ulises LicensesUlises Licenses
FeaturesPricingAPIAnnouncements
Solutions
Java & Kotlin LicensingMinecraft Plugin LicensingChoosing LicensingBuiltByBit IntegrationPolymart Integration
Discord
Dashboard
  • Overview
Using the SDK
  • Installation
  • Plugin Integration
  • Complete Example
  • API Methods
  • Connection Management
  • Auto-Update
  • Best Practices
Using the Endpoint
  • Endpoint Overview
  • Validate a License
  • Public Signing Key
  • Verify the Response
  • Endpoint Best Practices
  1. Docs
  2. /
  3. Public Signing Key

Public Signing Key

Every successful validation response carries a compact JWS. Verify it with the public key on this page. The key is public, so it is safe to ship inside your plugin. The private key never leaves the server.

NOTICE: This is not the API key
The API key identifies your product and authenticates the request. This public key only verifies the signature on the response token. It is not a secret, and it must never be sent in place of the API key.

Current key

Key ID
2026-10Active
Algorithm
ES256 (ECDSA P-256, SHA-256)
JWKS URL
https://www.uliseslicenses.xyz/.well-known/jwks.json

The JWKS URL is the machine-readable copy. This page is the human-readable copy. Both are generated from the same keyring.

Public keys

2026-10Active
SPKI base64
Base64
1MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE5v07+GZ7jOdgk0ImQ7ESxjClbo+ZjuVHBfbwGxLr1IIPZpfYsSnzw4owYQOnoubRkezeiDz1XN1kGhPl7lcKXA==
JWK
JSON
1{2  "kty": "EC",3  "crv": "P-256",4  "x": "5v07-GZ7jOdgk0ImQ7ESxjClbo-ZjuVHBfbwGxLr1II",5  "y": "D2aX2LEp88OKMGEDp6Lm0ZHs3og89VzdZBoT5e5XClw",6  "use": "sig",7  "alg": "ES256",8  "kid": "2026-10",9  "key_ops": [10    "verify"11  ]12}

How to use the key

  1. Pin the key in your plugin at build time and look it up by the kid in the token header.
  2. Verify the ES256 signature over the ASCII bytes of header.payload.
  3. Check aud, exp, nbf, hwid, and st before trusting the payload.

Do not fetch a key from a URL supplied by the response. The machine running your plugin can rewrite the response, including any URL in it. The JWKS URL above is for build-time or pinned updates, not for runtime trust.

Complete Java, Node.js, and Python examples are in Verifying the Signed Token.

Rotation

Keys are identified by kid. When we rotate, the JWKS URL publishes both the new key and the retiring key until the old tokens expire. Add the new kid to your key map before you remove the old one. Treat an unknown kid as a rejection, not as a reason to fetch a key from the response.

One key for every product

You do not need a separate key per product. The token's aud claim is the product id, so a token issued for one product is not valid for another. One general key keeps integration and rotation simple.

Prefer a bundled library?

UlisesLib.jar does the same validation for you, with retries, HWID collection and the auto-updater built in. It is a dependency you shade into your jar rather than a contract you implement.

Using the SDK
PreviousValidate a LicenseNextVerify the Response

Built by Ulises - Citymoon Dynamics

Ulises LicensesUlises Licenses

License management for Minecraft plugins and Java applications.

Discord

Legal

  • Terms of Service
  • Privacy Policy
  • Refund Policy
  • DPA

Docs

  • Overview
  • Installation
  • Plugin Integration
  • Complete Example
  • API Methods
  • Connection Management
  • Auto-Update
  • Best Practices
  • Endpoint Overview
  • Validate a License
  • Public Signing Key
  • Verify the Response
  • Endpoint Best Practices

History

  • Announcements
  • Citymoon Dynamics

Company

  • About
  • Security
  • Status
  • Contact

Solutions

  • Java & Kotlin
  • Minecraft Plugins
  • Choosing Licensing
  • BuiltByBit
  • Polymart

© 2025-2030 Citymoon Dynamics (citymoon.org). All rights reserved.