@nevermined-io/payments
    Preparing search index...

    Interface OAuthUrls

    OAuth URLs configuration for Nevermined authorization server. These URLs are used to build the OAuth discovery metadata.

    interface OAuthUrls {
        authorizationUri: string;
        issuer: string;
        jwksUri: string;
        tokenUri: string;
        userinfoUri: string;
    }
    Index

    Properties

    authorizationUri: string

    OAuth authorization endpoint URL — the Nevermined webapp's consent page, tier-qualified (https://nevermined.app/oauth/authorize?network=sandbox|live; nvm-monorepo#3430). An override is published verbatim: if you point it at the Nevermined webapp yourself (e.g. a custom environment behind a host the SDK cannot classify), include ?network=<tier> in the value. Overriding it also withdraws the RFC 9207 authorization_response_iss_parameter_supported advertisement from the discovery documents — the SDK cannot vouch that an AS it did not choose returns iss. That is a trade, not a non-event: RFC 9207 §2.4 has a client REJECT an iss-less response from a server that advertises support, and SHOULD DISCARD a response that carries iss from one that does not — so if the override still points at the Nevermined web app, which returns iss on every response, a strict client may discard its responses (payments#466).

    issuer: string

    The RFC 8414 issuer identifier — the CANONICAL origin of the Nevermined API this server runs against (e.g. https://api.sandbox.nevermined.app), one per tier: the value the API's own discovery document publishes and the web app returns as RFC 9207 iss. A named environment publishes its own canonical origin whatever tokenUri proxy sits in front of it; custom follows the backend it publishes, canonicalised for a Nevermined host. It was the frontend origin until #463 was fixed (payments#464): tier-blind, and rejected by RFC 9207 clients once the web app started returning iss. A non-empty explicit override is passed through unchanged and also becomes the protected-resource document's authorization_servers entry.

    jwksUri: string

    JSON Web Key Set endpoint URL

    tokenUri: string

    OAuth token endpoint URL (${backend}/oauth/token).

    ⚠️ An override here is honoured only by a client that discovers against THIS server's own document. The protected-resource document's authorization_servers names the issuer (the canonical API origin), so an RFC 9728 client fetches the Nevermined API's own metadata and exchanges its code at ${API origin}/oauth/token — around any proxy set here — and sees no registration_endpoint there (the API offers no DCR; this server does). payments#464.

    userinfoUri: string

    OpenID Connect userinfo endpoint URL