Zum Hauptinhalt springen
POST
Ein Security Profile auf Enterprise-Ebene erstellen
Erstellt ein Security Profile, das zur Enterprise gehört und für alle ihre Organisationen freigegeben ist. Organisationen können es auswählen, bearbeiten können es jedoch nur Enterprise-Admins. Um es unternehmensweit anzuwenden, verwenden Sie Enterprise-Standardprofil festlegen.

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageAccountSecureModeProfiles auf Enterprise-Ebene. Nur für Enterprise-Konten verfügbar.

Verhalten

  • Nur name ist erforderlich. Profilnamen müssen innerhalb des Enterprise eindeutig sein.
  • Wenn net_policy weggelassen wird, beginnt das Profil mit einer Positivliste, die nur den Host der Git-Integration enthält (derselbe Ausgangspunkt wie auf der Settings-Seite). Ein explizites null bedeutet, dass das Profil keine Netzwerkvorgaben macht – und nicht, dass alles verweigert wird.
  • remove_github_cli_token ist standardmäßig true. Um den Token beizubehalten (false), ist git_access_level: read_write erforderlich sowie – sofern eine Netzwerkrichtlinie festgelegt ist – eine Positivliste, die api.github.com enthält.
  • git_access_level ist standardmäßig read_write, enforcement_level standardmäßig recommended.

Autorisierungen

Authorization
string
header
erforderlich

Servicebenutzer-Anmeldedaten (Präfix: cog_)

Body

application/json
name
string
erforderlich
Required string length: 1 - 128
devin_mcp_read_only
boolean
Standard:false
enforcement_level
enum<string>
Standard:recommended
Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string>
Standard:read_write
Verfügbare Optionen:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Weggelassen = eine Allowlist, die nur den Host der Git-Integration enthält (derselbe Ausgangswert wie in der UI für Sicherheitsprofile); explizites null = dieses Profil macht keine Netzwerkvorgabe (das bedeutet NICHT, dass alles verweigert wird). Da die Standard-Allowlist api.github.com nicht enthält, muss bei einer Anfrage mit remove_github_cli_token=false net_policy explizit angegeben werden (gegebenenfalls als null).

remove_github_cli_token
boolean
Standard:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Weggelassen oder null = dieses Profil macht keine Vorgabe für Slack-Kanäle (es gilt die Slack-Einstellung der Organisation).

slack_dm_scope
enum<string> | null

Weggelassen oder null = dieses Profil macht keine Vorgabe für Slack-Direktnachrichten (es gilt die Slack-Einstellung der Organisation).

Verfügbare Optionen:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Weggelassen oder null = dieses Profil macht keine Vorgabe für Teams-Kanäle (es gilt der Teams-Standardzugriff der Organisation).

teams_dm_scope
enum<string> | null

Weggelassen oder null = dieses Profil macht keine Vorgabe für Teams-Direktnachrichten (es gilt der Teams-Standardzugriff der Organisation).

Verfügbare Optionen:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Weggelassen oder null = dieses Profil macht keine Vorgabe für Teams-Gruppenchats (wie bei Direktnachrichten wird die Vorgabe vom Teams-Standardzugriff der Organisation abgeleitet).

Verfügbare Optionen:
disabled,
origin_chat

Antwort

Erfolgreiche Antwort

Ein Security Profile im Besitz eines Enterprise, das allen Organisationen im Enterprise zur Verfügung steht. Das zugehörige Enterprise ergibt sich aus dem Token des Aufrufers.

created_at
integer
erforderlich
devin_mcp_read_only
boolean
erforderlich

Bei true dürfen Sitzungen nur Devin-MCP-Tools mit reinem Lesezugriff aufrufen (keine Sitzungserstellung, Automatisierungsverwaltung oder sonstigen Schreiboperationen).

enforcement_level
enum<string>
erforderlich

Profile vom Typ recommended können durch untergeordnete Bindungen überschrieben werden; Profile vom Typ mandatory legen Mindestbeschränkungen fest, die untergeordnete Richtlinien nur verschärfen dürfen.

Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string>
erforderlich
Verfügbare Optionen:
read_only,
read_write
name
string
erforderlich
profile_id
string
erforderlich

Die ID des Security Profiles.

remove_github_cli_token
boolean
erforderlich

Bei true wird das GitHub-CLI-Token vom Rechner der Sitzung entfernt und damit der direkte Zugriff auf die GitHub-API verhindert.

updated_at
integer
erforderlich
mcp_config
SecurityProfileMcpConfig · object | null

null = dieses Profil macht keine Vorgabe für MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = dieses Profil macht keine Netzwerkvorgabe (das bedeutet NICHT, dass alles gesperrt ist).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Begrenzt, in welchen Slack-Kanälen Sitzungen unter diesem Profil lesen und posten dürfen. null = dieses Profil macht keine Vorgabe; es gilt die Slack-Einstellung der Organisation.

slack_dm_scope
enum<string> | null

Begrenzt, wer Devin unter diesem Profil Direktnachrichten in Slack senden darf. null = dieses Profil macht keine Vorgabe; es gilt die Slack-Einstellung der Organisation. 'workspace' wird bei Enterprise-Konten auf 'org_members' eingeschränkt.

Verfügbare Optionen:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Begrenzt, in welchen Microsoft-Teams-Kanälen Sitzungen unter diesem Profil lesen und posten dürfen. null = dieses Profil macht keine Vorgabe; es gilt der Teams-Standardzugriff der Organisation.

teams_dm_scope
enum<string> | null

Begrenzt, wem Devin unter diesem Profil Direktnachrichten in Microsoft Teams senden darf. null = dieses Profil macht keine Vorgabe; es gilt der Teams-Standardzugriff der Organisation.

Verfügbare Optionen:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Begrenzt, welche Teams-Gruppenchats Devin unter diesem Profil lesen darf; origin_chat = nur der Gruppenchat, aus dem die Sitzung gestartet wurde; null = keine Vorgabe, der Zugriff wird wie bei Direktnachrichten aus dem Teams-Standardzugriff der Organisation abgeleitet.

Verfügbare Optionen:
disabled,
origin_chat