rdf::crypt::role::doessign(3pm) [debian man page]

RDF::Crypt::Role::DoesSign(3pm) 			User Contributed Perl Documentation			   RDF::Crypt::Role::DoesSign(3pm)

NAME

       RDF::Crypt::Role::DoesSign - signing methods

DESCRIPTION

   Object Methods
       "sign_model($model)"
	   Given an RDF::Trine::Model, returns a signature as a string.

	   The model is converted to a canonicalised N-Triples representation (see RDF::Trine::Serializer::NTriples::Canonical) with any triples
	   that cannot be canonicalised being truncated. This representation is then signed using an MD5 digest, and the resulting binary
	   signature encoded using base64.

       "generate_manifest($webid, @urls)"
	   Given a WebID that people can use to recover your public key, and a list of URLs that need signing, signs each and returns an
	   RDF::Trine::Model containing the results of processing. This can be serialised as, say, Turtle to act as an endorsement for a bunch of
	   RDF graphs.

       "sign_embed_turtle($turtle, $baseuri)"
	   Parses the given Turtle into a model, generates a signature for that and then returns the original Turtle with the signature embedded
	   as a comment. This allows the signature to sit in the same file as the data itself.

	   The base URI is used to resolve any relative URI references. Note that if a different base URI is provided when verifying the
	   signature, this may cause verification to fail. The base URI is optional.

       "sign_embed_rdfxml($xml, $baseuri)"
	   As per "sign_embed_turtle", but RDF/XML.

       "sign_embed_rdfa($html, $baseuri, \%config)"
	   Similar to "sign_embed_turtle" and "sign_embed_rdfxml". The base URI is required. A set of configuration options may be provided, which
	   will be passed along to RDF::RDFa::Parser's constructor.

	   Rather than storing the signature as an XML/HTML comment, the signature is stored on the root element as an attribute.

       "sign_text($str)"
	   Signs a literal string which may or may not have anything to do with RDF.

   Required Methods
       This role does not implement these methods, but requires classes to implement them instead:

       "sign_bytes($str)"
	   Generates a signature for an octet string.

       "SIG_MARK"
	   Returns a string used as a marker for signatures within serialised RDF.

SEE ALSO

       RDF::Crypt, RDF::Crypt::Signer.

BUGS

       Please report any bugs to <http://rt.cpan.org/>.

AUTHOR

       Toby Inkster <tobyink@cpan.org>.

COPYRIGHT

       Copyright 2010, 2012 Toby Inkster

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

DISCLAIMER OF WARRANTIES

       THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
       MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

perl v5.14.2							    2012-06-25					   RDF::Crypt::Role::DoesSign(3pm)