NAME

OAuthomatic::SecretStorage::Keyring - Save tokens in secure storage, using Passwd::Keyring::Auto

VERSION

version 0.0202

DESCRIPTION

Implements OAuthomatic::SecretStorage interface using Passwd::Keyring::Auto (what usually means saving data in Gnome Keyring, KDE Wallet, Windows Vault or similar secure storage).

Note that tokens are saved in slightly specific way. Whenever client key is saved, we create two entries in keyring:

    username: client_key
    password: client_secret

and

    username: "oauthomatic_client_key"
    password: client_key

The former is natural. The latter helps find what current key is (this record is not very secret but it is easier to keep it too than invent second configuration backend).

Access tokens are treated similarly:

    username: token
    password: token_secret

and

    username: "oauthomatic_token"
    password: token

ATTRIBUTES

config

OAuthomatic::Config object used to bundle various configuration params.

server

OAuthomatic::Server object used to bundle server-related configuration params.

keyring

Actual password backend in use.

Usually initialized automatically, guessing best possible password backend (according to Passwd::Keyring::Auto selection and using it's app_name and password_group attributes), but can be specified if application prefers to use sth. specific:

    keyring => Passwd::Keyring::KDEWallet->new(...))

AUTHOR

Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Marcin Kasperski.

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