OAuthomatic::SecretStorage::Keyring

- NAME
- VERSION
- DESCRIPTION
- ATTRIBUTES
  - config
  - server
  - keyring
- AUTHOR
- COPYRIGHT AND LICENSE

# NAME

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

# VERSION

version 0.01

# 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.