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)