Yhdistä mukautettu CMS

Jos Silktidella ei ole lisäosaa CMS:llesi, kehittäjäsi voivat yhdistää sen itse. Mukautettu yhteys tekee samat kaksi asiaa kuin muutkin (katso CMS-yhteydet):

• Julkaiseminen: kun sivu julkaistaan tai sitä muutetaan, CMS:si ilmoittaa siitä Silktidelle, joka testaa sen uudelleen.
• Muokkaaminen: jokaisella sivulla on metatunniste, joka kertoo, missä sitä muokataan, joten Silktiden Avaa CMS:ssä avaa kyseisen sivun CMS:ssäsi.

Voit toteuttaa kumman tahansa osan tai molemmat.

1. Hanki avaimesi ja API-osoite

1. Avaa Silktidessa Asetukset, sitten Integraatiot ja valitse CMS.
2. Valitse Mukautettu CMS, valitse, mihin yhteys koskee, ja valitse Yhdistä.
3. Kopioi Avain ja API-osoite.

API-osoite riippuu alueesta, jolla tilisi on, esimerkiksi https://api.eu.silktide.com. Käytä Silktiden näyttämää osoitetta. Korvaa alla olevissa esimerkeissä https://api.eu.silktide.com sillä ja avain omallasi.

Voit tarkistaa, että avain toimii, lähettämällä sen osoitteeseen /cms/test-key. Silktide vastaa 200, jos avain on kelvollinen, ja 403, jos se ei ole:

curl --request POST \
  --header "Content-Type: application/json" \
  --data '{"apiKey": "eu:your-key"}' \
  https://api.eu.silktide.com/cms/test-key

Integraatiosi ei tarvitse kutsua tätä. Se on tarkoitettu testaamiseen.

2. Julkaiseminen: kerro Silktidelle, mikä muuttui

Kun sivu lisätään tai sitä muutetaan, lähetä POST-pyyntö osoitteeseen /cms/update JSON-rungolla:

• apiKey: avaimesi.
• url: muuttuneen sivun julkinen osoite tai urls: luettelo osoitteista.
• deferRetestSeconds (valinnainen): kuinka monta sekuntia Silktiden tulee odottaa ennen testaamista, esimerkiksi välimuistien tyhjentymisen ajan.

curl --request POST \
  --header "Content-Type: application/json" \
  --data '{"apiKey": "eu:your-key", "url": "https://www.example.com/news/open-day"}' \
  https://api.eu.silktide.com/cms/update

Silktide vastaa heti ja asettaa testin jonoon. Sivu testataan yleensä uudelleen minuutin kuluessa.

Silktide testaa vain osoitteita, jotka kuuluvat verkkosivustoihin, joihin yhteys koskee, kunkin verkkosivuston testauksen laajuuden sisällä. Kaikki muu ohitetaan.

3. Muokkaaminen: kerro, missä kutakin sivua muokataan

Lisää metatunniste jokaisen CMS:si julkaisemaan sivun <head>-osioon:

<meta name="silktide-cms" content="...">

Sen content on Base64-koodattu JSON-objekti:

{"cms": "Your CMS name", "editorUrl": "https://cms.example.com/pages/123/edit"}

• cms nimeää CMS:si. Se on vapaamuotoinen teksti.
• editorUrl on osoite, jossa tätä sivua muokataan.

Silktide lukee tunnisteen aina testatessaan sivun. Avaa CMS:ssä avaa editorUrl-osoitteen uuteen välilehteen.

Base64 on helppo purkaa, joten kuka tahansa sivua katsova voi lukea editorUrl-osoitteen. Älä koskaan lisää siihen mitään, mikä kirjaa jonkun sisään, kuten tunnusta tai käyttäjänimeä. Jos et halua näyttää muokkausosoitteitasi lainkaan, salaa tunniste.

Salaa tunniste (valinnainen)

Salaa JSON AES-256-CBC:llä käyttäen avaintasi salausavaimena. Koodaa sitten Base64-muotoon tässä järjestyksessä: alustamisvektori, salattujen tavujen SHA-256 HMAC (myös avaintasi käyttäen) ja salatut tavut. PHP:ssä:

$data = ['cms' => 'Your CMS name', 'editorUrl' => 'https://cms.example.com/pages/123/edit'];
$iv = openssl_random_pseudo_bytes(openssl_cipher_iv_length('AES-256-CBC'));
$encrypted = openssl_encrypt(json_encode($data), 'AES-256-CBC', $key, OPENSSL_RAW_DATA, $iv);
$hmac = hash_hmac('sha256', $encrypted, $key, true);
$content = base64_encode($iv . $hmac . $encrypted);
// $content is the meta tag's content.

4. Testaa se

1. Ota muutoksesi käyttöön. Jos lisäsit metatunnisteen, tyhjennä välimuistit, jotta se on julkisilla sivuilla.
2. Testaa verkkosivusto uudelleen Silktidessa.
3. Avaa sivu Inspectorissa. Avaa CMS:ssä -vaihtoehdon pitäisi näkyä ja avata kyseinen sivu CMS:ssäsi.
4. Julkaise sivu CMS:ssäsi. Silktiden pitäisi aloittaa sen testaaminen minuutin kuluessa.

Jos jokin ei toimi, valitse Silktidessa Ota yhteyttä tukeen.