File: keyring.rst

package info (click to toggle)
git-ubuntu 1.1-2
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 1,688 kB
  • sloc: python: 13,378; sh: 480; makefile: 2
file content (26 lines) | stat: -rw-r--r-- 1,320 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Keyring integration
===================

Some git-ubuntu subcommands (eg. ``git-ubuntu submit``) require authenticated
access to the Launchpad API. The first time you do this, you will be prompted
to authenticate in a web browser. If successful, the authenticated API key will
then be saved in your local keyring. You may be prompted for a password. This
password is used to encrypt your local keyring. If you don't yet have a local
keyring, the password you provide will be used to encrypt it. If you already
have a local keyring, the password you provide is the one required to decrypt
it.

See :doc:`/howto/keyring` for instructions on configuring keyring to use
plaintext password storage instead, to avoid getting keyring password prompts.

Implementation details
----------------------

git-ubuntu simply uses `launchpadlib
<https://help.launchpad.net/API/launchpadlib>`_ for Launchpad API access. This
library in turn uses the `Python keyring package
<https://pypi.org/project/keyring/>`_ for credential storage which is quite
configurable. If you see a password prompt, it is because the keyring package's
defaults in your particular environment require encrypted password-based
credential storage. You can configure this your needs by following the `keyring
documentation <https://pypi.org/project/keyring/>`_.