Skip to main content

​
Guia de Administração de Segurança FedRAMP

Este guia descreve como configurar, operar e desativar com segurança contas administrativas de nível superior no Windsurf. Ele abrange definições de funções administrativas, procedimentos de ciclo de vida de contas e todas as configurações de segurança controladas por administradores, com suas respectivas funções, impactos na segurança e valores recomendados.
Este guia foi escrito para a implantação FedRAMP do Windsurf, que é executada na AWS GovCloud. A implantação FedRAMP usa um portal corporativo dedicado e autenticação baseada em SSO (Single Sign-On), via OIDC ou SAML 2.0. Alguns recursos descritos em outra documentação do Windsurf, relativa à oferta SaaS, não estão disponíveis no ambiente FedRAMP.

​
Definições de funções administrativas

Windsurf utiliza um sistema de Controle de Acesso Baseado em Funções (RBAC) para controlar privilégios administrativos. As funções são gerenciadas no Admin Portal, na seção de configurações Role Management, e podem ser atribuídas a usuários individualmente.

​
Funções internas

Windsurf fornece duas funções internas que não podem ser removidas.

​
Funções personalizadas

Administradores podem criar funções personalizadas para aplicar o princípio do privilégio mínimo. Funções personalizadas são compostas por permissões granulares selecionadas entre as categorias abaixo. Para criar uma função personalizada, acesse o Admin Portal e abra a seção Role Management em Settings.

​
Referência de permissões

A tabela abaixo lista todas as permissões disponíveis para atribuição de função na implantação FedRAMP. Cada permissão controla o acesso a uma função administrativa específica.
Algumas dessas permissões (como Attribution, License, SSO, Indexing, Fine-Tuning) existem no sistema de RBAC, mas suas páginas correspondentes no portal não estão disponíveis na implantação FedRAMP multi-tenant. Essas permissões são incluídas na interface de gerenciamento de funções para fins de completude, mas não concedem acesso a nenhum recurso ativo neste ambiente.

​
Procedimentos do ciclo de vida de contas de administrador

Esta seção descreve o ciclo de vida de ponta a ponta de uma conta de administrador de nível superior, desde a criação inicial até a desativação.

​
Configuração de contas

O onboarding baseado em SSO (Single Sign-On) é o principal método de provisionamento na implantação FedRAMP. A plataforma oferece suporte a OIDC e SAML 2.0 para integração de Single Sign-On. Os usuários se autenticam por meio do provedor de identidade configurado e, depois que a conta é criada no primeiro login do usuário, um administrador atribui a função apropriada por meio do Admin Portal. Observe que a integração de SSO no ambiente FedRAMP requer coordenação com a equipe FedRAMP da Windsurf e não pode ser configurada em modo de autoatendimento. Cada nova conta de administrador deve ser configurada de acordo com o princípio do menor privilégio. Dê preferência a funções personalizadas com apenas as permissões necessárias para as responsabilidades do administrador, em vez de atribuir a função de Administrador completa, a menos que o usuário exija acesso total ao sistema.

​
Requisitos de autenticação e MFA

A implantação FedRAMP usa exclusivamente Single Sign-On (SSO), com suporte aos protocolos OIDC e SAML 2.0. A autenticação por e-mail e senha não está disponível. Todos os usuários devem se autenticar por meio do provedor de identidade configurado. A Autenticação Multifator (MFA) é aplicada pelo provedor de identidade da organização. O Windsurf herda as políticas de MFA configuradas no IdP conectado, o que significa que todos os requisitos de segurança da autenticação (como exigência de um segundo fator, autenticadores resistentes a phishing ou políticas de acesso condicional) são definidos no nível do IdP. As organizações devem configurar seu IdP para exigir MFA de todos os usuários que acessam o aplicativo Windsurf, particularmente para contas com funções administrativas.
O Windsurf recomenda fortemente que seja exigido MFA para todas as contas administrativas. Configure seu provedor de identidade para aplicar MFA como condição para acessar o aplicativo Windsurf.

​
Configuração da conta

Após a criação de uma conta administrativa, as seguintes etapas de configuração devem ser concluídas. Atribuição de função determina o escopo do acesso administrativo da conta. Atribua funções no Admin Portal, acessando a guia Manage Team, localizando o usuário, clicando em Edit e selecionando a função apropriada no menu suspenso. As alterações entram em vigor imediatamente. Gerenciamento de Chave de serviço é necessário quando o administrador precisa de acesso à API para automação ou Analytics. As chaves de serviço são criadas em Settings com permissões de escopo que correspondem ao uso pretendido da chave. Cada chave de serviço deve ter um nome descritivo (por exemplo, “Analytics Dashboard”) e ter atribuída uma função com o mínimo de permissões necessárias.

​
Operação de contas

As práticas operacionais contínuas para contas administrativas incluem o seguinte: Revisões regulares de acesso devem ser realizadas para verificar se as contas administrativas ainda precisam do nível atual de acesso. Revise periodicamente a lista de usuários com a função Admin pela aba Manage Team e ajuste as funções conforme as responsabilidades forem mudando. O monitoramento de atividades está disponível por meio dos painéis de Analytics integrados. Administradores com a permissão Analytics Read podem acompanhar a atividade dos usuários, métricas de engajamento e uso de funcionalidades. A Analytics API fornece acesso programático a esses dados para integração com sistemas de monitoramento externos. A rotação de chaves de serviço deve ser realizada em um cronograma regular. Para fazer a rotação de uma chave, crie uma nova chave de serviço com as mesmas permissões, atualize o sistema consumidor para usar a nova chave e, em seguida, exclua a chave antiga.

​
Desativação de contas

Quando um administrador não precisar mais de acesso, a conta deve ser desativada prontamente seguindo o procedimento abaixo.
1

Revogar função administrativa

Acesse o Admin Portal, abra a guia Manage Team, localize o usuário, clique em Edit e altere sua função de Admin para User (ou uma função personalizada sem permissões administrativas).
2

Revogar chaves de serviço

Exclua quaisquer Service Keys que tenham sido criadas por ou usadas exclusivamente pelo administrador que está saindo. Acesse Settings, depois Service Key, e exclua as chaves relevantes.
3

Remover ou desativar a conta

Remova o usuário por meio da guia Manage Team clicando em Delete ao lado do seu nome. Isso desativará a conta Windsurf do usuário e liberará sua vaga de licença.
4

Revisar acessos residuais

Verifique se a conta desativada não aparece mais em nenhuma função administrativa consultando a lista de usuários em Manage Team filtrada pela função Admin. Confirme que todas as Service Keys associadas à conta foram excluídas.
Desative contas administrativas imediatamente quando um administrador mudar de função ou sair da organização. A desativação tardia gera uma exposição de segurança desnecessária.

​
Referência de configurações de segurança

A tabela abaixo descreve todas as configurações de segurança controladas por administradores disponíveis no Admin Portal da implantação FedRAMP. Cada entrada explica a função da configuração, seu impacto na segurança e a configuração recomendada para uma implantação com foco em segurança. Última atualização: 28 de janeiro de 2026