Revision e0bfcf77

/dev/null
1
Copyright 2011-2012 GRNET S.A. All rights reserved.
2

  
3
Redistribution and use in source and binary forms, with or
4
without modification, are permitted provided that the following
5
conditions are met:
6

  
7
  1. Redistributions of source code must retain the above
8
     copyright notice, this list of conditions and the following
9
     disclaimer.
10

  
11
  2. Redistributions in binary form must reproduce the above
12
     copyright notice, this list of conditions and the following
13
     disclaimer in the documentation and/or other materials
14
     provided with the distribution.
15

  
16
THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
17
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
20
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
21
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
22
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
23
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
24
AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
26
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27
POSSIBILITY OF SUCH DAMAGE.
28

  
29
The views and conclusions contained in the software and
30
documentation are those of the authors and should not be
31
interpreted as representing official policies, either expressed
32
or implied, of GRNET S.A.
/dev/null
1
README
2
======
3

  
4
Astakos is an identity management service, built by GRNET using Django (https://www.djangoproject.com/).
5
Learn more about Astakos at: http://code.grnet.gr/projects/astakos
6
Consult LICENSE for licensing information.
7

  
8
Documentation
9
-------------
10

  
11
All docs are in the docs/source directory. The .rst files are perfectly readable in source form.
12

  
13
To build the documentation you need to have Sphinx (http://sphinx.pocoo.org/) installed.
14

  
15
On a typical debian-based Linux system run:
16
    apt-get install python-django python-django-south python-setuptools python-sphinx python-httplib2
17

  
18
Then run:
19
    python setup.py build_sphinx
20

  
21
The documentation will be built in the docs/build/html directory.
22

  
23
Also run:
24
    python setup.py build_sphinx -b text
25

  
26
Then find the plain text version of the docs in docs/build/text.
27

  
28
Running the server
29
------------------
30

  
31
Make sure you have all required packages installed:
32
    apt-get install python-django python-django-south python-setuptools python-sphinx python-httplib2
33

  
34
Then run:
35
    python manage.py syncdb
36
    python manage.py migrate im
37
    python manage.py loaddata admin_user
38
    python manage.py runserver
39

  
40
This server is useful during development, but should not be used for deployment.
41
To deploy Astakos using Apache, take a look at the Administrator Guide in docs.
b/snf-astakos-app/COPYRIGHT
1
Copyright 2011 GRNET S.A. All rights reserved.
1
Copyright 2011-2012 GRNET S.A. All rights reserved.
2 2

  
3 3
Redistribution and use in source and binary forms, with or
4 4
without modification, are permitted provided that the following
b/snf-astakos-app/README
1
README
2
======
3

  
4
Astakos is an identity management service, built by GRNET using Django (https://www.djangoproject.com/).
5
Learn more about Astakos at: http://code.grnet.gr/projects/astakos
6

  
7
Consult COPYRIGHT for licensing information.
8

  
9
About Astakos application
10
-------------------------
11

  
12
This package contains the Django application that implements all identity management functions.
13

  
14
How to run
15
----------
16

  
17
Use snf-webproject to run Astakos automatically.
18

  
19
To use Astakos in a custom Django project, add ``astakos.im`` to ``INSTALLED_APPS``. Astakos requires South (http://south.aeracode.org/).
20

  
21
Also, add the following to your ``settings.py``::
22

  
23
    TEMPLATE_CONTEXT_PROCESSORS = (
24
        ...
25
        'astakos.im.context_processors.cloudbar',
26
        'astakos.im.context_processors.im_modules',
27
        'astakos.im.context_processors.next',
28
        'astakos.im.context_processors.code',
29
        'astakos.im.context_processors.invitations')
30
    
31
    AUTHENTICATION_BACKENDS = ('astakos.im.auth_backends.EmailBackend',
32
                               'astakos.im.auth_backends.TokenBackend')
33
    
34
    CUSTOM_USER_MODEL = 'astakos.im.AstakosUser'
35
    
36
    LOGIN_URL = '/im'
37

  
38
Settings
39
--------
40

  
41
Configure in ``settings.py`` or a ``.conf`` file in ``/etc/synnefo`` if using snf-webproject.
42

  
43
===============================  ================================================  ============================================================
44
Name                             Default value                                     Description
45
===============================  ================================================  ============================================================
46
...
47
===============================  ================================================  ============================================================
48

  
49
Administrator functions
50
-----------------------
51

  
52
Available as extensions to Django's command-line management utility:
53

  
54
============  ======================
55
Name          Description
56
============  ======================
57
...
58
============  ======================
59

  
1 60

  
b/snf-astakos-app/astakos/im/settings.py
1 1
from django.conf import settings
2
from os.path import abspath, dirname, join
3
from urlparse import urlparse
4 2

  
5 3
# Set the expiration time of newly created auth tokens
6 4
# to be this many hours after their creation time.

Also available in: Unified diff