Komponentti-instanssin tunnus on yksilöivä tunniste komponentille, joka muodostetaan sisäiseen kehykseen sivustossa.
Kun käyttäjä vetää ja pudottaa sisäiseen kehykseen muodostettavan komponentin komponenttiluettelosta sivuston sivulle, Oracle Sites Cloud -palveluun lähetetään tarjoamiskutsu uuden yksilöivän komponentti-instanssin tunnuksen luontia varten. Tunnus on aina yksilöivä. Kaikki vastaavat komponentti-instanssit, jotka tarjotaan samassa palvelussa, saavat saman instanssin tunnuksen.
Komponentti-instanssin tunnus sisältää lisätietoja, joiden avulla voidaan suojata sisäiseen kehykseen muodostettavan komponentin asetukset ja käyttö. Näin komponentti voi varmistaa, että asetusten päivitys on peräisin luotetusta sijainnista.
Instanssin tunnuksen parametrin avulla kehittäjät voivat tunnistaa sivuston ja todentaa kutsujan. Kutsuja todennetaan tarkistamalla digitaalinen allekirjoitus, joka luodaan käyttämällä komponentin salaista avainta. Salainen avain luodaan komponentin rekisteröinnin aikana.
Komponentti-instanssi koostuu kahdesta osasta, jotka on erotettu .-erottimella. Osia ovat tiedot ja rakenne.
Komponentti-instanssi: tiedot
Sisäiseen kehykseen muodostettavan komponentti-instanssin tieto-osa on Base64-muotoinen JSON-koodattu merkkijono. JSON-merkkijonon rakenne on seuraava:
{
"instanceid": "BBDC7614F693B75110D811E6C0B77C935FAEC5112E5E",
"permissions": "",
"entitlements": "",
"signdate": "1435426735293",
"sitedomain": "service1-tenant4.localhost"
}
| Kentän nimi | Kuvaus |
|---|---|
|
|
Sisäiseen kehykseen muodostettavan komponentin yksilöivä tunniste Oracle Content Management -asiakkaalle. |
|
|
Allekirjoituksen luontipäivämäärä. |
|
|
Oracle Content Management -instanssin toimialueen nimi. |
|
|
Sivuston jäsenen oikeusjoukko. Muokkaustilassa sen arvo on |
|
|
Sivuston omistajan ostamien maksullisten ominaisuuksien lista. |
Komponentti-instanssi: allekirjoitus
Komponentti-instanssin tieto-osa sarjoitetaan, ennen kuin se allekirjoitetaan APP_SECRET_KEY-avaimella. Tämä salainen avain on luotava ja näytettävä kehittäjälle, kun komponentti rekisteröidään. Allekirjoitus lasketaan luomalla komponentti-instanssin tieto-osan (sarjoitettu JSON-rakenne) hajautusarvo salaista avainta käyttämällä. Esimerkki:
$signature = HMAC (serialized JSON structure, APP_SECRET_KEY)
Allekirjoituksen luontiin käytetään SHA256-hajautusalgoritmia. Merkki on siis sarjoitetun rakenteen ja luodun allekirjoituskomponentin yhdistelmä, kuten alla näytetään:
$instance = {base64encoded serialized JSON structure}.{base64encoded $signature}
Esimerkki:
//base64 encoded serialized object //signature eyJpbnN0YW5jZWlkIjoiQTRGOTE3REY5OTZEN0Q3ODBCMjUzODZFOTFEMDA3ODJGMjVBRjY2Rjc3OTIiLCJzaWduZGF0ZSI6IjE0NDU2MzcwNTk5MTciLCJzaXRlZG9tYWluIjoic2VydmljZTEtdGVuYW50MS51cy5vcmFjbGUuY29tIiwicGVybWlzc2lvbnMiOiJTSVRFX09XTkVSIiwiZW50aXRsZW1lbnRzIjoiIn0=.5p3of7t11OwuysF3zpm+YgICSHH8C/BHczdbVZx2VH8=