Class: Saml::Kit::Document

Inherits:
Object
  • Object
show all
Includes:
ActiveModel::Validations, Buildable, Translatable, Trustable, XsdValidatable
Defined in:
lib/saml/kit/document.rb

Constant Summary collapse

PROTOCOL_XSD = 
File.expand_path("./xsd/saml-schema-protocol-2.0.xsd", File.dirname(__FILE__)).freeze
NAMESPACES = 
{
  "NameFormat": ::Saml::Kit::Namespaces::ATTR_SPLAT,
  "ds": ::Xml::Kit::Namespaces::XMLDSIG,
  "md": ::Saml::Kit::Namespaces::METADATA,
  "saml": ::Saml::Kit::Namespaces::ASSERTION,
  "samlp": ::Saml::Kit::Namespaces::PROTOCOL,
}.freeze
XPATH = 
[
  "/samlp:AuthnRequest",
  "/samlp:LogoutRequest",
  "/samlp:LogoutResponse",
  "/samlp:Response",
].join("|")

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Trustable

#signed?, #trusted?

Constructor Details

#initialize(xml, name:, configuration: Saml::Kit.configuration) ⇒ Document

Returns a new instance of Document.



23
24
25
26
27
 
# File 'lib/saml/kit/document.rb', line 23

def initialize(xml, name:, configuration: Saml::Kit.configuration)
  @configuration = configuration
  @content = xml
  @name = name
end

Class Method Details

.to_saml_document(xml, configuration: Saml::Kit.configuration) ⇒ Object

Returns the raw xml as a Saml::Kit SAML document.

Parameters:

  • xml (String) —

    the raw xml string.

  • configuration (Saml::Kit::Configuration) (defaults to: Saml::Kit.configuration) —

    the configuration to use for unpacking the document.



88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'lib/saml/kit/document.rb', line 88

def to_saml_document(xml, configuration: Saml::Kit.configuration)
  xml_document = ::Xml::Kit::Document.new(xml, namespaces: {
    "samlp": ::Saml::Kit::Namespaces::PROTOCOL
  })
  constructor = {
    "AuthnRequest" => Saml::Kit::AuthenticationRequest,
    "LogoutRequest" => Saml::Kit::LogoutRequest,
    "LogoutResponse" => Saml::Kit::LogoutResponse,
    "Response" => Saml::Kit::Response,
  }[xml_document.find_by(XPATH).name] || InvalidDocument
  constructor.new(xml, configuration: configuration)
rescue => error
  Saml::Kit.logger.error(error)
  InvalidDocument.new(xml, configuration: configuration)
end

Instance Method Details

#destination ⇒ Object

Returns the Destination of the SAML document.



45
46
47
 
# File 'lib/saml/kit/document.rb', line 45

def destination
  root.fetch('Destination', nil)
end

#id ⇒ Object

Returns the ID for the SAML document.



30
31
32
 
# File 'lib/saml/kit/document.rb', line 30

def id
  root.fetch('ID', nil)
end

#issue_instant ⇒ Object

Returns the Destination of the SAML document.



50
51
52
 
# File 'lib/saml/kit/document.rb', line 50

def issue_instant
  Time.parse(root['IssueInstant'])
end

#issuer ⇒ Object

Returns the Issuer for the SAML document.



35
36
37
 
# File 'lib/saml/kit/document.rb', line 35

def issuer
  root.fetch('Issuer', nil)
end

#to_h ⇒ Object

Returns the SAML document returned as a Hash.



55
56
57
 
# File 'lib/saml/kit/document.rb', line 55

def to_h
  @xml_hash ||= Hash.from_xml(content) || {}
end

#to_s ⇒ Object 



72
73
74
 
# File 'lib/saml/kit/document.rb', line 72

def to_s
  to_xml
end

#to_xhtml ⇒ Object

Returns the SAML document as an XHTML string. This is useful for rendering in a web page.



68
69
70
 
# File 'lib/saml/kit/document.rb', line 68

def to_xhtml
  Nokogiri::XML(content, &:noblanks).to_xhtml
end

#to_xml(pretty: false) ⇒ Object

Returns the SAML document as an XML string.

Parameters:

  • pretty (Boolean) (defaults to: false) —

    formats the xml or returns the raw xml.



62
63
64
 
# File 'lib/saml/kit/document.rb', line 62

def to_xml(pretty: false)
  pretty ? Nokogiri::XML(content).to_xml(indent: 2) : content
end

#version ⇒ Object

Returns the Version of the SAML document.



40
41
42
 
# File 'lib/saml/kit/document.rb', line 40

def version
  root.fetch('Version', {})
end