Module description
==================

This module provides a way for securely storing passwords and other secrets.

It uses D-Bus `Secret Service`_ API that is supported by GNOME Keyring
(since version 2.30) and KSecretsService.

The main classes provided are ``secretstorage.Item``, representing a secret
item (that has a *label*, a *secret* and some *attributes*) and
``secretstorage.Collection``, a place items are stored in.

SecretStorage supports most of the functions provided by Secret Service,
including creating and deleting items and collections, editing items,
locking and unlocking collections (asynchronous unlocking is also supported).

The documentation can be found on `pythonhosted.org`_.

.. _`Secret Service`: http://standards.freedesktop.org/secret-service/
.. _`pythonhosted.org`: https://pythonhosted.org/SecretStorage/

Building the module
===================

.. note::
SecretStorage supports all versions of Python since 2.6. Here we assume
that your Python version is 3.x.

SecretStorage requires these packages to work:

* `dbus-python`_;
* PyCrypto_ (also `available on PyPI`_).

To build SecretStorage, use this command::

python3 setup.py build

If you have Sphinx_ installed, you can also build the documentation::

python3 setup.py build_sphinx

.. _`dbus-python`: http://www.freedesktop.org/wiki/Software/DBusBindings/#dbus-python
.. _PyCrypto: https://www.dlitz.net/software/pycrypto/
.. _`available on PyPI`: https://pypi.python.org/pypi/pycrypto
.. _Sphinx: http://sphinx-doc.org/

Get the code
============

SecretStorage is available under BSD license. The source code can be found
on GitHub_.

.. _GitHub: https://github.com/mitya57/secretstorage

Products for ALP Marble 6.0

Marble 6.0 Rebuild

Sources are stored on https://src.opensuse.org/products/SUSE_ALP_Standard

SUSE Internal CA Certificate (mirrored from IBS)

SUSE Linux Enterprise 10 base. To be used for SLES 10 and SLED 10 packages.

This repository contains the status of SP 3.

The SDK for SLES 10 SP 3 and SLED 10 SP 3

SUSE Linux Enterprise 10 base. To be used for SLES 10 and SLED 10 packages.

This repository contains the status of SP 4.

The SDK for SLES 10 SP 4 and SLED 10 SP 4

This repository contains the status of GA.

This repository contains the status of GA.

Official released updates for SUSE Linux Enterprise 11 SP1

This project will not provide all updates. It is limited to selected updates.

This repository contains the status of GA.

Official released updates for SUSE Linux Enterprise 11 SP2

This project will not provide all updates. It is limited to selected updates.

This repository contains the status of GA.

Official released updates for SUSE Linux Enterprise 11 SP3

This project will not provide all updates. It is limited to selected updates.

The security repository provides additional openssl version 1 support, but use
this only with special care. Wrong link dependencies can lead to all kind of
malfuntion.

This repository contains the status of GA.

Official released updates for SUSE Linux Enterprise 11

This project will not provide all updates. It is limited to selected updates.

SUSE Linux Enterprise 12 Service Pack 1

SLE 12 SP1 Update

SUSE Linux Enterprise 12 Service Pack 2

SLE 12 SP2 Update

SUSE Linux Enterprise 12 Service Pack 3

SLE 12 SP3 Update