Om forekomst-ID-en og strukturen for komponenter gjengitt i linjebundne rammer

Forekomst-ID-en for en komponent er den unike identifikatoren for en komponent gjengitt i en linjebundet ramme i et område.

Når en bruker drar og slipper en komponent gjengitt i en linjebundet ramme fra komponentkatalogen til en områdeside, utføres et klargjøringskall til Oracle Sites Cloud Service slik at det genereres en ny unik forekomst-ID for komponenten. Denne ID-en er garantert unik, og alle slike komponentforekomster klargjort i denne tjenesten, får den samme forekomst-ID-en.

En forekomst-ID for en komponent inneholder tilleggsopplysninger som kan brukes til å sikre innstillingene og bruken av en komponent gjengitt i en linjebundet ramme, slik at komponenten kan være sikker på at innstillingsoppdateringen kommer fra et klarert sted.

Parameteren for forekomst-ID-en gjør det mulig for utviklere å identifisere området og autentisere parten som utfører kallet. Oppkalleren autentiseres ved å verifisere en digital signatur som genereres ved hjelp av den hemmelige nøkkelen for komponenten. Den hemmelige nøkkelen genereres under komponentregistreringsprosessen.

Komponentforekomsten består av to deler atskilt med et skilletegn: data og struktur.

Komponentforekomst: data

Datadelen for forekomsten for en komponent gjengitt i en linjebundet ramme er en Base64 JSON-kodet streng. Her er strukturen i JSON-strengen:

{
  "instanceid": "BBDC7614F693B75110D811E6C0B77C935FAEC5112E5E",
  "permissions": "",
  "entitlements": "",
  "signdate": "1435426735293",
  "sitedomain": "service1-tenant4.localhost"
}
Feltnavn Beskrivelse

instanceid

Unik identifikator for en komponent angitt i en linjebundet ramme for en Oracle Content Management-leier.

signdate

Signaturgenereringsdato.

sitedomain

Domenenavnet for Oracle Content Management-forekomsten.

permissions

Sett med tillatelser for områdemedlemmet. Feltet har verdien "SITE_OWNER" i redigeringsmodus. I andre tilfeller inneholder det ingen verdi.

entitlements

Liste over premiumfunksjoner kjøpt av områdeeieren.

Komponentforekomst: signatur

Datadelen av komponentforekomsten serialiseres før den signeres av en APP_SECRET_KEY. Den hemmelige nøkkelen må genereres og vises til utvikleren under registrering av komponenten. Signaturen beregnes ved å generere en hash-kode for datadelen av komponentforekomsten (en serialisert JSON-struktur) med den hemmelige nøkkelen, som vist her:

$signature = HMAC (serialized JSON structure, APP_SECRET_KEY)

Hash-algoritmen som brukes i genereringen av signaturen, er SHA256. Symbolet er deretter sammenkjedingen av den serialiserte JSON-strukturen og den genererte signaturkomponenten, som vist her:

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

Eksempel:

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