root / snf-astakos-app / README @ 81f840be
History | View | Annotate | Download (6.1 kB)
1 | e0bfcf77 | Antony Chazapis | README |
---|---|---|---|
2 | e0bfcf77 | Antony Chazapis | ====== |
3 | e0bfcf77 | Antony Chazapis | |
4 | e0bfcf77 | Antony Chazapis | Astakos is an identity management service, built by GRNET using Django (https://www.djangoproject.com/). |
5 | e0bfcf77 | Antony Chazapis | Learn more about Astakos at: http://code.grnet.gr/projects/astakos |
6 | e0bfcf77 | Antony Chazapis | |
7 | e0bfcf77 | Antony Chazapis | Consult COPYRIGHT for licensing information. |
8 | e0bfcf77 | Antony Chazapis | |
9 | e0bfcf77 | Antony Chazapis | About Astakos application |
10 | e0bfcf77 | Antony Chazapis | ------------------------- |
11 | e0bfcf77 | Antony Chazapis | |
12 | e0bfcf77 | Antony Chazapis | This package contains the Django application that implements all identity management functions. |
13 | e0bfcf77 | Antony Chazapis | |
14 | e0bfcf77 | Antony Chazapis | How to run |
15 | e0bfcf77 | Antony Chazapis | ---------- |
16 | e0bfcf77 | Antony Chazapis | |
17 | e0bfcf77 | Antony Chazapis | Use snf-webproject to run Astakos automatically. |
18 | e0bfcf77 | Antony Chazapis | |
19 | e0bfcf77 | Antony Chazapis | To use Astakos in a custom Django project, add ``astakos.im`` to ``INSTALLED_APPS``. Astakos requires South (http://south.aeracode.org/). |
20 | e0bfcf77 | Antony Chazapis | |
21 | e0bfcf77 | Antony Chazapis | Also, add the following to your ``settings.py``:: |
22 | e0bfcf77 | Antony Chazapis | |
23 | e0bfcf77 | Antony Chazapis | TEMPLATE_CONTEXT_PROCESSORS = ( |
24 | e0bfcf77 | Antony Chazapis | ... |
25 | e0bfcf77 | Antony Chazapis | 'astakos.im.context_processors.cloudbar', |
26 | e0bfcf77 | Antony Chazapis | 'astakos.im.context_processors.im_modules', |
27 | e0bfcf77 | Antony Chazapis | 'astakos.im.context_processors.next', |
28 | e0bfcf77 | Antony Chazapis | 'astakos.im.context_processors.code', |
29 | e0bfcf77 | Antony Chazapis | 'astakos.im.context_processors.invitations') |
30 | e0bfcf77 | Antony Chazapis | |
31 | e0bfcf77 | Antony Chazapis | AUTHENTICATION_BACKENDS = ('astakos.im.auth_backends.EmailBackend', |
32 | e0bfcf77 | Antony Chazapis | 'astakos.im.auth_backends.TokenBackend') |
33 | e0bfcf77 | Antony Chazapis | |
34 | e0bfcf77 | Antony Chazapis | CUSTOM_USER_MODEL = 'astakos.im.AstakosUser' |
35 | e0bfcf77 | Antony Chazapis | |
36 | e0bfcf77 | Antony Chazapis | LOGIN_URL = '/im' |
37 | e0bfcf77 | Antony Chazapis | |
38 | e0bfcf77 | Antony Chazapis | Settings |
39 | e0bfcf77 | Antony Chazapis | -------- |
40 | e0bfcf77 | Antony Chazapis | |
41 | e0bfcf77 | Antony Chazapis | Configure in ``settings.py`` or a ``.conf`` file in ``/etc/synnefo`` if using snf-webproject. |
42 | e0bfcf77 | Antony Chazapis | |
43 | a9281516 | Sofia Papagiannaki | ============================== ============================================================================= =========================================================================================== |
44 | a9281516 | Sofia Papagiannaki | Name Default value Description |
45 | a9281516 | Sofia Papagiannaki | ============================== ============================================================================= =========================================================================================== |
46 | a9281516 | Sofia Papagiannaki | ASTAKOS_AUTH_TOKEN_DURATION one month Expiration time of newly created auth tokens |
47 | a9281516 | Sofia Papagiannaki | ASTAKOS_TWITTER_KEY Twitter ``oauth_token`` |
48 | a9281516 | Sofia Papagiannaki | ASTAKOS_TWITTER_SECRET Twitter ``oauth_token_secret`` |
49 | a9281516 | Sofia Papagiannaki | ASTAKOS_DEFAULT_USER_LEVEL 4 Default (not-invited) user level |
50 | a9281516 | Sofia Papagiannaki | ASTAKOS_INVITATIONS_PER_LEVEL {0:100, 1:2, 2:0, 3:0, 4:0} Number of user invitations per user level |
51 | a9281516 | Sofia Papagiannaki | ASTAKOS_DEFAULT_FROM_EMAIL GRNET Cloud <no-reply\@grnet.gr> ``from`` parameter passed in ``django.core.mail.send_mail`` |
52 | a9281516 | Sofia Papagiannaki | ASTAKOS_DEFAULT_CONTACT_EMAIL support\@cloud.grnet.gr Contact email |
53 | b38e85ae | Sofia Papagiannaki | ASTAKOS_DEFAULT_ADMIN_EMAIL support\@cloud.grnet.gr Administrator email to receive user creation notifications (if None disables notifications) |
54 | a9281516 | Sofia Papagiannaki | ASTAKOS_IM_MODULES ['local', 'twitter', 'shibboleth'] Signup modules |
55 | a9281516 | Sofia Papagiannaki | ASTAKOS_FORCE_PROFILE_UPDATE True Force user profile verification |
56 | a9281516 | Sofia Papagiannaki | ASTAKOS_INVITATIONS_ENABLED True Enable invitations |
57 | a9281516 | Sofia Papagiannaki | ASTAKOS_COOKIE_NAME _pithos2_a ``Key`` parameter passed in ``django.http.HttpResponse.set_cookie`` |
58 | a9281516 | Sofia Papagiannaki | ASTAKOS_COOKIE_DOMAIN None ``Domain`` parameter passed in ``django.http.HttpResponse.set_cookie`` |
59 | a9281516 | Sofia Papagiannaki | ASTAKOS_COOKIE_SECURE True ``Secure`` parameter passed in ``django.http.HttpResponse.set_cookie`` |
60 | a9281516 | Sofia Papagiannaki | ASTAKOS_IM_STATIC_URL /static/im/ URL to use when referring to static files |
61 | a9281516 | Sofia Papagiannaki | ASTAKOS_MODERATION_ENABLED True If False and invitations are not enabled newly created user will be automatically accepted |
62 | a9281516 | Sofia Papagiannaki | ASTAKOS_BASEURL \http://pithos.dev.grnet.gr Astakos baseurl |
63 | a9281516 | Sofia Papagiannaki | ASTAKOS_SITENAME GRNET Cloud Service name that appears in emails |
64 | a9281516 | Sofia Papagiannaki | ASTAKOS_CLOUD_SERVICES ({'icon': 'home-icon.png', 'id': 'cloud', 'name': 'grnet cloud', 'url': '/'}, Cloud services appear in the horizontal bar |
65 | a9281516 | Sofia Papagiannaki | {'id': 'okeanos', 'name': '~okeanos', 'url': '/okeanos.html'}, |
66 | a9281516 | Sofia Papagiannaki | {'id': 'pithos', 'name': 'pithos+', 'url': '/ui/'}) |
67 | f2cee255 | Sofia Papagiannaki | ASTAKOS_RECAPTCHA_PUBLIC_KEY Recaptcha public key obtained after registration here: http://recaptcha.net |
68 | f2cee255 | Sofia Papagiannaki | ASTAKOS_RECAPTCHA_PRIVATE_KEY Recaptcha private key obtained after registration here: http://recaptcha.net |
69 | a9281516 | Sofia Papagiannaki | ============================== ============================================================================= =========================================================================================== |
70 | e0bfcf77 | Antony Chazapis | |
71 | e0bfcf77 | Antony Chazapis | Administrator functions |
72 | e0bfcf77 | Antony Chazapis | ----------------------- |
73 | e0bfcf77 | Antony Chazapis | |
74 | e0bfcf77 | Antony Chazapis | Available as extensions to Django's command-line management utility: |
75 | e0bfcf77 | Antony Chazapis | |
76 | d01e7b22 | Antony Chazapis | =============== =========================== |
77 | d01e7b22 | Antony Chazapis | Name Description |
78 | d01e7b22 | Antony Chazapis | =============== =========================== |
79 | d01e7b22 | Antony Chazapis | activateuser Activates one or more users |
80 | d01e7b22 | Antony Chazapis | createuser Create a user |
81 | d01e7b22 | Antony Chazapis | inviteuser Invite a user |
82 | d01e7b22 | Antony Chazapis | listinvitations List invitations |
83 | d01e7b22 | Antony Chazapis | listusers List users |
84 | d01e7b22 | Antony Chazapis | modifyuser Modify a user's attributes |
85 | d01e7b22 | Antony Chazapis | showinvitation Show invitation info |
86 | d01e7b22 | Antony Chazapis | showuser Show user info |
87 | d01e7b22 | Antony Chazapis | =============== =========================== |