Authentifizierung zu einer Anwendung oder Webseite mit eingebettetem Oracle Analytics-Inhalt hinzufügen

In den Themen in diesem Abschnitt wird beschrieben, wie Sie einer Webanwendung oder Portalwebseite, die eingebetteten Oracle Analytics-Inhalt enthält, eine Authentifizierungsmethode hinzufügen.

Authentifizierung über Anmelde-Prompt mit eingebettetem Oracle Analytics-Inhalt verwenden

Die Authentifizierung per Anmelde-Prompt ist die Standardauthentifizierungsmethode für Oracle Analytics-Inhalt, der in einer Webanwendung oder Portalwebseite eingebettet ist.

Wenn Benutzer auf eingebetteten Analyseinhalt zugreifen, wird ein Anmeldebildschirm angezeigt, in dem sie ihren Anmeldenamen und Ihr Kennwort eingeben, bevor sie Daten anzeigen können. Wenn kein gemeinsames Identity Management zwischen Oracle Analytics und der Webanwendung oder der Portalwebseite genutzt wird, sehen Benutzer diesen Anmeldebildschirm. Er wird auch dann angezeigt, wenn die Benutzer sich bereits bei der Webanwendung oder der Portalwebseite mit dem eingebetteten Analyseinhalt angemeldet haben.

Meldung der Anmelde-Prompt-Authentifizierung anpassen

Fügen Sie Attribute zum Tag <oracle-dv> hinzu, um die Meldungen bei der Anmelde-Prompt-Authentifizierung anzupassen. Die folgenden Attribute werden unterstützt:

  • auth-message-prefix: Gibt den Präfixtext für die Anmeldemeldung an. Der Standardwert lautet "Oracle Analytics".

  • auth-message-link: Gibt den Text für den Anmeldelink an. Der Standardwert lautet "Login".

  • auth-message-suffix: Gibt den Suffixtext für die Anmeldemeldung an. Der Standardwert lautet "Required".

  • auth-needed-message: Gibt den Text für die Meldung "Authentifizierung erforderlich" an. Der Standardwert lautet "Requires Authentication".

  • auth-message-prefix-small: Gibt den Präfixtext für die Anmeldemeldung an. Der Standardwert lautet "Oracle Analytics". Gilt nur, wenn der eingebettete Container weniger als 215 Pixel aufweist.

  • auth-message-link-small: Gibt den Text für den Anmeldelink an. Der Standardwert lautet "Login". Gilt nur, wenn der eingebettete Container weniger als 215 Pixel aufweist.

  • auth-message-suffix-small: Gibt den Suffixtext für die Anmeldemeldung an. Der Standardwert ist eine leere Zeichenfolge. Gilt nur, wenn der eingebettete Container weniger als 215 Pixel aufweist.

  • auth-needed-message-small: Gibt den Text für die Meldung "Authentifizierung erforderlich" an. Der Standardwert lautet "Requires Authentication". Gilt nur, wenn der eingebettete Container weniger als 160 Pixel aufweist.

Dreibeinige OAuth-Authentifizierung mit eingebettetem Oracle Analytics-Inhalt verwenden

Verwenden Sie dreibeiniges OAuth als Authentifizierungsmethode beim Einbetten von Oracle Analytics-Inhalt in einer Portal- oder Webanwendung, die bereits eine eigene Authentifizierungsmethode verwendet.

Für eine nahtlose Benutzererfahrung müssen die benutzerdefinierte Webseite und Oracle Analytics denselben Authentifizierungsprovider verwenden. Eine Drittanbieterwebanwendung muss also denselben Oracle Cloud-Authentifizierungsprovider wie Oracle Analytics verwenden (also dieselbe Oracle Identity Cloud Service-Instanz oder Oracle Cloud Infrastructure Identity and Access Management-(IAM-)Identitätsdomain), oder Oracle Analytics muss mit dem externen Authentifizierungsprovider föderiert sein. 

Für eine korrekte Authentifizierung müssen Sie den Parameter für dreibeiniges OAuth für alle Serveranforderungen angeben.

  1. Setzen Sie den Parameter IDCS_OAUTH3LEGGED in der Skriptreferenz embedding.js auf "true".
  2. Geben Sie den Sicherheitskonfigurationstyp oauth_3legged für die Anwendung an, die die setSecurityConfig-Funktion verwendet.

Beispiel

Hier gibt project-path den Repository-Pfad der Arbeitsmappe an.

<!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>

Tokenauthentifizierung mit eingebettetem Oracle Analytics-Inhalt verwenden

Verwenden Sie die Authentifizierungsmethode mit Token, wenn die Authentifizierung bei Oracle Analytics im Hintergrund erfolgen soll, Sie aber nicht dreibeiniges OAuth verwenden möchten.

Aktualisieren Sie die HTML-Seite, um die richtige Tokenauthentifizierung zu ermöglichen. Informationen zum Generieren von Token finden Sie unter Autorisierungen in Oracle Cloud sichern.

  1. Setzen Sie auf der HTML-Seite den Parameter TOKEN in der Skriptreferenz embedding.js auf "true".
  2. Geben Sie den Sicherheitskonfigurationstyp "Token" an. Fügen Sie die Funktionen zum Abrufen des Tokens für die Anwendung mit der Funktion setSecurityConfig hinzu. Siehe das folgende Beispiel.

Beispiel

In diesem Beispiel wird das Token mit einer API abgerufen. Wenn die HTML-Seite das Token mit einer API abruft, müssen Sie die erforderliche API verfügbar machen.

Hier gibt project-path den Repository-Pfad der Arbeitsmappe an.

<!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>