38
szerkesztés
Módosítások
nincs szerkesztési összefoglaló
Ezen az oldalon a föderációban résztvevő IdP-k [http://eduid.hu/stats eduID-ban használt statisztikai oldalba] történő becsatornázásáról lehet olvasni.
* eduID statisztikák: [http://eduid.hu/stats http://eduid.hu/stats]
* statisztikai projektről bővebben, angolul: [[FederationStats]]
==Általában==
Egy IdP-nek naponta egyszer kell beküldenie - célszerű erre egy cront beállítani - az összesített, előző napra vonatkozó statisztikátstatisztikáit. A beküldendő fájl, amit beküld, az alább alábbi módon épül fel:
ENTITYID https://idp.niif.hu/idp/shibboleth
==Teendők==
# Kivonatoló python szkript letöltése. Jelenleg [[Média:Audit_shib._py|Shibboleth-hez]] és [[Média:Audit_ssp._py|simpleSAMLphp-hez]] készítettük el.
# A beküldendő fájlt elkészítő [[FederationStats#Running_the_log_statistics_collector|szkript]] letöltése - ugyanaz Shibboleth-hez is és impleSAMLphp-hez is, lévén a forrás, melyből dolgoznak (a fenti szkript kimenete) ugyanaz.
# Az utóbbi szkript elején meg kell adni a beállításokat.
<source lang="bash">
PARSER_COMMAND="/opt/shibboleth-idp/bin/audit_r7.py" //Az első lépésben letöltött szkript elérési útvonala
SOURCEDIR="/opt/shibboleth-idp/logs" //A statisztika alapját képző logok elérési útvonala
TARGETDIR="/tmp" //Munkakönyvtár - itt hozza létre a beküldendő fájlokat a szkript, majd beküldés után törli is őket innen
ENTITYID="idp-entity-id" //Az idp entityID-je
APIKEY="aaa..." //A 40 karakteres egyedi azonosító. Ezt az első beküldés előtt meg kell kérni: aai@niif.hu
LOCATION2PUT="http://eduid.hu/stats/import_stats" //Az eduID statisztikái ezen az url-en keresztül kerülnek fogadásra
//Az alábbi két sorban az audit logokat tartalmazó fájlnév mintáját adjuk meg - ez idp-nként változhat, az alábbi példa egy Shibboleth IdP-re vonatkozik
DATE=`date -d "yesterday" +"%Y-%m-%d"`
SOURCEFILE="$SOURCEDIR/idp-audit-$DATE.log"
</source>
Mindezek után az utóbbi szkriptet célszerű betenni egy cronjobba, mindennapi futtatással. Érdemes kora hajnali időpontot megadni, hisz ekkor már elérhetők az előző napi statisztikák, és az adott nap munkaidőben pedig már tudjuk nézegetni a beküldött adatokat :)
===Alternatív megoldás ===
Shibboleth-hez választható cstamas python szkriptje is, amely által kihagyható a shell szkriptes ügyeskedés, és minden egy python configon keresztül adható meg.
* Szkript: [[Fájl:Audit_shib_cstamas._py]]
* Példa konfig: [[Fájl:Audit_shib_cstamas.cfg]]
Használata:
review
./Audit_shib_cstamas.py -lupe -d 2010-11-28 --config Audit_shib_cstamas.cfg /tmp/idp-audit-2010-11-28.log
upload
./Audit_shib_cstamas.py -lupe -d 2010-11-28 --config Audit_shib_cstamas.cfg --up /tmp/idp-audit-2010-11-28.log
Természetesen a megfelelő beállítások után ezt is napi rendszerességgel kell lefuttatni.
Erre ime egy megoldas, ez cronjobbal vagy valami alternativ utemezovel indithato.
<source lang="bash">
#!/bin/sh
set -e
cd /ahol-a-script-van
# vagy a scriptet berakod a pathba es teljes utvonallal hivatkozol a konfigra
for i in /usr/local/shibboleth-idp-2.2.0-slo9/logs/idp-audit-201*log
do
d=$(echo $i | cut -b 53-62)
# XXX a cut -nak a datumot kell kiszednie a fajlnevbol, igy valtoztatas szukseges
./Audit_shib_cstamas.py -lupe -d $d --config Audit_shib_cstamas.cfg --up $i
gzip -v9 $i
sleep 5
done
</source>
