セキュリティ機能

CircleCI に組み込まれているセキュリティ機能と、関連するインテグレーションの概要について説明します。

概要
暗号化
サンドボックス化
インテグレーション
監査ログ
CircleCI を安全に使用していただくためのチェックリスト

概要

CircleCI では、セキュリティを最優先事項と考え、セキュリティ問題発生の防止に努めると共に、問題発生時にはすばやい対応を心掛けています。セキュリティに関する問題が発生した場合には、CircleCI セキュリティチームの GPG キー (ID：0x4013DDA7、フィンガープリント：3CD2 A48F 2071 61C0 B9B7 1AE2 6170 15B8 4013 DDA7) を使用して、security@circleci.com まで暗号化メッセージをお送りください。

暗号化

CircleCI では、CircleCI サービス内外へのすべてのネットワーク通信で HTTPS または SSH を使用します。これには、ブラウザーから Services アプリケーションへの通信、Services アプリケーションから Builder フリートへの通信、Builder フリートからソース管理システムへの通信など、あらゆる通信ポイントが含まれます。したがって、ユーザーのコードやデータが暗号化されずに CircleCI から送受信されることはありません。ただし、自身の判断で暗号化しないコードをビルドに含めることも可能です。オペレーターは、CircleCI の SSL 構成を回避することも、基盤システムの通信に TLS を使用しないように選択することもできます。

CircleCI のソフトウェアは性質上、ユーザーのコードやそのコードが操作するあらゆるデータにアクセスできます。 CircleCI 上のすべてのジョブは、他のあらゆるビルドから独立し、インターネットやユーザー自身のネットワークからアクセスできないサンドボックス (具体的には、Docker コンテナまたはエフェメラル VM) 内で実行されます。ビルドエージェントは、SSH によって Git からコードをプルします。特定のテストスイートまたはジョブ構成は、外部サービスまたはネットワーク内のインテグレーションポイントに対して呼び出しを行うことができます。そうした呼び出しからの応答は、ジョブにプルされ、ユーザー自身の判断でコードに使用されます。 1 つのジョブが完了すると、ジョブを実行したコンテナは廃棄され、リビルドされます。すべての環境変数は、HashiCorp の Vault を使用して暗号化されます。環境変数は、AES256-GCM96 を使用して暗号化され、CircleCI の従業員には使用できません。

サンドボックス化

CircleCI では、コードのビルドを実行するために割り当てられるリソースをユーザーが制御できます。これは、ビルドが実行されるコンテナをセットアップする Builder boxes のインスタンスを介して行われます。ビルドコンテナは性質上、ソースコードをプルダウンし、コードベースまたは構成に含まれるあらゆるテストスクリプトとデプロイスクリプトを実行します。これらのコンテナはサンドボックス化されます。つまり、ビルド (または並列ビルドの一部分) ごとに専用のコンテナが 1 つずつ作成され、破棄されます。これらのコンテナは外部から使用することはできません。 CircleCI のサービスでは、特定のビルドコンテナに直接 SSH 接続できる機能が提供されています。これにより、そのビルドコンテナ内のすべてのファイルまたは実行中のプロセスに完全にアクセスできると共に、ソースコードを任せられるユーザーだけに CircleCI へのアクセスを許可できます。

インテグレーション

CircleCI には、関連する外部のサービスやテクノロジーとのインテグレーションポイントがいくつかあります。以下の一覧では、これらのインテグレーションポイントについて説明します。

WebSocket: CircleCI は、サーバーとブラウザー間の WebSocket 通信に Pusher クライアントライブラリを使用していますが、インストールには slanger という内部サーバーを使用しています。そのため、Pusher サーバーが CircleCI インスタンスやソース管理システムにアクセスすることはありません。こうしたしくみによって、たとえば、ビルドリストが動的に更新されたり、ビルドの出力が発生と同時に 1 行ずつ表示されたりします。ビルドステータスとビルド出力の行は、WebSocket サーバーを経由して送信されます (SSL なしで実行するように CircleCI を構成しない限り、SSL 上で同じ証明書を使用して行われます)。したがって、転送時には暗号化されます。
Replicated: CircleCI Server のプライベートインスタンスでは、Replicated を使用して、インストールウィザード、ライセンスキー、システム監査ログ、ソフトウェアの更新など、CircleCI のメンテナンスやシステムに関する作業を管理します。 CircleCI Servｅｒインスタンスは、更新の有無を確認するために、Replicated サーバーと通信してライセンスキー情報やバージョン情報を送信します。 Replicated がユーザーのデータや他のシステムにアクセスすることはありません。また、CircleCI がユーザーのデータを Replicated に送信することもありません。
ソース管理システム: CircleCI を使用するには、GitHub Enterprise、GitHub.com などのソース管理システムのインスタンスとの直接接続をセットアップします。 CircleCI のセットアップ時に、プライベートリポジトリのチェックアウトをシステムに許可します。この権限は、GitHub アプリケーションの設定ページで、リポジトリの管理者ページから CircleCI のデプロイキーとサービスフックを削除して、いつでも取り消すことができます。 CircleCI ではプロジェクトを選択してビルドできますが、GitHub の権限モデルは極端なものであるため、CircleCI にはすべてのリポジトリへのアクセスが許可されるか、一切許可されないかのどちらかになります。 CircleCI インスタンスは、Git リポジトリでホスティングされているすべての項目にアクセスでき、コードのプッシュやユーザーの追加など、さまざまなイベントの Web フックを作成します。これが CircleCI にコールバックして、1 つ以上の Git コマンドをトリガーすることで、コードが Builder フリートにプルダウンされます。
依存関係とソースのキャッシュ: ほとんどの CircleCI ユーザーは、Amazon VPC などのプライベートクラウドインフラストラクチャ内で S3 または同等のクラウドベースのストレージを使用して、依存関係やソースのキャッシュを格納しています。これらのストレージサーバーは、このようなサービス上に格納されるすべての項目の標準的なセキュリティパラメーターの対象となります。つまり、ほとんどの場合、ユーザーは外部からのアクセスを阻止できます。
アーティファクト: アーティファクトには、S3 などのホスティングされたストレージを使用するのが一般的です。これらのリソースが、標準的なポリシーに従ってセキュリティ保護されているなら、共に保存されている他のデータと同様、アーティファクトも外部からの侵入に対して安全と言えます。
iOS ビルド: CircleCI のハードウェア上で iOS ビルドを有料で実行している場合は、macOS フリート上のビルドボックスにソースコードがダウンロードされ、コンパイルやテストの実行もそこで行われます。自身で制御するプライマリビルドコンテナと同様に、CircleCI で実行される iOS ビルドも、アクセスできないようにサンドボックス化されます。
Docker: Docker イメージを使用している場合は、Docker Engine について、Docker 公式の seccomp (セキュリティコンピューティングモード) プロファイルを参照してください。 CircleCI は、Docker のデフォルトの seccomp プロファイルに以下のように付加します。

[
  {
    "comment": "ユーザー名前空間の作成を許可",
    "names": [
      "clone",
      "setns",
      "unshare"
    ],
    "action": "SCMP_ACT_ALLOW",
    "args": [],
    "includes": {},
    "excludes": {}
  }
]

監査ログ

監査ログ機能は、独自のサーバーまたはプライベートクラウド上にインストールした CircleCI でのみ使用できます。

CircleCI では、監査およびフォレンジック分析の目的で、重要なイベントをログとしてシステムに記録します。監査ログは、パフォーマンスやネットワークメトリクスを追跡するシステムログとは区別されます。

完全な監査ログは、アプリケーションの管理者セクション内にある [Audit Log (監査ログ)] ページから CSV ファイル形式でダウンロードできます。ネストされたデータを含む監査ログフィールドには JSON BLOB が含まれます。

メモ: 内部挙動により、監査ログにイベントが重複して生成される場合があります。ダウンロードしたログの id フィールドはイベントに固有であるため、このフィールドを使用して重複するエントリを特定できます。

監査ログイベント

ログには以下のシステムイベントが記録されます。定義と形式については、以下の「監査ログフィールド」セクションの

action を参照してください。

context.create
context.delete
context.env_var.delete
context.env_var.store
project.env_var.create
project.env_var.delete
project.settings.update
user.create
user.logged_in
user.logged_out
workflow.job.approve
workflow.job.finish
workflow.job.scheduled
workflow.job.start

監査ログフィールド

action: 実行され、イベントを生成したアクション。ドット区切りの小文字 ASCII ワードの形式が使用され、最初に影響を受けたエンティティと最後に実行されたアクションが含まれます。エンティティは、たとえば workflow.job.start のようにネストされる場合があります。
actor: 対象のイベントを実行したアクター。ほとんどの場合は CircleCI ユーザーです。このデータは JSON BLOB で、id と type が必ず含まれ、多くの場合 name も含まれます。
target: 対象のイベントで影響を受けたエンティティインスタンス (プロジェクト、組織、アカウント、ビルドなど)。このデータは JSON BLOB で、id と type が必ず含まれ、多くの場合 name も含まれます。
payload: アクション固有の情報の JSON BLOB。 payload のスキーマは、同じ action と version を持つすべてのイベントで一貫していると想定されます。
occurred_at: イベントが発生した UTC 日時。時刻は、最大 9 桁の小数精度の ISO-8601 形式で表されます (例：’2017-12-21T13:50:54.474Z’)。
metadata: 任意のイベントに付加できるキー・値のペアのセット。キーと値はすべて文字列です。これを使用すると、特定の種類のイベントに情報を追加できます。
id: 対象のイベントを一意に識別する UUID。イベントのコンシューマーが、重複するデリバリーを識別できるようにします。
version: イベントスキーマのバージョン。現在、値は必ず「1」になります。今後のバージョンでは、スキーマの変更に合わせてこの値も変更になる可能性があります。
scope: ターゲットが CircleCI ドメインモデル内のアカウントによって所有されている場合、アカウントフィールドにはアカウント名と ID が挿入されます。このデータは JSON BLOB で、id と type が必ず含まれ、多くの場合 name も含まれます。
success: アクションが成功したかどうかを示すフラグ。
request: 対象のイベントが外部リクエストによってトリガーされた場合に挿入されるデータ。同じ外部リクエストから発生したイベントどうしを関連付けるために使用できます。 id (CircleCI がこのリクエストに割り当てたリクエスト ID)、ip_address (リクエストされた元の IP アドレスであり、たとえば 127.0.0.1 など IPV4 のドット区切り表記で表される)、および client_trace_id (元のリクエストに HTTP ヘッダー「X-Client-Trace-Id」が存在する場合は、対応するクライアント追跡 ID ヘッダー) を含む JSON BLOB の形式で表示されます。

CircleCI を安全に使用していただくためのチェックリスト

CircleCI を使用するときには、CircleCI のユーザーとして、セキュリティ面のベストプラクティスに関していくつかの事項を考慮する必要があります。

ビルドが必要とするシークレット (プライベートキー、環境変数) の数を最小限に抑え、定期的にシークレットを入れ替えます。
- 組織のシークレットを定期的に (チームメンバーが変わるときは特に) 入れ替えることが重要です。
- シークレットを定期的に入れ替えることで、シークレットの有効期限が設けられ、キーが漏洩した場合の潜在的なリスクを軽減できます。
- 使用するシークレットは範囲を制限し、ビルドの目的を満たす最低限の権限のみを許可することを徹底します。 AWS 上での IAM 権限や GitHub の Machine User 機能など、CircleCI の外部で使用する他のプラットフォームのロールおよび権限システムについては、慎重に判断していただくようお願いします。
ユーザーが何らかのツールを誤用することで、シークレットが偶然に stdout に出力され、ログに記録されてしまう可能性があります。以下の場合には注意してください。
- すべての環境変数を stdout に出力する env または printenv を実行する場合
- echo を使用し、コードベースまたはシェル内のシークレットを出力する場合
- プログラムやデバッグツールがエラー時にシークレットを出力する場合
VCS プロバイダーから付与された組織の権限を確認したうえで、最小権限の原則に従うよう努めます (組織に属している場合)。
チーム間では制約付きコンテキストを使用し、環境変数は一部のセキュリティグループでのみ共有します。詳細については、コンテキストに関するドキュメントをお読みください。
SSH キーへのアクセス権を持つ人間は、必ず組織による監査の対象とします。
VCS で 2 要素認証 (2FA) を必ず使用します (Github 2FA、Bitbucket)。ユーザーの GitHub または Bitbucket アカウントが漏れると、悪意のあるアクターによってコードがプッシュされたり、秘密が盗まれたりする危険性があります。
パブリックのオープンソースプロジェクトでは、環境変数を共有するかどうかを明記します。 CircleCI では、プロジェクトの設定を変更して、フォークされたバージョンのリポジトリに環境変数を渡すかどうかを制御できます。これは、デフォルトでは有効になっていません。この設定とオープンソースのセキュリティの詳細については、オープンソースプロジェクトのドキュメントを参照してください。