<spanclass="anchor"id="line-5-2"></span><spanclass="anchor"id="line-6-1"></span><pclass="line874">Non è ancora completo ma per ora offre un'interfaccia a linea di comando testata e funzionante. <spanclass="anchor"id="line-7-1"></span><spanclass="anchor"id="line-8-1"></span><pclass="line874">Se invece preferisci continuare ad usare un'interfaccia grafica leggi sotto. <spanclass="anchor"id="line-9-1"></span><spanclass="anchor"id="line-10-1"></span><pclass="line867">
<h3id="Tunnel_SSH">Tunnel SSH</h3>
<spanclass="anchor"id="line-11-1"></span><spanclass="anchor"id="line-12"></span><pclass="line874">Siccome LDAP non è esposto pubblicamente su Internet occorre accedervi da localhost tramite un tunnel SSH <spanclass="anchor"id="line-13"></span><spanclass="anchor"id="line-14"></span><pclass="line867"><spanclass="anchor"id="line-15"></span><spanclass="anchor"id="line-16"></span><pre><spanclass="anchor"id="line-1"></span>ssh -L 10389:localhost:389 mio_utente@zaphoda.unit -N -f</pre><spanclass="anchor"id="line-17"></span><spanclass="anchor"id="line-18"></span><pclass="line862">In questo modo LDAP sarà accessibile in locale sulla porta <tt>10389</tt><spanclass="anchor"id="line-19"></span><spanclass="anchor"id="line-20"></span><pclass="line867"><strong>TODO:</strong> Altra pagina della wiki su come configurare ssh per accedere al server nuovo <spanclass="anchor"id="line-21"></span><spanclass="anchor"id="line-22"></span><pclass="line867">
<h3id="Installazione">Installazione</h3>
<spanclass="anchor"id="line-23"></span><spanclass="anchor"id="line-24"></span><pclass="line862">Scarica Phi dal relativo <aclass="https"href="https://git.abbiamoundominio.org/unit/phi">repository git</a>: <spanclass="anchor"id="line-25"></span><spanclass="anchor"id="line-26"></span><pclass="line867"><spanclass="anchor"id="line-27"></span><spanclass="anchor"id="line-28"></span><spanclass="anchor"id="line-29"></span><pre><spanclass="anchor"id="line-1-1"></span>git clone https://git.abbiamoundominio.org/unit/phi
<spanclass="anchor"id="line-2"></span>cd phi</pre><spanclass="anchor"id="line-30"></span><spanclass="anchor"id="line-31"></span><pclass="line874">Crea un virtual environment (opzionale) <spanclass="anchor"id="line-32"></span><spanclass="anchor"id="line-33"></span><pclass="line867"><spanclass="anchor"id="line-34"></span><spanclass="anchor"id="line-35"></span><spanclass="anchor"id="line-36"></span><pre><spanclass="anchor"id="line-1-2"></span>virtualenv --python=/usr/bin/python3 env
<spanclass="anchor"id="line-2-1"></span>source env/bin/activate</pre><spanclass="anchor"id="line-37"></span><spanclass="anchor"id="line-38"></span><pclass="line874">E lancia il setup vero e proprio (se non stai usando il virtual environment assicurarti di lanciarlo con python3) <spanclass="anchor"id="line-39"></span><spanclass="anchor"id="line-40"></span><pclass="line867"><spanclass="anchor"id="line-41"></span><spanclass="anchor"id="line-42"></span><pre><spanclass="anchor"id="line-1-3"></span>python setup.py install</pre><spanclass="anchor"id="line-43"></span><spanclass="anchor"id="line-44"></span><pclass="line867">
<h3id="Configurazione">Configurazione</h3>
<spanclass="anchor"id="line-45"></span><spanclass="anchor"id="line-46"></span><pclass="line862">Apri il file <tt>real.yml</tt> con un editor di testo e cambia il campo <tt>port</tt> in <tt>10389</tt> e quello <tt>password</tt> con la password di root di LDAP <spanclass="anchor"id="line-47"></span><spanclass="anchor"id="line-48"></span><spanclass="anchor"id="line-49"></span><pclass="line867"><spanclass="anchor"id="line-50"></span><spanclass="anchor"id="line-51"></span><spanclass="anchor"id="line-52"></span><spanclass="anchor"id="line-53"></span><spanclass="anchor"id="line-54"></span><spanclass="anchor"id="line-55"></span><spanclass="anchor"id="line-56"></span><spanclass="anchor"id="line-57"></span><spanclass="anchor"id="line-58"></span><spanclass="anchor"id="line-59"></span><spanclass="anchor"id="line-60"></span><spanclass="anchor"id="line-61"></span><pre><spanclass="anchor"id="line-1-4"></span>ldap:
<spanclass="anchor"id="line-64"></span><spanclass="anchor"id="line-65"></span><pclass="line874">Creare un nuovo utente: <spanclass="anchor"id="line-66"></span><spanclass="anchor"id="line-67"></span><pclass="line867"><spanclass="anchor"id="line-68"></span><spanclass="anchor"id="line-69"></span><pre><spanclass="anchor"id="line-1-5"></span>src/phicli adduser luther_blisset</pre><spanclass="anchor"id="line-70"></span><spanclass="anchor"id="line-71"></span><pclass="line874">Verranno chiesti diversi campi, premendo invio vengono lasciati i valori di default <spanclass="anchor"id="line-72"></span><spanclass="anchor"id="line-73"></span><pclass="line867"><spanclass="anchor"id="line-74"></span><spanclass="anchor"id="line-75"></span><spanclass="anchor"id="line-76"></span><spanclass="anchor"id="line-77"></span><spanclass="anchor"id="line-78"></span><spanclass="anchor"id="line-79"></span><pre><spanclass="anchor"id="line-1-6"></span>Common name: [luther_blisset] Luther
<spanclass="anchor"id="line-5-1"></span>Retype password: </pre><spanclass="anchor"id="line-80"></span><spanclass="anchor"id="line-81"></span><pclass="line874">Aggiungerlo ai gruppi Wiki e Git: <spanclass="anchor"id="line-82"></span><spanclass="anchor"id="line-83"></span><pclass="line867"><spanclass="anchor"id="line-84"></span><spanclass="anchor"id="line-85"></span><spanclass="anchor"id="line-86"></span><pre><spanclass="anchor"id="line-1-7"></span>src/phicli addtogroup luther_blisset WikiUsers
<h2id="Usando_Apache_Directory_Studio_.28vecchio_metodo.29">Usando Apache Directory Studio (vecchio metodo)</h2>
<spanclass="anchor"id="line-93"></span><spanclass="anchor"id="line-94"></span><pclass="line874">I servizi offerti da zaphoda sono tutti linkati ad un'unico LDAP, presente sulla macchina stessa. <spanclass="anchor"id="line-95"></span>In attesa che <aclass="https"href="https://git.abbiamoundominio.org/unit/phi">phi</a> sia completo, e renda quindi più semplice la gestione delle utenze, possiamo operare a mano. <spanclass="anchor"id="line-96"></span><spanclass="anchor"id="line-97"></span><pclass="line862">Io non sono riuscito a far funzionare correttamente <tt>ldapvi</tt> (editor di ldap simile a <tt>vi</tt>), e ricorro quindi ad una applicazione ad interfaccia grafica: <aclass="https"href="https://directory.apache.org/studio/">ApacheDirectoryStudio</a><spanclass="anchor"id="line-98"></span><spanclass="anchor"id="line-99"></span><pclass="line874">Per installarlo su debian: <spanclass="anchor"id="line-100"></span><spanclass="anchor"id="line-101"></span><pclass="line867"><tt>sudo apt install apacheds</tt><spanclass="anchor"id="line-102"></span><spanclass="anchor"id="line-103"></span><pclass="line874">Per usarlo, dato che LDAP è bindato solo in localhost, bisogna fare un forward locale con ssh. Io uso localmente la porta 10389 per parlare alla 389 (porta di LDAP) su localhost di zaphoda: <spanclass="anchor"id="line-104"></span><spanclass="anchor"id="line-105"></span><pclass="line867"><tt>ssh -L 10389:localhost:389 mio_utente@abbiamoundominio.org -N -f</tt><spanclass="anchor"id="line-106"></span><spanclass="anchor"id="line-107"></span><spanclass="anchor"id="line-108"></span><pclass="line862">Si possono omettere <tt>-N -f</tt>, e il processo ssh non andrà in background. <spanclass="anchor"id="line-109"></span><spanclass="anchor"id="line-110"></span><spanclass="anchor"id="line-111"></span><pclass="line862">Possiamo adesso usare <aclass="nonexistent"href="./ApacheDirectoryStudio.html">ApacheDirectoryStudio</a> parlando con ldap sul nostro <tt>localhost:10389</tt>. <spanclass="anchor"id="line-112"></span><spanclass="anchor"id="line-113"></span><pclass="line867">
<spanclass="anchor"id="line-114"></span><spanclass="anchor"id="line-115"></span><pclass="line862">Dal menu in alto a sinistra, andiamo su File > New <spanclass="anchor"id="line-116"></span><spanclass="anchor"id="line-117"></span><pclass="line867"><imgalt="Main menu"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/01-menu.png"title="Main menu"/><spanclass="anchor"id="line-118"></span><spanclass="anchor"id="line-119"></span><pclass="line862">Selezioniamo LDAP Browser > LDAP Connection <spanclass="anchor"id="line-120"></span><spanclass="anchor"id="line-121"></span><pclass="line867"><imgalt="Creiamo una nuova connessione LDAP"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/02-new_menu.png"title="Creiamo una nuova connessione LDAP"/><spanclass="anchor"id="line-122"></span><spanclass="anchor"id="line-123"></span><pclass="line862">Chiamiamo la connessione come vogliamo, ad esempio <tt>zaphoda-localhost</tt> e specifichiamo i seguenti parametri di connessione: <spanclass="anchor"id="line-124"></span><spanclass="anchor"id="line-125"></span><pclass="line867"><tt>Hostname: locahost</tt><spanclass="anchor"id="line-126"></span><spanclass="anchor"id="line-127"></span><pclass="line867"><tt>Port: 10389</tt> (o la porta su cui scegliamo di fare il bind locale nel passo precedente di ssh) <spanclass="anchor"id="line-128"></span><spanclass="anchor"id="line-129"></span><pclass="line867"><tt>Encryption method: Use StartTLS extension</tt><spanclass="anchor"id="line-130"></span><spanclass="anchor"id="line-131"></span><spanclass="anchor"id="line-132"></span><pclass="line867"><imgalt="Parametri di connesione"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/03-new_ldap_conn.png"title="Parametri di connesione"/><spanclass="anchor"id="line-133"></span><spanclass="anchor"id="line-134"></span><pclass="line862">Clicchiamo Next e andiamo al pannello di inserimento delle credenziali del'utente root (<strong>quindi facciamo attenzione</strong>) <spanclass="anchor"id="line-135"></span><spanclass="anchor"id="line-136"></span><pclass="line867"><tt>User: cn=root,dc=unit,dc=macaomilano,dc=org</tt> (Nell'immagine l'utente è diverso <imgalt=":D"height="16"src="/moin_static1911/acaro/img/biggrin.png"title=":D"width="16"/> ) <spanclass="anchor"id="line-137"></span><spanclass="anchor"id="line-138"></span><pclass="line867"><tt>Password: ***************************************</tt><spanclass="anchor"id="line-139"></span><spanclass="anchor"id="line-140"></span><pclass="line867"><imgalt="Credenziali di connessione"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/04-new_ldap_conn_creds.png"title="Credenziali di connessione"/><spanclass="anchor"id="line-141"></span><spanclass="anchor"id="line-142"></span><pclass="line862">Clicchiamo su Finish. A questo punto nel pannello in basso a sinistra dovremmo vedere la nostra connessione LDAP creata con nome <tt>zaphoda-localhost</tt>. Doppio click e ci connettiamo. Se appaiono errori di certificato TLS è abbastanza normale perché LDAP presenta un certificato TLS per un nome diverso da <tt>localhost</tt>. Continuiamo e dovremmo ottenere questa lista nel pannello di sinistra in alto: <spanclass="anchor"id="line-143"></span><spanclass="anchor"id="line-144"></span><pclass="line867"><imgalt="Lista di utenti e gruppi"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/05-left_view.png"title="Lista di utenti e gruppi"/><spanclass="anchor"id="line-145"></span><spanclass="anchor"id="line-146"></span><pclass="line867">
<h3id="Aggiunta_utente">Aggiunta utente</h3>
<spanclass="anchor"id="line-147"></span><spanclass="anchor"id="line-148"></span><pclass="line862">Aprendo la voce <tt>ou=Hackers</tt> possiamo vedere la lista utenti già esistenti. <spanclass="anchor"id="line-149"></span><spanclass="anchor"id="line-150"></span><pclass="line867"><imgalt="Lista degli utenti"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/07-user_list.png"title="Lista degli utenti"/><spanclass="anchor"id="line-151"></span><spanclass="anchor"id="line-152"></span><pclass="line874">Ogni utente è una voce LDAP con i seguenti campi: <spanclass="anchor"id="line-153"></span><spanclass="anchor"id="line-154"></span><pclass="line867"><imgalt="I campi LDAP di un utente"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/08-user_fields.png"title="I campi LDAP di un utente"/><spanclass="anchor"id="line-155"></span><spanclass="anchor"id="line-156"></span><pclass="line874">Quelli in grasseto identificano il tipo di entry LDAP <spanclass="anchor"id="line-157"></span><spanclass="anchor"id="line-158"></span><ul><li><pclass="line891"><tt>inetOrgPerson</tt><spanclass="anchor"id="line-159"></span></li><li><pclass="line891"><tt>organizationalPerson</tt><spanclass="anchor"id="line-160"></span></li><li><pclass="line891"><tt>person</tt><spanclass="anchor"id="line-161"></span></li><li><pclass="line891"><tt>top</tt><spanclass="anchor"id="line-162"></span><spanclass="anchor"id="line-163"></span></li></ul><pclass="line874">e sono attributi che hanno un'utilità interna allo schema LDAP che stiamo usando. <spanclass="anchor"id="line-164"></span>I seguenti sono attributi qualificanti per l'utente: <spanclass="anchor"id="line-165"></span><spanclass="anchor"id="line-166"></span><ul><li><pclass="line891"><tt>cn</tt><spanclass="anchor"id="line-167"></span></li><li><pclass="line891"><tt>sn</tt><spanclass="anchor"id="line-168"></span></li><li><pclass="line891"><tt>mail</tt><spanclass="anchor"id="line-169"></span></li><li><pclass="line891"><tt>uid</tt><spanclass="anchor"id="line-170"></span></li><li><pclass="line891"><tt>userPassword</tt><spanclass="anchor"id="line-171"></span><spanclass="anchor"id="line-172"></span></li></ul><pclass="line862">Solitamente, <tt>cn</tt>, <tt>sn</tt> e <tt>uid</tt> hanno lo stesso valore, ma il campo <em>importante</em> è <tt>uid</tt>. <spanclass="anchor"id="line-173"></span><spanclass="anchor"id="line-174"></span><pclass="line862">Per aggiungere qualcun* possiamo cliccare su <tt>ou=Hackers</tt> col tasto destro e selezionare "New Entry". <spanclass="anchor"id="line-175"></span><spanclass="anchor"id="line-176"></span><pclass="line867"><imgalt="Nuovo utente"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/06-new_user.png"title="Nuovo utente"/><spanclass="anchor"id="line-177"></span><imgalt="Scegliamo il template"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/09-new_user_from_template_base.png"title="Scegliamo il template"/><spanclass="anchor"id="line-178"></span><spanclass="anchor"id="line-179"></span><pclass="line874">Dobbiamo aggiungere tutti i campi elencati in grassetto sopra. <spanclass="anchor"id="line-180"></span><spanclass="anchor"id="line-181"></span><pclass="line874">In alternativa possiamo clonare un utente e modicare i suoi dati. <spanclass="anchor"id="line-182"></span><spanclass="anchor"id="line-183"></span><pclass="line867"><imgalt="Usiamo un utente esistente per crearne uno nuovo"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/10-new_user_from_template_from_existing_user.png"title="Usiamo un utente esistente per crearne uno nuovo"/><spanclass="anchor"id="line-184"></span><spanclass="anchor"id="line-185"></span><pclass="line874">In questo caso avremo la lista di campi necessari a LDAP già popolata <spanclass="anchor"id="line-186"></span><spanclass="anchor"id="line-187"></span><pclass="line867"><imgalt="La lista di campi"class="attachment"src="attachment
<h3id="Aggiunta_ai_gruppi">Aggiunta ai gruppi</h3>
<spanclass="anchor"id="line-203"></span><spanclass="anchor"id="line-204"></span><pclass="line874">A questo punto possiamo aggiungere il nostro utente ai gruppi. Ci sono 5 gruppi esistenti. <spanclass="anchor"id="line-205"></span><spanclass="anchor"id="line-206"></span><pclass="line867"><imgalt="I gruppi su zaphoda"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/13-groups_list.png"title="I gruppi su zaphoda"/><spanclass="anchor"id="line-207"></span><spanclass="anchor"id="line-208"></span><pclass="line874">Quelli di interesse sono <spanclass="anchor"id="line-209"></span><spanclass="anchor"id="line-210"></span><ul><li><pclass="line891"><tt>GitUsers</tt> per accedere a git.abbiamoundominio.org <spanclass="anchor"id="line-211"></span></li><li><pclass="line891"><tt>IRCUsers</tt> per usare il quasselcore di abbiamoundominio.org <spanclass="anchor"id="line-212"></span></li><li><pclass="line891"><tt>WikiUsers</tt> per avere accesso in scrittura a questa wiki <spanclass="anchor"id="line-213"></span><spanclass="anchor"id="line-214"></span></li></ul><pclass="line874">Per aggiungere un utente ad un gruppo, selezioniamo il gruppo in questione <spanclass="anchor"id="line-215"></span><spanclass="anchor"id="line-216"></span><pclass="line867"><imgalt="Gli utenti nel gruppo WikiUsers"class="attachment"src="attachments/Come_aggiungere_un_utente_ad_LDAP/14-users_in_group.png"title="Gli utenti nel gruppo WikiUsers"/><spanclass="anchor"id="line-217"></span><spanclass="anchor"id="line-218"></span><pclass="line862">Tasto destro su members > New Value e aggiungiamo la stringa che identifica il nostro utente. Ad esempio <spanclass="anchor"id="line-219"></span><spanclass="anchor"id="line-220"></span><pclass="line867"><tt>uid=pinco,dc=unit,dc=macaomilano,dc=org</tt><spanclass="anchor"id="line-221"></span><spanclass="anchor"id="line-222"></span><pclass="line874">E abbiamo finito. <spanclass="anchor"id="line-223"></span><spanclass="anchor"id="bottom"></span></div>