Forum Centralne

Opis użycia integracjo-autoryzacji.

Słowem wstępu:
System obecnie wspiera dwie podstawowe akcje: autoryzację oraz pobranie podstawowych danych mieszkańca. W przyszłości zostaną dodane kolejne opcje jak np przelewy, publikacje itp, w zależności od zapotrzebowania.

Instalacja:
1. Pobieramy pliki ze strony http://www.sarmacja.org/_integracja/autoryzacjav2.zip

Archiwum zawiera 2 pliki:

a) autoryzacja.php - jest to główny plik integracyjny. Należy go wrzucić gdzieś na swój serwer/konto i dalej można zapomnieć o nim. Uprasza się raczej o nie zmienianie w nim nic.

b) example.php - jest to plik z przykładowym użyciem integracji. Należy go oczywiście dostosować do swoich potrzeb. Każda linijka została opisana, tak więc specjalnie wywodzić się tutaj nie będę. Plik zawiera wszystkie obecnie dostępne opcje integracjo-autoryzacji.

2. Zakładamy instytucję, bądź korzystamy z już istniejącej. Wchodzimy w edycję profilu instytucji i generujemy hasło naszej aplikacji - przydatne tylko w przypadku autoryzacji.

3. Uruchamiamy i cieszymy się początkowo działającą integracją.

W razie jakiś pytań / niejasności zapraszam na FB, bądź priv, a w miarę czasu chętnie wytłumaczę / pomogę. Co ciekawsze i warte wspomnienia pytania będą tutaj umieszczane dla pokoleń.

Informuje się iż zaktualizowane zostały pliki integracyjne, które nadal dostępne są pod adresem:

http://www.sarmacja.org/_integracja/autoryzacjav2.zip

Przypomina się o konieczności aktualizacji pliku autoryzacja.php. Nowa wersja poprawia nieco pewne błędy poprzedniczki przez co autoryzacja na starych plikach nie będzie działać.

Ponownie w pliku ja.php znajdują się przykłady użycia wszystkich funkcjonalności integracji. Obecnie są to:
- pobranie informacji o użytkowniku
- autoryzacja
- wysłanie powiadomienia
- dokonanie przelewu od aplikacji do użytkownika
- dokonanie przelewu od użytkownika do aplikacji

Ponownie uprasza się o niemodyfikowanie pliku autoryzacja (pozwoli to na szybsze wprowadzanie zmian przez użytkownika).
Również jeżeli występowały by jakieś błędy, bądź istniało by jakieś niezrozumienie działania skryptów - zapraszam na PW w celu pomocy :)

Pozdrawiam i życzę miłej zabawy.

Edit:
Dopisując. Po pobraniu danych mieszkańca mamy parametr [status] z przedziału 0-8
0 - użytkownik nie zweryfikował się w KS
1 - mieszkaniec KS
2 - obywatel KS
3 - Były obywatel — 30 dni nieobecności w systemie informatycznym,
4 - Były obywatel — zrzeczenie się obywatelstwa,
5 - Były obywatel — brak udziału w wyborach lub referendum,
6 - Były obywatel — oświadczenie o opuszczeniu Sarmacji,
7 - Były obywatel — pozbawienie obywatelstwa przez Księcia,
8 - Były obywatel — przyczyna nieustalona.

Informacja Dodatkowa:

W pliku Autoryzacja.php znajduje się gdzieś na początku linijka podobna do:

Kod: Zaznacz cały

session_save_path('/home/users/sarmacja_system/www/_integracja/testSess/');

Należy ją usunąć dla poprawnego działania programu. Moje przeoczenie, zapomniałem usunąć :)

Wydano nową wersję Integracji.

Zmiany:
- Plik główny integracji autoryzacja.php nie uległ zmianie
- Plik z przykładowymi możliwościami (ja.php) integracji został rozszerzony o nowe obowiązujące już funkcje.

Informuje się o możliwości zewnętrznego zarządzania grupami na forum:

Kod: Zaznacz cały

//Zarządzanie grupami:
$inputArray = array(
              'groupId' => 109, // id grupy na forum
              'secureKey' => 'klucz', // klucz ustalany przez NIA na prośbę zainteresowanego
              'groupMembers' => array('A7782', 'A0062', 'AD468', 'A7169') // lista paszportów wszystkich członków grupy
);
$app->ogolnaIntegracja($inputArray, 'editForumGroup');
print_r($app->getWynik());

Tymczasowa autoryzacja.php: http://www.sarmacja.org/_integracja/autoryzacjav2.zip

Działa autoryzacja, działają przelewy. Tyle sprawdziłem. A czego najlepszym dowodem jest działająca karczma i zdrapka czarnoleska.

Teoretycznie wszystko inne również powinno działać (mam tu na myśli integrację pod względem funkcjonalnym, nie: wszystkie serwisy używające integrację).

Jak Diuk Avril wróci z wojaży, to powinien przygotować piękną i finalną wersję. Póki co musi działać ten szybki workaround z mojej strony.

Kolejna dodatkowa informacja.

Wprowadzono obsługę nowej akcji "dodajOsiagniecie"
Wymaga ona dwóch parametrów:
paszport
idOsiagniecia (numer z naszej bazy)

Aplikacja ma prawo do dodawania tylko swoich osiagnięć i takie powiązanie istnieje w naszej bazie.
Czyli... zewnętrzne osiągnięcia również muszą być u nas, mieć "nasz" numerek i być przypisane do aplikacji przez NIA.

Nie jest konieczny update skryptu autoryzacja.