focal (3) WebAuth::KeyringEntry.3pm.gz

NAME

       WebAuth::KeyringEntry - A single entry in a WebAuth::Keyring

SYNOPSIS

           use WebAuth ();
           use WebAuth::Keyring ();

           my $wa = WebAuth->new;
           eval {
               $ring = WebAuth::Keyring->read ($wa, '/path/to/keyring');
               my @entries = $ring->entries;
               for my $entry (@entries) {
                   print $entry->creation, ' ', $entry->valid_after, "\n";
               }
           };
           if ($@) {
               # handle exception
           }

DESCRIPTION

       A WebAuth::KeyringEntry represents a single entry in a WebAuth::Keyring.  Calling the entries() method on
       a WebAuth::Keyring in an array context returns a list of these objects.  They encapsulate the
       WebAuth::Key and the additional metadata about that key stored in a keyring, specifically the creation
       and valid-after timestamps.

       This object is always read-only.

       A WebAuth::KeyringEntry object will be destroyed when the corresponding WebAuth::Keyring object is
       destroyed, which in turn will happen when the WebAuth context used to create it is destroyed.  Subsequent
       accesses to it may cause memory access errors or other serious bugs.  Be careful not to retain a copy of
       a WebAuth::KeyringEntry object after the enclosing objects that created it have been destroyed.

INSTANCE METHODS

       creation ()
           Returns the creation time of the key in seconds since epoch.

       key ()
           Returns the key of this entry as a WebAuth::Key object.

       valid_after ()
           Returns the valid-after time of the key in seconds since epoch.  For more information about how the
           valid-after time is used, see the documentation of the add() and best_key() methods of
           WebAuth::Keyring.

AUTHOR

       Russ Allbery <eagle@eyrie.org>

SEE ALSO

       WebAuth(3), WebAuth::Key(3), WebAuth::Keyring(3)

       This module is part of WebAuth.  The current version is available from <http://webauth.stanford.edu/>.

COPYRIGHT AND LICENSE

       Copyright 2012 The Board of Trustees of the Leland Stanford Junior University

       Copying and distribution of this file, with or without modification, are permitted in any medium without
       royalty provided the copyright notice and this notice are preserved.  This file is offered as-is, without
       any warranty.