Nola gaitu web-zerbitzuak erabiltzaile arruntentzat: berrikuspenen arteko aldeak

MoodleDocstik
Hona jauzi:nabigazioa, bilatu
No edit summary
 
(2 erabiltzailek tartean egindako 12 berrikusketa ez dira erakusten)
1. lerroa: 1. lerroa:
{{Itzuli gabekoak}}
{{Moodle_2.0}}Kudeatzaile batek erabiltzaile arruntentzat web-zerbitzua nola gaitzen duen azaltzen du dokumentu honek.
{{Moodle_2.0}}This document explains how an administrator set up a web service for ordinary users.
=Sarrera=
=Introduction=
Erabiltzaile bat bere segurtasun-giltzen orrira joaten da (Nire profila blokea > segurtasun-giltzak). Segurtasun-giltza lortzen du bertan (token ere esaten zaio). Giltza sartzen du Moodle-ra sartzeko kanpoko aplikazioan. Edozein unetan berritu dezake erabiltzaileak giltza lapurtu diotela uste badu. Giltza konplexua da, luzea eta sortzen zaila. Hau da web-zerbitzurako gomendatzen den autentifikazio-metodoa. Moodle kudeatzaile batek nola gaitzen duen azaltzen du dokumentu honek.
A user goes on his security keys page. He gets a security key (also called token). He enters the key on the external application accessing to Moodle. At any time, a user can reset the key if he suspects that it has been stolen. The key is complex, long and difficult to generate. This is the recommended authentication method for web service. This document explains how a Moodle administrator can set it up.


= Enable the web service in Moodle =
= Gaitu web-zerbitzua Moodle-n =
   Settings block > Site Administration > Advanced features<br/>
   Ezarpenak blokea > Gunearen kudeaketa > Funtzio aurreratuak<br/>
   Check '''Enable web services''' option and '''Save Changes'''
   Markatu '''Gaitu web-zerbitzuak''' aukera eta '''Gorde aldaketak'''
[[Image:enable_ws_option.png|800px]]
[[Image:enable_ws_option.png|800px]]


= Enable a protocol =
= Gaitu protokolo bat =
   Settings block > Site Administration > Plugins > Web services > Manage protocols<br/>
   Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kudeatu protokoloak<br/>
   Enable the desired protocol (SOAP, REST, XMLRPC, AMF, ...)
   Gaitu nahi duzun protokoloa (SOAP, REST, XMLRPC, AMF, ...)
[[Image:ws_manageprotocal_settings.png|800px]]
[[Image:ws_manageprotocal_settings.png|800px]]


= Enable capabilities to users=
= Gaitu gaitasunak erabiltzaileei=
== for create token ==
== token-a sortzeko ==
you need to set "moodle/webservice:createtoken" capability to the users
"moodle/webservice:createtoken" gaitasuna baimendu behar diezu erabiltzaileei
== for protocols ==
you need to set the activated protocol (webservice/rest:use, webservice/soap:use,...) capability to the users


= Create a service with funtions =
== protokoloetarako ==
   Settings block > Site Administration > Plugins > Web services > External Services
aktibatutako protokoloa (webservice/rest:use, webservice/soap:use,...) gaitasuna baimendu behar diezu erabiltzaileei
   Click on '''Add''' new custom service
 
= Funtzioak dituen zerbitzu bat sortu =
   Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kanpoko zerbitzuak
   Sakatu pertsonalizatutako zerbitzu berria '''Gehitu'''ri
[[Image:externlservices_settings.png|800px]]
[[Image:externlservices_settings.png|800px]]




==Add new custom service page==
==Gehitu zerbitzu-orri pertsonalizatu berria==
A service is a group of web service functions. You need to create first the service then add the function. When you create the service do not check "Authenticated users", we want all users (only the one with "moodle/webservice:createtoken" capability) to be able to use the web service. If you want you can select a required capability. Any user access a web service will be checked against it. It is just an additional and optional security layer for your own usage.
Zerbitzu bat web-zerbitzu funtzio multzo bat da. Lehenik zerbitzua sortu behar duzu eta ondoren gehitu funtzioa. Zerbitzua sortzen duzunean ez markatu "Autentifikatutako erabiltzaileak", erabiltzaile guztiak ("moodle/webservice:createtoken" gaitasuna dutenak bakarrik) web-zerbitzua erabiltzeko baimena izatea nahi dugu. Nahi izanez gero, beharrezko gaitasuna aukera dezakezu. Erabiltzaileen web-zerbitzuetarako sarrerak aztertu egingo dira egin aurretik. Aukerako segurtasun-pauso gehigarria da zeure erabilerarako.
   Enter a name, check enable
   Sartu izena, markatu gaitu
   Click on Save changes
   Sakatu Gorde aldaketak-i
[[Image:add_webservice.png|800px]]
[[Image:add_webservice.png|800px]]


==Add a function to the service ==
==Gehitu funtzioa zerbitzuari ==
   Settings block > Site Administration > Plugins > Web services > External Services<br/>
   Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kanpoko zerbitzuak<br/>
   Click on the Functions link for the newly created service
   Sakatu Funtzioak estekari sortu berri den zerbitzurako




===Service functions page===
===Zerbitzuen funtzioen orria===
   Select Add function operation, then select a function and Save changes
   Aukeratu Gehitu funtzioa eragiketa eta ondoren, aukeratu funtzioa eta Gorde aldaketak
[[Image:wsfunctionadmin.png|800px]]
[[Image:wsfunctionadmin.png|800px]]


[[Image:selectservicefunction.png|800px]]
[[Image:selectservicefunction.png|800px]]


= Erabiltzaileak web-zerbitzuen orrira joaten dira auto token-a lortzeko=
Zorionak, web-zerbitzua ezarrita dago. Erabiltzaileak euren profilaren blokera joan daitezke orain eta euren segurtasun-giltzak eskuratu. Erabiltzailea lehen aldiz "segurtasun-giltzen" orrira joaten denean, giltza sortu egingo zaio.


 
[[Category:Web-zerbitzuak]]
= Users visit web service page to get auto token=
Congratulation, the web service are set up. The users will now go on their profil block and access their security keys. The first time a user access the "security keys" page, his key is created.
 
[[Category:Web zerbitzuak]]


[[en:How to enable web services for ordinary users]]
[[en:How to enable web services for ordinary users]]

Hauxe da oraingo bertsioa, 08:11, 4 Martxoa 2010 data duena

Moodle 2.0

Kudeatzaile batek erabiltzaile arruntentzat web-zerbitzua nola gaitzen duen azaltzen du dokumentu honek.

Sarrera

Erabiltzaile bat bere segurtasun-giltzen orrira joaten da (Nire profila blokea > segurtasun-giltzak). Segurtasun-giltza lortzen du bertan (token ere esaten zaio). Giltza sartzen du Moodle-ra sartzeko kanpoko aplikazioan. Edozein unetan berritu dezake erabiltzaileak giltza lapurtu diotela uste badu. Giltza konplexua da, luzea eta sortzen zaila. Hau da web-zerbitzurako gomendatzen den autentifikazio-metodoa. Moodle kudeatzaile batek nola gaitzen duen azaltzen du dokumentu honek.

Gaitu web-zerbitzua Moodle-n

  Ezarpenak blokea > Gunearen kudeaketa > Funtzio aurreratuak
Markatu Gaitu web-zerbitzuak aukera eta Gorde aldaketak

enable ws option.png

Gaitu protokolo bat

  Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kudeatu protokoloak
Gaitu nahi duzun protokoloa (SOAP, REST, XMLRPC, AMF, ...)

ws manageprotocal settings.png

Gaitu gaitasunak erabiltzaileei

token-a sortzeko

"moodle/webservice:createtoken" gaitasuna baimendu behar diezu erabiltzaileei

protokoloetarako

aktibatutako protokoloa (webservice/rest:use, webservice/soap:use,...) gaitasuna baimendu behar diezu erabiltzaileei

Funtzioak dituen zerbitzu bat sortu

  Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kanpoko zerbitzuak
  Sakatu pertsonalizatutako zerbitzu berria Gehituri

externlservices settings.png


Gehitu zerbitzu-orri pertsonalizatu berria

Zerbitzu bat web-zerbitzu funtzio multzo bat da. Lehenik zerbitzua sortu behar duzu eta ondoren gehitu funtzioa. Zerbitzua sortzen duzunean ez markatu "Autentifikatutako erabiltzaileak", erabiltzaile guztiak ("moodle/webservice:createtoken" gaitasuna dutenak bakarrik) web-zerbitzua erabiltzeko baimena izatea nahi dugu. Nahi izanez gero, beharrezko gaitasuna aukera dezakezu. Erabiltzaileen web-zerbitzuetarako sarrerak aztertu egingo dira egin aurretik. Aukerako segurtasun-pauso gehigarria da zeure erabilerarako.

  Sartu izena, markatu gaitu
  Sakatu Gorde aldaketak-i

add webservice.png

Gehitu funtzioa zerbitzuari

  Ezarpenak blokea > Gunearen kudeaketa > Pluginak > Web-zerbitzuak > Kanpoko zerbitzuak
Sakatu Funtzioak estekari sortu berri den zerbitzurako


Zerbitzuen funtzioen orria

  Aukeratu Gehitu funtzioa eragiketa eta ondoren, aukeratu funtzioa eta Gorde aldaketak

wsfunctionadmin.png

selectservicefunction.png

Erabiltzaileak web-zerbitzuen orrira joaten dira auto token-a lortzeko

Zorionak, web-zerbitzua ezarrita dago. Erabiltzaileak euren profilaren blokera joan daitezke orain eta euren segurtasun-giltzak eskuratu. Erabiltzailea lehen aldiz "segurtasun-giltzen" orrira joaten denean, giltza sortu egingo zaio.