Plesk-käyttöoikeuksien myynti Tunniste-käyttöoikeuksien kanssa

Käytä tätä menetelmää, jos haluat myydä puhtaita Plesk-instansseja yhdessä useiden kaupallisten Tunnisteiden kanssa. Tämä menetelmä ei tue sovelluksen sisäistä ostamista.

Toteutuksen yksityiskohdat

  1. Sinulla täytyy olla sekä Plesk että jälleenmyytävät Tunnisteet saatavilla ostettavaksi verkkokaupassasi.

  2. Kun asiakas tekee tilauksen, sinun täytyy ottaa yhteyttä KA:han KA Partner API:n kautta ja pyytää tilatuille kohteille käyttöoikeuksia.

  3. KA luo pyydetyt käyttöoikeudet ja lähettää sinulle yhden aktivointikoodin näille käyttöoikeuksille. Huomaa, että KA:lla on kaksi Partner API -versiota: v1 ja v3.

    1. Partner API v1 (vanhentunut, ei suositella):

      1. Voi pyytää sekä pääasiallisen Plesk-avaimen että useita lisäavaimia Tunnisteille yhdellä kutsulla (katso createKey()).

      2. Käyttää yhtä aktivointikoodia sekä pääasialliselle Plesk-käyttöoikeudelle että kaikille lisäkäyttöoikeusavaimille.

    2. Partner API v3 (suositeltu):

      1. Voi pyytää vain yhden avaimen (joko pääasiallisen Plesk-avaimen tai Tunnisteen lisäavaimen) yhdellä kutsulla (katso Käyttöoikeusavaimen luominen).

      2. Käyttää yhtä aktivointikoodia sekä pääasialliselle Plesk-käyttöoikeudelle että kaikille lisäkäyttöoikeusavaimille (erillisillä API-kutsuilla pyydetyt lisäavaimet liitetään pääasialliseen käyttöoikeuteen. Pääasiallisen Plesk-käyttöoikeuden aktivointikoodi aktivoi myös kaikki liitetyt lisäavaimet).

  4. Kun kauppasi saa aktivointikoodin, voit joko antaa koodin asiakkaalle (verkkokaupan käyttöliittymän tai sähköpostin kautta). Vaihtoehtoisesti (ja mieluummin) voit aktivoida käyttöoikeudet suorittamalla CLI-komennon asiakkaalle luomallasi Plesk-instanssilla. Voit aktivoida käyttöoikeuksia CLI:n kautta käyttämällä “license”-apuohjelmaa (Plesk for Linux, Plesk for Windows).

Tunnisteen lisämyynti sovelluksessa

Käytä tätä menetelmää, jos haluat myydä lisää Tunnisteita verkkokaupassasi jo käyttöön otetuille Plesk-instansseille. Kun yksi asiakkaistasi napsauttaa Plesk-laajennuskatalogin “Osta nyt” -painiketta, hänet ohjataan verkkokauppaasi, jossa hän voi viedä tilauksensa loppuun.

Integraatio KA:n kanssa

  1. Kun asiakas tekee tilauksen, sinun täytyy ottaa yhteyttä KA:han KA Partner API:n kautta ja pyytää käyttöoikeutta ostetulle Tunnisteelle. Välitä pääasiallisen Plesk-avaimen numero argumenttina API-kutsussa.

  2. KA luo pyydetyn Tunnisteen käyttöoikeuden ja liittää sen pääasialliseen Plesk-käyttöoikeuteen.

  3. Voit käyttää joko Partner API v1:tä tai v3:a käyttöoikeuksien pyytämiseen:

    1. Partner API v1 (vanhentunut, ei suositella): Luo Tunnisteen käyttöoikeus ja liitä se pääasialliseen Plesk-käyttöoikeuteen yhdellä kutsulla (katso createKey())

    2. Partner API v3 (suositeltu): Luo Tunnisteen käyttöoikeus ja liitä se pääasialliseen Plesk-käyttöoikeuteen yhdellä kutsulla (katso Käyttöoikeusavaimen luominen)

Kun tilaat Tunnisteen käyttöoikeuden Partner API:n kautta, se liitetään pääasialliseen Plesk-käyttöoikeuteen. Tunnisteen käyttöoikeus asennetaan Plesk-palvelimelle seuraavan kerran, kun Plesk yhdistää KA:han päivittääkseen pääasiallisen Plesk-käyttöoikeuden (yleensä tämä kestää yhdestä päivästä yhteen kuukauteen). Asiakas voi myös suorittaa seuraavat vaiheet asentaakseen Tunnisteen käyttöoikeuden heti (tämä voidaan tehdä esimerkiksi verkkokauppasi käyttöliittymässä):

  1. Napsauta Työkalut ja asetukset navigointipaneelissa.

  2. Napsauta Lisenssin tiedot (Plesk-kohdan alla).

  3. Napsauta Hae avaimet asentaaksesi uuden käyttöoikeusavaimen Pleskiin.

Asiakkaiden ohjaaminen verkkokauppaasi

Oletusarvoisesti, kun asiakas napsauttaa Plesk-laajennuskatalogin “Osta nyt” -painiketta, hänet ohjataan Pleskin kauppaan, ei sinun kauppaasi. Voit muuttaa tätä asettamalla oman kauppasi isäntänimen panel.ini-tiedostoon. Kun kaupan isäntänimi on mukautettu, kaikki “Osta nyt” -linkit ja muut mahdolliset lisämyyntilinkit Tunnisteiden sisällä johtavat verkkokauppaasi.

Voit muuttaa ”Osta nyt” -linkkien kohteena olevan verkkokaupan URL-osoitetta muokkaamalla panel.ini-tiedostoa ja lisäämällä seuraavan rivin [extensions]-osioon:

[extensions]
buyUrl = "https://shop.com"

jossa ”shop.com” on verkkokauppasi toimialue.

Tässä on esimerkki siitä, miten se toimisi:

  • Tunnisteen käyttämä alkuperäinen URL-osoite:

    https://go.plesk.com/buy-plesk-ext/some-extension-name?kn=PLESK.12345678.0001&token=U29NZVVuaXF1ZUdVSUQxMjM%3D&product-id=SomeProductID

    Tunnisteen käyttämä muokattu URL-osoite, kun olet määrittänyt kaupan isäntänimen panel.ini-tiedostossa: https://shop.com/?extension-id=some-extension-name&kn=PLESK.12345678.0001&token=U29NZVVuaXF1ZUdVSUQxMjM%3D&product-id=SomeProductID

Käyttöoikeuden ostotyönkulku näyttäisi seuraavalta ”Single Offer” ja ”Multiple Offers” -käyttöoikeusmalleille:

image 79081

Nyt joka kerta, kun asiakas napsauttaa “Osta nyt” -painiketta, hänet ohjataan verkkokauppaasi. Varmista, että verkkokauppasi osaa käsitellä muokattuihin URL-osoitteisiin välitetyt parametrit:

Parametrin nimi

Esimerkki

Kuvaus

extension-id

extension-id=jonkin-laajennuksen-nimi

Tunnisteen tunnus. Katso Tunnisteiden luettelo ja niiden tunnukset (“koodit”) täältä.

Valitse pyydetylle Tunnisteelle sopiva Partner API -vakio ja sisällytä se Partner API -kutsuun. Luettelo Partner API -vakioista on saatavilla täällä:

Huomaa, että “Extension ID” vastaa extension-id-kenttää Excel-tiedostoissa ja “extensionId” vastaa extension-id-kenttää JSON-tiedostoissa.

kn

kn=PLSK.12345678.0001

Pääasiallisen Plesk-avaimen numero. Välitä tämä avaimen numero pääavaimen numerona Partner API -kutsussa.

token

token=U29NZVVuaXF1ZUdVSUQxMjM%3D

Valinnaiset parametrit. Pakollinen vain ”Individual Offers” -käyttöoikeusmallille.

Tässä käyttöoikeusmallissa verkkosivustojen omistajat voivat ostaa tuotteita ja palveluita itse tarpeen mukaan. Tämä tehdään lisäämällä Plesk-käyttöliittymään linkki, jonka avulla loppukäyttäjät voivat tehdä tilauksia. Ensin loppukäyttäjä valitsee haluamansa verkkosivuston, sitten valitsee haluamansa tuotteen Tunnisteen tarjoamista tuotteista ja siirtyy sitten verkkokauppaan viemään tilauksensa loppuun.

product-id-parametri sisältää asiakkaan valitseman tuotteen tunnuksen. Valitse pyydetylle Tunnisteelle ja tuotteelle sopiva Partner API -vakio ja sisällytä se Partner API -kutsuun. Löytääksesi sopivan Partner API -vakion extension-id- ja product-id-tunnuksilla käytä seuraavia linkkejä:

Huomaa, että “Extension ID” ja “Extension Product ID” vastaavat extension-id- ja product-id-kenttiä Excel-tiedostoissa, ja “extensionId” ja “extensionProductId” vastaavat extension-id- ja product-id-kenttiä JSON-tiedostoissa.

token-parametrin luo Tunniste itse, ja se sisältää tilauksen yksilöllisen tunnuksen. Tunnistetta tarvitaan, jotta Tunniste voi seurata tilauksen tilaa ISV-puolella. Tämä parametri on käsiteltävä seuraavasti:

  1. Ensin se on dekoodattava URL-koodauksen mekanismin mukaisesti.

  2. Sitten se on dekoodattava BASE64-koodauksen mukaisesti.

  3. Sen jälkeen se on välitettävä KA:lle Partner API -kutsussa:

product-id

product-id=SomeProductID

Tässä on, miltä käyttöoikeuden ostoprosessi näyttäisi ”Individual Offers” -käyttöoikeusmallille:

image 79082

Muista: Tämä ominaisuus vaikuttaa vain Pleskin myymiin Tunnisteisiin, jotka käyttävät “go.plesk.com” kohdeisäntänimenä. Jos ISV myy Tunnisteen suoraan, sen “Osta nyt” -linkkeihin ja muihin mahdollisiin lisämyyntilinkkeihin ei vaikuteta.

Kuinka hallita, mitkä Tunnisteet haluat näyttää ja myydä

Kun olet muuttanut “Osta nyt” -linkkien URL-osoitteen edellä kuvatulla tavalla, kaikki kaupalliset Tunnisteet, mukaan lukien ne, jotka lisätään Laajennuskatalogiin tulevaisuudessa, johtavat sinun kauppaasi, vaikka et olisi vielä määrittänyt niitä. Voit varmistaa, että asiakkaasi näkevät vain ne kaupalliset Tunnisteet, joita olet valmis myymään, määrittämällä älykkään välityspalvelimen Plesk-laajennuskatalogille. Tämä välityspalvelin ottaa vastaan Laajennuskatalogin syötteen, suodattaa pois Tunnisteet, joita et ole valmis myymään, ja toimittaa muokatun syötteen Plesk-instansseillesi.

Toteutuksen yksityiskohdat:

  1. Ota käyttöön palvelin (fyysinen tai virtuaalinen), jolla välityspalvelinskripti on käynnissä.

  2. Lataa välityspalvelinskripti palvelimelle. Tämä linkki sisältää ohjeet skriptin käyttöönottoon ja käyttöön.

  3. Määritä välityspalvelin päästämään läpi vain ne kaupalliset Tunnisteet, jotka pitäisi näkyä Plesk-palvelimillasi. Välityspalvelin toimii sallittujen luettelona – sinun täytyy määrittää kaupallisten Tunnisteiden tunnukset, jotka pitäisi näyttää Pleskissä; muuta ei näy.

    Muista: Välityspalvelin vaikuttaa vain niihin Tunnisteisiin, joiden “Osta nyt” -linkit osoittavat osoitteeseen https://go.plesk.com. Ilmaisia Tunnisteita ja Tunnisteita, joiden “Osta nyt” -painikkeet osoittavat muualle, ei suodateta välityspalvelimella. Ne näkyvät Laajennuskatalogissa Plesk-palvelimillasi välityspalvelimen asetuksista riippumatta.

  4. Muuta Laajennuskatalogin syötteen URL-osoite kaikilla Plesk-palvelimillasi niin, että se osoittaa välityspalvelimen osoitteeseen. Tämä tehdään lisäämällä seuraava rivi panel.ini-tiedostoon:

    [extensions]
catalog.url = http://<proxy-address>:8080

  5. Kun uusi kaupallinen Tunniste tulee saataville Laajennuskatalogiin ja olet määrittänyt kauppasi myymään sitä, muokkaa välityspalvelinta lisäämällä vastaava Tunnisteen tunnus, jotta tämä Tunniste päästetään läpi ja on asiakkaidesi saatavilla. Huomaa, että katalogisyöte on välimuistissa Plesk-palvelimilla. Uudet Tunnisteet eivät näy heti.

Alla oleva kuva näyttää, miten välityspalvelinskriptiä voidaan käyttää Laajennuskatalogin kanssa:

image 79094