メインコンテンツへスキップ
POST
組織のセキュリティプロファイルを作成する
組織が所有するセキュリティプロフィールを作成します。プロフィールは作成しただけではどこにも適用されません。デフォルトとして割り当てるには、組織のセキュリティプロフィールのデフォルトを設定を使用してください。

権限

組織階層で ManageSecureModeProfiles 権限を持つサービスユーザーまたは個人用アクセストークンが必要です。実行中の Devin セッションが利用するトークンは拒否されます。そのため、セッションが自らに適用されているプロフィールを変更することはできません。

動作

  • 必須なのは 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
必須

サービスユーザーの credential(プレフィックス: cog_)

パスパラメータ

org_id
string
必須

組織ID(プレフィックス:org-)

例:

"org-abc123def456"

ボディ

application/json
name
string
必須
Required string length: 1 - 128
net_policy
SecurityProfileNetPolicy · object | null

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

mcp_config
SecurityProfileMcpConfig · object | null
git_access_level
enum<string>
デフォルト:read_write
利用可能なオプション:
read_only,
read_write
enforcement_level
enum<string>
デフォルト:recommended
利用可能なオプション:
recommended,
mandatory
devin_mcp_read_only
boolean
デフォルト:false
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

レスポンス

成功レスポンス

組織が所有するセキュリティプロファイル。

profile_id
string
必須

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

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

recommendedのプロファイルは下位階層のバインドで上書きできます。mandatoryのプロファイルは制限の最低基準となり、下位階層のポリシーでは制限を厳しくすることしかできません。

利用可能なオプション:
recommended,
mandatory
devin_mcp_read_only
boolean
必須

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

remove_github_cli_token
boolean
必須

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

created_at
integer
必須
updated_at
integer
必須
org_id
string
必須
net_policy
SecurityProfileNetPolicy · object | null

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

mcp_config
SecurityProfileMcpConfig · object | null

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

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