Passer au contenu principal
POST
Créer un profil de sécurité de l’Enterprise
Crée un profil de sécurité appartenant à l’Enterprise et partagé avec toutes ses organisations. Les organisations peuvent le sélectionner, mais seuls les administrateurs d’entreprise peuvent le modifier. Pour l’appliquer à l’échelle de l’entreprise, utilisez Définir le profil par défaut de l’Enterprise.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant de l’autorisation ManageAccountSecureModeProfiles au niveau Enterprise. Disponible uniquement pour les comptes d’entreprise.

Comportement

  • Seul name est obligatoire. Les noms de profil doivent être uniques au sein de l’Enterprise.
  • Si net_policy est omis, le profil part d’une liste d’autorisation contenant uniquement l’hôte de l’intégration Git (le même point de départ que sur la page des paramètres). Une valeur null explicite signifie que le profil n’impose aucune politique réseau, et non qu’il bloque tout.
  • remove_github_cli_token vaut true par défaut. Pour conserver le token (false), il faut git_access_level: read_write et, si une politique réseau est définie, une liste d’autorisation incluant api.github.com.
  • Par défaut, git_access_level vaut read_write et enforcement_level vaut recommended.

Autorisations

Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Corps

application/json
name
string
requis
Required string length: 1 - 128
devin_mcp_read_only
boolean
défaut:false
enforcement_level
enum<string>
défaut:recommended
Options disponibles:
recommended,
mandatory
git_access_level
enum<string>
défaut:read_write
Options disponibles:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Omis = une liste d’autorisation contenant uniquement l’hôte de l’intégration Git (la même valeur par défaut que celle proposée initialement dans l’UI des Profils de sécurité) ; null explicite = ce profil n’exprime aucune préférence en matière de réseau (cela ne signifie PAS que tout est bloqué). Comme la liste d’autorisation par défaut n’inclut pas api.github.com, une requête avec remove_github_cli_token=false doit fournir explicitement net_policy (ou null).

remove_github_cli_token
boolean
défaut:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Omis ou null = ce profil n’exprime aucune préférence concernant les canaux Slack (le paramètre Slack de l’organisation s’applique).

slack_dm_scope
enum<string> | null

Omis ou null = ce profil n’exprime aucune préférence concernant les messages privés Slack (le paramètre Slack de l’organisation s’applique).

Options disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Omis ou null = ce profil n’exprime aucune préférence concernant les canaux Teams (le paramètre d’accès par défaut à Teams de l’organisation s’applique).

teams_dm_scope
enum<string> | null

Omis ou null = ce profil n’exprime aucune préférence concernant les messages privés Teams (le paramètre d’accès par défaut à Teams de l’organisation s’applique).

Options disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Omis ou null = ce profil n’exprime aucune préférence concernant les conversations de groupe Teams (l’accès est dérivé du paramètre d’accès par défaut à Teams de l’organisation, comme pour les messages privés).

Options disponibles:
disabled,
origin_chat

Réponse

Réponse réussie

Un profil de sécurité appartenant à une Enterprise, partagé avec toutes les organisations de l’Enterprise. L’Enterprise propriétaire est déterminée implicitement par le token de l’appelant.

created_at
integer
requis
devin_mcp_read_only
boolean
requis

Si la valeur est true, les sessions peuvent uniquement appeler les outils MCP de Devin en lecture seule (aucune création de session, gestion des automatisations ou autre opération d’écriture).

enforcement_level
enum<string>
requis

Les profils recommandés peuvent être remplacés par des associations de niveau inférieur ; les profils obligatoires constituent un socle de restrictions que les politiques de niveau inférieur ne peuvent que renforcer.

Options disponibles:
recommended,
mandatory
git_access_level
enum<string>
requis
Options disponibles:
read_only,
read_write
name
string
requis
profile_id
string
requis

L’ID du profil de sécurité.

remove_github_cli_token
boolean
requis

Si la valeur est true, le token de l’interface en ligne de commande GitHub est supprimé de la machine de la session, ce qui empêche tout accès direct à l’API GitHub.

updated_at
integer
requis
mcp_config
SecurityProfileMcpConfig · object | null

null = ce profil n’a aucune préférence concernant MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = ce profil n’a aucune préférence concernant le réseau (cela ne signifie PAS que tout est interdit).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Périmètre maximal des canaux Slack dans lesquels les sessions régies par ce profil peuvent lire et publier des messages. null = ce profil n’a aucune préférence et le paramètre Slack de l’organisation s’applique.

slack_dm_scope
enum<string> | null

Périmètre maximal des personnes autorisées à envoyer des messages directs à Devin dans Slack avec ce profil. null = ce profil n’a aucune préférence et le paramètre Slack de l’organisation s’applique. 'workspace' est restreint à 'org_members' pour les comptes d’entreprise.

Options disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Périmètre maximal des canaux Microsoft Teams dans lesquels les sessions régies par ce profil peuvent lire et publier des messages. null = ce profil n’a aucune préférence et le paramètre d’accès par défaut à Teams de l’organisation s’applique.

teams_dm_scope
enum<string> | null

Périmètre maximal des personnes auxquelles Devin peut envoyer des messages directs dans Microsoft Teams avec ce profil. null = ce profil n’a aucune préférence et le paramètre d’accès par défaut à Teams de l’organisation s’applique.

Options disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Périmètre maximal des conversations de groupe Teams que Devin peut lire avec ce profil ; origin_chat = uniquement la conversation de groupe depuis laquelle la session a été lancée ; null = aucune préférence, l’accès est déterminé à partir du paramètre d’accès par défaut à Teams de l’organisation, comme pour les messages directs.

Options disponibles:
disabled,
origin_chat