Vai al contenuto principale
PATCH
Aggiorna un profilo di sicurezza dell'azienda
Aggiorna un profilo di sicurezza di proprietà dell’azienda. Le sessioni in esecuzione mantengono le restrizioni determinate al loro ultimo avvio o risveglio; le modifiche si applicano subito alle nuove sessioni e a quelle esistenti alla loro successiva ripresa.

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

  • I campi omessi restano invariati.
  • Un valore null esplicito cancella l’impostazione del profilo per net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope e teams_group_chat_scope. Per gli altri campi, null viene rifiutato.
  • net_policy: null significa che il profilo non definisce alcuna impostazione di rete, non che blocca tutto il traffico. Per bloccare tutto, usa {"allow": []}.
  • mcp_config.servers elenca i server MCP tramite slug (uno slug del marketplace come github oppure lo slug di un’installazione).

Autorizzazioni

Authorization
string
header
obbligatorio

Credenziale dell'utente del servizio (prefisso: cog_)

Parametri del percorso

profile_id
string
obbligatorio

Corpo

application/json

Semantica PATCH: i campi omessi restano invariati; un valore null esplicito cancella i campi che ammettono null (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope) e viene rifiutato per gli altri.

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
Opzioni disponibili:
recommended,
mandatory
git_access_level
enum<string> | null
Opzioni disponibili:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
name
string | null
Required string length: 1 - 128
net_policy
SecurityProfileNetPolicy · object | null
remove_github_cli_token
boolean | null
slack_channel_access
SecurityProfileSlackChannelAccess · object | null
slack_dm_scope
enum<string> | null
Opzioni disponibili:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
Opzioni disponibili:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
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