Package com.nimbusds.jose

Class Header

    • Field Detail

      • MAX_HEADER_STRING_LENGTH

        public static final int MAX_HEADER_STRING_LENGTH
        The max allowed string length when parsing a JOSE header (after the BASE64URL decoding). 20K chars should be sufficient to accommodate JOSE headers with an X.509 certificate chain in the x5c header parameter.
        See Also:
        Constant Field Values

    • Constructor Detail

      • Header

        protected Header​(Algorithm alg,
                 JOSEObjectType typ,
                 String cty,
                 Set<String> crit,
                 Map<String,​Object> customParams,
                 Base64URL parsedBase64URL)
        Creates a new abstract header.
        Parameters:
        alg - The algorithm (alg) parameter. Must not be null.
        typ - The type (typ) parameter, null if not specified.
        cty - The content type (cty) parameter, null if not specified.
        crit - The names of the critical header (crit) parameters, empty set or null if none.
        customParams - The custom parameters, empty map or null if none.
        parsedBase64URL - The parsed Base64URL, null if the header is created from scratch.

      • Header

        protected Header​(Header header)
        Deep copy constructor.
        Parameters:
        header - The header to copy. Must not be null.

    • Method Detail

      • getAlgorithm

        public Algorithm getAlgorithm()
        Gets the algorithm (alg) parameter.
        Returns:
        The algorithm parameter.

      • getType

        public JOSEObjectType getType()
        Gets the type (typ) parameter.
        Returns:
        The type parameter, null if not specified.

      • getContentType

        public String getContentType()
        Gets the content type (cty) parameter.
        Returns:
        The content type parameter, null if not specified.

      • getCriticalParams

        public Set<String> getCriticalParams()
        Gets the critical header parameters (crit) parameter.
        Returns:
        The names of the critical header parameters, as a unmodifiable set, null if not specified.

      • getCustomParam

        public Object getCustomParam​(String name)
        Gets a custom (non-registered) parameter.
        Parameters:
        name - The name of the custom parameter. Must not be null.
        Returns:
        The custom parameter, null if not specified.

      • getCustomParams

        public Map<String,​Object> getCustomParams()
        Gets the custom (non-registered) parameters.
        Returns:
        The custom parameters, as a unmodifiable map, empty map if none.

      • getParsedBase64URL

        public Base64URL getParsedBase64URL()
        Gets the original Base64URL used to create this header.
        Returns:
        The parsed Base64URL, null if the header was created from scratch.

      • getIncludedParams

        public Set<String> getIncludedParams()
        Gets the names of all included parameters (registered and custom) in the header instance.
        Returns:
        The included parameters.

      • toJSONObject

        public Map<String,​Object> toJSONObject()
        Returns a JSON object representation of the header. All custom parameters are included if they serialise to a JSON entity and their names don't conflict with the registered ones.
        Returns:
        The JSON object representation of the header.

      • toString

        public String toString()
        Returns a JSON string representation of the header. All custom parameters will be included if they serialise to a JSON entity and their names don't conflict with the registered ones.
        Overrides:
        toString in class Object
        Returns:
        The JSON string representation of the header.

      • toBase64URL

        public Base64URL toBase64URL()
        Returns a Base64URL representation of the header. If the header was parsed always returns the original Base64URL (required for JWS validation and authenticated JWE decryption).
        Returns:
        The original parsed Base64URL representation of the header, or a new Base64URL representation if the header was created from scratch.

      • parseAlgorithm

        public static Algorithm parseAlgorithm​(Map<String,​Object> json)
                                throws ParseException
        Parses an algorithm (alg) parameter from the specified header JSON object. Intended for initial parsing of unsecured (plain), JWS and JWE headers.

        The algorithm type (none, JWS or JWE) is determined by inspecting the algorithm name for "none" and the presence of an "enc" parameter.

        Parameters:
        json - The JSON object to parse. Must not be null.
        Returns:
        The algorithm, an instance of Algorithm.NONE, JWSAlgorithm or JWEAlgorithm. null if not found.
        Throws:
        ParseException - If the alg parameter couldn't be parsed.

      • parse

        public static Header parse​(String jsonString,
                           Base64URL parsedBase64URL)
                    throws ParseException
        Parses a PlainHeader, JWSHeader or JWEHeader from the specified JSON object string.
        Parameters:
        jsonString - The JSON object string to parse. Must not be null.
        parsedBase64URL - The original parsed Base64URL, null if not applicable.
        Returns:
        The header.
        Throws:
        ParseException - If the specified JSON object string doesn't represent a valid header.