Beágyazott keretben megjelenített összetevők példányazonosítója és szerkezete

Az összetevőpéldány azonosítója a webhelyen belüli beágyazott keretben megjelenített összetevőhöz tartozó egyedi azonosító.

Amikor a felhasználó egy beágyazott keretben megjelenített összetevőt húz át az összetevő-katalógusból egy webhelyoldalra, előkészítési hívás érkezik az Oracle Sites Cloud szolgáltatásba az összetevőpéldány új egyedi azonosítójának előállítására. Ez az azonosító garantáltan egyedi, és az adott szolgáltatáson előkészített minden ilyen összetevőpéldány ugyanezt a példányazonosítót fogja kapni.

Az összetevőpéldány azonosítója további adatokat is tartalmaz, amelyek a beállítások és a beágyazott keretben megjelenített összetevő általi alkalmazásának védelmére használhatók, így az összetevő biztos lehet abban, hogy a beállítások frissítése megbízható helyről érkezik.

A példányazonosító paraméter lehetővé teszi a fejlesztőknek a webhely azonosítását és a hívó fél hitelesítését. A hívó hitelesítése az összetevő titkos kulcsának használatával előállított digitális aláírás ellenőrzésével történik. A titkos kulcsot az összetevő regisztrációs folyamata során állítja elő a rendszer.

Az összetevőpéldány ponttal ('.') elválasztott két részből áll: adatok és struktúra.

Összetevőpéldány: adatok

A beágyazott keretben megjelenített összetevő példányának adatszakasza Base64 JSON kódolású karakterlánc. A JSON karakterlánc szerkezete a következő:

{
  "instanceid": "BBDC7614F693B75110D811E6C0B77C935FAEC5112E5E",
  "permissions": "",
  "entitlements": "",
  "signdate": "1435426735293",
  "sitedomain": "service1-tenant4.localhost"
}
Mező neve Leírás

instanceid

Az Oracle Content Management bérlője számára beágyazott keretben megjelenített összetevő egyedi azonosítója.

signdate

Aláírás előállítási dátuma

sitedomain

Az Oracle Content Management példány tartományneve.

permissions

A webhelytag engedélyeinek készlete. Szerkesztési üzemmódban a "SITE_OWNER" értékkel rendelkezik, egyébként nincs értéke.

entitlements

A webhely tulajdonosa által vásárolt prémiumfunkciók listája.

Összetevőpéldány: aláírás

Az összetevőpéldány adatszakaszát soros adattá alakítja a rendszer az APP_SECRET_KEY kulccsal való aláírás előtt. A titkos kulcsot az összetevő regisztrálásakor állítja elő és jeleníti meg a fejlesztőnek a rendszer. Az aláírás kiszámítása az összetevőpéldány adatszakasza (soros JSON struktúra) kivonatának a titkos kulccsal való előállításával történik az alábbiak szerint:

$signature = HMAC (serialized JSON structure, APP_SECRET_KEY)

Az aláírás előállításakor használt kivonatoló algoritmus az SHA256. A token ezután a soros JSON struktúra és az előállított aláírás összetevő összefűzése:

$instance = {base64encoded serialized JSON structure}.{base64encoded $signature}

Példa:

//base64 encoded serialized object           //signature
eyJpbnN0YW5jZWlkIjoiQTRGOTE3REY5OTZEN0Q3ODBCMjUzODZFOTFEMDA3ODJGMjVBRjY2Rjc3OTIiLCJzaWduZGF0ZSI6IjE0NDU2MzcwNTk5MTciLCJzaXRlZG9tYWluIjoic2VydmljZTEtdGVuYW50MS51cy5vcmFjbGUuY29tIiwicGVybWlzc2lvbnMiOiJTSVRFX09XTkVSIiwiZW50aXRsZW1lbnRzIjoiIn0=.5p3of7t11OwuysF3zpm+YgICSHH8C/BHczdbVZx2VH8=