Práticas recomendadas de segurança para o Cortex Code CLI¶

Credenciais¶

Use autenticação baseada em navegador quando possível.

O método de autenticação padrão para o Cortex Code CLI é a autenticação baseada no navegador. Use authenticator = "externalbrowser" no arquivo connections.toml para definir esta opção manualmente.

Use tokens de acesso programático (PATs) ao tentar definir o escopo do acesso a uma função específica.

Geração de PATs dedicados no Snowsight (consulte Uso de tokens de acesso programático para autenticação). Defina a expiração para até 90 dias, use nomes descritivos e alterne regularmente.

Proteção de arquivos de configuração

Use o modo 600 com arquivos de configuração e 700 com diretórios para restringir o acesso apenas ao seu usuário.

chmod 600 ~/.snowflake/connections.toml
chmod 700 ~/.snowflake/cortex

Copy

Nunca confirme credenciais

Adicione arquivos de configuração confidenciais a .gitignore.

echo "~/.snowflake/connections.toml" >> ~/.gitignore

Copy

Use variáveis de ambiente para manter credenciais e tokens e incorporá-los em seus arquivos de configuração usando a sintaxe ${VARIABLE_NAME}.

Funções e acesso¶

Uso das funções apropriadas por ambiente

Por exemplo, use uma função somente leitura na produção e uma função mais abrangente no desenvolvimento.

[dev]
role = "DEVELOPER"

[prod_readonly]
role = "ANALYST"

Copy

Nunca use ACCOUNTADMIN para operações de rotina. Conceda menos privilégios.

Histórico de conversas¶

As conversas são armazenadas em ~/.snowflake/cortex/conversations/. Use cortex --private ao iniciar o Cortex Code para desabilitar o salvamento de sessões de trabalho confidenciais. Alternativamente, use o comando /clear para limpar a sessão atual antes de sair do Cortex Code CLI.

Use o modo 700 para restringir o acesso ao histórico de conversas somente ao seu usuário.

chmod 700 ~/.snowflake/cortex/conversations

Segurança MCP¶

Instale apenas os servidores MCP confiáveis

Verifique a fonte e a integridade dos servidores MCP antes de adicioná-los. Use os comandos a seguir para obter uma lista e remover quaisquer servidores não confiáveis:

cortex mcp list
cortex mcp remove <server>

Copy

Nunca codifique credenciais de MCP

Use variáveis ​ ​de ambiente. Primeiro, defina em seu shell:

export GITHUB_TOKEN="your_token"

Copy

Em seguida, faça referência a eles na sua configuração de MCP:

{
   "mcpServers": {
      "github": {
         "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
      }
   }
}

Copy

Segurança de produção¶

Ativação do modo de planejamento

Use o comando /plan para revisar as ações pretendidas antes da execução.

/plan
Drop and recreate the ANALYTICS schema

Copy

Caso seu token de acesso pessoal seja comprometido¶

Revogue o PAT no Snowsight imediatamente! Em seguida, gere um novo token e comece a usá-lo. Lembre-se de não usar o token nos arquivos de configuração; use variáveis de ambiente.

Revise o histórico de consultas para identificar qualquer atividade suspeita.

SHOW QUERIES IN ACCOUNT

Configurações gerenciadas (política corporativa)¶

Em algumas organizações, os administradores implantam configurações gerenciadas que aplicam políticas para o Cortex Code CLI. As configurações gerenciadas podem restringir ou substituir a configuração em nível de usuário (incluindo solicitações de permissão e comportamento de bypass).

Para obter mais informações, consulte Configurações gerenciadas (política da organização).

Permissões¶

O Cortex Code tem três modos operacionais:

Pressione Shift-Tab no Cortex Code CLI para alternar entre esses modos.

{
   "hooks": {
      "PreToolUse": [
         {
         "matcher": "Bash",
         "hooks": [
            {
               "type": "command",
               "command": "bash .claude/hooks/auto-approve.sh"
            }
         ]
         }
      ]
   }
}

{
   "hookSpecificOutput": {
      "hookEventName": "PreToolUse",
      "permissionDecision": "allow",
      "permissionDecisionReason": "Approved by policy"
   }
}

{
   "/path/to/project": {
      "Bash": {
         "npm test": "allow",
         "make build": "allow"
      },
      "Write": {
         "*": "allow"
      }
   }
}

Lista de verificação de segurança¶

• Use PATs que expiram em no máximo 90 dias

• Defina as permissões de arquivo como 600/700

• Nunca confirme credenciais para o git

• Use funções de privilégio mínimo

• Nunca use ACCOUNTADMIN para trabalhos de rotina

• Habilite o modo de planejamento para produção e reserve o modo bypass para ambientes confiáveis

• Instale apenas os servidores MCP confiáveis

• Armazene credenciais em variáveis de ambiente

• Use ganchos para aplicar políticas, automatizando verificações de segurança personalizadas

• Faça uma auditoria periódica das permissões