Antonio Sergio Rodrigues Figueiredo
56c11d0715
Estado na virada para versionamento: Secoes 1-5 do setup de banco validadas ponta a ponta (ONNX CLIP corrigido - ORA-54426; regiao do Generative AI corrigida na Secao 5.3 - ORA-20404), observabilidade de IA adicionada (TB_26AI_TECH_LOG + PRC_26AI_TECH_LOG instrumentando FNC_26ai_rag/fnc_26ai_tech_rag/fnc_26ai_embed/PRC_26AI_TECH), bug de vazamento de sqlerrm em insight_report corrigido, job de geracao em lote agora se autoencerra, e nova doc 09-operacao-observabilidade.html com checklist de erros comuns e consultas de troubleshooting. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
86 lines
5.5 KiB
HTML
86 lines
5.5 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="pt-BR">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>ampmInsights · Segurança & boas práticas</title>
|
|
<meta name="description" content="Recomendações de segurança e boas práticas para o ambiente ampmInsights.">
|
|
<link rel="stylesheet" href="assets/main.css">
|
|
</head>
|
|
<body>
|
|
<div class="layout">
|
|
<aside class="sidebar">
|
|
<div class="brand">
|
|
<span class="oracle">ORACLE</span>
|
|
<span class="name">ampmInsights</span>
|
|
</div>
|
|
<button class="menu-toggle" type="button">Menu ☰</button>
|
|
<div class="kicker">Documentação V1 · AM/PM</div>
|
|
<ul class="nav-list">
|
|
<li><a class="" href="index.html"><span class="step-no">1</span>Visão geral</a></li>
|
|
<li><a class="" href="02-arquitetura.html"><span class="step-no">2</span>Arquitetura</a></li>
|
|
<li><a class="" href="03-pre-requisitos-credenciais.html"><span class="step-no">3</span>Pré-requisitos & credenciais</a></li>
|
|
<li><a class="" href="04-passo-a-passo-banco.html"><span class="step-no">4</span>Passo a passo: banco de dados</a></li>
|
|
<li><a class="" href="05-passo-a-passo-apex.html"><span class="step-no">5</span>Passo a passo: aplicação APEX</a></li>
|
|
<li><a class="" href="06-validacao-testes.html"><span class="step-no">6</span>Validação & testes</a></li>
|
|
<li><a class="active" href="07-seguranca-boas-praticas.html"><span class="step-no">7</span>Segurança & boas práticas</a></li>
|
|
<li><a class="" href="08-glossario-roadmap.html"><span class="step-no">8</span>Glossário & roadmap</a></li>
|
|
<li><a class="" href="09-operacao-observabilidade.html"><span class="step-no">9</span>Operação & observabilidade</a></li>
|
|
</ul>
|
|
<div class="sidebar-footer">
|
|
Vulnerability & Audit AI Insights<br>
|
|
Oracle AI Database 26ai · AI Vector Search<br>
|
|
Versão V1 · ambiente reprodutível do cliente
|
|
</div>
|
|
</aside>
|
|
<main class="content">
|
|
<p class="page-kicker">Segurança</p>
|
|
<h1>Segurança & boas práticas</h1>
|
|
<p class="lede">Boas práticas de segurança, escopo atual de autenticação e pontos de atenção para o time funcional antes de liberar o ambiente aos usuários finais.</p>
|
|
|
|
<h2>Boas práticas para o ambiente do cliente</h2>
|
|
<div class="grid">
|
|
<div class="card"><h4>Privilégio mínimo</h4><p>Restrinja a política IAM da API key ao compartimento e ao bucket estritamente necessários (ver exemplo em Pré-requisitos).</p></div>
|
|
<div class="card"><h4>Rotação periódica</h4><p>Defina um ciclo de rotação da API key e da senha do schema <code>AMPMINSIGHTS</code>.</p></div>
|
|
<div class="card"><h4>ACL de rede restrita</h4><p>A regra de rede liberada cobre apenas o host de Generative AI necessário — evite abrir hosts adicionais sem necessidade.</p></div>
|
|
<div class="card"><h4>Sem segredos em texto puro</h4><p>Nunca deixe a chave privada ou senha do schema em planilhas, chats ou repositórios compartilhados.</p></div>
|
|
</div>
|
|
|
|
<h2>Autenticação — escopo desta versão e próxima release</h2>
|
|
<p>Esta versão (V1) usa a autenticação nativa do Oracle APEX: usuário e senha, com
|
|
autoprovisionamento de conta por domínio de e-mail corporativo e troca de senha obrigatória no
|
|
primeiro acesso (ver Seção 5 · Passo a passo: aplicação APEX).</p>
|
|
<div class="callout info">
|
|
<div class="callout-title">Planejado para a próxima release</div>
|
|
<p>A autenticação via <strong>SSO</strong> (login federado com o provedor de identidade da AM/PM)
|
|
para os usuários finais da aplicação está prevista para a próxima release, junto com as demais
|
|
integrações de autenticação/identidade descritas na documentação da Jornada Agêntica. Nenhum desses
|
|
itens faz parte do escopo desta versão V1.</p>
|
|
</div>
|
|
|
|
<h2>Itens que precisam de atenção do time funcional antes de liberar aos usuários finais</h2>
|
|
<ul>
|
|
<li><strong>Autoprovisionamento de acesso:</strong> o cadastro automático de novos usuários (com envio de senha inicial por e-mail) só cria a conta se o e-mail informado bater com o domínio configurado
|
|
<code><SUBSTITUA-PELO-DOMINIO-CORPORATIVO-DA-AMPM.COM.BR></code> — confirme que esse domínio está com o valor real da AM/PM na página de cadastro antes de liberar o app, ou nenhum usuário conseguirá se autoprovisionar.</li>
|
|
<li><strong>Disclaimer de uso:</strong> revise a redação final do texto de disclaimer exibido no app com o time de compliance/segurança da informação da AM/PM antes de liberar aos usuários finais.</li>
|
|
</ul>
|
|
|
|
<h2>Sobre a normalização de nome de marca na view</h2>
|
|
<p>A view <code>V_26AI_TECH</code> contém duas chamadas <code>REPLACE()</code> que padronizam
|
|
os valores de <code>NOME</code>/<code>EMPRESA</code> para "Company" quando o CMDB traz "Ipiranga" ou
|
|
"Ampm". Avalie com o time de negócio se essa normalização ainda faz sentido para o ambiente da AM/PM
|
|
ou se deve ser removida da view.</p>
|
|
|
|
<h2>Privacidade dos dados</h2>
|
|
<p>As tabelas de vulnerabilidade e CMDB carregam dados reais e sensíveis do ambiente da AM/PM
|
|
(inventário de ativos, severidade de vulnerabilidades, criticidade de sistemas). Trate a base
|
|
carregada com o mesmo nível de confidencialidade do relatório de origem (Tenable/CMDB), inclusive
|
|
em ambientes de teste/demonstração.</p>
|
|
|
|
<div class="pillnav"><a class="prev" href="06-validacao-testes.html">← Validação & testes</a><a class="next" href="08-glossario-roadmap.html">Glossário & roadmap →</a></div>
|
|
</main>
|
|
</div>
|
|
<script src="assets/main.js"></script>
|
|
</body>
|
|
</html>
|