Vai al contenuto principale
POST
Crea un profilo di sicurezza dell'org
Crea un profilo di sicurezza di proprietà dell’organizzazione. La creazione di un profilo non comporta la sua applicazione; per associarlo come valore predefinito, usa Imposta i valori predefiniti del profilo di sicurezza dell’org.

Autorizzazioni

Richiede un utente di servizio o un token di accesso personale con l’autorizzazione ManageSecureModeProfiles a livello di organizzazione. I token usati da una sessione Devin in esecuzione vengono rifiutati, in modo che una sessione non possa modificare i profili che la governano.

Comportamento

  • Solo name è obbligatorio. I nomi dei profili devono essere univoci all’interno dell’organizzazione.
  • 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 null esplicito indica che il profilo non definisce alcuna network policy, non che blocca tutto il traffico.
  • Il valore predefinito di remove_github_cli_token è true. Per mantenere il token (false) è necessario impostare 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_)

Parametri del percorso

org_id
string
obbligatorio

ID dell'organizzazione (prefisso: org-)

Esempio:

"org-abc123def456"

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'organizzazione.

created_at
integer
obbligatorio
devin_mcp_read_only
boolean
obbligatorio

Se true, le sessioni possono chiamare solo strumenti Devin MCP 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 sovrascritti dalle associazioni dei livelli inferiori; i profili obbligatori impongono restrizioni minime che le policy dei livelli inferiori possono solo rendere più rigide.

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

L'ID del profilo di sicurezza.

remove_github_cli_token
boolean
obbligatorio

Se true, il token della GitHub CLI 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 su MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = questo profilo non esprime alcuna preferenza sulla rete (NON significa bloccare tutto).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Limite ai canali Slack in cui le sessioni regolate da 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

Limite agli 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. 'workspace' viene limitato a 'org_members' per gli account enterprise.

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

Limite ai canali Microsoft Teams in cui le sessioni regolate da questo profilo possono leggere e pubblicare messaggi. null = questo profilo non esprime alcuna preferenza e si applica l'accesso predefinito a Teams dell'organizzazione.

teams_dm_scope
enum<string> | null

Limite ai destinatari a cui Devin può inviare messaggi diretti su Microsoft Teams con questo profilo. null = questo profilo non esprime alcuna preferenza e si applica l'accesso predefinito a Teams dell'organizzazione.

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

Limite alle 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, l'accesso deriva dall'accesso predefinito a Teams dell'org, come per i messaggi diretti.

Opzioni disponibili:
disabled,
origin_chat