Adición de autenticación a una aplicación o una página web que contenga contenido de Oracle Analytics embebido

Use los temas de esta sección para agregar un método de autenticación a su aplicación web o página web del portal que contenga contenido de Oracle Analytics.

Uso de la autenticación de petición de datos de conexión con contenido de Oracle Analytics embebido

La autenticación de petición de datos de conexión es el método de autenticación por defecto para el contenido de Oracle Analytics embebido en una aplicación web o una página web de portal.

Cuando los usuarios acceden al contenido de análisis embebido, se les muestra una pantalla de conexión donde deben introducir el nombre y la contraseña de conexión para poder ver los datos. Si no hay una gestión de identidad común entre Oracle Analytics y la aplicación web o la página web del portal, se muestra a los usuarios esta pantalla de conexión, incluso si ya se han conectado a la aplicación web o a la página web del portal que contiene el contenido de análisis embebido

Personalización del mensaje de autenticación de petición de datos de conexión

Agregue atributos a la etiqueta <oracle-dv> para personalizar los mensajes de autenticación de petición de datos de conexión. Los siguientes atributos están soportados:

  • auth-message-prefix: especifica el texto de prefijo para el mensaje de conexión. El valor por defecto es "Oracle Analytics".

  • auth-message-link: especifica el texto para el enlace de conexión. El valor por defecto es "Login".

  • auth-message-suffix: especifica el texto de sufijo para el mensaje de conexión. El valor por defecto es "Required".

  • auth-needed-message: especifica el texto para el mensaje que requiere autenticación. El valor por defecto es "Requires Authentication".

  • auth-message-prefix-small: especifica el texto de prefijo para el mensaje de conexión. El valor por defecto es "Oracle Analytics". Solo es aplicable si el tamaño del contenedor embebido es inferior a 215 píxeles.

  • auth-message-link-small: especifica el texto para el enlace de conexión. El valor por defecto es "Login". Solo es aplicable si el tamaño del contenedor embebido es inferior a 215 píxeles.

  • auth-message-suffix-small: especifica el texto de sufijo para el mensaje de conexión. El valor por defecto es la cadena vacía. Solo es aplicable si el tamaño del contenedor embebido es inferior a 215 píxeles.

  • auth-needed-message-small: especifica el texto para el mensaje que requiere autenticación. El valor por defecto es "Requires Authentication". Solo es aplicable si el tamaño del contenedor embebido es inferior a 160 píxeles.

Uso de una autenticación de OAuth en tres partes con contenido de Oracle Analytics embebido

Utilice el método de autenticación mediante OAuth de 3 partes al embeber contenido de Oracle Analytics en un portal o una aplicación web que ya use su propio método de autenticación.

Para disfrutar de una experiencia de usuario ininterrumpida, la página web personalizada y Oracle Analytics deben utilizar el mismo proveedor de autenticación. Por ello, en el caso de una aplicación web de terceros, necesitaría utilizar la misma instancia de Oracle Identity Cloud Service que Oracle Analytics (es decir, la misma instancia de Oracle Identity Cloud Service o el mismo dominio de identidad de Oracle Cloud Infrastructure Identity and Access Management [IAM]), o bien Oracle Analytics necesitaría federarse en el proveedor de autenticación de terceros. 

Para poder realizar una autenticación adecuada, debe especificar el parámetro de OAuth de 3 partes para todas las solicitudes del servidor.

  1. Defina el parámetro IDCS_OAUTH3LEGGED en true en la referencia de script embedding.js.
  2. Especifique el tipo de configuración de seguridad de oauth_3legged en la aplicación mediante la función setSecurityConfig.

Ejemplo

Aquí project-path especifica la ruta del repositorio del libro de trabajo.

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

Uso de la autenticación de token con contenido de Oracle Analytics embebido

Utilice el método de autenticación de token cuando desee autenticarse en Oracle Analytics en segundo plano, pero no desee utilizar OAuth de 3 partes.

Actualice la página HTML para permitir una autenticación de token correcta. Para obtener información sobre cómo generar tokens, consulte Protección de las autorizaciones en Oracle Cloud.

  1. En la página HTML, defina el parámetro TOKEN en true en la referencia de script embedding.js.
  2. Especifique el tipo de configuración de seguridad del token. Agregue las funciones para recuperar el token en la aplicación mediante la función setSecurityConfig. Consulte el ejemplo siguiente.

Ejemplo

En este ejemplo, se utiliza una API para obtener el token. Si en la página HTML se utiliza una API para obtener el token, debe hacer que la API necesaria esté disponible.

Aquí project-path especifica la ruta del repositorio del libro de trabajo.

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