Package openid :: Package server :: Module trustroot :: Class TrustRoot
[frames] | no frames]

Class TrustRoot

source code

object --+
         |
        TrustRoot

This class represents an OpenID trust root. The parse classmethod accepts a trust root string, producing a TrustRoot object. The method OpenID server implementers would be most likely to use is the isSane method, which checks the trust root for given patterns that indicate that the trust root is too broad or points to a local network resource.

Instance Methods [hide private]
bool isSane(self)
This method checks the to see if a trust root represents a reasonable (sane) set of URLs.
  __init__(self, unparsed, proto, wildcard, host, port, path)
x.__init__(...) initializes x; see x.__class__.__doc__ for signature
bool validateURL(self, url)
Validates a URL against this trust root.
  __repr__(self)
repr(x)
  __str__(self)
str(x)

Inherited from object: __delattr__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __setattr__


Class Methods [hide private]
NoneType or TrustRoot parse(cls, trust_root)
This method creates a TrustRoot instance from the given input, if possible.
  checkSanity(cls, trust_root_string)
str -> bool
  checkURL(cls, trust_root, url)
quick func for validating a url against a trust root.

Properties [hide private]

Inherited from object: __class__


Method Details [hide private]

parse(cls, trust_root)
Class Method

source code 

This method creates a TrustRoot instance from the given input, if possible.
Parameters:
  • trust_root (str) - This is the trust root to parse into a TrustRoot object.
Returns: NoneType or TrustRoot
A TrustRoot instance if trust_root parses as a trust root, None otherwise.

isSane(self)

source code 

This method checks the to see if a trust root represents a reasonable (sane) set of URLs. 'http://*.com/', for example is not a reasonable pattern, as it cannot meaningfully specify the site claiming it. This function attempts to find many related examples, but it can only work via heuristics. Negative responses from this method should be treated as advisory, used only to alert the user to examine the trust root carefully.
Returns: bool
Whether the trust root is sane

__init__(self, unparsed, proto, wildcard, host, port, path)
(Constructor)

source code 

x.__init__(...) initializes x; see x.__class__.__doc__ for signature
Overrides: object.__init__
(inherited documentation)

validateURL(self, url)

source code 

Validates a URL against this trust root.
Parameters:
  • url (str) - The URL to check
Returns: bool
Whether the given URL is within this trust root.

checkSanity(cls, trust_root_string)
Class Method

source code 

str -> bool

is this a sane trust root?

checkURL(cls, trust_root, url)
Class Method

source code 

quick func for validating a url against a trust root. See the TrustRoot class if you need more control.

__repr__(self)
(Representation operator)

source code 

repr(x)
Overrides: object.__repr__
(inherited documentation)

__str__(self)
(Informal representation operator)

source code 

str(x)
Overrides: object.__str__
(inherited documentation)