/*
 * oauth2-oidc-sdk
 *
 * Copyright 2012-2016, Connect2id Ltd and contributors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use
 * this file except in compliance with the License. You may obtain a copy of the
 * License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed
 * under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 * CONDITIONS OF ANY KIND, either express or implied. See the License for the
 * specific language governing permissions and limitations under the License.
 */

package com.nimbusds.oauth2.sdk.client;


import com.nimbusds.jose.EncryptionMethod;
import com.nimbusds.jose.JWEAlgorithm;
import com.nimbusds.jose.JWSAlgorithm;
import com.nimbusds.jose.JWSObject;
import com.nimbusds.jose.jwk.JWKSet;
import com.nimbusds.jwt.SignedJWT;
import com.nimbusds.langtag.LangTag;
import com.nimbusds.langtag.LangTagUtils;
import com.nimbusds.oauth2.sdk.*;
import com.nimbusds.oauth2.sdk.auth.ClientAuthenticationMethod;
import com.nimbusds.oauth2.sdk.ciba.BackChannelTokenDeliveryMode;
import com.nimbusds.oauth2.sdk.id.Identifier;
import com.nimbusds.oauth2.sdk.id.SoftwareID;
import com.nimbusds.oauth2.sdk.id.SoftwareVersion;
import com.nimbusds.oauth2.sdk.rar.AuthorizationType;
import com.nimbusds.oauth2.sdk.util.CollectionUtils;
import com.nimbusds.oauth2.sdk.util.JSONObjectUtils;
import com.nimbusds.oauth2.sdk.util.StringUtils;
import com.nimbusds.oauth2.sdk.util.URIUtils;
import com.nimbusds.openid.connect.sdk.federation.registration.ClientRegistrationType;
import net.minidev.json.JSONArray;
import net.minidev.json.JSONObject;

import java.net.URI;
import java.net.URISyntaxException;
import java.util.*;


/**
 * Client metadata.
 * 
 * <p>Example client metadata, serialised to a JSON object:
 * 
 * <pre>
 * {
 *  "redirect_uris"              : ["https://client.example.org/callback",
 *                                  "https://client.example.org/callback2"],
 *  "client_name"                : "My Example Client",
 *  "client_name#ja-Jpan-JP"     : "\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8\u540D",
 *  "token_endpoint_auth_method" : "client_secret_basic",
 *  "scope"                      : "read write dolphin",
 *  "logo_uri"                   : "https://client.example.org/logo.png",
 *  "jwks_uri"                   : "https://client.example.org/my_public_keys.jwks"
 * }
 * </pre>
 * 
 * <p>Related specifications:
 *
 * <ul>
 *     <li>OAuth 2.0 Dynamic Client Registration Protocol (RFC 7591), section
 *         2.
 *     <li>OAuth 2.0 Mutual TLS Client Authentication and Certificate Bound
 *         Access Tokens (RFC 8705), sections 2.1.2 and 3.4.
 *     <li>OAuth 2.0 Demonstrating Proof of Possession (DPoP) (RFC 9449),
 *        section 5.2.
 *     <li>Financial-grade API: JWT Secured Authorization Response Mode for
 *         OAuth 2.0 (JARM).
 *     <li>OAuth 2.0 Pushed Authorization Requests (RFC 9126)
 *     <li>OAuth 2.0 Rich Authorization Requests (RFC 9396), section 10.
 *     <li>OpenID Connect Client Initiated Backchannel Authentication Flow -
 *         Core 1.0
 *     <li>OpenID Connect Federation 1.0 (draft 22)
 * </ul>
 */
public class ClientMetadata {


        /**
         * The registered parameter names.
         */
        private static final Set<String> REGISTERED_PARAMETER_NAMES;
        
        
        /**
         * @see RedirectURIValidator#PROHIBITED_REDIRECT_URI_SCHEMES
         */
        @Deprecated
        public static final Set<String> PROHIBITED_REDIRECT_URI_SCHEMES = RedirectURIValidator.PROHIBITED_REDIRECT_URI_SCHEMES;


        static {
                Set<String> p = new HashSet<>();

                p.add("redirect_uris");
                p.add("scope");
                p.add("response_types");
                p.add("grant_types");
                p.add("contacts");
                p.add("client_name");
                p.add("logo_uri");
                p.add("client_uri");
                p.add("policy_uri");
                p.add("tos_uri");
                p.add("token_endpoint_auth_method");
                p.add("token_endpoint_auth_signing_alg");
                p.add("jwks_uri");
                p.add("jwks");
                p.add("request_uris");
                p.add("request_object_signing_alg");
                p.add("request_object_encryption_alg");
                p.add("request_object_encryption_enc");
                p.add("require_pushed_authorization_requests");
                p.add("software_id");
                p.add("software_version");
                p.add("software_statement");
                p.add("tls_client_certificate_bound_access_tokens");
                p.add("tls_client_auth_subject_dn");
                p.add("tls_client_auth_san_dns");
                p.add("tls_client_auth_san_uri");
                p.add("tls_client_auth_san_ip");
                p.add("tls_client_auth_san_email");
                p.add("dpop_bound_access_tokens");
                p.add("authorization_signed_response_alg");
                p.add("authorization_encrypted_response_alg");
                p.add("authorization_encrypted_response_enc");
                p.add("authorization_details_types");

                // CIBA
                p.add("backchannel_token_delivery_mode");
                p.add("backchannel_client_notification_endpoint");
                p.add("backchannel_authentication_request_signing_alg");
                p.add("backchannel_user_code_parameter");
                
                // OIDC federation
                p.add("organization_name");
                p.add("signed_jwks_uri");
                p.add("client_registration_types");

                REGISTERED_PARAMETER_NAMES = Collections.unmodifiableSet(p);
        }
        
        
        /**
         * Redirect URIs.
         */
        private Set<URI> redirectURIs;


        /**
         * The client OAuth 2.0 scope.
         */
        private Scope scope;


        /**
         * The expected OAuth 2.0 response types.
         */
        private Set<ResponseType> responseTypes;


        /**
         * The expected OAuth 2.0 grant types.
         */
        private Set<GrantType> grantTypes;


        /**
         * Administrator email contacts for the client.
         */
        private List<String> contacts;


        /**
         * The client name.
         */
        private final Map<LangTag,String> nameEntries;


        /**
         * The client application logo.
         */
        private final Map<LangTag,URI> logoURIEntries;


        /**
         * The client URI entries.
         */
        private final Map<LangTag,URI> uriEntries;


        /**
         * The client policy for use of end-user data.
         */
        private final Map<LangTag,URI> policyURIEntries;


        /**
         * The client terms of service.
         */
        private final Map<LangTag,URI> tosURIEntries;


        /**
         * Token endpoint authentication method.
         */
        private ClientAuthenticationMethod authMethod;


        /**
         * The JSON Web Signature (JWS) algorithm required for
         * {@code private_key_jwt} and {@code client_secret_jwt}
         * authentication at the Token endpoint.
         */
        private JWSAlgorithm authJWSAlg;


        /**
         * URI for this client's JSON Web Key (JWK) set containing key(s) that
         * are used in signing requests to the server and key(s) for encrypting
         * responses.
         */
        private URI jwkSetURI;


        /**
         * URI for this client's signed JSON Web Key (JWK) set containing
         * key(s) that are used in signing requests to the server and key(s)
         * for encrypting responses. Intended for use in OpenID Connect
         * Federation 1.0.
         */
        private URI signedJWKSetURI;


        /**
         * Client's JSON Web Key (JWK) set containing key(s) that are used in
         * signing requests to the server and key(s) for encrypting responses.
         * Intended as an alternative to {@link #jwkSetURI} for native clients.
         */
        private JWKSet jwkSet;
        
        
        /**
         * Pre-registered request object URIs.
         */
        private Set<URI> requestObjectURIs;
        
        
        /**
         * The JSON Web Signature (JWS) algorithm required for request objects
         * sent by this client.
         */
        private JWSAlgorithm requestObjectJWSAlg;
        
        
        /**
         * The JSON Web Encryption (JWE) algorithm required for request objects
         * sent by this client.
         */
        private JWEAlgorithm requestObjectJWEAlg;
        
        
        /**
         * The JSON Web Encryption (JWE) method required for request objects
         * sent by this client.
         */
        private EncryptionMethod requestObjectJWEEnc;


        /**
         * Identifier for the OAuth 2.0 client software.
         */
        private SoftwareID softwareID;


        /**
         * Version identifier for the OAuth 2.0 client software.
         */
        private SoftwareVersion softwareVersion;
        
        
        /**
         * Signed software statement.
         */
        private SignedJWT softwareStatement;
        
        
        /**
         * Preference for TLS client certificate bound access tokens.
         */
        private boolean tlsClientCertificateBoundAccessTokens = false;
        
        
        /**
         * The expected subject distinguished name (DN) of the client X.509
         * certificate the in mutual TLS authentication.
         */
        private String tlsClientAuthSubjectDN = null;
        
        
        /**
         * The expected dNSName SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication.
         */
        private String tlsClientAuthSanDNS = null;
        
        
        /**
         * The expected uniformResourceIdentifier SAN entry in the X.509
         * certificate, which the OAuth client will use in mutual TLS
         * authentication.
         */
        private String tlsClientAuthSanURI = null;
        
        
        /**
         * The expected iPAddress SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication.
         */
        private String tlsClientAuthSanIP = null;
        
        
        /**
         * The expected rfc822Name SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication.
         */
        private String tlsClientAuthSanEmail = null;


        /**
         * Preference for DPoP bound access tokens.
         */
        private boolean dPoPBoundAccessTokens = false;
        
        
        /**
         * The JWS algorithm for JWT-encoded authorisation responses.
         */
        private JWSAlgorithm authzJWSAlg;
        
        
        /**
         * The JWE algorithm for JWT-encoded authorisation responses.
         */
        private JWEAlgorithm authzJWEAlg;
        
        
        /**
         * The encryption method for JWT-encoded authorisation responses.
         */
        private EncryptionMethod authzJWEEnc;
        
        
        /**
         * If {@code true} PAR is required, else not.
         */
        private boolean requirePAR = false;


        /**
         * The authorisation details types.
         */
        private List<AuthorizationType> authzTypes;
        
        
        /**
         * The CIBA token delivery mode.
         */
        private BackChannelTokenDeliveryMode backChannelTokenDeliveryMode;
        
        
        /**
         * The CIBA client notification endpoint for the ping or push token
         * delivery modes.
         */
        private URI backChannelClientNotificationEndpoint;
        
        
        /**
         * The JWS algorithm for signed CIBA requests.
         */
        private JWSAlgorithm backChannelAuthRequestJWSAlg;
        
        
        /**
         * Support for the {@code user_code} CIBA request parameter.
         */
        private boolean backChannelUserCodeParam = false;
        
        
        /**
         * The supported OpenID Connect Federation 1.0 client registration
         * types.
         */
        private List<ClientRegistrationType> clientRegistrationTypes;
        
        
        /**
         * The organisation name in OpenID Connect Federation 1.0.
         */
        private String organizationName;


        /**
         * The custom metadata fields.
         */
        private JSONObject customFields;


        /**
         * Creates a new OAuth 2.0 client metadata instance.
         */
        public ClientMetadata() {

                nameEntries = new HashMap<>();
                logoURIEntries = new HashMap<>();
                uriEntries = new HashMap<>();
                policyURIEntries = new HashMap<>();
                tosURIEntries = new HashMap<>();
                customFields = new JSONObject();
        }


        /**
         * Creates a shallow copy of the specified OAuth 2.0 client metadata
         * instance.
         *
         * @param metadata The client metadata to copy. Must not be
         *                 {@code null}.
         */
        public ClientMetadata(final ClientMetadata metadata) {

                redirectURIs = metadata.getRedirectionURIs();
                scope = metadata.getScope();
                responseTypes = metadata.getResponseTypes();
                grantTypes = metadata.getGrantTypes();
                contacts = metadata.getEmailContacts();
                nameEntries = metadata.getNameEntries();
                logoURIEntries = metadata.getLogoURIEntries();
                uriEntries = metadata.getURIEntries();
                policyURIEntries = metadata.getPolicyURIEntries();
                tosURIEntries = metadata.getTermsOfServiceURIEntries();
                authMethod = metadata.getTokenEndpointAuthMethod();
                authJWSAlg = metadata.getTokenEndpointAuthJWSAlg();
                jwkSetURI = metadata.getJWKSetURI();
                signedJWKSetURI = metadata.getSignedJWKSetURI();
                jwkSet = metadata.getJWKSet();
                requestObjectURIs = metadata.getRequestObjectURIs();
                requestObjectJWSAlg = metadata.getRequestObjectJWSAlg();
                requestObjectJWEAlg = metadata.getRequestObjectJWEAlg();
                requestObjectJWEEnc = metadata.getRequestObjectJWEEnc();
                softwareID = metadata.getSoftwareID();
                softwareVersion = metadata.getSoftwareVersion();
                softwareStatement = metadata.getSoftwareStatement();
                tlsClientCertificateBoundAccessTokens = metadata.getTLSClientCertificateBoundAccessTokens();
                tlsClientAuthSubjectDN = metadata.getTLSClientAuthSubjectDN();
                tlsClientAuthSanDNS = metadata.getTLSClientAuthSanDNS();
                tlsClientAuthSanURI = metadata.getTLSClientAuthSanURI();
                tlsClientAuthSanIP = metadata.getTLSClientAuthSanIP();
                tlsClientAuthSanEmail = metadata.getTLSClientAuthSanEmail();
                dPoPBoundAccessTokens = metadata.getDPoPBoundAccessTokens();
                authzJWSAlg = metadata.getAuthorizationJWSAlg();
                authzJWEAlg = metadata.getAuthorizationJWEAlg();
                authzJWEEnc = metadata.getAuthorizationJWEEnc();
                requirePAR = metadata.requiresPushedAuthorizationRequests();
                authzTypes = metadata.getAuthorizationDetailsTypes();
                backChannelTokenDeliveryMode = metadata.getBackChannelTokenDeliveryMode();
                backChannelClientNotificationEndpoint = metadata.getBackChannelClientNotificationEndpoint();
                backChannelAuthRequestJWSAlg = metadata.getBackChannelAuthRequestJWSAlg();
                backChannelUserCodeParam = metadata.supportsBackChannelUserCodeParam();
                clientRegistrationTypes = metadata.getClientRegistrationTypes();
                organizationName = metadata.getOrganizationName();
                customFields = metadata.getCustomFields();
        }


        /**
         * Gets the registered (standard) OAuth 2.0 client metadata parameter
         * names.
         *
         * @return The registered parameter names, as an unmodifiable set.
         */
        public static Set<String> getRegisteredParameterNames() {

                return REGISTERED_PARAMETER_NAMES;
        }


        /**
         * Gets the redirection URIs for this client. Corresponds to the
         * {@code redirect_uris} client metadata field.
         *
         * @return The redirection URIs, {@code null} if not specified.
         */
        public Set<URI> getRedirectionURIs() {

                return redirectURIs;
        }
        
        
        /**
         * Gets one of the redirection URIs for this client. Corresponds to the
         * {@code redirect_uris} client metadata field.
         *
         * @return The redirection URI, {@code null} if not specified.
         */
        public URI getRedirectionURI() {
                
                if (redirectURIs != null && ! redirectURIs.isEmpty()) {
                        return redirectURIs.iterator().next();
                } else {
                        return null;
                }
        }


        /**
         * Gets the redirection URIs for this client as strings. Corresponds to
         * the {@code redirect_uris} client metadata field.
         *
         * <p>This short-hand method is intended to enable string-based URI
         * comparison.
         *
         * @return The redirection URIs as strings, {@code null} if not
         *         specified.
         */
        public Set<String> getRedirectionURIStrings() {

                if (redirectURIs == null)
                        return null;

                Set<String> uriStrings = new HashSet<>();

                for (URI uri: redirectURIs)
                        uriStrings.add(uri.toString());

                return uriStrings;
        }


        /**
         * Sets the redirection URIs for this client. Corresponds to the
         * {@code redirect_uris} client metadata field.
         *
         * @param redirectURIs The redirection URIs, {@code null} if not
         *                     specified. Valid redirection URIs must not
         *                     contain a fragment.
         */
        public void setRedirectionURIs(final Set<URI> redirectURIs) {

                if (redirectURIs != null) {
                        // check URIs
                        for (URI uri: redirectURIs) {
                                if (uri == null) {
                                        throw new IllegalArgumentException("The redirect_uri must not be null");
                                }
                                RedirectURIValidator.ensureLegal(uri);
                        }
                        this.redirectURIs = Collections.unmodifiableSet(redirectURIs);
                } else {
                        this.redirectURIs = null;
                }
        }


        /**
         * Sets a single redirection URI for this client. Corresponds to the
         * {@code redirect_uris} client metadata field.
         *
         * @param redirectURI The redirection URIs, {@code null} if not
         *                    specified. A valid redirection URI must not
         *                    contain a fragment.
         */
        public void setRedirectionURI(final URI redirectURI) {

                setRedirectionURIs(redirectURI != null ? Collections.singleton(redirectURI) : null);
        }


        /**
         * Gets the scope values that the client can use when requesting access
         * tokens. Corresponds to the {@code scope} client metadata field.
         *
         * @return The scope, {@code null} if not specified.
         */
        public Scope getScope() {

                return scope;
        }


        /**
         * Checks if the scope matadata field is set and contains the specified
         * scope value.
         *
         * @param scopeValue The scope value. Must not be {@code null}.
         *
         * @return {@code true} if the scope value is contained, else
         *         {@code false}.
         */
        public boolean hasScopeValue(final Scope.Value scopeValue) {

                return scope != null && scope.contains(scopeValue);
        }


        /**
         * Sets the scope values that the client can use when requesting access
         * tokens. Corresponds to the {@code scope} client metadata field.
         *
         * @param scope The scope, {@code null} if not specified.
         */
        public void setScope(final Scope scope) {

                this.scope = scope;
        }


        /**
         * Gets the expected OAuth 2.0 response types. Corresponds to the
         * {@code response_types} client metadata field.
         *
         * @return The response types, {@code null} if not specified.
         */
        public Set<ResponseType> getResponseTypes() {

                return responseTypes;
        }


        /**
         * Sets the expected OAuth 2.0 response types. Corresponds to the
         * {@code response_types} client metadata field.
         *
         * @param responseTypes The response types, {@code null} if not
         *                      specified.
         */
        public void setResponseTypes(final Set<ResponseType> responseTypes) {

                this.responseTypes = responseTypes;
        }


        /**
         * Gets the expected OAuth 2.0 grant types. Corresponds to the
         * {@code grant_types} client metadata field.
         *
         * @return The grant types, {@code null} if not specified.
         */
        public Set<GrantType> getGrantTypes() {

                return grantTypes;
        }


        /**
         * Sets the expected OAuth 2.0 grant types. Corresponds to the
         * {@code grant_types} client metadata field.
         *
         * @param grantTypes The grant types, {@code null} if not specified.
         */
        public void setGrantTypes(final Set<GrantType> grantTypes) {

                this.grantTypes = grantTypes;
        }


        /**
         * Gets the administrator email contacts for the client. Corresponds to
         * the {@code contacts} client metadata field.
         *
         * @return The administrator email contacts, {@code null} if not
         *         specified.
         */
        public List<String> getEmailContacts() {

                return contacts;
        }


        /**
         * Sets the administrator email contacts for the client. Corresponds to
         * the {@code contacts} client metadata field.
         *
         * @param contacts The administrator email contacts, {@code null} if
         *                 not specified.
         */
        public void setEmailContacts(final List<String> contacts) {

                this.contacts = contacts;
        }


        /**
         * Gets the client name. Corresponds to the {@code client_name} client
         * metadata field, with no language tag.
         *
         * @return The client name, {@code null} if not specified.
         */
        public String getName() {

                return getName(null);
        }


        /**
         * Gets the client name. Corresponds to the {@code client_name} client
         * metadata field, with an optional language tag.
         *
         * @param langTag The language tag of the entry, {@code null} to get
         *                the non-tagged entry.
         *
         * @return The client name, {@code null} if not specified.
         */
        public String getName(final LangTag langTag) {

                return nameEntries.get(langTag);
        }


        /**
         * Gets the client name entries. Corresponds to the {@code client_name}
         * client metadata field.
         *
         * @return The client name entries, empty map if none.
         */
        public Map<LangTag,String> getNameEntries() {

                return nameEntries;
        }


        /**
         * Sets the client name. Corresponds to the {@code client_name} client
         * metadata field, with no language tag.
         *
         * @param name The client name, {@code null} if not specified.
         */
        public void setName(final String name) {

                nameEntries.put(null, name);
        }


        /**
         * Sets the client name. Corresponds to the {@code client_name} client
         * metadata field, with an optional language tag.
         *
         * @param name    The client name. Must not be {@code null}.
         * @param langTag The language tag, {@code null} if not specified.
         */
        public void setName(final String name, final LangTag langTag) {

                nameEntries.put(langTag, name);
        }


        /**
         * Gets the client application logo. Corresponds to the
         * {@code logo_uri} client metadata field, with no language
         * tag.
         *
         * @return The logo URI, {@code null} if not specified.
         */
        public URI getLogoURI() {

                return getLogoURI(null);
        }


        /**
         * Gets the client application logo. Corresponds to the
         * {@code logo_uri} client metadata field, with an optional
         * language tag.
         *
         * @param langTag The language tag, {@code null} if not specified.
         *
         * @return The logo URI, {@code null} if not specified.
         */
        public URI getLogoURI(final LangTag langTag) {

                return logoURIEntries.get(langTag);
        }


        /**
         * Gets the client application logo entries. Corresponds to the
         * {@code logo_uri} client metadata field.
         *
         * @return The logo URI entries, empty map if none.
         */
        public Map<LangTag,URI> getLogoURIEntries() {

                return logoURIEntries;
        }


        /**
         * Sets the client application logo. Corresponds to the
         * {@code logo_uri} client metadata field, with no language
         * tag.
         *
         * @param logoURI The logo URI, {@code null} if not specified.
         */
        public void setLogoURI(final URI logoURI) {

                logoURIEntries.put(null, logoURI);
        }


        /**
         * Sets the client application logo. Corresponds to the
         * {@code logo_uri} client metadata field, with an optional
         * language tag.
         *
         * @param logoURI The logo URI. Must not be {@code null}.
         * @param langTag The language tag, {@code null} if not specified.
         */
        public void setLogoURI(final URI logoURI, final LangTag langTag) {

                logoURIEntries.put(langTag, logoURI);
        }


        /**
         * Gets the client home page. Corresponds to the {@code client_uri}
         * client metadata field, with no language tag.
         *
         * @return The client URI, {@code null} if not specified.
         */
        public URI getURI() {

                return getURI(null);
        }


        /**
         * Gets the client home page. Corresponds to the {@code client_uri}
         * client metadata field, with an optional language tag.
         *
         * @param langTag The language tag, {@code null} if not specified.
         *
         * @return The client URI, {@code null} if not specified.
         */
        public URI getURI(final LangTag langTag) {

                return uriEntries.get(langTag);
        }


        /**
         * Gets the client home page entries. Corresponds to the
         * {@code client_uri} client metadata field.
         *
         * @return The client URI entries, empty map if none.
         */
        public Map<LangTag,URI> getURIEntries() {

                return uriEntries;
        }


        /**
         * Sets the client home page. Corresponds to the {@code client_uri}
         * client metadata field, with no language tag.
         *
         * @param uri The client URI, {@code null} if not specified. The URI
         *            scheme must be https or http.
         */
        public void setURI(final URI uri) {

                URIUtils.ensureSchemeIsHTTPSorHTTP(uri);
                uriEntries.put(null, uri);
        }


        /**
         * Sets the client home page. Corresponds to the {@code client_uri}
         * client metadata field, with an optional language tag.
         *
         * @param uri     The URI. The URI scheme must be https or http. Must
         *                not be {@code null}.
         * @param langTag The language tag, {@code null} if not specified.
         */
        public void setURI(final URI uri, final LangTag langTag) {
                
                URIUtils.ensureSchemeIsHTTPSorHTTP(uri);
                uriEntries.put(langTag, uri);
        }


        /**
         * Gets the client policy for use of end-user data. Corresponds to the
         * {@code policy_uri} client metadata field, with no language
         * tag.
         *
         * @return The policy URI, {@code null} if not specified.
         */
        public URI getPolicyURI() {

                return getPolicyURI(null);
        }


        /**
         * Gets the client policy for use of end-user data. Corresponds to the
         * {@code policy_uri} client metadata field, with an optional
         * language tag.
         *
         * @param langTag The language tag, {@code null} if not specified.
         *
         * @return The policy URI, {@code null} if not specified.
         */
        public URI getPolicyURI(final LangTag langTag) {

                return policyURIEntries.get(langTag);
        }


        /**
         * Gets the client policy entries for use of end-user data.
         * Corresponds to the {@code policy_uri} client metadata field.
         *
         * @return The policy URI entries, empty map if none.
         */
        public Map<LangTag,URI> getPolicyURIEntries() {

                return policyURIEntries;
        }


        /**
         * Sets the client policy for use of end-user data. Corresponds to the
         * {@code policy_uri} client metadata field, with no language
         * tag.
         *
         * @param policyURI The policy URI, {@code null} if not specified. The
         *                  URI scheme must be https or http.
         */
        public void setPolicyURI(final URI policyURI) {

                URIUtils.ensureSchemeIsHTTPSorHTTP(policyURI);
                policyURIEntries.put(null, policyURI);
        }


        /**
         * Sets the client policy for use of end-user data. Corresponds to the
         * {@code policy_uri} client metadata field, with an optional
         * language tag.
         *
         * @param policyURI The policy URI. The URI scheme must be https or
         *                  http. Must not be {@code null}.
         * @param langTag   The language tag, {@code null} if not specified.
         */
        public void setPolicyURI(final URI policyURI, final LangTag langTag) {

                URIUtils.ensureSchemeIsHTTPSorHTTP(policyURI);
                policyURIEntries.put(langTag, policyURI);
        }


        /**
         * Gets the client's terms of service. Corresponds to the
         * {@code tos_uri} client metadata field, with no language
         * tag.
         *
         * @return The terms of service URI, {@code null} if not specified.
         */
        public URI getTermsOfServiceURI() {

                return getTermsOfServiceURI(null);
        }


        /**
         * Gets the client's terms of service. Corresponds to the
         * {@code tos_uri} client metadata field, with an optional
         * language tag.
         *
         * @param langTag The language tag, {@code null} if not specified.
         *
         * @return The terms of service URI, {@code null} if not specified.
         */
        public URI getTermsOfServiceURI(final LangTag langTag) {

                return tosURIEntries.get(langTag);
        }


        /**
         * Gets the client's terms of service entries. Corresponds to the
         * {@code tos_uri} client metadata field.
         *
         * @return The terms of service URI entries, empty map if none.
         */
        public Map<LangTag,URI> getTermsOfServiceURIEntries() {

                return tosURIEntries;
        }


        /**
         * Sets the client's terms of service. Corresponds to the
         * {@code tos_uri} client metadata field, with no language
         * tag.
         *
         * @param tosURI The terms of service URI, {@code null} if not
         *               specified. The URI scheme must be https or http.
         */
        public void setTermsOfServiceURI(final URI tosURI) {

                URIUtils.ensureSchemeIsHTTPSorHTTP(tosURI);
                tosURIEntries.put(null, tosURI);
        }


        /**
         * Sets the client's terms of service. Corresponds to the
         * {@code tos_uri} client metadata field, with an optional
         * language tag.
         *
         * @param tosURI  The terms of service URI. The URI scheme must not be
         *                https or http. Must not be {@code null}.
         * @param langTag The language tag, {@code null} if not specified.
         */
        public void setTermsOfServiceURI(final URI tosURI, final LangTag langTag) {
                
                URIUtils.ensureSchemeIsHTTPSorHTTP(tosURI);
                tosURIEntries.put(langTag, tosURI);
        }


        /**
         * Gets the Token endpoint authentication method. Corresponds to the
         * {@code token_endpoint_auth_method} client metadata field.
         *
         * @return The Token endpoint authentication method, {@code null} if
         *         not specified.
         */
        public ClientAuthenticationMethod getTokenEndpointAuthMethod() {

                return authMethod;
        }


        /**
         * Sets the Token endpoint authentication method. Corresponds to the
         * {@code token_endpoint_auth_method} client metadata field.
         *
         * @param authMethod The Token endpoint authentication  method,
         *                   {@code null} if not specified.
         */
        public void setTokenEndpointAuthMethod(final ClientAuthenticationMethod authMethod) {

                this.authMethod = authMethod;
        }


        /**
         * Gets the JSON Web Signature (JWS) algorithm required for
         * {@code private_key_jwt} and {@code client_secret_jwt}
         * authentication at the Token endpoint. Corresponds to the
         * {@code token_endpoint_auth_signing_alg} client metadata field.
         *
         * @return The JWS algorithm, {@code null} if not specified.
         */
        public JWSAlgorithm getTokenEndpointAuthJWSAlg() {

                return authJWSAlg;
        }


        /**
         * Sets the JSON Web Signature (JWS) algorithm required for
         * {@code private_key_jwt} and {@code client_secret_jwt}
         * authentication at the Token endpoint. Corresponds to the
         * {@code token_endpoint_auth_signing_alg} client metadata field.
         *
         * @param authJWSAlg The JWS algorithm, {@code null} if not specified.
         */
        public void setTokenEndpointAuthJWSAlg(final JWSAlgorithm authJWSAlg) {

                this.authJWSAlg = authJWSAlg;
        }


        /**
         * Gets the URI for this client's JSON Web Key (JWK) set containing
         * key(s) that are used in signing requests to the server and key(s)
         * for encrypting responses. Corresponds to the {@code jwks_uri} client
         * metadata field.
         *
         * @return The JWK set URI, {@code null} if not specified.
         */
        public URI getJWKSetURI() {

                return jwkSetURI;
        }


        /**
         * Sets the URI for this client's JSON Web Key (JWK) set containing
         * key(s) that are used in signing requests to the server and key(s)
         * for encrypting responses. Corresponds to the {@code jwks_uri} client
         * metadata field.
         *
         * @param jwkSetURI The JWK set URI, {@code null} if not specified.
         */
        public void setJWKSetURI(final URI jwkSetURI) {

                this.jwkSetURI = jwkSetURI;
        }


        /**
         * Gets the URI for this client's signed JSON Web Key (JWK) set
         * containing key(s) that are used in signing requests to the server
         * and key(s) for encrypting responses. Corresponds to the
         * {@code signed_jwks_uri} client metadata field. Intended for use in
         * OpenID Connect Federation 1.0.
         *
         * @return The signed JWK set URI, {@code null} if not specified.
         */
        public URI getSignedJWKSetURI() {

                return signedJWKSetURI;
        }


        /**
         * Sets the URI for this client's signed JSON Web Key (JWK) set
         * containing key(s) that are used in signing requests to the server
         * and key(s) for encrypting responses. Corresponds to the
         * {@code signed_jwks_uri} client metadata field. Intended for use in
         * OpenID Connect Federation 1.0.
         *
         * @param signedJWKSetURI The signed JWK set URI, {@code null} if not
         *                        specified.
         */
        public void setSignedJWKSetURI(final URI signedJWKSetURI) {

                this.signedJWKSetURI = signedJWKSetURI;
        }


        /**
         * Gets this client's JSON Web Key (JWK) set containing key(s) that are
         * used in signing requests to the server and key(s) for encrypting
         * responses. Intended as an alternative to {@link #getJWKSetURI} for
         * native clients. Corresponds to the {@code jwks} client metadata
         * field.
         *
         * @return The JWK set, {@code null} if not specified.
         */
        public JWKSet getJWKSet() {

                return jwkSet;
        }


        /**
         * Sets this client's JSON Web Key (JWK) set containing key(s) that are
         * used in signing requests to the server and key(s) for encrypting
         * responses. Intended as an alternative to {@link #getJWKSetURI} for
         * native clients. Corresponds to the {@code jwks} client metadata
         * field.
         *
         * @param jwkSet The JWK set, {@code null} if not specified.
         */
        public void setJWKSet(final JWKSet jwkSet) {

                this.jwkSet = jwkSet;
        }
        
        
        /**
         * Gets the pre-registered request object URIs. Corresponds to the
         * {@code request_uris} client metadata field.
         *
         * @return The request object URIs, {@code null} if not specified.
         */
        public Set<URI> getRequestObjectURIs() {
                
                return requestObjectURIs;
        }
        
        
        /**
         * Sets the pre-registered request object URIs. Corresponds to the
         * {@code request_uris} client metadata field.
         *
         * @param requestObjectURIs The request object URIs, {@code null} if
         *                          not specified.
         */
        public void setRequestObjectURIs(final Set<URI> requestObjectURIs) {
                
                this.requestObjectURIs = requestObjectURIs;
        }
        
        
        /**
         * Gets the JSON Web Signature (JWS) algorithm required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_signing_alg} client metadata field.
         *
         * @return The JWS algorithm, {@code null} if not specified.
         */
        public JWSAlgorithm getRequestObjectJWSAlg() {
                
                return requestObjectJWSAlg;
        }
        
        
        /**
         * Sets the JSON Web Signature (JWS) algorithm required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_signing_alg} client metadata field.
         *
         * @param requestObjectJWSAlg The JWS algorithm, {@code null} if not
         *                            specified.
         */
        public void setRequestObjectJWSAlg(final JWSAlgorithm requestObjectJWSAlg) {
                
                this.requestObjectJWSAlg = requestObjectJWSAlg;
        }
        
        
        /**
         * Gets the JSON Web Encryption (JWE) algorithm required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_encryption_alg} client metadata field.
         *
         * @return The JWE algorithm, {@code null} if not specified.
         */
        public JWEAlgorithm getRequestObjectJWEAlg() {
                
                return requestObjectJWEAlg;
        }
        
        
        /**
         * Sets the JSON Web Encryption (JWE) algorithm required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_encryption_alg} client metadata field.
         *
         * @param requestObjectJWEAlg The JWE algorithm, {@code null} if not
         *                            specified.
         */
        public void setRequestObjectJWEAlg(final JWEAlgorithm requestObjectJWEAlg) {
                
                this.requestObjectJWEAlg = requestObjectJWEAlg;
        }
        
        
        /**
         * Gets the JSON Web Encryption (JWE) method required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_encryption_enc} client metadata field.
         *
         * @return The JWE method, {@code null} if not specified.
         */
        public EncryptionMethod getRequestObjectJWEEnc() {
                
                return requestObjectJWEEnc;
        }
        
        
        /**
         * Sets the JSON Web Encryption (JWE) method required for request
         * objects sent by this client. Corresponds to the
         * {@code request_object_encryption_enc} client metadata field.
         *
         * @param requestObjectJWEEnc The JWE method, {@code null} if not
         *                            specified.
         */
        public void setRequestObjectJWEEnc(final EncryptionMethod requestObjectJWEEnc) {
                
                this.requestObjectJWEEnc = requestObjectJWEEnc;
        }


        /**
         * Gets the identifier for the OAuth 2.0 client software. Corresponds
         * to the {@code software_id} client metadata field.
         *
         * @return The software identifier, {@code null} if not specified.
         */
        public SoftwareID getSoftwareID() {

                return softwareID;
        }


        /**
         * Sets the identifier for the OAuth 2.0 client software. Corresponds
         * to the {@code software_id} client metadata field.
         *
         * @param softwareID The software identifier, {@code null} if not
         *                   specified.
         */
        public void setSoftwareID(final SoftwareID softwareID) {

                this.softwareID = softwareID;
        }


        /**
         * Gets the version identifier for the OAuth 2.0 client software.
         * Corresponds to the {@code software_version} client metadata field.
         *
         * @return The version identifier, {@code null} if not specified.
         */
        public SoftwareVersion getSoftwareVersion() {

                return softwareVersion;
        }


        /**
         * Sets the version identifier for the OAuth 2.0 client software.
         * Corresponds to the {@code software_version} client metadata field.
         *
         * @param softwareVersion The version identifier, {@code null} if not
         *                        specified.
         */
        public void setSoftwareVersion(final SoftwareVersion softwareVersion) {

                this.softwareVersion = softwareVersion;
        }
        
        
        /**
         * Gets the software statement. Corresponds to the
         * {@code software_statement} client metadata field.
         *
         * @return The signed software statement, {@code null} if not
         *         specified.
         */
        public SignedJWT getSoftwareStatement() {
                
                return softwareStatement;
        }
        
        
        /**
         * Sets the software statement. Corresponds to the
         * {@code software_statement} client metadata field.
         *
         * @param softwareStatement The signed software statement, {@code null}
         *                          if not specified.
         */
        public void setSoftwareStatement(final SignedJWT softwareStatement) {
                
                if (softwareStatement != null && softwareStatement.getState().equals(JWSObject.State.UNSIGNED)) {
                        throw new IllegalArgumentException("The software statement must be signed");
                }
                
                this.softwareStatement = softwareStatement;
        }
        
        
        /**
         * Gets the preference for TLS client certificate bound access tokens.
         * Corresponds to the
         * {@code tls_client_certificate_bound_access_tokens} client metadata
         * field.
         *
         * @return {@code true} indicates a preference for TLS client
         *         certificate bound access tokens, {@code false} if none.
         */
        public boolean getTLSClientCertificateBoundAccessTokens() {
                
                return tlsClientCertificateBoundAccessTokens;
        }
        
        
        /**
         * Sets the preference for TLS client certificate bound access tokens.
         * Corresponds to the
         * {@code tls_client_certificate_bound_access_tokens} client metadata
         * field.
         *
         * @param tlsClientCertBoundTokens {@code true} indicates a preference
         *                                 for TLS client certificate bound
         *                                 access tokens, {@code false} if
         *                                 none.
         */
        public void setTLSClientCertificateBoundAccessTokens(final boolean tlsClientCertBoundTokens) {
                
                tlsClientCertificateBoundAccessTokens = tlsClientCertBoundTokens;
        }
        
        
        /**
         * Sets the preference for TLS client certificate bound access tokens.
         * Corresponds to the
         * {@code tls_client_certificate_bound_access_tokens} client metadata
         * field.
         *
         * @return {@code true} indicates a preference for TLS client
         *         certificate bound access tokens, {@code false} if none.
         */
        @Deprecated
        public boolean getMutualTLSSenderConstrainedAccessTokens() {
                
                return tlsClientCertificateBoundAccessTokens;
        }
        
        
        /**
         * Gets the preference for TLS client certificate bound access tokens.
         * Corresponds to the
         * {@code tls_client_certificate_bound_access_tokens} client metadata
         * field.
         *
         * @param tlsSenderAccessTokens {@code true} indicates a preference for
         *                              TLS client certificate bound access
         *                              tokens, {@code false} if none.
         */
        @Deprecated
        public void setMutualTLSSenderConstrainedAccessTokens(final boolean tlsSenderAccessTokens) {
                
                tlsClientCertificateBoundAccessTokens = tlsSenderAccessTokens;
        }
        
        
        /**
         * Gets the expected subject distinguished name (DN) of the client
         * X.509 certificate in mutual TLS authentication. Corresponds to the
         * {@code tls_client_auth_subject_dn} client metadata field.
         *
         * @return The expected subject distinguished name (DN) of the client
         *         X.509 certificate, {@code null} if not specified.
         */
        public String getTLSClientAuthSubjectDN() {
                
                return tlsClientAuthSubjectDN;
        }
        
        
        /**
         * Sets the expected subject distinguished name (DN) of the client
         * X.509 certificate in mutual TLS authentication. Corresponds to the
         * {@code tls_client_auth_subject_dn} client metadata field.
         *
         * @param subjectDN The expected subject distinguished name (DN) of the
         *                  client X.509 certificate, {@code null} if not
         *                  specified.
         */
        public void setTLSClientAuthSubjectDN(final String subjectDN) {
                
                this.tlsClientAuthSubjectDN = subjectDN;
        }
        
        
        /**
         * Gets the expected dNSName SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_dns} client metadata field.
         *
         * @return The expected dNSName SAN entry in the X.509 certificate,
         *         {@code null} if not specified.
         */
        public String getTLSClientAuthSanDNS() {
                
                return tlsClientAuthSanDNS;
        }
        
        
        /**
         * Sets the expected dNSName SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_dns} client metadata field.
         *
         * @param dns The expected dNSName SAN entry in the X.509 certificate,
         *            {@code null} if not specified.
         */
        public void setTLSClientAuthSanDNS(final String dns) {
                
                this.tlsClientAuthSanDNS = dns;
        }
        
        
        /**
         * Gets the expected uniformResourceIdentifier SAN entry in the X.509
         * certificate, which the OAuth client will use in mutual TLS
         * authentication. Corresponds to the {@code tls_client_auth_san_uri}
         * client metadata field.
         *
         * @return The expected uniformResourceIdentifier SAN entry in the X.509
         *         certificate, {@code null} if not specified.
         */
        public String getTLSClientAuthSanURI() {
                
                return tlsClientAuthSanURI;
        }
        
        
        /**
         * Sets the expected uniformResourceIdentifier SAN entry in the X.509
         * certificate, which the OAuth client will use in mutual TLS
         * authentication. Corresponds to the {@code tls_client_auth_san_uri}
         * client metadata field.
         *
         * @param uri The expected uniformResourceIdentifier SAN entry in the X.509
         *            certificate, {@code null} if not specified.
         */
        public void setTLSClientAuthSanURI(final String uri) {
                
                this.tlsClientAuthSanURI = uri;
        }
        
        
        /**
         * Gets the expected iPAddress SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_ip} client metadata field.
         *
         * @return The expected iPAddress SAN entry in the X.509 certificate,
         *         {@code null} if not specified.
         */
        public String getTLSClientAuthSanIP() {
                
                return tlsClientAuthSanIP;
        }
        
        
        /**
         * Sets the expected iPAddress SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_ip} client metadata field.
         *
         * @param ip The expected iPAddress SAN entry in the X.509
         *           certificate, {@code null} if not specified.
         */
        public void setTLSClientAuthSanIP(final String ip) {
                
                this.tlsClientAuthSanIP = ip;
        }
        
        
        /**
         * Gets the expected rfc822Name SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_email} client metadata field.
         *
         * @return The expected rfc822Name SAN entry in the X.509 certificate,
         *         {@code null} if not specified.
         */
        public String getTLSClientAuthSanEmail() {
                
                return tlsClientAuthSanEmail;
        }
        
        
        /**
         * Sets the expected rfc822Name SAN entry in the X.509 certificate, which
         * the OAuth client will use in mutual TLS authentication. Corresponds
         * to the {@code tls_client_auth_san_email} client metadata field.
         *
         * @param email The expected rfc822Name SAN entry in the X.509
         *              certificate, {@code null} if not specified.
         */
        public void setTLSClientAuthSanEmail(final String email) {
                
                this.tlsClientAuthSanEmail = email;
        }
        
        
        /**
         * Ensures that for {@code tls_client_auth} a certificate field for the
         * subject is specified. See
         * https://www.rfc-editor.org/rfc/rfc8705.html#section-2.1.2
         */
        private void ensureExactlyOneCertSubjectFieldForTLSClientAuth()
                throws IllegalStateException {
                
                if (! ClientAuthenticationMethod.TLS_CLIENT_AUTH.equals(getTokenEndpointAuthMethod())) {
                        // Not tls_client_auth, ignore
                        return;
                }
                
                if (tlsClientAuthSubjectDN == null && tlsClientAuthSanDNS == null && tlsClientAuthSanURI == null && tlsClientAuthSanIP == null && tlsClientAuthSanEmail == null) {
                        throw new IllegalStateException("A certificate field must be specified to indicate the subject in tls_client_auth: " +
                                "tls_client_auth_subject_dn, tls_client_auth_san_dns, tls_client_auth_san_uri, tls_client_auth_san_ip or tls_client_auth_san_email");
                }
                
                String exceptionMessage = "Exactly one certificate field must be specified to indicate the subject in tls_client_auth: " +
                        "tls_client_auth_subject_dn, tls_client_auth_san_dns, tls_client_auth_san_uri, tls_client_auth_san_ip or tls_client_auth_san_email";
                
                if (tlsClientAuthSubjectDN != null) {
                        if (tlsClientAuthSanDNS != null || tlsClientAuthSanURI != null || tlsClientAuthSanIP != null || tlsClientAuthSanEmail != null) {
                                throw new IllegalStateException(exceptionMessage);
                        }
                }
                
                if (tlsClientAuthSanDNS != null) {
                        if (tlsClientAuthSanURI != null || tlsClientAuthSanIP != null || tlsClientAuthSanEmail != null) {
                                throw new IllegalStateException(exceptionMessage);
                        }
                }
                
                if (tlsClientAuthSanURI != null) {
                        if (tlsClientAuthSanIP != null || tlsClientAuthSanEmail != null) {
                                throw new IllegalStateException(exceptionMessage);
                        }
                }
                
                if (tlsClientAuthSanIP != null) {
                        if (tlsClientAuthSanEmail != null) {
                                throw new IllegalStateException(exceptionMessage);
                        }
                }
        }


        /**
         * Gets the preference for DPoP bound access tokens. Corresponds to the
         * {@code dpop_bound_access_tokens} client metadata field.
         *
         * @return {@code true} indicates a preference for DPoP bound access
         *         tokens, {@code false} if none.
         */
        public boolean getDPoPBoundAccessTokens() {

                return dPoPBoundAccessTokens;
        }


        /**
         * Sets the preference for DPoP bound access tokens. Corresponds to the
         * {@code dpop_bound_access_tokens} client metadata field.
         *
         * @param dPoPBoundAccessTokens {@code true} indicates a preference for
         *                              DPoP bound access tokens, {@code false}
         *                              if none.
         */
        public void setDPoPBoundAccessTokens(final boolean dPoPBoundAccessTokens) {

                this.dPoPBoundAccessTokens = dPoPBoundAccessTokens;
        }
        
        
        /**
         * Gets the JWS algorithm for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_signed_response_alg} client
         * metadata field.
         *
         * @return The JWS algorithm, {@code null} if not specified.
         */
        public JWSAlgorithm getAuthorizationJWSAlg() {
                
                return authzJWSAlg;
        }
        
        
        /**
         * Sets the JWS algorithm for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_signed_response_alg} client
         * metadata field.
         *
         * @param authzJWSAlg The JWS algorithm, {@code null} if not specified.
         *                    Must not be {@code "none"}.
         */
        public void setAuthorizationJWSAlg(final JWSAlgorithm authzJWSAlg) {
                
                if (new JWSAlgorithm("none").equals(authzJWSAlg)) {
                        // Prevent passing none as JWS alg
                        throw new IllegalArgumentException("The JWS algorithm must not be \"none\"");
                }
                
                this.authzJWSAlg = authzJWSAlg;
        }
        
        
        /**
         * Gets the JWE algorithm for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_encrypted_response_alg}
         * client metadata field.
         *
         * @return The JWE algorithm, {@code null} if not specified.
         */
        public JWEAlgorithm getAuthorizationJWEAlg() {
                
                return authzJWEAlg;
        }
        
        
        /**
         * Sets the JWE algorithm for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_encrypted_response_alg}
         * client metadata field.
         *
         * @param authzJWEAlg The JWE algorithm, {@code null} if not specified.
         */
        public void setAuthorizationJWEAlg(final JWEAlgorithm authzJWEAlg) {
                
                this.authzJWEAlg = authzJWEAlg;
        }
        
        
        /**
         * Sets the encryption method for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_encrypted_response_enc}
         * client metadata field.
         *
         * @return The encryption method, {@code null} if specified.
         */
        public EncryptionMethod getAuthorizationJWEEnc() {
                
                return authzJWEEnc;
        }
        
        
        /**
         * Sets the encryption method for JWT-encoded authorisation responses.
         * Corresponds to the {@code authorization_encrypted_response_enc}
         * client metadata field.
         *
         * @param authzJWEEnc The encryption method, {@code null} if specified.
         */
        public void setAuthorizationJWEEnc(final EncryptionMethod authzJWEEnc) {
                
                this.authzJWEEnc = authzJWEEnc;
        }
        
        
        /**
         * Gets the requirement for pushed authorisation requests (PAR).
         * Corresponds to the {@code pushed_authorization_request_endpoint}
         * client metadata field.
         *
         * @return {@code true} if PAR is required, else {@code false}.
         */
        public boolean requiresPushedAuthorizationRequests() {
                
                return requirePAR;
        }
        
        
        /**
         * Sets the requirement for pushed authorisation requests (PAR).
         * Corresponds to the {@code pushed_authorization_request_endpoint}
         * client metadata field.
         *
         * @param requirePAR {@code true} if PAR is required, else
         *                   {@code false}.
         */
        public void requiresPushedAuthorizationRequests(final boolean requirePAR) {
                
                this.requirePAR = requirePAR;
        }


        /**
         * Gets the authorisation details types for Rich Authorisation Requests
         * (RAR). Corresponds to the {@code authorization_details_types}
         * metadata field.
         *
         * @return The authorisation types, {@code null} if not specified.
         */
        public List<AuthorizationType> getAuthorizationDetailsTypes() {

                return this.authzTypes;
        }


        /**
         * Sets the authorisation details types for Rich Authorisation Requests
         * (RAR). Corresponds to the {@code authorization_details_types}
         * metadata field.
         *
         * @param authzTypes The authorisation types, {@code null} if not
         *                   specified.
         */
        public void setAuthorizationDetailsTypes(final List<AuthorizationType> authzTypes) {

                this.authzTypes = authzTypes;
        }
        
        
        /**
         * Gets the CIBA token delivery mode. Corresponds to the
         * {@code backchannel_token_delivery_mode} metadata field.
         *
         * @return The CIBA token delivery mode, {@code null} if not
         *         specified.
         */
        public BackChannelTokenDeliveryMode getBackChannelTokenDeliveryMode() {
                
                return backChannelTokenDeliveryMode;
        }
        
        
        /**
         * Sets the CIBA token delivery mode. Corresponds to the
         * {@code backchannel_token_delivery_mode} metadata field.
         *
         * @param backChannelTokenDeliveryMode The CIBA token delivery mode,
         *                                     {@code null} if not specified.
         */
        public void setBackChannelTokenDeliveryMode(final BackChannelTokenDeliveryMode backChannelTokenDeliveryMode) {
                
                this.backChannelTokenDeliveryMode = backChannelTokenDeliveryMode;
        }
        
        
        /**
         * Gets the CIBA client notification endpoint URI for the ping or push
         * delivery modes. Corresponds to the
         * {@code backchannel_client_notification_endpoint} metadata field.
         *
         * @return The CIBA client notification endpoint URI, {@code null} if
         *         not specified.
         */
        public URI getBackChannelClientNotificationEndpoint() {
                
                return backChannelClientNotificationEndpoint;
        }
        
        
        /**
         * Sets the CIBA client notification endpoint URI for the ping or push
         * delivery modes. Corresponds to the
         * {@code backchannel_client_notification_endpoint} metadata field.
         *
         * @param backChannelClientNotificationEndpoint The CIBA client
         *                                              notification endpoint
         *                                              URI, {@code null} if
         *                                              not specified.
         */
        public void setBackChannelClientNotificationEndpoint(final URI backChannelClientNotificationEndpoint) {
                
                this.backChannelClientNotificationEndpoint = backChannelClientNotificationEndpoint;
        }
        
        
        /**
         * Gets the JWS algorithm for CIBA requests. Corresponds to the
         * {@code backchannel_authentication_request_signing_alg} metadata
         * field.
         *
         * @return The JWS algorithm for CIBA requests, {@code null} if not
         *         specified.
         */
        public JWSAlgorithm getBackChannelAuthRequestJWSAlg() {
                
                return backChannelAuthRequestJWSAlg;
        }
        
        
        /**
         * Sets the JWS algorithm for CIBA requests. Corresponds to the
         * {@code backchannel_authentication_request_signing_alg} metadata
         * field.
         *
         * @param backChannelAuthRequestJWSAlg The JWS algorithm for CIBA
         *                                     requests, {@code null} if not
         *                                     specified.
         */
        public void setBackChannelAuthRequestJWSAlg(final JWSAlgorithm backChannelAuthRequestJWSAlg) {
                
                this.backChannelAuthRequestJWSAlg = backChannelAuthRequestJWSAlg;
        }
        
        
        /**
         * Gets the support for the {@code user_code} CIBA request parameter.
         * Corresponds to the {@code backchannel_user_code_parameter} metadata
         * field.
         *
         * @return {@code true} if the {@code user_code} parameter is
         *         supported, else {@code false}.
         */
        public boolean supportsBackChannelUserCodeParam() {
                
                return backChannelUserCodeParam;
        }
        
        
        /**
         * Sets the support for the {@code user_code} CIBA request parameter.
         * Corresponds to the {@code backchannel_user_code_parameter} metadata
         * field.
         *
         * @param backChannelUserCodeParam {@code true} if the
         *                                 {@code user_code} parameter is
         *                                 supported, else {@code false}.
         */
        public void setSupportsBackChannelUserCodeParam(final boolean backChannelUserCodeParam) {
                
                this.backChannelUserCodeParam = backChannelUserCodeParam;
        }
        
        
        /**
         * Gets the supported OpenID Connect Federation 1.0 client registration
         * types. Corresponds to the {@code client_registration_types} metadata
         * field.
         *
         * @return The supported registration types, {@code null} if not
         *         specified.
         */
        public List<ClientRegistrationType> getClientRegistrationTypes() {
                
                return clientRegistrationTypes;
        }
        
        
        /**
         * Sets the supported OpenID Connect Federation 1.0 client registration
         * types. Corresponds to the {@code client_registration_types} metadata
         * field.
         *
         * @param regTypes The supported registration types, {@code null} if
         *                 not specified.
         */
        public void setClientRegistrationTypes(final List<ClientRegistrationType> regTypes) {
                
                this.clientRegistrationTypes = regTypes;
        }
        
        
        /**
         * Gets the organisation name in OpenID Connect Federation 1.0.
         * Corresponds to the {@code organization_name} metadata field.
         *
         * @return The organisation name, {@code null} if not specified.
         */
        public String getOrganizationName() {
                
                return organizationName;
        }
        
        
        /**
         * Sets the organisation name in OpenID Connect Federation 1.0.
         * Corresponds to the {@code organization_name} metadata field.
         *
         * @param organizationName The organisation name, {@code null} if not
         *                         specified.
         */
        public void setOrganizationName(final String organizationName) {
                
                this.organizationName = organizationName;
        }
        
        
        /**
         * Gets the specified custom metadata field.
         *
         * @param name The field name. Must not be {@code null}.
         *
         * @return The field value, typically serialisable to a JSON entity,
         *         {@code null} if none.
         */
        public Object getCustomField(final String name) {

                return customFields.get(name);
        }


        /**
         * Gets the custom metadata fields.
         *
         * @return The custom metadata fields, as a JSON object, empty object
         *         if none.
         */
        public JSONObject getCustomFields() {

                return customFields;
        }


        /**
         * Sets the specified custom metadata field.
         *
         * @param name  The field name. Must not be {@code null}.
         * @param value The field value. Should serialise to a JSON entity.
         */
        public void setCustomField(final String name, final Object value) {

                customFields.put(name, value);
        }


        /**
         * Sets the custom metadata fields.
         *
         * @param customFields The custom metadata fields, as a JSON object,
         *                     empty object if none. Must not be {@code null}.
         */
        public void setCustomFields(final JSONObject customFields) {

                if (customFields == null)
                        throw new IllegalArgumentException("The custom fields JSON object must not be null");

                this.customFields = customFields;
        }

        
        /**
         * Applies the client metadata defaults where no values have been
         * specified.
         *
         * <ul>
         *     <li>The response types default to {@code ["code"]}.
         *     <li>The grant types default to {@code ["authorization_code"]}.
         *     <li>The client authentication method defaults to
         *         "client_secret_basic", unless the grant type is "implicit"
         *         only.
         *     <li>The encryption method for JWT-encoded authorisation
         *         responses defaults to {@code A128CBC-HS256} if a JWE
         *         algorithm is set.
         * </ul>
         */
        public void applyDefaults() {

                if (responseTypes == null) {
                        responseTypes = new HashSet<>();
                        responseTypes.add(ResponseType.getDefault());
                }

                if (grantTypes == null) {
                        grantTypes = new HashSet<>();
                        grantTypes.add(GrantType.AUTHORIZATION_CODE);
                }

                if (authMethod == null) {

                        if (grantTypes.contains(GrantType.IMPLICIT) && grantTypes.size() == 1) {
                                authMethod = ClientAuthenticationMethod.NONE;
                        } else {
                                authMethod = ClientAuthenticationMethod.getDefault();
                        }
                }
                
                if (authzJWEAlg != null && authzJWEEnc == null) {
                        authzJWEEnc = EncryptionMethod.A128CBC_HS256;
                }
        }


        /**
         * Returns the JSON object representation of this client metadata,
         * including any custom fields.
         *
         * @return The JSON object.
         */
        public JSONObject toJSONObject() {

                return toJSONObject(true);
        }


        /**
         * Returns the JSON object representation of this client metadata.
         *
         * @param includeCustomFields {@code true} to include any custom
         *                            metadata fields, {@code false} to omit
         *                            them.
         *
         * @return The JSON object.
         */
        public JSONObject toJSONObject(final boolean includeCustomFields) {

                ensureExactlyOneCertSubjectFieldForTLSClientAuth();
                
                JSONObject o;

                if (includeCustomFields)
                        o = new JSONObject(customFields);
                else
                        o = new JSONObject();


                if (redirectURIs != null)
                        o.put("redirect_uris", URIUtils.toStringList(redirectURIs));


                if (scope != null)
                        o.put("scope", scope.toString());


                if (responseTypes != null) {

                        JSONArray rtList = new JSONArray();

                        for (ResponseType rt: responseTypes)
                                rtList.add(rt.toString());

                        o.put("response_types", rtList);
                }


                if (grantTypes != null) {

                        JSONArray grantList = new JSONArray();

                        for (GrantType grant: grantTypes)
                                grantList.add(grant.toString());

                        o.put("grant_types", grantList);
                }


                if (contacts != null) {
                        o.put("contacts", contacts);
                }


                if (! nameEntries.isEmpty()) {

                        for (Map.Entry<LangTag,String> entry: nameEntries.entrySet()) {

                                LangTag langTag = entry.getKey();
                                String name = entry.getValue();

                                if (name == null)
                                        continue;

                                if (langTag == null)
                                        o.put("client_name", entry.getValue());
                                else
                                        o.put("client_name#" + langTag, entry.getValue());
                        }
                }


                if (! logoURIEntries.isEmpty()) {

                        for (Map.Entry<LangTag,URI> entry: logoURIEntries.entrySet()) {

                                LangTag langTag = entry.getKey();
                                URI uri = entry.getValue();

                                if (uri == null)
                                        continue;

                                if (langTag == null)
                                        o.put("logo_uri", entry.getValue().toString());
                                else
                                        o.put("logo_uri#" + langTag, entry.getValue().toString());
                        }
                }


                if (! uriEntries.isEmpty()) {

                        for (Map.Entry<LangTag,URI> entry: uriEntries.entrySet()) {

                                LangTag langTag = entry.getKey();
                                URI uri = entry.getValue();

                                if (uri == null)
                                        continue;

                                if (langTag == null)
                                        o.put("client_uri", entry.getValue().toString());
                                else
                                        o.put("client_uri#" + langTag, entry.getValue().toString());
                        }
                }


                if (! policyURIEntries.isEmpty()) {

                        for (Map.Entry<LangTag,URI> entry: policyURIEntries.entrySet()) {

                                LangTag langTag = entry.getKey();
                                URI uri = entry.getValue();

                                if (uri == null)
                                        continue;

                                if (langTag == null)
                                        o.put("policy_uri", entry.getValue().toString());
                                else
                                        o.put("policy_uri#" + langTag, entry.getValue().toString());
                        }
                }


                if (! tosURIEntries.isEmpty()) {

                        for (Map.Entry<LangTag,URI> entry: tosURIEntries.entrySet()) {

                                LangTag langTag = entry.getKey();
                                URI uri = entry.getValue();

                                if (uri == null)
                                        continue;

                                if (langTag == null)
                                        o.put("tos_uri", entry.getValue().toString());
                                else
                                        o.put("tos_uri#" + langTag, entry.getValue().toString());
                        }
                }


                if (authMethod != null)
                        o.put("token_endpoint_auth_method", authMethod.toString());


                if (authJWSAlg != null)
                        o.put("token_endpoint_auth_signing_alg", authJWSAlg.getName());


                if (jwkSetURI != null)
                        o.put("jwks_uri", jwkSetURI.toString());


                if (jwkSet != null)
                        o.put("jwks", JSONObjectUtils.toJSONObject(jwkSet.toPublicJWKSet())); // prevent private keys from leaking
                
                
                if (requestObjectURIs != null)
                        o.put("request_uris", URIUtils.toStringList(requestObjectURIs));
                
                if (requestObjectJWSAlg != null)
                        o.put("request_object_signing_alg", requestObjectJWSAlg.getName());
                
                if (requestObjectJWEAlg != null)
                        o.put("request_object_encryption_alg", requestObjectJWEAlg.getName());
                
                if (requestObjectJWEEnc != null)
                        o.put("request_object_encryption_enc", requestObjectJWEEnc.getName());


                if (softwareID != null)
                        o.put("software_id", softwareID.getValue());

                if (softwareVersion != null)
                        o.put("software_version", softwareVersion.getValue());
                
                if (softwareStatement != null)
                        o.put("software_statement", softwareStatement.serialize());

                // mTLS
                if (tlsClientCertificateBoundAccessTokens)
                        o.put("tls_client_certificate_bound_access_tokens", true);
                
                if (tlsClientAuthSubjectDN != null)
                        o.put("tls_client_auth_subject_dn", tlsClientAuthSubjectDN);
                
                if (tlsClientAuthSanDNS != null)
                        o.put("tls_client_auth_san_dns", tlsClientAuthSanDNS);
                
                if (tlsClientAuthSanURI != null)
                        o.put("tls_client_auth_san_uri", tlsClientAuthSanURI);
                
                if (tlsClientAuthSanIP != null)
                        o.put("tls_client_auth_san_ip", tlsClientAuthSanIP);
                
                if (tlsClientAuthSanEmail != null)
                        o.put("tls_client_auth_san_email", tlsClientAuthSanEmail);

                // DPoP
                if (dPoPBoundAccessTokens)
                        o.put("dpop_bound_access_tokens", true);

                // JARM
                if (authzJWSAlg != null) {
                        o.put("authorization_signed_response_alg", authzJWSAlg.getName());
                }
                
                if (authzJWEAlg != null) {
                        o.put("authorization_encrypted_response_alg", authzJWEAlg.getName());
                }
                
                if (authzJWEEnc != null) {
                        o.put("authorization_encrypted_response_enc", authzJWEEnc.getName());
                }
                
                // PAR
                if (requirePAR) {
                        o.put("require_pushed_authorization_requests", true);
                }

                // RAR
                if (authzTypes != null) {
                        o.put("authorization_details_types", Identifier.toStringList(authzTypes));
                }
                
                // CIBA
                
                if (backChannelTokenDeliveryMode != null) {
                        o.put("backchannel_token_delivery_mode", backChannelTokenDeliveryMode.getValue());
                }
                
                if (backChannelClientNotificationEndpoint != null) {
                        o.put("backchannel_client_notification_endpoint", backChannelClientNotificationEndpoint.toString());
                }
                
                if (backChannelAuthRequestJWSAlg != null) {
                        o.put("backchannel_authentication_request_signing_alg", backChannelAuthRequestJWSAlg.getName());
                }
                
                if (backChannelUserCodeParam) {
                        o.put("backchannel_user_code_parameter", true);
                }
                
                // Federation
                if (CollectionUtils.isNotEmpty(clientRegistrationTypes)) {
                        o.put("client_registration_types", Identifier.toStringList(clientRegistrationTypes));
                }
                if (organizationName != null) {
                        o.put("organization_name", organizationName);
                }
                if (signedJWKSetURI != null) {
                        o.put("signed_jwks_uri", signedJWKSetURI.toString());
                }

                return o;
        }
        
        
        @Override
        public String toString() {
                return toJSONObject().toJSONString();
        }
        
        
        /**
         * Parses a client metadata instance from the specified JSON object.
         *
         * @param jsonObject The JSON object to parse. Must not be
         *                   {@code null}.
         *
         * @return The client metadata.
         *
         * @throws ParseException If the JSON object couldn't be parsed to a
         *                        client metadata instance.
         */
        public static ClientMetadata parse(final JSONObject jsonObject)
                throws ParseException {

                // Copy JSON object, then parse
                return parseFromModifiableJSONObject(new JSONObject(jsonObject));
        }


        /**
         * Parses a client metadata instance from the specified JSON object.
         *
         * @param jsonObject The JSON object to parse, will be modified by
         *                   the parse routine. Must not be {@code null}.
         *
         * @return The client metadata.
         *
         * @throws ParseException If the JSON object couldn't be parsed to a
         *                        client metadata instance.
         */
        private static ClientMetadata parseFromModifiableJSONObject(final JSONObject jsonObject)
                throws ParseException {

                ClientMetadata metadata = new ClientMetadata();

                if (jsonObject.get("redirect_uris") != null) {

                        Set<URI> redirectURIs = new LinkedHashSet<>();

                        for (String uriString: JSONObjectUtils.getStringArray(jsonObject, "redirect_uris")) {
                                URI uri;
                                try {
                                        uri = new URI(uriString);
                                } catch (URISyntaxException e) {
                                        throw new ParseException("Invalid redirect_uris parameter: " + e.getMessage(), RegistrationError.INVALID_REDIRECT_URI.appendDescription(": " + e.getMessage()));
                                }
                                redirectURIs.add(uri);
                        }
                        try {
                                metadata.setRedirectionURIs(redirectURIs);
                        } catch (IllegalArgumentException e) {
                                throw new ParseException("Invalid redirect_uris parameter: " + e.getMessage(), RegistrationError.INVALID_REDIRECT_URI.appendDescription(": " + e.getMessage()));
                        }
                        jsonObject.remove("redirect_uris");
                }

                try {

                        if (jsonObject.get("scope") != null) {
                                metadata.setScope(Scope.parse(JSONObjectUtils.getString(jsonObject, "scope")));
                                jsonObject.remove("scope");
                        }


                        if (jsonObject.get("response_types") != null) {

                                Set<ResponseType> responseTypes = new LinkedHashSet<>();

                                for (String rt : JSONObjectUtils.getStringArray(jsonObject, "response_types")) {

                                        responseTypes.add(ResponseType.parse(rt));
                                }

                                metadata.setResponseTypes(responseTypes);
                                jsonObject.remove("response_types");
                        }


                        if (jsonObject.get("grant_types") != null) {

                                Set<GrantType> grantTypes = new LinkedHashSet<>();

                                for (String grant : JSONObjectUtils.getStringArray(jsonObject, "grant_types")) {

                                        grantTypes.add(GrantType.parse(grant));
                                }

                                metadata.setGrantTypes(grantTypes);
                                jsonObject.remove("grant_types");
                        }


                        if (jsonObject.get("contacts") != null) {
                                metadata.setEmailContacts(JSONObjectUtils.getStringList(jsonObject, "contacts"));
                                jsonObject.remove("contacts");
                        }


                        // Find lang-tagged client_name params
                        Map<LangTag, Object> matches = LangTagUtils.find("client_name", jsonObject);

                        for (Map.Entry<LangTag, Object> entry : matches.entrySet()) {

                                try {
                                        metadata.setName((String) entry.getValue(), entry.getKey());

                                } catch (ClassCastException e) {

                                        throw new ParseException("Invalid client_name (language tag) parameter");
                                }

                                removeMember(jsonObject, "client_name", entry.getKey());
                        }


                        matches = LangTagUtils.find("logo_uri", jsonObject);

                        for (Map.Entry<LangTag, Object> entry : matches.entrySet()) {

                                if (entry.getValue() == null) continue;
                                
                                try {
                                        metadata.setLogoURI(new URI((String) entry.getValue()), entry.getKey());
                                } catch (Exception e) {
                                        throw new ParseException("Invalid logo_uri (language tag) parameter");
                                }

                                removeMember(jsonObject, "logo_uri", entry.getKey());
                        }


                        matches = LangTagUtils.find("client_uri", jsonObject);

                        for (Map.Entry<LangTag, Object> entry : matches.entrySet()) {
                                
                                if (entry.getValue() == null) continue;

                                try {
                                        metadata.setURI(new URI((String) entry.getValue()), entry.getKey());
                                } catch (Exception e) {
                                        throw new ParseException("Invalid client_uri (language tag) parameter: " + e.getMessage());
                                }

                                removeMember(jsonObject, "client_uri", entry.getKey());
                        }


                        matches = LangTagUtils.find("policy_uri", jsonObject);

                        for (Map.Entry<LangTag, Object> entry : matches.entrySet()) {
                                
                                if (entry.getValue() == null) continue;

                                try {
                                        metadata.setPolicyURI(new URI((String) entry.getValue()), entry.getKey());
                                } catch (Exception e) {
                                        throw new ParseException("Invalid policy_uri (language tag) parameter: " + e.getMessage());
                                }

                                removeMember(jsonObject, "policy_uri", entry.getKey());
                        }


                        matches = LangTagUtils.find("tos_uri", jsonObject);

                        for (Map.Entry<LangTag, Object> entry : matches.entrySet()) {
                                
                                if (entry.getValue() == null) continue;

                                try {
                                        metadata.setTermsOfServiceURI(new URI((String) entry.getValue()), entry.getKey());
                                } catch (Exception e) {
                                        throw new ParseException("Invalid tos_uri (language tag) parameter: " + e.getMessage());
                                }

                                removeMember(jsonObject, "tos_uri", entry.getKey());
                        }


                        if (jsonObject.get("token_endpoint_auth_method") != null) {
                                metadata.setTokenEndpointAuthMethod(ClientAuthenticationMethod.parse(
                                        JSONObjectUtils.getString(jsonObject, "token_endpoint_auth_method")));

                                jsonObject.remove("token_endpoint_auth_method");
                        }


                        if (jsonObject.get("token_endpoint_auth_signing_alg") != null) {
                                metadata.setTokenEndpointAuthJWSAlg(JWSAlgorithm.parse(
                                        JSONObjectUtils.getString(jsonObject, "token_endpoint_auth_signing_alg")));

                                jsonObject.remove("token_endpoint_auth_signing_alg");
                        }


                        if (jsonObject.get("jwks_uri") != null) {
                                metadata.setJWKSetURI(JSONObjectUtils.getURI(jsonObject, "jwks_uri"));
                                jsonObject.remove("jwks_uri");
                        }

                        if (jsonObject.get("jwks") != null) {

                                try {
                                        metadata.setJWKSet(JWKSet.parse(JSONObjectUtils.getJSONObject(jsonObject, "jwks")));

                                } catch (java.text.ParseException e) {
                                        throw new ParseException("Illegal JWK set: " + e.getMessage(), e);
                                }

                                jsonObject.remove("jwks");
                        }
                        
                        if (jsonObject.get("request_uris") != null) {
                                
                                Set<URI> requestURIs = new LinkedHashSet<>();
                                
                                for (String uriString : JSONObjectUtils.getStringArray(jsonObject, "request_uris")) {
                                        
                                        try {
                                                requestURIs.add(new URI(uriString));
                                                
                                        } catch (URISyntaxException e) {
                                                
                                                throw new ParseException("Invalid request_uris parameter");
                                        }
                                }
                                
                                metadata.setRequestObjectURIs(requestURIs);
                                jsonObject.remove("request_uris");
                        }
                        
                        if (jsonObject.get("request_object_signing_alg") != null) {
                                metadata.setRequestObjectJWSAlg(JWSAlgorithm.parse(
                                        JSONObjectUtils.getString(jsonObject, "request_object_signing_alg")));
                                
                                jsonObject.remove("request_object_signing_alg");
                        }
                        
                        if (jsonObject.get("request_object_encryption_alg") != null) {
                                metadata.setRequestObjectJWEAlg(JWEAlgorithm.parse(
                                        JSONObjectUtils.getString(jsonObject, "request_object_encryption_alg")));
                                
                                jsonObject.remove("request_object_encryption_alg");
                        }
                        
                        if (jsonObject.get("request_object_encryption_enc") != null) {
                                metadata.setRequestObjectJWEEnc(EncryptionMethod.parse(
                                        JSONObjectUtils.getString(jsonObject, "request_object_encryption_enc")));
                                
                                jsonObject.remove("request_object_encryption_enc");
                        }

                        if (jsonObject.get("software_id") != null) {
                                metadata.setSoftwareID(new SoftwareID(JSONObjectUtils.getString(jsonObject, "software_id")));
                                jsonObject.remove("software_id");
                        }

                        if (jsonObject.get("software_version") != null) {
                                // Normalize to string, in non-compliant OB profiles
                                metadata.setSoftwareVersion(new SoftwareVersion(jsonObject.get("software_version").toString()));
                                jsonObject.remove("software_version");
                        }
                        
                        if (jsonObject.get("software_statement") != null) {
                                try {
                                        metadata.setSoftwareStatement(SignedJWT.parse(JSONObjectUtils.getString(jsonObject, "software_statement")));
                                } catch (java.text.ParseException e) {
                                        throw new ParseException("Invalid software_statement JWT: " + e.getMessage());
                                }
                                jsonObject.remove("software_statement");
                        }

                        // mTLS
                        
                        if (jsonObject.get("tls_client_certificate_bound_access_tokens") != null) {
                                metadata.setTLSClientCertificateBoundAccessTokens(JSONObjectUtils.getBoolean(jsonObject, "tls_client_certificate_bound_access_tokens"));
                                jsonObject.remove("tls_client_certificate_bound_access_tokens");
                        }
                        
                        if (jsonObject.get("tls_client_auth_subject_dn") != null) {
                                metadata.setTLSClientAuthSubjectDN(JSONObjectUtils.getString(jsonObject, "tls_client_auth_subject_dn"));
                                jsonObject.remove("tls_client_auth_subject_dn");
                        }
                        
                        if (jsonObject.get("tls_client_auth_san_dns") != null) {
                                metadata.setTLSClientAuthSanDNS(JSONObjectUtils.getString(jsonObject, "tls_client_auth_san_dns"));
                                jsonObject.remove("tls_client_auth_san_dns");
                        }
                        
                        if (jsonObject.get("tls_client_auth_san_uri") != null) {
                                metadata.setTLSClientAuthSanURI(JSONObjectUtils.getString(jsonObject, "tls_client_auth_san_uri"));
                                jsonObject.remove("tls_client_auth_san_uri");
                        }
                        
                        if (jsonObject.get("tls_client_auth_san_ip") != null) {
                                metadata.setTLSClientAuthSanIP(JSONObjectUtils.getString(jsonObject, "tls_client_auth_san_ip"));
                                jsonObject.remove("tls_client_auth_san_ip");
                        }
                        
                        if (jsonObject.get("tls_client_auth_san_email") != null) {
                                metadata.setTLSClientAuthSanEmail(JSONObjectUtils.getString(jsonObject, "tls_client_auth_san_email"));
                                jsonObject.remove("tls_client_auth_san_email");
                        }
                        
                        metadata.ensureExactlyOneCertSubjectFieldForTLSClientAuth();

                        // DPoP

                        if (jsonObject.get("dpop_bound_access_tokens") != null) {
                                metadata.setDPoPBoundAccessTokens(JSONObjectUtils.getBoolean(jsonObject, "dpop_bound_access_tokens"));
                                jsonObject.remove("dpop_bound_access_tokens");
                        }

                        // JARM
                        
                        if (jsonObject.get("authorization_signed_response_alg") != null) {
                                metadata.setAuthorizationJWSAlg(JWSAlgorithm.parse(JSONObjectUtils.getString(jsonObject, "authorization_signed_response_alg")));
                                jsonObject.remove("authorization_signed_response_alg");
                        }
                        
                        if (jsonObject.get("authorization_encrypted_response_alg") != null) {
                                metadata.setAuthorizationJWEAlg(JWEAlgorithm.parse(JSONObjectUtils.getString(jsonObject, "authorization_encrypted_response_alg")));
                                jsonObject.remove("authorization_encrypted_response_alg");
                        }
                        
                        if (jsonObject.get("authorization_encrypted_response_enc") != null) {
                                metadata.setAuthorizationJWEEnc(EncryptionMethod.parse(JSONObjectUtils.getString(jsonObject, "authorization_encrypted_response_enc")));
                                jsonObject.remove("authorization_encrypted_response_enc");
                        }
                        
                        // PAR
                        if (jsonObject.get("require_pushed_authorization_requests") != null) {
                                metadata.requiresPushedAuthorizationRequests(JSONObjectUtils.getBoolean(jsonObject, "require_pushed_authorization_requests"));
                                jsonObject.remove("require_pushed_authorization_requests");
                        }

                        // RAR
                        if (jsonObject.get("authorization_details_types") != null) {
                                List<AuthorizationType> authzTypes = new LinkedList<>();
                                for (String v: JSONObjectUtils.getStringList(jsonObject, "authorization_details_types")) {
                                        if (StringUtils.isNotBlank(v)) {
                                                authzTypes.add(new AuthorizationType(v));
                                        }
                                }
                                metadata.setAuthorizationDetailsTypes(authzTypes);
                                jsonObject.remove("authorization_details_types");
                        }
                        
                        // CIBA
                        
                        if (jsonObject.get("backchannel_token_delivery_mode") != null) {
                                metadata.setBackChannelTokenDeliveryMode(BackChannelTokenDeliveryMode.parse(JSONObjectUtils.getString(jsonObject, "backchannel_token_delivery_mode")));
                                jsonObject.remove("backchannel_token_delivery_mode");
                        }
                        
                        if (jsonObject.get("backchannel_client_notification_endpoint") != null) {
                                metadata.setBackChannelClientNotificationEndpoint(JSONObjectUtils.getURI(jsonObject, "backchannel_client_notification_endpoint"));
                                jsonObject.remove("backchannel_client_notification_endpoint");
                        }
                        
                        if (jsonObject.get("backchannel_authentication_request_signing_alg") != null) {
                                metadata.setBackChannelAuthRequestJWSAlg(JWSAlgorithm.parse(JSONObjectUtils.getString(jsonObject, "backchannel_authentication_request_signing_alg")));
                                jsonObject.remove("backchannel_authentication_request_signing_alg");
                        }
                        
                        if (jsonObject.get("backchannel_user_code_parameter") != null) {
                                metadata.setSupportsBackChannelUserCodeParam(JSONObjectUtils.getBoolean(jsonObject, "backchannel_user_code_parameter"));
                                jsonObject.remove("backchannel_user_code_parameter");
                        }
                        
                        
                        // Federation
                        
                        if (jsonObject.get("client_registration_types") != null) {
                                List<ClientRegistrationType> types = new LinkedList<>();
                                for (String v: JSONObjectUtils.getStringList(jsonObject, "client_registration_types")) {
                                        types.add(new ClientRegistrationType(v));
                                }
                                metadata.setClientRegistrationTypes(types);
                                jsonObject.remove("client_registration_types");
                        }
                        
                        if (jsonObject.get("organization_name") != null) {
                                metadata.setOrganizationName(JSONObjectUtils.getString(jsonObject, "organization_name"));
                                jsonObject.remove("organization_name");
                        }
                        
                        if (jsonObject.get("signed_jwks_uri") != null) {
                                metadata.setSignedJWKSetURI(JSONObjectUtils.getURI(jsonObject, "signed_jwks_uri"));
                                jsonObject.remove("signed_jwks_uri");
                        }

                } catch (ParseException | IllegalStateException e) {
                        // Insert client_client_metadata error code so that it
                        // can be reported back to the client if we have a
                        // registration event
                        throw new ParseException(
                                e.getMessage(),
                                RegistrationError.INVALID_CLIENT_METADATA.appendDescription(ErrorObject.removeIllegalChars(": " + e.getMessage())),
                                e.getCause()
                        );
                }

                // Remove any remaining top-level client information fields
                for (String paramName: ClientInformation.getRegisteredParameterNames()) {
                        jsonObject.remove(paramName);
                }
                // The remaining fields are custom
                metadata.customFields = jsonObject;

                return metadata;
        }


        /**
         * Removes a JSON object member with the specified base name and
         * optional language tag.
         *
         * @param jsonObject The JSON object. Must not be {@code null}.
         * @param name       The base member name. Must not be {@code null}.
         * @param langTag    The language tag, {@code null} if none.
         */
        private static void removeMember(final JSONObject jsonObject, final String name, final LangTag langTag) {

                if (langTag == null)
                        jsonObject.remove(name);
                else
                        jsonObject.remove(name + "#" + langTag);
        }
}