Automaattinen kirjautuminen Pleskiin¶

Automaattinen kirjautuminen Pleskiin on hyödyllinen integraatioissa, jotta asiakkaat, jotka ovat kirjautuneet sisään johonkin toiseen järjestelmään, voivat käyttää Pleskiä ilman toista kirjautumista.

Automaattisen kirjautumisen toteuttamiseksi tarvitset integraatioskriptin, joka sisältää XML API -pyynnön istuntotunnuksen luomiseksi kertakäyttöistä URL-osoitetta varten. Skripti kirjaa käyttäjät Pleskiin URL-osoitteella, joka sisältää jompikumpi seuraavista:

(Suositus) Istuntotunnus
(Ei suositella turvallisuussyistä) Käyttäjän tunnus ja salasana

Automaattinen kirjautuminen Pleskiin istuntotunnusten avulla¶

Muista

Tämä osio kuvaa istuntotunnuksen luomisen XML API:n kautta. Voit myös luoda istuntotunnuksen REST API:n kautta, joka tukee lisäksi MFA-kehotteen ohittamista istuntotunnuksella tehtävissä kirjautumisissa – XML API -toiminto ei tue tätä. Katso Istuntotunnusten luominen REST API:n kautta.

Automaattisen kirjautumisen määrittämiseksi istuntotunnusten avulla:

Määritä integraatioskriptisi luomaan istuntotunnus. Tehdäksesi tämän, lähetä XML API -pyyntö käyttäen create_session solmua, esimerkiksi:
```
<packet version="1.6.9.1">
  <server>
    <create_session>
      <login>admin</login>
      <data>
        <user_ip>192.0.2.1</user_ip>
        <source_server></source_server>
      </data>
    </create_session>
  </server>
</packet>
```
Seuraavien parametrien tulee sisältää omat arvosi:
- login on sen Pleskin käyttäjän tunnus, jolle sinun tarvitsee luoda istunto.
- user_ip on käyttäjän IP-osoite selkotekstinä tai koodattuna base64-muotoon (esimerkiksi MTkyLjAuMi4x).
- (Valinnainen) source_server on sen tietokoneen isäntänimi, josta pyyntö lähetetään, koodattuna base64-muotoon.
Muista

create_session-toiminto on käytettävissä Pleskin järjestelmänvalvojalle, asiakkaille ja jälleenmyyjille. Pleskin järjestelmänvalvoja voi luoda istuntotunnuksia itselleen, jälleenmyyjille ja asiakkaille; jälleenmyyjät – vain itselleen ja asiakkailleen; asiakkaat – vain itselleen.

Sen sijaan, että lähettäisit XML API -pyynnön suoraan, voit lisätä sen XML-tiedostoon ja lähettää sen curl-komennolla, esimerkiksi:
```
curl –kLi -H "Content-Type: text/xml" -H "HTTP_AUTH_LOGIN: admin" -H "HTTP_AUTH_PASSWD: password" -H "HTTP_PRETTY_PRINT: TRUE" -d @request.xml https:<server-hostname-or-ip>/enterprise/control/agent.php
```
missä
- admin ja password ovat Pleskin järjestelmänvalvojan tunnistetiedot, joilla kirjaudutaan Pleskin palvelimelle.
- request.xml on XML-tiedosto, joka sisältää XML API -pyynnön istuntotunnuksen luomiseksi (esimerkiksi yllä näkyvä pyyntö).
- server-hostname-or-ip on sen Pleskin palvelimen isäntänimi tai IP-osoite, jolle haluat luoda istuntotunnuksen.
Pleskin XML API luo istuntotunnuksen ja lähettää sen vastauksessa, esimerkiksi:
```
<?xml version="1.0" encoding="UTF-8"?>
<packet version="1.6.9.1">
  <server>
    <create_session>
      <result>
        <status>ok</status>
        <id>df9d386ee5ef13dbcd583c1f616857a2</id>
      </result>
    </create_session>
  </server>
</packet>
```
id-tunniste sisältää istuntotunnuksen (esimerkissä df9d386ee5ef13dbcd583c1f616857a2). Skripti käyttää tätä tunnusta kertakäyttöisessä URL-osoitteessa kirjautumiseen.
Skripti ohjaa käyttäjän selaimen osoitteeseen rsession_init.php ja käyttäjä kirjautuu Pleskiin. Kertakäyttöisellä kirjautumis-URL-osoitteella on seuraava rakenne:
```
https://<server-hostname-or-ip>:8443/enterprise/rsession_init.php?PLESKSESSID=<session_token>&success_redirect_url=<success_redirect_url>&failure_redirect_url=<failure_redirect_url>
```
missä:
- <server-hostname-or-ip> on sen palvelimen isäntänimi tai IP-osoite, jolle olet luonut istuntotunnuksen.
- <session_token> on luotu istuntotunnus.
Voit myös määrittää seuraavat valinnaiset parametrit:
- <success_redirect_url> on URL-osoite, johon selain ohjataan onnistuneen kirjautumisen jälkeen.
- <failure_redirect_url> on URL-osoite, johon selain ohjataan sen jälkeen, kun Pleskin istunto on umpeutunut tai käyttäjä on kirjautunut ulos.
- <locale_id> on kielialueen nimi, jota käytetään kirjautumisen yhteydessä (esimerkiksi de-DE).
Kirjautumis-URL-osoite voi näyttää seuraavalta:
```
https://192.0.2.1:8443/enterprise/rsession_init.php?PLESKSESSID=df9d386ee5ef13dbcd583c1f616857a2&success_redirect_url=/admin/customer/list
```
Muista

Suosittelemme käyttämään suhteellisia URL-osoitteita (ne alkavat merkillä /) parametreissa success_redirect_url ja failure_redirect_url, esimerkiksi: /admin/customer/list. Ohjataksesi muihin isäntänimiin kuin Pleskiin, sinun tulee käyttää absoluuttisia URL-osoitteita parametreissa (esimerkiksi example.com) sekä asetuksessa trustedRedirectHosts tiedostossa panel.ini (katso seuraava vaihe).
Jos määrität automaattisen kirjautumisen Pleskiin success_redirect_url- ja/tai failure_redirect_url-parametreilla, jotka ohjaavat muihin isäntänimiin kuin Pleskiin ja joissa on absoluuttiset URL-osoitteet, suojaa Pleskin palvelimesi avoimelta uudelleenohjaukselta. Tee se lisäämällä seuraava merkintä panel.ini-tiedostoon:
```
[security]
trustedRedirectHosts = hostname1,hostname2
```
Missä hostname1 ja hostname2 ovat luotettavia isäntänimiä, joihin sallit URL-uudelleenohjauksen success_redirect_url- ja failure_redirect_url-parametrien kautta.

Lisätietoja Pleskin suojaamisesta avoimelta uudelleenohjaukselta.

Automaattinen kirjautuminen Pleskiin tunnistetiedoilla¶

Voit myös määrittää automaattisen kirjautumisen ilman istuntotunnuksen luomista: välittämällä käyttäjän tunnuksen ja salasanan parametreina URL-osoitteessa. Turvallisuussyistä emme suosittele tätä tapaa.

Jos haluat silti käyttää sitä, kirjautumis-URL-osoitteella on seuraava rakenne:

https://<server-hostname-or-ip>:8443/login_up.php3?login_name=<login>&passwd=<password>&success_redirect_url=<success_redirect_url>&failure_redirect_url=<failure_redirect_url>

missä

<server-hostname-or-ip> on sen palvelimen isäntänimi tai IP-osoite, jolle olet luonut istuntotunnuksen.
<login> ja <password> ovat käyttäjän tunnus ja salasana vastaavasti.

Voit myös määrittää seuraavat valinnaiset parametrit:

<success_redirect_url> on URL-osoite, johon selain ohjataan onnistuneen kirjautumisen jälkeen.
<failure_redirect_url> on URL-osoite, johon selain ohjataan sen jälkeen, kun Pleskin istunto on umpeutunut tai käyttäjä on kirjautunut ulos.
<locale_id> on kielialueen nimi, jota käytetään kirjautumisen yhteydessä (esimerkiksi de-DE).