Tengja sérsniðið CMS

Ef Silktide er ekki með viðbót fyrir CMS-kerfið þitt geta forritararnir þínir tengt það sjálfir. Sérsniðin tenging gerir sömu tvo hluti og hinar (sjá CMS-tengingar):

• Birting: þegar síða er birt eða breytt lætur CMS-kerfið þitt Silktide vita, sem prófar hana aftur.
• Ritstýring: hver síða er með lýsimerki sem segir hvar henni er ritstýrt, þannig að Opna í CMS í Silktide opnar síðuna í CMS-kerfinu þínu.

Þú getur útfært annan hvorn hlutann eða þá báða.

1. Sæktu lykilinn þinn og API-slóðina

1. Opnaðu Stillingar í Silktide, síðan Samþættingar, og veldu CMS.
2. Veldu Sérsniðið CMS, veldu hvað tengingin á við og veldu Tengja.
3. Afritaðu Lykilinn og API-slóðina.

API-slóðin fer eftir því á hvaða svæði reikningurinn þinn er, til dæmis https:\/\/api.eu.silktide.com. Notaðu þá slóð sem Silktide sýnir. Í dæmunum hér fyrir neðan skaltu skipta https:\/\/api.eu.silktide.com út fyrir hana og lyklinum út fyrir þinn lykil.

Til að athuga hvort lykillinn virki skaltu senda hann á \/cms\/test-key. Silktide svarar með 200 ef lykillinn er gildur og 403 ef hann er það ekki:

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

Samþættingin þín þarf ekki að kalla á þetta. Þetta er aðeins til prófana.

2. Birting: láttu Silktide vita hvað breyttist

Þegar síðu er bætt við eða henni breytt skaltu senda POST-beiðni á \/cms\/update með JSON-meginmáli:

• apiKey: lykillinn þinn.
• url: opinbera slóðin á síðuna sem breyttist, eða urls: listi yfir slóðir.
• deferRetestSeconds (valkvætt): hve margar sekúndur Silktide á að bíða áður en það prófar síðuna, til dæmis á meðan skyndiminni þín tæmast.

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 svarar strax og setur prófunina í biðröð. Síðan er yfirleitt prófuð aftur innan mínútu.

Silktide prófar aðeins slóðir sem tilheyra vefsvæðunum sem tengingin á við um, innan prófunarsviðs hvers vefsvæðis. Allt annað er hunsað.

3. Ritstýring: tilgreindu hvar hverri síðu er ritstýrt

Bættu lýsimerki við <head> á hverri síðu sem CMS-kerfið þitt birtir:

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

content þess er JSON-hlutur, Base64-kóðaður:

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

• cms heitir CMS-kerfið þitt. Það er frjáls texti.
• editorUrl er slóðin sem einhver heimsækir til að ritstýra þessari síðu.

Silktide les merkið í hvert skipti sem það prófar síðuna. Opna í CMS opnar editorUrl í nýjum flipa.

Auðvelt er að afkóða Base64, þannig að allir sem skoða síðuna geta lesið editorUrl. Settu aldrei neitt í það sem skráir einhvern inn, svo sem auðkenni eða notandanafn. Ef þú vilt alls ekki sýna ritstjóraslóðirnar þínar skaltu dulkóða merkið.

Dulkóða merkið (valkvætt)

Dulkóðaðu JSON með AES-256-CBC og notaðu lykilinn þinn sem dulkóðunarlykil. Kóðaðu síðan með Base64, í þessari röð: frumbreytingarvigurinn, SHA-256 HMAC af dulkóðuðu bætunum (einnig með lyklinum þínum) og dulkóðuðu bætin. Í PHP:

$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 er innihald lýsimerkisins.

4. Prófaðu þetta

1. Settu breytingarnar þínar í notkun. Ef þú bættir við lýsimerkinu skaltu tæma öll skyndiminni svo það birtist á opinberu síðunum.
2. Prófaðu vefsvæðið aftur í Silktide.
3. Opnaðu síðu í skoðunarglugganum. Opna í CMS ætti að birtast og opna þá síðu í CMS-kerfinu þínu.
4. Birtu síðu í CMS-kerfinu þínu. Silktide ætti að byrja að prófa hana innan mínútu.

Ef eitthvað virkar ekki skaltu velja Hafa samband við þjónustuver í Silktide.