O projekcie
-----------

CAS to aplikacja WWW służąca do uwierzytelniania użytkowników 
serwisów Fundacji Nowoczesna Polska. Implementuje ona protokół CAS <http://www.jasig.org/cas>
w  wersjach 1.0 i 2.0.

Wymagania
---------

* Zobacz requirements.txt

Instalacja i uruchomienie
-------------------------

1. Zainstaluj wymagane biblioteki, np. używając pip:

    pip install -r requirements.txt

2. Wypełnij bazę danych

	./manage.py migrate

3. Aby utworzyć pierwszego użytkownika, użyj komendy:

	./manage createsuperuser

5. Uruchom serwer deweloperski

	./manage.py runserver

6. Przy wdrożeniu utwórz plik `localsettings.py` i wpisz tam 
ustawienia używanej bazy danych. Do przygotowania wersji do
wdrożenia możesz użyć komendy `make deploy`.

OpenID Connect
--------------

Aplikacja działa też jako dostawca OIDC (`django-oidc-provider`),
pod adresem `/openid/` (konfiguracja: `/openid/.well-known/openid-configuration`).

Przy wdrożeniu:

* ustaw zmienną środowiskową `SITE_URL` (np. `https://cas.example.org`);
  issuer będzie wtedy `https://cas.example.org/openid`,
* jednorazowo wygeneruj klucz podpisujący: `./manage.py creatersakey`,
* klientów (usługi) dodaje się w panelu admina: OpenID Connect Provider → Clients.

Udostępniane claimy (`emails/oidc.py`): `sub` (id użytkownika), `preferred_username`
(login), `name`, `given_name`, `family_name`, `email`, `email_verified`.
