Cysylltu CMS personol

Os nad oes gan Silktide ategyn ar gyfer eich CMS, gall eich datblygwyr ei gysylltu eu hunain. Mae cysylltiad personol yn gwneud yr un ddau beth â'r lleill (gweler cysylltiadau CMS):

• Cyhoeddi: pan gaiff tudalen ei chyhoeddi neu ei newid, mae eich CMS yn hysbysu Silktide, sydd wedyn yn ei hailbrofi.
• Golygu: mae tag meta ar bob tudalen yn nodi ble y caiff ei golygu, felly mae Agor yn CMS yn Silktide yn agor y dudalen honno yn eich CMS.

Gallwch adeiladu'r naill ran neu'r llall, neu'r ddwy.

1. Cael eich allwedd a chyfeiriad API

1. Yn Silktide, agorwch Gosodiadau, yna Integreiddiadau, a dewiswch CMS.
2. Dewiswch CMS personol, dewiswch beth mae'r cysylltiad yn berthnasol iddo, a dewiswch Cysylltu.
3. Copïwch yr Allwedd a'r cyfeiriad API.

Mae'r cyfeiriad API yn dibynnu ar y rhanbarth y mae eich cyfrif ynddo, er enghraifft https://api.eu.silktide.com. Defnyddiwch yr un y mae Silktide yn ei ddangos. Yn yr enghreifftiau isod, rhowch hwnnw yn lle https://api.eu.silktide.com, a rhowch eich allwedd chi yn lle'r allwedd.

I wirio bod yr allwedd yn gweithio, anfonwch hi at /cms/test-key. Mae Silktide yn ymateb â 200 os yw'r allwedd yn ddilys, a 403 os nad yw:

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

Nid oes angen i'ch integreiddiad alw hwn. Mae yno i'w brofi.

2. Cyhoeddi: hysbysu Silktide beth sydd wedi newid

Pan gaiff tudalen ei hychwanegu neu ei newid, anfonwch gais POST at /cms/update gyda chorff JSON:

• apiKey: eich allwedd.
• url: cyfeiriad cyhoeddus y dudalen a newidiodd, neu urls: rhestr o gyfeiriadau.
• deferRetestSeconds (dewisol): faint o eiliadau y dylai Silktide aros cyn profi, er enghraifft tra bo'ch storfeydd celc yn cael eu clirio.

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

Mae Silktide yn ymateb ar unwaith ac yn rhoi'r prawf mewn ciw. Caiff y dudalen ei hailbrofi o fewn munud fel arfer.

Dim ond cyfeiriadau sy'n perthyn i'r gwefannau y mae'r cysylltiad yn berthnasol iddynt y mae Silktide yn eu profi, o fewn cwmpas profi pob gwefan. Anwybyddir unrhyw beth arall.

3. Golygu: nodi ble y caiff pob tudalen ei golygu

Ychwanegwch dag meta at <head> pob tudalen y mae eich CMS yn ei chyhoeddi:

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

Mae ei content yn wrthrych JSON, wedi'i amgodio â Base64:

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

• Mae cms yn enwi eich CMS. Testun rhydd ydyw.
• editorUrl yw'r cyfeiriad y mae rhywun yn ymweld ag ef i olygu'r dudalen hon.

Mae Silktide yn darllen y tag bob tro y mae'n profi'r dudalen. Mae Agor yn CMS yn agor editorUrl mewn tab newydd.

Mae Base64 yn hawdd ei ddadgodio, felly gall unrhyw un sy'n gweld y dudalen ddarllen editorUrl. Peidiwch byth â rhoi unrhyw beth ynddo sy'n mewngofnodi rhywun, fel tocyn neu enw defnyddiwr. Os nad ydych am ddangos cyfeiriadau eich golygydd o gwbl, amgryptiwch y tag.

Amgryptio'r tag (dewisol)

Amgryptiwch y JSON gydag AES-256-CBC, gan ddefnyddio eich allwedd fel yr allwedd amgryptio. Yna amgodiwch â Base64, yn y drefn hon: y fector ymgychwyn, HMAC SHA-256 o'r beitiau wedi'u hamgryptio (gan ddefnyddio eich allwedd hefyd), a'r beitiau wedi'u hamgryptio. Yn 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 is the meta tag's content.

4. Ei brofi

1. Defnyddiwch eich newidiadau. Os gwnaethoch ychwanegu'r tag meta, cliriwch unrhyw storfeydd celc fel bod y tudalennau cyhoeddus yn ei gynnwys.
2. Ailbrofwch y wefan yn Silktide.
3. Agorwch dudalen yn yr Arolygydd. Dylai Agor yn CMS ymddangos, ac agor y dudalen honno yn eich CMS.
4. Cyhoeddwch dudalen yn eich CMS. Dylai Silktide ddechrau ei phrofi o fewn munud.

Os nad yw rhywbeth yn gweithio, dewiswch Cysylltu â chymorth yn Silktide.