CoRoidは、お客様のコードに対して自律的なエンジニアリング作業を実行します。本ページでは、その作業が実行される場所、到達可能な範囲、認証情報およびデータの保護方法、そして残される記録について説明します。また、現時点で適用されている制御措置についても記載しています。計画中の制御措置には「計画中」と表記されています。
エージェントの作業が実行される場所
各タスクは、それぞれ独自の分離されたクラウドワークスペースで実行されます。このワークスペースは当該タスクのために作成され、タスク完了後に削除されます。エージェントは、そのワークスペースにチェックアウトされたリポジトリのみを読み書きできます。
以下の3つのゾーンがあります:
| ゾーン | オーナー | 含まれる内容 |
|---|---|---|
| エージェントワークスペース | CoRoid | 1つのタスク分のチェックアウト、ビルド、テストツール群です。タスクごとに作成され、タスク完了後に削除されます。 |
| コントロールプレーン | CoRoid | スケジューリング、仕様、証拠、および決定履歴が含まれます。プロジェクトスコープ内の認証情報は暗号化された設定によって管理されます。 |
| お客様のネットワークおよび本番環境 | お客様 | エージェントワークスペースからはアクセスできません。 |
- エージェントワークスペースCoRoid が実行1つのタスク専用のチェックアウト、ビルド、テストツール群
- コントロールプレーンCoRoid が実行スケジューリング、仕様書、証拠資料、決定履歴。認証情報は暗号化されたままです。
- ユーザーのネットワークおよび本番環境ご自身のものIDE の拡張機能やローカルエージェント、ネットワークアクセスは不要です。
エージェントのワークスペースは、ご自身のネットワークや本番環境にアクセスできません。
pull request として出力されるのが唯一の出口であり、マージするかどうかはチームで決定します。
作業の結果は一つの形式でワークスペースを出ます:それがpull requestです。マージするかどうかは貴社のチームが決定し、その後は貴社独自のデプロイメントパスに従って処理されます。CoRoidにはIDE拡張機能やローカルエージェント、プライベートネットワークへのアクセス権は不要です。
ワークスペースがインターネット上でアクセスできる範囲
コードのビルドおよびテストを行うワークスペースは、公開インターネットアドレスに直接アクセスできるため、インストールやダウンロードは開発者マシン上と同様に動作します。ただし、クラスターの内部ネットワーク、クラウドメタデータサービス、プライベートIP範囲にはアクセスできません。
サンドボックスネットワーク、以下の下でセキュリティ → 設定、スコープ内のワークスペースをCoRoidの出力プロキシ経由で送信します。この機能は既定では無効になっており、組織レベルまたは個別のプロジェクトごとに有効化でき、すべてのプランで利用可能です:
- 有効(監視モード)。すべての接続はプロキシを経由し、タスクのホスト名およびポート番号のみが記録されます。パスやコンテンツ内容は記録されません。拒否される接続はありません。
- 許可されていないものを拒否(強制モード)、保護設定パネルで選択されます。このプロキシは、パブリックなパッケージレジストリ(npm、PyPI、Go Modules、crates.io、RubyGems、Maven Central、Gradle、NuGet、Packagist、Hex、pub.dev、conda)やプロジェクトのGitホスト、設定の許可リストに含まれるホストを利用できます。それ以外のすべてのホストへのアクセスは拒否されます。拒否後にコマンドが失敗した場合、エージェントにはどのホストが拒否されたかとその理由が通知されます。
このパネルにはサンドボックスが接続した先過去30日間の接続先が表示されます。各ホスト名およびポート番号、タスク数および接続数、最後にアクセスしたタスク、そして許可されたか拒否されたか、あるいは強制モード時の現在のリストに基づいて拒否されるかが確認できます。許可リストにホストを追加します。まずは監視モードで開始してください。強制モードで拒否される内容がリストに表示されます。
タスクのネットワーク該当セクションのファクトリービューには、ワークスペースが到達した先の一覧が拒否分から順に表示されます。CoRoidが自ら実行するスキャン(セキュリティスキャンなど)では、ワークスペースが独自のタスクとして保持され、そのタスク内にスキャンの種類や到達先の一覧が記載されます。
どちらのモードでも、プロキシをバイパスするRaw TCP接続などの場合は接続が失敗し、プロキシがプライベートアドレスに接続することはありません。ツールは標準のプロキシ変数を通じてプロキシを検出しますが、これはCoRoidが設定するものです。Mavenはプロキシ情報を次の場所からのみ読み取ります:settings.xml各許可リストエントリは、ホスト名(
)、サブドメイン(api.example.com)、またはポートを指定した両方のパターン(*.example.com;ポート未指定の場合は80および443)です。独自の設定を持つプロジェクトには、独自のモードおよびリストが適用されます;example.com:8443「Use the default」を選択すると、組織の設定に戻ります。この設定は設定の移植性と共に移行され、セキュリティの他の設定と同様に扱われます。認証はゲートウェイで一元管理されます。対応する方式は以下の通りです:ポータルアクセス用のJWTベースのユーザーセッション
IDおよびアクセス
ローテーションを自動管理するサービス間通信用トークン
- ポータルアクセス用のJWTベースのユーザーセッション
- ユーザー、サービス、および混合アクセスエンドポイント用のガード
- リポジトリへのアクセスはプロジェクト単位でスコープが設定されます。1つのプロジェクトの認証情報は他のプロジェクトで使用できず、APIが1つのリポジトリで作業するために組織全体の認証情報を必要とすることはありません。詳細は
- コードを接続する
リポジトリアクセスはプロジェクト単位でスコープが設定されます。あるプロジェクトの認証情報は他のプロジェクトで使用できず、CoRoidが単一のリポジトリで作業するために組織全体の認証情報を必要とすることもありません。詳細はコードを接続する。
プライベートプレビュー設定 → IDおよびアクセス。SCIMプロビジョニングを備えたSSO/SAMLはEnterpriseプランに含まれており、詳細はデータは転送中および保存時に暗号化されます。。
データ保護
- データは転送中および保存時に暗号化されます。
- 貴社の認証情報(プロバイダーキー、リポジトリトークン、その他の統合シークレットなど)は、貴社自身が所有するデータキーで暗号化されます。そのデータキーはキー管理サービスによってさらに暗号化されます。これらを復号できるのはCoRoidのクレデンシャルブローカーのみで、すべての利用履歴が記録されます。詳細はプロバイダーキー。
- CoRoid自身の設定用シークレットも暗号化されて保存されます。
- パブリッククラウドサービスでは「EUホスティングプロファイル」を提供しています。EUホスティングプロファイルGDPRまたはGDPRの要件、あるいはデータレジデンシー要件があるチーム向けです。EU限定AIプロファイルにより、モデル推論処理をEUホスティングのプロバイダーで実行できます。詳細はこちらをご覧ください。AIプロファイル。
- 実行履歴、トランスクリプト、アーティファクトの保持期間はユーザーが自由に設定できます。詳細はこちらをご覧ください。データ保持。
決定の履歴
すべての自動化された変更内容は、レビュアーやセキュリティチームが既に使い慣れている用語で説明されます。
- 仕様、エージェントの活動内容、レビューおよび承認の決定事項が、タスクと関連付けられて記録されます。
- 実行履歴には、各エージェントの実行結果、失敗した場合の原因までが記録されます。
- プルリクエストの履歴には、コードがマージされる前の最終的な証拠が表示されます。
- セキュリティ、依存関係、カバレッジ、ビジュアル、エンドツーエンド、ブラウザテストの証拠をレビューに添付できます。詳細はこちらをご覧ください。レビュー証拠。
マージゲートにより、本番環境への変更は明示的なポリシーに従って制御されます。貴社の「品質ゲート」による承認なしには一切マージされません。品質ゲートこれらが要求条件となります。
本番運用
- CIにおけるSBOM生成およびコンテナイメージのスキャン
- TLS終端機能を備えたHTTPSのみ対応のパブリックエンドポイント
- 自動化されたデータベースのスナップショット作成および復元のランブック
- メトリクス、ログ、エラーに関する監視およびアラート機能
デプロイオプション
CoRoidは3つの運用モデルで動作します。各モデルでのワークフローは同一ですが、ランタイム、ストレージ、リポジトリアクセス、認証情報の存在場所が異なります。
| モデル | 利用可否 | 実行場所 |
|---|---|---|
| クラウド | 一般利用可能 | CoRoidが運営する環境で、オプションとしてEUホスティングプロファイルを選択可能 |
| エンタープライズクラウド | プライベートプレビュー | CoRoidが運営する環境で、契約済みのキャパシティ、SSO/SAML、SCIM、監査データエクスポート機能を提供 |
| オンプレミス | プライベートプレビュー | 貴社のインフラ上でDocker ComposeまたはKubernetesを利用 |
オンプレミス
オンプレミスでのデプロイにより、規制対象のチームはリポジトリアクセス、ストレージ、認証情報、ネットワークポリシーを自ら管理するインフラ内に留めることができます。
- Docker Compose単一サーバーでの導入やパイロットプロジェクトに適しており、永続ボリュームにデータベース、リポジトリ、ログが格納されます。
- Kubernetes複数サーバーや自動スケーリング環境に適しており、Helmがアプリケーション、ワーカー、同期、ランナーサービスを管理し、マネージド型または自己ホスト型のPostgreSQLやオブジェクトストレージと連携します。
- 制限されたネットワークオフラインでのモデルや依存関係の処理、自己ホスト型のシークレット管理、内部TLSを利用できます。
Gitアクセスにはサードパーティ製アプリのインストールではなく個人用アクセストークンを使用し、内部リポジトリホストを指定することも可能です。
認証
CoRoidは現在、SOC 2レポートやその他の第三者によるセキュリティ認証を取得していません。SOC 2は準備段階の目標であり、認証を得るまでは制御措置を「認証済み」と表記することはありません。