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.
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.
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.
IDCS_OAUTH3LEGGED
como true na referência do script embedding.js
.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>
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.
TOKEN
como true na referência do script embedding.js.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>