ampmInsights/docs/07-seguranca-boas-praticas.html

<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>ampmInsights &middot; 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 &#9776;</button>
    <div class="kicker">Documentação V1 &middot; 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>
<li><a class="" href="10-carga-cmdb-vulnerabilidades.html"><span class="step-no">10</span>Carga: CMDB & Vulnerabilidades</a></li>
    </ul>
    <div class="sidebar-footer">
      Vulnerability &amp; Audit AI Insights<br>
      Oracle AI Database 26ai &middot; AI Vector Search<br>
      Versão V1 &middot; 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 &middot; 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>&lt;SUBSTITUA-PELO-DOMINIO-CORPORATIVO-DA-AMPM.COM.BR&gt;</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">&larr; Validação & testes</a><a class="next" href="08-glossario-roadmap.html">Glossário & roadmap &rarr;</a></div>
  </main>
</div>
<script src="assets/main.js"></script>
</body>
</html>