Pular para o conteúdo principal
POST
Criar um perfil de segurança da empresa
Cria um perfil de segurança que pertence à empresa e é compartilhado com todas as suas organizações. As organizações podem selecioná-lo, mas somente os administradores do Enterprise podem editá-lo. Para aplicá-lo em toda a empresa (enterprise-wide), use Definir o perfil padrão da empresa.

Permissões

Requer um usuário de serviço ou um token de acesso pessoal com a permissão ManageAccountSecureModeProfiles no nível empresarial. Disponível apenas para contas empresariais.

Comportamento

  • Apenas name é obrigatório. Os nomes de perfil devem ser únicos na empresa.
  • Quando net_policy é omitido, o perfil parte de uma lista de permissões que contém apenas o host da integração com o Git (o mesmo ponto de partida da página de configurações). Um null explícito significa que o perfil não define nenhuma network policy, e não que todo o acesso é negado.
  • O valor padrão de remove_github_cli_token é true. Para manter o token (false), é necessário git_access_level: read_write e, quando houver uma network policy definida, uma lista de permissões que inclua api.github.com.
  • O valor padrão de git_access_level é read_write, e o de enforcement_level é recommended.

Autorizações

Authorization
string
header
obrigatório

Credencial de usuário de serviço (prefixo: cog_)

Corpo

application/json
name
string
obrigatório
Required string length: 1 - 128
devin_mcp_read_only
boolean
padrão:false
enforcement_level
enum<string>
padrão:recommended
Opções disponíveis:
recommended,
mandatory
git_access_level
enum<string>
padrão:read_write
Opções disponíveis:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Omitido = uma lista de permissões contendo apenas o host da integração com o Git (o mesmo padrão inicial da UI de Perfis de Segurança); null explícito = este perfil não define uma preferência de rede (NÃO significa bloquear tudo). Como a lista de permissões padrão não inclui api.github.com, uma requisição com remove_github_cli_token=false deve fornecer net_policy explicitamente (ou null).

remove_github_cli_token
boolean
padrão:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Omitido ou null = este perfil não define uma preferência para canais do Slack (aplica-se a configuração do Slack da organização).

slack_dm_scope
enum<string> | null

Omitido ou null = este perfil não define uma preferência para mensagens diretas no Slack (aplica-se a configuração do Slack da organização).

Opções disponíveis:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Omitido ou null = este perfil não define uma preferência para canais do Teams (aplica-se o Acesso Padrão do Teams da organização).

teams_dm_scope
enum<string> | null

Omitido ou null = este perfil não define uma preferência para mensagens diretas no Teams (aplica-se o Acesso Padrão do Teams da organização).

Opções disponíveis:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Omitido ou null = este perfil não define uma preferência para conversas em grupo no Teams (a configuração é derivada do Acesso Padrão do Teams da organização, assim como nas mensagens diretas).

Opções disponíveis:
disabled,
origin_chat

Resposta

Resposta Bem-Sucedida

Um perfil de segurança pertencente à empresa, compartilhado com todas as organizações da empresa. A empresa proprietária é determinada implicitamente pelo token do solicitante.

created_at
integer
obrigatório
devin_mcp_read_only
boolean
obrigatório

Quando true, as sessões só podem chamar ferramentas MCP do Devin de somente leitura (sem criação de sessões, gerenciamento de automações ou outras operações de gravação).

enforcement_level
enum<string>
obrigatório

perfis recomendados podem ser substituídos por vinculações de níveis inferiores; perfis obrigatórios definem restrições mínimas que as políticas desses níveis só podem tornar mais rigorosas.

Opções disponíveis:
recommended,
mandatory
git_access_level
enum<string>
obrigatório
Opções disponíveis:
read_only,
read_write
name
string
obrigatório
profile_id
string
obrigatório

O ID do perfil de segurança.

remove_github_cli_token
boolean
obrigatório

Quando true, o token da CLI do GitHub é removido da máquina da sessão, impedindo o acesso direto à API do GitHub.

updated_at
integer
obrigatório
mcp_config
SecurityProfileMcpConfig · object | null

null = este perfil não tem nenhuma preferência quanto ao MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = este perfil não tem nenhuma preferência quanto à rede (isso NÃO significa negar tudo).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Restrição dos canais do Slack nos quais as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não tem nenhuma preferência e a configuração do Slack da organização se aplica.

slack_dm_scope
enum<string> | null

Restrição de quem pode enviar mensagens diretas ao Devin no Slack com este perfil. null = este perfil não tem nenhuma preferência e a configuração do Slack da organização se aplica. 'workspace' é restrito a 'org_members' para contas empresariais.

Opções disponíveis:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Restrição dos canais do Microsoft Teams nos quais as sessões regidas por este perfil podem ler e publicar mensagens. null = este perfil não tem nenhuma preferência e o Acesso Padrão do Teams da organização se aplica.

teams_dm_scope
enum<string> | null

Restrição de quem pode receber mensagens diretas do Devin no Microsoft Teams com este perfil. null = este perfil não tem nenhuma preferência e o Acesso Padrão do Teams da organização se aplica.

Opções disponíveis:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Restrição dos chats em grupo do Teams que o Devin pode ler com este perfil; origin_chat = somente o chat em grupo a partir do qual a sessão foi iniciada; null = nenhuma preferência, com o acesso determinado pelo Acesso Padrão do Teams da organização, assim como nas mensagens diretas.

Opções disponíveis:
disabled,
origin_chat