Το αναγνωριστικό στιγμιότυπου συστατικού στοιχείου είναι το μοναδικό αναγνωριστικό για ένα συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαίσιο εντός μιας τοποθεσίας.
Όταν ένας χρήστης μεταφέρει και εναποθέτει ένα συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαίσιο από τον Κατάλογο συστατικών στοιχείων σε μια σελίδα τοποθεσίας, γίνεται μια κλήση παροχής στην υπηρεσία Oracle Sites Cloud Service για να δημιουργήσει ένα νέο, μοναδικό αναγνωριστικό στιγμιότυπου συστατικού στοιχείου. Αυτό το αναγνωριστικό είναι εγγυημένα μοναδικό και όλα τα εν λόγω στιγμιότυπα συστατικών στοιχείων που παρέχονται σε αυτή την υπηρεσία θα λάβουν το ίδιο αναγνωριστικό στιγμιότυπου.
Ένα αναγνωριστικό στιγμιότυπου συστατικού στοιχείου περιέχει πρόσθετες πληροφορίες που μπορούν να χρησιμοποιηθούν για να προστατευθούν οι ρυθμίσεις και η χρήση ενός συστατικού στοιχείου που αποδίδεται σε ένα ενσωματωμένο πλαίσιο, ώστε το συστατικό στοιχείο να είναι βέβαιο ότι η ενημέρωση των ρυθμίσεων προέρχεται από αξιόπιστο μέρος.
Η παράμετρος αναγνωριστικού στιγμιότυπου επιτρέπει στους προγραμματιστές να προσδιορίζουν την τοποθεσία και να ελέγχουν την ταυτότητα του καλούντος. Η ταυτότητα του καλούντος ελέγχεται επαληθεύοντας μια ψηφιακή υπογραφή που δημιουργείται χρησιμοποιώντας το μυστικό κλειδί του συστατικού στοιχείου. Το μυστικό κλειδί δημιουργείται κατά τη διαδικασία εγγραφής του συστατικού στοιχείου.
Το στιγμιότυπο συστατικού στοιχείου αποτελείται από δύο τμήματα που διαχωρίζονται από ένα διαχωριστικό ‘.’: τα δεδομένα και τη δομή.
Στιγμιότυπο στοιχείου: Δεδομένα
Το τμήμα δεδομένων του στιγμιότυπου για ένα συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαισιο είναι μια συμβολοσειρά με κωδικοποίηση JSON Base64. Ακολουθεί η δομή της συμβολοσειράς JSON:
{ "instanceid": "BBDC7614F693B75110D811E6C0B77C935FAEC5112E5E", "permissions": "", "entitlements": "", "signdate": "1435426735293", "sitedomain": "service1-tenant4.localhost" }
Όνομα πεδίου | Περιγραφή |
---|---|
|
Μοναδικό αναγνωριστικό ενός συστατικού στοιχείου που αποδίδεται σε ένα ενσωματωμένο πλαίσιο για έναν μισθωτή του Oracle Content Management. |
|
Ημερομηνία δημιουργίας υπογραφής. |
|
Όνομα τομέα του στιγμιότυπου Oracle Content Management. |
|
Σύνολο δικαιωμάτων του μέλους τοποθεσίας. Στη λειτουργία επεξεργασίας, θα έχει την τιμή |
|
Λίστα με τις λειτουργίες premium που αγόρασε ο κάτοχος της τοποθεσίας. |
Στιγμιότυπο στοιχείου: Υπογραφή
Το τμήμα δεδομένων του στιγμιότυπου συστατικού στοιχείου σειριοποιείται πριν υπογραφεί από ένα APP_SECRET_KEY
. Αυτό το μυστικό κλειδί πρέπει να δημιουργηθεί και να εμφανιστεί στον προγραμματιστή κατά την εγγραφή ενός συστατικού στοιχείου. Η υπογραφή υπολογίζεται δημιουργώντας έναν κατακερματισμό του τμήματος δεδομένων του στιγμιότυπου συστατικού στοιχείου (μια σειριοποιημένη δομή JSON) με το μυστικό κλειδί όπως εμφανίζεται εδώ:
$signature = HMAC (serialized JSON structure, APP_SECRET_KEY)
Ο αλγόριθμος κατακερματισμού που χρησιμοποιείται στη δημιουργία της υπογραφής είναι SHA256. Το διακριτικό είναι, στη συνέχεια, η συνένωση της σειριοποιημένης δομής JSON και του δημιουργημένου συστατικού στοιχείου υπογραφής, όπως εμφανίζεται εδώ:
$instance = {base64encoded serialized JSON structure}.{base64encoded $signature}
Παράδειγμα:
//base64 encoded serialized object //signature eyJpbnN0YW5jZWlkIjoiQTRGOTE3REY5OTZEN0Q3ODBCMjUzODZFOTFEMDA3ODJGMjVBRjY2Rjc3OTIiLCJzaWduZGF0ZSI6IjE0NDU2MzcwNTk5MTciLCJzaXRlZG9tYWluIjoic2VydmljZTEtdGVuYW50MS51cy5vcmFjbGUuY29tIiwicGVybWlzc2lvbnMiOiJTSVRFX09XTkVSIiwiZW50aXRsZW1lbnRzIjoiIn0=.5p3of7t11OwuysF3zpm+YgICSHH8C/BHczdbVZx2VH8=