com.onelogin.saml2.settings

Class IdPMetadataParser

java.lang.Object

com.onelogin.saml2.settings.IdPMetadataParser

public class IdPMetadataParser
extends Object

IdPMetadataParser class of OneLogin's Java Toolkit. A class that implements the settings parser from IdP Metadata This class does not validate in any way the URL that is introduced, make sure to validate it properly before use it in a get_metadata method.

Constructor Summary

Constructors

Constructor and Description
IdPMetadataParser()

Method Summary

Modifier and Type	Method and Description
static Saml2Settings	injectIntoSettings(Saml2Settings settings, Map<String,Object> metadataInfo) Inject metadata info into Saml2Settings
static Map<String,Object>	parseFileXML(String xmlFileName) Get IdP Metadata Info from XML file
static Map<String,Object>	parseFileXML(String xmlFileName, String entityId) Get IdP Metadata Info from XML file
static Map<String,Object>	parseFileXML(String xmlFileName, String entityId, String desiredNameIdFormat, String desiredSSOBinding, String desiredSLOBinding) Get IdP Metadata Info from XML file
static Map<String,Object>	parseRemoteXML(URL xmlURL) Get IdP Metadata Info from XML file
static Map<String,Object>	parseRemoteXML(URL xmlURL, String entityId) Get IdP Metadata Info from XML file
static Map<String,Object>	parseRemoteXML(URL xmlURL, String entityId, String desiredNameIdFormat, String desiredSSOBinding, String desiredSLOBinding) Get IdP Metadata Info from XML file
static Map<String,Object>	parseXML(Document xmlDocument) Get IdP Metadata Info from XML Document
static Map<String,Object>	parseXML(Document xmlDocument, String entityId) Get IdP Metadata Info from XML Document
static Map<String,Object>	parseXML(Document xmlDocument, String entityId, String desiredNameIdFormat, String desiredSSOBinding, String desiredSLOBinding) Get IdP Metadata Info from XML Document

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IdPMetadataParser

public IdPMetadataParser()

Method Detail

parseXML

public static Map<String,Object> parseXML(Document xmlDocument,
                                          String entityId,
                                          String desiredNameIdFormat,
                                          String desiredSSOBinding,
                                          String desiredSLOBinding)
                                   throws XPathException

Get IdP Metadata Info from XML Document

Parameters:

xmlDocument - XML document hat contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

desiredNameIdFormat - If available on IdP metadata, use that nameIdFormat

desiredSSOBinding - Parse specific binding SSO endpoint.

desiredSLOBinding - Parse specific binding SLO endpoint.

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

XPathExpressionException

XPathException

parseXML

public static Map<String,Object> parseXML(Document xmlDocument,
                                          String entityId)
                                   throws XPathException

Get IdP Metadata Info from XML Document

Parameters:

xmlDocument - XML document that contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

XPathException

parseXML

public static Map<String,Object> parseXML(Document xmlDocument)
                                   throws XPathException

Get IdP Metadata Info from XML Document

Parameters:

xmlDocument - XML document that contains IdP metadata

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

XPathException

parseFileXML

public static Map<String,Object> parseFileXML(String xmlFileName,
                                              String entityId,
                                              String desiredNameIdFormat,
                                              String desiredSSOBinding,
                                              String desiredSLOBinding)
                                       throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlFileName - Filename of the XML filename that contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

desiredNameIdFormat - If available on IdP metadata, use that nameIdFormat

desiredSSOBinding - Parse specific binding SSO endpoint.

desiredSLOBinding - Parse specific binding SLO endpoint.

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

parseFileXML

public static Map<String,Object> parseFileXML(String xmlFileName,
                                              String entityId)
                                       throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlFileName - Filename of the XML filename that contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

parseFileXML

public static Map<String,Object> parseFileXML(String xmlFileName)
                                       throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlFileName - Filename of the XML filename that contains IdP metadata

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

parseRemoteXML

public static Map<String,Object> parseRemoteXML(URL xmlURL,
                                                String entityId,
                                                String desiredNameIdFormat,
                                                String desiredSSOBinding,
                                                String desiredSLOBinding)
                                         throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlURL - URL to the XML document that contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

desiredNameIdFormat - If available on IdP metadata, use that nameIdFormat

desiredSSOBinding - Parse specific binding SSO endpoint.

desiredSLOBinding - Parse specific binding SLO endpoint.

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

parseRemoteXML

public static Map<String,Object> parseRemoteXML(URL xmlURL,
                                                String entityId)
                                         throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlURL - URL to the XML document that contains IdP metadata

entityId - Entity Id of the desired IdP, if no entity Id is provided and the XML metadata contains more than one IDPSSODescriptor, the first is returned

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

parseRemoteXML

public static Map<String,Object> parseRemoteXML(URL xmlURL)
                                         throws Exception

Get IdP Metadata Info from XML file

Parameters:

xmlURL - URL to the XML document that contains IdP metadata

Returns:

Mapped values with metadata info in Saml2Settings format

Throws:

Exception

injectIntoSettings

public static Saml2Settings injectIntoSettings(Saml2Settings settings,
                                               Map<String,Object> metadataInfo)

Inject metadata info into Saml2Settings

Parameters:

settings - the Saml2Settings object

metadataInfo - mapped values with metadata info in Saml2Settings format

Returns:

the Saml2Settings object with metadata info settings loaded