# Kirjautuminen

##### **Käyttäjä**

Käyttäjän kirjautuminen on tarkoitettu käyttöpäätteille. Käyttäjä kirjataan sisään ja luodaan tarvittaessa uusi sessio palvelimelle asiakasta varten.

Esimerkki:

/plc.php

POST  
 user=kayttaja  
 secret=1111

Vastaus:  
\[{"time":"1505129923"}\]

Esimerkki:

/plc.php

POST  
 user=kayttaja  
 secret=111111

Vastaus:  
\[{"error":true,"code":99,"msg":"Authentication failed"}\]

  
**HUOM!** Ilman sisäänkirjautumista ei voi käyttää mitään muuta web-rajapinnan toimintoa!

##### **Robotti**

Robottimallinen kirjautuminen suorittaa sisäänkirjautumisen palvelulle, automaattista tietojen siirtoa varten.

Käyttäjällä joka kirjautuu tällaisella avaintunnuksella (shared key) ei ole täysiä valtuuksia, mm. arvojen kirjoittaminen tietokantaan tai PLC-skriptien suorittaminen web service -rajapinnan yli ei ole sallittua.

Esimerkki:  
 /plc.php?key=12312345

Vastaus:  
\[{"time":"1505129923"}\]

Esimerkki:  
 /plc.php?key=133333335

Vastaus:  
\[{"time":"1505129923"}\]

Vastaus:  
\[{"error":true,"code":99,"msg":"Authentication failed"}\]

  
**HUOM!** Ilman sisäänkirjautumista ei voi käyttää mitään muuta web-rajapinnan toimintoa!

##### **Yhdistetty kirjautuminen ja kysely**

Shared key -autentikointiavain on mahdollista antaa suoraan mm. list- tai get-kyselyiden yhteydessä URL-parametrina, jolloin erillistä kirjautumista ei tarvita.

Esimerkki:

/plc.php?list=ioPoints/%2A&amp;key=1234512345

Vastaus:  
\[{"list":\["ioPoints\\/TK01\\/TE10","ioPoints\\/TK01\\/TE30"\]},{"time":"1505137744"}\]