הוספת אימות זהות ליישום או דף אינטרנט המכילים תוכן Oracle Analytics משובץ

השתמש בנושאים בפרק זה להוספת שיטת אימות ליישום האינטרנט או דף אינטרנט של פורטל שלך שמכיל תוכן Oracle Analytics משובץ.

נושאים:

שימוש באימות זהות באמצעות מנחה התחברות עם תוכן Oracle Analytics משובץ

אימות באמצעות מנחה התחברות הוא שיטת ברירת המחדל של אימות לתוכן Oracle Analytics המשובץ ביישום אינטרנט או דף אינטרנט של פורטל.

כאשר משתמשים ניגשים לתוכן Analytics משובץ, מוצג להם מסך התחברות שבו הם מזינים שם התחברות וסיסמה לפני שיוכלו להציג נתונים. אם אין ניהול זהויות משותף בין Oracle Analytics ויישום האינטרנט או דף האינטרנט של הפורטל, אזי למשתמשים מוצג מסך התחברות זה, אפילו אם הם כבר התחברו ליישום האינטרנט או לדף האינטרנט של הפורטל שמכילים את תוכן Analytics המשובץ.

התאמה אישית של הודעת האימות של מנחה התחברות

הוסף תכונות לתגית <oracle-dv> כדי להתאים אישית את הודעות האימות של מנחה ההתחברות. התכונות הבאות נתמכות:

  • auth-message-prefix: מציין את טקסט התחילית של הודעת ההתחברות. ערך ברירת המחדל הוא "Oracle Analytics".

  • auth-message-link: מציין את הטקסט לקישור ההתחברות. ערך ברירת המחדל הוא "התחברות".

  • auth-message-suffix: מציין את טקסט הסיומת של הודעת ההתחברות. ברירת המחדל היא "דרוש".

  • auth-needed-message: מציין את הטקסט של ההודעה 'דרוש אימות'. ברירת המחדל היא "דורש אימות".

  • auth-message-prefix-small: מציין את טקסט התחילית של הודעת ההתחברות. ערך ברירת המחדל הוא "Oracle Analytics". ישים רק אם גודל האובייקט המכיל המשובץ קטן מ-215 פיקסל.

  • auth-message-link-small: מציין את הטקסט לקישור ההתחברות. ערך ברירת המחדל הוא "התחברות". ישים רק אם גודל האובייקט המכיל המשובץ קטן מ-215 פיקסל.

  • auth-message-suffix-small - מציין את טקסט הסיומת של הודעת ההתחברות. ערך ברירת המחדל הוא המחרוזת הריקה. ישים רק אם גודל האובייקט המכיל המשובץ קטן מ-215 פיקסל.

  • auth-needed-message-small: מציין את הטקסט של ההודעה 'דרוש אימות'. ברירת המחדל היא "דורש אימות". ישים רק אם גודל האובייקט המכיל המשובץ קטן מ-160 פיקסל.

שימוש בהרשאה פתוחה תלת-שלבית (3-legged Oauth) עם תוכן Oracle Analytics משובץ

השתמש בשיטת האימות של OAuth תלת-רגלי כאשר אתה משבץ תוכן של Oracle Analytics בתוך פורטל או יישום אינטרנט שכבר משתמשים בשיטת אימות משלהם.

לחוויית משתמש חלקה, דף האינטרנט המותאם אישית ו-Oracle Analytics צריכים להשתמש באותו ספק אימות. כך במקרה של יישום אינטרנט צד שלישי, הוא צריך להשתמש באותו ספק אימות זהות שלOracle Cloud כמו Oracle Analytics (כלומר, באותו מופע של Oracle Identity Cloud Service או דומיין זהויות שלOracle Cloud Infrastructure Identity and Access Management (IAM)), או שאתOracle Analytics צריך לאחד עם ספק האימות של הצד השלישי. 

כדי לאפשר אימות נכון, עליך להגדיר את הפרמטר של OAuth תלת-רגלי בכל הבקשות לשרת.

  1. הגדר את הפרמטר IDCS_OAUTH3LEGGED כ-true בהפניה לתסריט embedding.js.
  2. הגדר את סוג תצורת האבטחה של oauth_3legged ליישום המשתמש בפונקציה setSecurityConfig

דוגמה

כאן project-path מציינת את נתיב המאגר של חוברת העבודה.

<!DOCTYPE html>
<html dir="ltr">
    <head>
        <script src=""https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embedding_method>/embedding.js?IDCS_OAUTH3LEGGED=true" type="application/javascript">
        </script>
    </head>
    <body>
        <div style="position: absolute; width: calc(100% - 40px); height: calc(100% - 120px)" >
            <oracle-dv project-path="/Shared Folders/Embed/Embed Samples">
            </oracle-dv>
        </div>
    <script>
      requirejs(['jquery', 'knockout', 'obitech-application/application', 'ojs/ojcore', 'ojs/ojknockout', 'ojs/ojcomposite', 'jet-composites/oracle-dv/loader'], function($, ko, application) {
      application.setSecurityConfig("oauth_3legged");
      ko.applyBindings();
      });
     </script>
    </body>
</html>

השתמש באימות זהות באמצעות אסימון עם תוכן Oracle Analytics משובץ

השתמש בשיטת אימות הזהות באסימון כשתרצה לאמת כנגד Oracle Analytics ברקע, אך לא תרצה להשתמש ב-OAuth תלת-רגלי.

עדכן את דף HTML כדי להרשות אימות זהות נכון באסימון. לקבלת מידע כיצד להפיק אסימונים, ראה אבטחת הרשאות ב-Oracle Cloud.

  1. בדף ה-HTML, הגדר את הפרמטר TOKEN כ-true בהפניה לתסריט embedding.js.
  2. ציין את סוג תצורת האבטחה של האסימון. הוסף ליישום את הפונקציות לאחזור האסימון באמצעות הפונקציה setSecurityConfig. ראה את הדוגמה להלן.

דוגמה

דוגמה זו משתמשת ב-API לקבלת האסימון. אם דף HTML שלך משתמש ב-API כדי לקבל את האסימון, עליך להפוך את ה-API הדרוש לזמין.

כאן project-path מציינת את נתיב המאגר של חוברת העבודה.

<!DOCTYPE html>
<html dir="ltr">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
     <title>Standalone DV Embed Demo Using Token</title>
     <script src="https://<instance>.analytics.ocp.oraclecloud.com/public/dv/v1/embedding/<embedding mode>/embedding.js?TOKEN=true" type="application/javascript">
     </script>
   </head>
   <body>
     <B>Standalone embedded workbook test</B>
      <div style="width: calc(50% - 40px); height: 50%; border: 1px solid black; padding: 10px;" >
         <oracle-dv
            project-path="/@Catalog/Shared Folders/Embed/Embed Samples"
            active-page="canvas"
            active-tab-id="1">
         </oracle-dv>
      </div>

      <script>
         var token = '<token from identity management API>';
         requirejs(['jquery', 'knockout', 'obitech-application/application', 'ojs/ojcore', 'ojs/ojknockout', 'ojs/ojcomposite', 'jet-composites/oracle-dv/loader'],
       function($, ko, application) {
               application.setSecurityConfig("token", {tokenAuthFunction:
                  function(){
                     return token;
                  }
               });
               ko.applyBindings();
            }
        );
      </script>
   </body>
</html>