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:

  1. 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.

  2. 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).

  3. 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).