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 |
---|---|
|
Unik identifikator for en komponent angitt i en linjebundet ramme for en Oracle Content Management-leier. |
|
Signaturgenereringsdato. |
|
Domenenavnet for Oracle Content Management-forekomsten. |
|
Sett med tillatelser for områdemedlemmet. Feltet har verdien |
|
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=