Zum Hauptinhalt springen
POST
Ein Security Profile für die Organisation erstellen
Erstellt ein Security Profile, das der Organisation gehört. Durch das Erstellen wird das Profil noch nirgends angewendet. Um es als Standard festzulegen, verwenden Sie Standardwerte für Security Profiles der Organisation festlegen.

Berechtigungen

Erfordert einen Service-Benutzer oder ein persönliches Zugriffstoken mit der Berechtigung ManageSecureModeProfiles auf Organisationsebene. Tokens, die von einer laufenden Devin-Sitzung verwendet werden, werden abgelehnt. So kann eine Sitzung die Profile, die für sie gelten, nicht selbst ändern.

Verhalten

  • Nur name ist erforderlich. Profilnamen müssen innerhalb der Organisation eindeutig sein.
  • Wird net_policy weggelassen, startet 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 das 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_)

Pfadparameter

org_id
string
erforderlich

Organisations-ID (Präfix: org-)

Beispiel:

"org-abc123def456"

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, das einer Organisation gehört.

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, Verwaltung von Automatisierungen oder sonstige Schreiboperationen).

enforcement_level
enum<string>
erforderlich

Empfohlene Profile können durch untergeordnete Bindungen überschrieben werden; verbindliche Profile legen Mindestbeschränkungen fest, die untergeordnete Richtlinien nur verschärfen können.

Verfügbare Optionen:
recommended,
mandatory
git_access_level
enum<string>
erforderlich
Verfügbare Optionen:
read_only,
read_write
name
string
erforderlich
org_id
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, wodurch der direkte Zugriff auf die GitHub-API verhindert wird.

updated_at
integer
erforderlich
mcp_config
SecurityProfileMcpConfig · object | null

null = dieses Profil macht keine MCP-Vorgabe.

net_policy
SecurityProfileNetPolicy · object | null

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

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Legt fest, in welchen Slack-Kanälen Sitzungen unter diesem Profil höchstens lesen und Beiträge veröffentlichen dürfen. null = dieses Profil macht keine Vorgabe und es gilt die Slack-Einstellung der Organisation.

slack_dm_scope
enum<string> | null

Legt fest, wer Devin unter diesem Profil in Slack höchstens Direktnachrichten senden darf. null = dieses Profil macht keine Vorgabe und 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

Legt fest, in welchen Microsoft-Teams-Kanälen Sitzungen unter diesem Profil höchstens lesen und Beiträge veröffentlichen dürfen. null = dieses Profil macht keine Vorgabe und es gilt der Teams-Standardzugriff der Organisation.

teams_dm_scope
enum<string> | null

Legt fest, wem Devin unter diesem Profil in Microsoft Teams höchstens Direktnachrichten senden darf. null = dieses Profil macht keine Vorgabe und es gilt der Teams-Standardzugriff der Organisation.

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

Legt fest, welche Teams-Gruppenchats Devin unter diesem Profil höchstens lesen darf; origin_chat = nur der Gruppenchat, aus dem die Sitzung gestartet wurde; null = keine Vorgabe, die Berechtigung wird wie bei Direktnachrichten vom Teams-Standardzugriff der Organisation abgeleitet.

Verfügbare Optionen:
disabled,
origin_chat