Vai al contenuto principale
POST
Crea un profilo di sicurezza dell'azienda
Crea un profilo di sicurezza di proprietà dell’azienda e condiviso con tutte le sue organizzazioni. Le organizzazioni possono selezionarlo, ma solo gli amministratori Enterprise possono modificarlo. Per applicarlo all’intera azienda (enterprise-wide), usa Imposta il profilo predefinito dell’azienda.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageAccountSecureModeProfiles a livello aziendale. Disponibile solo per gli account enterprise.

Comportamento

  • L’unico campo obbligatorio è name. I nomi dei profili devono essere univoci all’interno dell’azienda.
  • Se net_policy viene omesso, il profilo parte da un elenco di elementi consentiti che contiene solo l’host dell’integrazione Git (lo stesso punto di partenza della pagina delle impostazioni). Un valore null esplicito indica che il profilo non definisce alcuna impostazione di rete, non che blocca tutto il traffico.
  • Il valore predefinito di remove_github_cli_token è true. Per mantenere il token (false) sono necessari git_access_level: read_write e, se è impostata una network policy, un elenco di elementi consentiti che includa api.github.com.
  • Il valore predefinito di git_access_level è read_write, mentre quello di enforcement_level è recommended.

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Corpo

application/json
name
string
obbligatorio
Required string length: 1 - 128
devin_mcp_read_only
boolean
predefinito:false
enforcement_level
enum<string>
predefinito:recommended
Opzioni disponibili:
recommended,
mandatory
git_access_level
enum<string>
predefinito:read_write
Opzioni disponibili:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Omesso = un'allowlist contenente solo l'host dell'integrazione Git (la stessa impostazione predefinita iniziale della UI dei profili di sicurezza); null esplicito = questo profilo non esprime alcuna preferenza sulla rete (NON significa bloccare tutto). Poiché l'allowlist predefinita non include api.github.com, una richiesta con remove_github_cli_token=false deve specificare esplicitamente net_policy (eventualmente con valore null).

remove_github_cli_token
boolean
predefinito:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Omesso o null = questo profilo non esprime alcuna preferenza sui canali Slack (si applica l'impostazione Slack dell'organizzazione).

slack_dm_scope
enum<string> | null

Omesso o null = questo profilo non esprime alcuna preferenza sui messaggi diretti su Slack (si applica l'impostazione Slack dell'organizzazione).

Opzioni disponibili:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Omesso o null = questo profilo non esprime alcuna preferenza sui canali Teams (si applica l'accesso predefinito a Teams dell'organizzazione).

teams_dm_scope
enum<string> | null

Omesso o null = questo profilo non esprime alcuna preferenza sui messaggi diretti su Teams (si applica l'accesso predefinito a Teams dell'organizzazione).

Opzioni disponibili:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Omesso o null = questo profilo non esprime alcuna preferenza sulle chat di gruppo di Teams (l'accesso deriva dall'accesso predefinito a Teams dell'organizzazione, come per i messaggi diretti).

Opzioni disponibili:
disabled,
origin_chat

Risposta

Risposta riuscita

Un profilo di sicurezza di proprietà dell'azienda, condiviso con tutte le org dell'azienda. L'azienda proprietaria è determinata implicitamente dal token del chiamante.

created_at
integer
obbligatorio
devin_mcp_read_only
boolean
obbligatorio

Se true, le sessioni possono chiamare solo strumenti MCP di Devin di sola lettura (nessuna creazione di sessioni, gestione di automazioni o altra operazione di scrittura).

enforcement_level
enum<string>
obbligatorio

i profili consigliati possono essere sostituiti dalle associazioni discendenti; i profili obbligatori stabiliscono un livello minimo di restrizioni che le policy discendenti possono solo rendere più severe.

Opzioni disponibili:
recommended,
mandatory
git_access_level
enum<string>
obbligatorio
Opzioni disponibili:
read_only,
read_write
name
string
obbligatorio
profile_id
string
obbligatorio

L'ID del profilo di sicurezza.

remove_github_cli_token
boolean
obbligatorio

Se true, il token della CLI di GitHub viene rimosso dalla macchina della sessione, impedendo l'accesso diretto all'API di GitHub.

updated_at
integer
obbligatorio
mcp_config
SecurityProfileMcpConfig · object | null

null = questo profilo non esprime alcuna preferenza per MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = questo profilo non esprime alcuna preferenza per la rete (NON significa negare ogni accesso).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Limita i canali Slack in cui le sessioni soggette a questo profilo possono leggere e pubblicare messaggi. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Slack dell'organizzazione.

slack_dm_scope
enum<string> | null

Limita gli utenti che possono inviare messaggi diretti a Devin su Slack con questo profilo. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Slack dell'organizzazione. Per gli account enterprise, 'workspace' viene ristretto a 'org_members'.

Opzioni disponibili:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Limita i canali Microsoft Teams in cui le sessioni soggette a questo profilo possono leggere e pubblicare messaggi. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Accesso predefinito di Teams dell'organizzazione.

teams_dm_scope
enum<string> | null

Limita gli utenti a cui Devin può inviare messaggi diretti su Microsoft Teams con questo profilo. null = questo profilo non esprime alcuna preferenza e si applica l'impostazione Accesso predefinito di Teams dell'organizzazione.

Opzioni disponibili:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Limita le chat di gruppo di Teams che Devin può leggere con questo profilo; origin_chat = solo la chat di gruppo da cui è stata avviata la sessione; null = nessuna preferenza, il valore deriva dall'impostazione Accesso predefinito di Teams dell'org, come per i messaggi diretti.

Opzioni disponibili:
disabled,
origin_chat