Passer au contenu principal
POST
Créer un profil de sécurité de l’organisation
Crée un profil de sécurité appartenant à l’organisation. La création d’un profil ne l’applique à aucune ressource ; pour le définir comme valeur par défaut, utilisez Définir les valeurs par défaut des profils de sécurité de l’organisation.

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel disposant de l’autorisation ManageSecureModeProfiles au niveau de l’organisation. Les jetons utilisés par une session Devin en cours d’exécution sont rejetés : une session ne peut donc pas modifier les profils qui la régissent.

Comportement

  • Seul name est obligatoire. Les noms de profil doivent être uniques au sein de l’organisation.
  • Si net_policy est omis, le profil part d’une liste d’autorisation ne contenant que 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 ne définit aucune règle 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_)

Paramètres de chemin

org_id
string
requis

Identifiant d’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

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 organisation.

created_at
integer
requis
devin_mcp_read_only
boolean
requis

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

enforcement_level
enum<string>
requis

les profils recommandés peuvent être remplacés par des associations définies à des niveaux inférieurs ; les profils obligatoires constituent un socle de restrictions que les politiques de ces niveaux peuvent uniquement renforcer.

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

L’ID du profil de sécurité.

remove_github_cli_token
boolean
requis

Lorsque la valeur est true, le token GitHub CLI est supprimé de la machine de la session, empêchant tout accès direct à l’API GitHub.

updated_at
integer
requis
mcp_config
SecurityProfileMcpConfig · object | null

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

net_policy
SecurityProfileNetPolicy · object | null

null = ce profil n’exprime aucune préférence en matière de réseau (cela ne signifie PAS que tout est bloqué).

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’exprime 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 privés à Devin dans Slack avec ce profil. null = ce profil n’exprime 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’exprime 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 privés dans Microsoft Teams avec ce profil. null = ce profil n’exprime 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é démarrée ; null = aucune préférence, 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