๐Ÿ“ฆ cyrozap / python-vipaccess

๐Ÿ“„ README.rst ยท 73 lines
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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73Deprecation Notice
==================

This repository is no longer maintained. Please use the fork by
`@dlenski`_: https://github.com/dlenski/python-vipaccess

python-vipaccess
================

|PyPI| |License| |Build Status| |Coverage Status|

python-vipaccess is a free and open source software (FOSS)
implementation of Symantec's VIP Access client. It is able to generate
OATH URIs and their corresponding QR codes so any TOTP-generating
application can be used as a VIP OTP token.

Right now, it only supports the bare minimum number of features of the
VIP Access provisioning protocol to work, but I might add support for
the other features at some point in the future.

You can see my original blog post
`here <https://www.cyrozap.com/2014/09/29/reversing-the-symantec-vip-access-provisioning-protocol/>`__,
in which I describe how I reverse-engineered the VIP Access application.

Dependencies
------------

-  Python 2.6, 2.7, 3.3, 3.4, 3.5
-  `image <https://pypi.python.org/pypi/image/1.3.3>`__
-  `lxml <https://pypi.python.org/pypi/lxml/3.4.0>`__
-  `oath <https://pypi.python.org/pypi/oath/1.2>`__
-  `PyCrypto <https://pypi.python.org/pypi/pycrypto/2.6.1>`__
-  `qrcode <https://pypi.python.org/pypi/qrcode/5.0.1>`__
-  `requests <https://pypi.python.org/pypi/requests/>`__

If you have ``pip`` installed on your system, you can install them with
``pip install image lxml oath PyCrypto qrcode requests``.

Installation
------------

Via pip (recommended)
~~~~~~~~~~~~~~~~~~~~~

``pip install python-vipaccess``

Manual
~~~~~~

1. Check out this repository by running
   ``git clone https://github.com/cyrozap/python-vipaccess.git``
2. Switch to the ``python-vipaccess`` directory by running
   ``cd python-vipaccess``
3. Install the ``vipaccess`` module

   -  With pip: ``pip install .``
   -  Without pip: ``python setup.py install``

Usage
-----

Execute ``vipaccess`` (it should be in your ``PATH``).

.. _@dlenski: https://github.com/dlenski
.. |PyPI| image:: https://img.shields.io/pypi/v/python-vipaccess.svg
   :target: https://pypi.python.org/pypi/python-vipaccess
.. |License| image:: https://img.shields.io/pypi/l/python-vipaccess.svg
   :target: https://www.apache.org/licenses/LICENSE-2.0.html
.. |Build Status| image:: https://travis-ci.org/cyrozap/python-vipaccess.svg?branch=master
   :target: https://travis-ci.org/cyrozap/python-vipaccess
.. |Coverage Status| image:: https://coveralls.io/repos/cyrozap/python-vipaccess/badge.svg?branch=master
   :target: https://coveralls.io/r/cyrozap/python-vipaccess?branch=master