Acrescentar Autenticação a uma Aplicação ou Página na Web com Conteúdo do Oracle Analytics Incorporado

Utilize os tópicos nesta secção para acrescentar um método de autenticação à sua aplicação da Web ou página na Web do portal que contém conteúdo do Oracle Analytics incorporado.

Utilizar a Autenticação de Prompt de Entrada em Sessão com Conteúdo do Oracle Analytics Incorporado

A autenticação de prompt de entrada em sessão é o método de autenticação por omissão para o conteúdo do Oracle Analytics incorporado numa aplicação Web ou página na Web do portal.

Quando os utilizadores acedem a conteúdo analítico incorporado, é-lhes apresentado um ecrã de entrada em sessão onde introduzem o nome e a senha de entrada em sessão para poderem visualizar dados. Se não existir uma gestão de identidades comum entre o Oracle Analytics e a aplicação Web ou página na Web do portal, este ecrã de entrada em sessão é apresentado aos utilizadores, mesmo que estes já tenham entrado em sessão na aplicação Web ou página na Web do portal que contém o conteúdo analítico incorporado

Customizar a Mensagem de Autenticação de Prompt de Entrada em Sessão

Acrescente atributos ao identificador <oracle-dv> para customizar as mensagens de autenticação de prompt de entrada em sessão. São suportados os seguintes atributos:

  • auth-message-prefix: Especifica o texto de prefixo para a mensagem de entrada em sessão. O valor por omissão é "Oracle Analytics".

  • auth-message-link: Especifica o texto para a ligação de entrada em sessão. O valor por omissão é "Login".

  • auth-message-suffix: Especifica o texto de sufixo para a mensagem de entrada em sessão. O valor por omissão é "Required".

  • auth-needed-message: Especifica o texto para a mensagem de autenticação necessária. O valor por omissão é "Requires Authentication".

  • auth-message-prefix-small: Especifica o texto de prefixo para a mensagem de entrada em sessão. O valor por omissão é "Oracle Analytics". Só é aplicável se o tamanho do container incorporado for inferior a 215 píxeis.

  • auth-message-link-small: Especifica o texto para a ligação de entrada em sessão. O valor por omissão é "Login". Só é aplicável se o tamanho do container incorporado for inferior a 215 píxeis.

  • auth-message-suffix-small - Especifica o texto de sufixo para a mensagem de entrada em sessão. O valor por omissão é a cadeia de caracteres vazia. Só é aplicável se o tamanho do container incorporado for inferior a 215 píxeis.

  • auth-needed-message-small: Especifica o texto para a mensagem de autenticação necessária. O valor por omissão é "Requires Authentication". Só é aplicável se o tamanho do container incorporado for inferior a 160 píxeis.

Utilizar a Autenticação de OAuth em 3 Etapas com Conteúdo do Oracle Analytics Incorporado

Utilize o método de autenticação de OAuth em 3 Etapas ao incorporar conteúdo do Oracle Analytics num portal ou numa aplicação da Web que já utilize o seu próprio método de autenticação.

Para uma experiência de utilizador totalmente integrada, a página na Web customizada e o Oracle Analytics devem utilizar o mesmo fornecedor de autenticação. Assim, no caso de uma aplicação Web de terceiros, esta tem de utilizar o mesmo fornecedor de autenticação Oracle Cloud que o Oracle Analytics (isto é, a mesma instância do Oracle Identity Cloud Service ou o mesmo domínio de identidade do Oracle Cloud Infrastructure Identity and Access Management (IAM)) ou o Oracle Analytics tem de ser federado para o fornecedor de autenticação de terceiros. 

Para permitir uma autenticação adequada, deve especificar o parâmetro de OAuth em 3 Etapas para todos os pedidos do servidor.

  1. Defina o parâmetro IDCS_OAUTH3LEGGED como true na referência do script embedding.js.
  2. Especifique o tipo de configuração de segurança de oauth_3legged para a aplicação utilizando a função setSecurityConfig.

Exemplo

Aqui, project-path especifica o percurso do repositório do livro.

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

Utilizar a Autenticação de Token com Conteúdo do Oracle Analytics Incorporado

Utilize o método de autenticação de token quando pretender efetuar a autenticação no Oracle Analytics em segundo plano, mas não pretender utilizar o OAuth em 3 Etapas.

Atualize a página em HTML para permitir a autenticação de token adequada. Para obter mais informações sobre como gerar tokens, consulte Proteger Autorizações no Oracle Cloud.

  1. Na página em HTML, defina o parâmetro TOKEN como true na referência do script embedding.js.
  2. Especifique o tipo de configuração de segurança do token. Acrescente as funções para obter o token para a aplicação utilizando a função setSecurityConfig. Consulte o exemplo abaixo.

Exemplo

Este exemplo utiliza uma API para obter o token. Se a sua página em HTML utiliza uma API para obter o token, deverá disponibilizar a API necessária.

Aqui, project-path especifica o percurso do repositório do livro.

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