Package se.swedenconnect.opensaml.eidas.metadata

Interface MetadataLocation

All Superinterfaces:
org.opensaml.core.xml.AttributeExtensibleXMLObject, org.opensaml.saml.common.SAMLObject, org.opensaml.core.xml.XMLObject
All Known Implementing Classes:
MetadataLocationImpl
public interface MetadataLocation extends org.opensaml.saml.common.SAMLObject, org.opensaml.core.xml.AttributeExtensibleXMLObject
Definition of the MetadataLocation type. The following schema fragment defines the MetadataLocationType complex type: 
 
  <xs:complexType name="MetadataLocationType">
    <xs:sequence>
      <xs:element name="Endpoint" type="ser:MsEndpointType" minOccurs="0" maxOccurs="unbounded">
        <xs:annotation>
          <xs:documentation>
            A list of eIDAS endpoints (nodes) for the current location.
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element ref="ds:KeyInfo" minOccurs="0" maxOccurs="unbounded">
        <xs:annotation>
          <xs:documentation>
            Key material (usually a certificate) that should be used to verify the signature
            of the downloaded metadata for this metadata location.
          </xs:documentation>
        </xs:annotation>
      </xs:element>
    </xs:sequence>
    <xs:attribute name="Location" type="xs:anyURI" use="required">
      <xs:annotation>
        <xs:documentation>
          The URL from where the metadata for the endpoint(s) can be obtained.
        </xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:anyAttribute namespace="##any" processContents="lax" />
  </xs:complexType>
Author:
Martin Lindström

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    DEFAULT_ELEMENT_LOCAL_NAME
    Name of the element.
    static final QName
    DEFAULT_ELEMENT_NAME
    Default element name.
    static final String
    LOCATION_ATTR_NAME
    Attribute label for the Location attribute.
    static final String
    TYPE_LOCAL_NAME
    Local name of the XSI type.
    static final QName
    TYPE_NAME
    QName of the XSI type.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    addX509Certificate(X509Certificate certificate)
    Utility method that creates a KeyInfo object and assigns the supplied certificate to it before adding it to getKeyInfos().
    List<Endpoint>
    getEndpoints()
    Returns the list of endpoints.
    default org.opensaml.xmlsec.signature.KeyInfo
    getKeyInfo()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Use getKeyInfos() instead
    List<org.opensaml.xmlsec.signature.KeyInfo>
    getKeyInfos()
    Returns a list of the key info elements that may be used when verifying downloaded metadata.
    String
    getLocation()
    Returns the location attribute, i.e., the URL from where the metadata endpoint(s) can be obtained.
    boolean
    getSuspend()
    For the Swedish eIDAS configuration, a flag, Suspend is used to indicate whether an endpoint has been suspended.
    default void
    setKeyInfo(org.opensaml.xmlsec.signature.KeyInfo keyInfo)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Use getKeyInfos() instead and add the element to the live list
    void
    setLocation(String location)
    Assigns the location attribute, i.e., the URL from where the metadata endpoint(s) can be obtained.
    void
    setSuspend(boolean suspendFlag)
    Assigns the Suspend flag.
    default void
    setX509Certificate(X509Certificate certificate)
    Deprecated, for removal: This API element is subject to removal in a future version.

    Methods inherited from interface org.opensaml.core.xml.AttributeExtensibleXMLObject

    getUnknownAttributes

    Methods inherited from interface org.opensaml.core.xml.XMLObject

    detach, ensureDOM, getDOM, getElementQName, getIDIndex, getNamespaceManager, getNamespaces, getNoNamespaceSchemaLocation, getObjectMetadata, getOrderedChildren, getParent, getSchemaLocation, getSchemaType, hasChildren, hasParent, isNil, isNilXSBoolean, releaseChildrenDOM, releaseDOM, releaseParentDOM, resolveID, resolveIDFromRoot, setDOM, setNil, setNil, setNoNamespaceSchemaLocation, setParent, setSchemaLocation

  • Field Details

    • DEFAULT_ELEMENT_LOCAL_NAME

      static final String DEFAULT_ELEMENT_LOCAL_NAME
      Name of the element.
      See Also:

    • DEFAULT_ELEMENT_NAME

      static final QName DEFAULT_ELEMENT_NAME
      Default element name.

    • TYPE_LOCAL_NAME

      static final String TYPE_LOCAL_NAME
      Local name of the XSI type.
      See Also:

    • TYPE_NAME

      static final QName TYPE_NAME
      QName of the XSI type.

    • LOCATION_ATTR_NAME

      static final String LOCATION_ATTR_NAME
      Attribute label for the Location attribute.
      See Also:

  • Method Details

    • getEndpoints

      List<Endpoint> getEndpoints()
      Returns the list of endpoints.
      Returns:
      endpoint list

    • getKeyInfo

      @Deprecated(since="3.0.1", forRemoval=true) default org.opensaml.xmlsec.signature.KeyInfo getKeyInfo()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use getKeyInfos() instead
      Returns the key info element to be used when verifying downloaded metadata.
      Returns:
      key info element, or null

    • getKeyInfos

      List<org.opensaml.xmlsec.signature.KeyInfo> getKeyInfos()
      Returns a list of the key info elements that may be used when verifying downloaded metadata.
      Returns:
      a (possibly empty) list of key info elements

    • setKeyInfo

      @Deprecated(since="3.0.1", forRemoval=true) default void setKeyInfo(org.opensaml.xmlsec.signature.KeyInfo keyInfo)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Use getKeyInfos() instead and add the element to the live list
      Assigns the key info element to be used when verifying downloaded metadata.
      Parameters:
      keyInfo - key info element
      See Also:

    • setX509Certificate

      @Deprecated(since="3.0.1", forRemoval=true) default void setX509Certificate(X509Certificate certificate)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Utility method that creates a KeyInfo object and assigns the supplied certificate to it before invoking setKeyInfo(KeyInfo).
      Parameters:
      certificate - the X.509 certificate to assign to a key info

    • addX509Certificate

      void addX509Certificate(X509Certificate certificate)
      Utility method that creates a KeyInfo object and assigns the supplied certificate to it before adding it to getKeyInfos().
      Parameters:
      certificate - certificate the X.509 certificate to assign to a key info

    • getLocation

      String getLocation()
      Returns the location attribute, i.e., the URL from where the metadata endpoint(s) can be obtained.
      Returns:
      URL

    • setLocation

      void setLocation(String location)
      Assigns the location attribute, i.e., the URL from where the metadata endpoint(s) can be obtained.
      Parameters:
      location - URL

    • getSuspend

      boolean getSuspend()
      For the Swedish eIDAS configuration, a flag, Suspend is used to indicate whether an endpoint has been suspended. This method is just a short cut instead of using AttributeExtensibleXMLObject.getUnknownAttributes().
      Returns:
      if the Suspend flag has been set to true this method returns true, otherwise false 

    • setSuspend

      void setSuspend(boolean suspendFlag)
      Assigns the Suspend flag. See getSuspend().
      Parameters:
      suspendFlag - the suspend flag