メインコンテンツへスキップ
POST
エンタープライズのセキュリティプロファイルを作成
エンタープライズが所有し、配下のすべての組織で共有されるセキュリティプロファイルを作成します。各組織はこのプロファイルを選択できますが、編集できるのはエンタープライズ管理者のみです。エンタープライズ全体に適用するには、Set enterprise profile default を利用してください。

権限

エンタープライズレベルで ManageAccountSecureModeProfiles 権限が付与されたサービスユーザーまたは個人用アクセストークンが必要です。Enterprise アカウントでのみ利用できます。

動作

  • 必須なのは name のみです。プロフィール名はエンタープライズ内で一意である必要があります。
  • net_policy を省略した場合、プロフィールは Git連携のホストのみを含む許可リストを初期状態として作成されます (設定ページと同じ初期状態です) 。明示的に null を指定すると、そのプロフィールはネットワークに関する設定を持たないことになります。すべてを拒否する設定ではありません。
  • remove_github_cli_token のデフォルトは true です。トークンを保持する (false) 場合は、git_access_level: read_write が必要です。さらに、ネットワークポリシーを設定している場合は、許可リストに api.github.com を含める必要があります。
  • git_access_level のデフォルトは read_write、enforcement_level のデフォルトは recommended です。

承認

Authorization
string
header
必須

サービスユーザーの認証情報(接頭辞: cog_)

ボディ

application/json
name
string
必須
Required string length: 1 - 128
devin_mcp_read_only
boolean
デフォルト:false
enforcement_level
enum<string>
デフォルト:recommended
利用可能なオプション:
recommended,
mandatory
git_access_level
enum<string>
デフォルト:read_write
利用可能なオプション:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

省略時 = Git連携のホストのみを含む許可リスト(セキュリティプロファイル UI の初期設定と同じ)。明示的な null = このプロファイルではネットワーク設定は未指定(すべて拒否するという意味ではありません)。デフォルトの許可リストには api.github.com が含まれないため、remove_github_cli_token=false のリクエストでは net_policy を明示的に指定する必要があります(null も可)。

remove_github_cli_token
boolean
デフォルト:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

省略時または null = このプロファイルでは Slackチャンネルの設定は未指定(組織の Slack 設定が適用されます)。

slack_dm_scope
enum<string> | null

省略時または null = このプロファイルでは Slack DM の設定は未指定(組織の Slack 設定が適用されます)。

利用可能なオプション:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

省略時または null = このプロファイルでは Teams チャンネルの設定は未指定(組織の Teams のデフォルトアクセス設定が適用されます)。

teams_dm_scope
enum<string> | null

省略時または null = このプロファイルでは Teams DM の設定は未指定(組織の Teams のデフォルトアクセス設定が適用されます)。

利用可能なオプション:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

省略時または null = このプロファイルでは Teams グループチャットの設定は未指定(DM と同様に、組織の Teams のデフォルトアクセス設定に基づいて決まります)。

利用可能なオプション:
disabled,
origin_chat

レスポンス

成功レスポンス

エンタープライズが所有し、そのエンタープライズ内のすべての組織で共有される セキュリティプロファイル。所有元のエンタープライズは呼び出し元のトークンから特定されます。

created_at
integer
必須
devin_mcp_read_only
boolean
必須

true の場合、セッションは読み取り専用の Devin MCP ツールのみを呼び出せます(セッションの作成、自動化の管理、その他の書き込み操作は不可)。

enforcement_level
enum<string>
必須

推奨プロファイルは下位のバインドで上書きできます。必須プロファイルは最低限の制限を定め、下位のポリシーでは制限を厳しくすることしかできません。

利用可能なオプション:
recommended,
mandatory
git_access_level
enum<string>
必須
利用可能なオプション:
read_only,
read_write
name
string
必須
profile_id
string
必須

セキュリティプロファイルの ID。

remove_github_cli_token
boolean
必須

true の場合、セッションのマシンから GitHub CLI トークンが削除され、GitHub API への直接アクセスができなくなります。

updated_at
integer
必須
mcp_config
SecurityProfileMcpConfig · object | null

null = このプロファイルでは MCP のポリシーが未指定です。

net_policy
SecurityProfileNetPolicy · object | null

null = このプロファイルではネットワークのポリシーが未指定です(すべて拒否するという意味ではありません)。

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

このプロファイルが適用されるセッションで、読み取りと投稿が許可される Slackチャンネルの最大範囲。null = このプロファイルでは未指定で、組織の Slack 設定が適用されます。

slack_dm_scope
enum<string> | null

このプロファイルで、Slack から Devin に DM を送信できるユーザーの最大範囲。null = このプロファイルでは未指定で、組織の Slack 設定が適用されます。Enterprise アカウントでは 'workspace' は 'org_members' に制限されます。

利用可能なオプション:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

このプロファイルが適用されるセッションで、読み取りと投稿が許可される Microsoft Teams チャンネルの最大範囲。null = このプロファイルでは未指定で、組織の Teams のデフォルトアクセス設定が適用されます。

teams_dm_scope
enum<string> | null

このプロファイルで、Devin が Microsoft Teams で DM を送信できる相手の最大範囲。null = このプロファイルでは未指定で、組織の Teams のデフォルトアクセス設定が適用されます。

利用可能なオプション:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

このプロファイルで、Devin に読み取りが許可される Teams グループチャットの最大範囲。origin_chat = セッションの開始元のグループチャットのみ。null = 未指定で、DM と同様に組織の Teams のデフォルトアクセス設定に基づいて決定されます。

利用可能なオプション:
disabled,
origin_chat