テスト駆動で学ぶ Firestore セキュリティルール【CI 編】
2020.06.29
目次
CI 環境におけるセキュリティルールの自動テスト
これまで、「テスト駆動で学ぶ Firestore セキュリティルール」をテーマに、実例を交えてセキュリティルールの仕様や利用可能な関数について解説してきました。
せっかく作成したテストであれば、「GitHub Actions」や「CircleCI」などの CI 環境で自動テストに活用したいところです。
今回は、ここまでの記事とは少し雰囲気をかえて、CI 環境でのセキュリティルールの自動テストについて解説していきます。
これまでの記事については、以下の記事を参照してください。
データ検証編はこちら
「データ検証編」では、リクエストデータ、データベース上のデータの参照などについて解説
データ比較編はこちら
「データ比較編」では、データの比較や型チェックなどについて解説
カスタム関数編はこちら
「カスタム関数編」では、「比較編」で作成したルールをもとに、カスタム関数の使い方を解説
対象読者
本記事では、以下のいずれかの CI ツールを利用している、または利用予定の読者を想定しています。
- GitHub Actions
- CircleCI
- GitLab CI/CD
※ GitHub Actions については、GitHub アカウントをお持ちであれば、本記事で紹介する設定ファイルの追加だけで動作確認が可能です。
注意書き
本記事では、各 CI ツール（ GitHub Actions、CircleCI、GitLab CI/CD ）でのセキュリティルールのテストについて、解説していきます。
各 CI ツールの基本的な使用方法や構築方法などの解説はいたしませんので、予めご了承ください。
また、CI ツールごとの解説は独立した内容となっています。
利用しない、または利用予定のない CI ツールの解説は飛ばして読み進めても問題ありません。
簡単な流れ
本記事では、以下のような流れで、「CI 環境でのセキュリティルールのテスト」について解説していきます。
- CI 環境で使用するテスト環境とテストコード、セキュリティルールを用意
- ローカル環境でのテストの流れのおさらいと、テスト成功チェック
- CI 環境でのテストの設定について解説
- 人気のある3つの CI ツールにおける、セキュリティルールのテストの設定例を紹介
- まとめ
前準備
まずは、CI 環境で使用する「テスト環境」と「テストコード」、「テスト対象のセキュリティルール」を用意します。
以下のリポジトリに、本記事のコードをまとめてあります。
【rightcode/firestore-security-rules-test_ci-setting】
https://github.com/rightcode/firestore-security-rules-test_ci-setting
セットアップ
以下のコマンドを実行して、テスト環境をセットアップしてください。
1 2 3 | git clone "https://github.com/rightcode/firestore-security-rules-test_ci-setting" sandbox cd sandbox git checkout refs/tags/test-environment |
「masterブランチ」に完成ソースコードを設置してあります。
本記事中で解説するソースコードを確認したい場合は、以下のコマンドで 「masterブランチ」をチェックアウトしてください。
1 | git checkout master |
※ コードの調整などにより、本記事の内容とは記述が若干異なる場合があります。
使用するテストとセキュリティルールの準備
テストコードとテスト対象となるルールは、先述のリポジトリに含まれているサンプルテストとサンプルルールを使用します。
サンプルテスト
サンプルテストの中身は、以下の通りです。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | process.env.FIRESTORE_EMULATOR_HOST = "localhost:58080"; import {FirestoreTestSupporter} from "firestore-test-supporter"; import * as path from "path"; import * as firebase from "@firebase/testing"; describe("サンプルテスト", () => { const supporter = new FirestoreTestSupporter("my-test-project", path.join(__dirname, "firestore.rules")); beforeEach(async () => { await supporter.loadRules(); }); afterEach(async () => { await supporter.cleanup() }); describe('デフォルトで全てのアクセスを拒否', () => { test('読み込み拒否', async () => { const db = supporter.getFirestore(); const doc = db.collection('default').doc('dummy'); await firebase.assertFails(doc.get()) }); test('書き込み拒否', async () => { const db = supporter.getFirestore(); const doc = db.collection('default').doc('dummy'); await firebase.assertFails(doc.set({data: 'dummy'})) }); test('認証付き読み込み拒否', async () => { const db = supporter.getFirestoreWithAuth(); const doc = db.collection('default').doc('dummy'); await firebase.assertFails(doc.get()) }); test('認証付き書き込み拒否', async () => { const db = supporter.getFirestoreWithAuth(); const doc = db.collection('default').doc('dummy'); await firebase.assertFails(doc.set({data: 'dummy'})) }); }); }); |
サンプルテストは、全てのアクセスの拒否を確認する内容のテストになっています。
サンプルルール
サンプルルールの中身は、以下の通りです。
1 2 3 4 5 6 | rules_version = '2'; service cloud.firestore { match /databases/{database}/documents { allow read, write: if false; } } |
サンプルルールは、サンプルテストの要件を満たす、全てのアクセスを拒否するセキュリティルールとなっています。
ローカル環境でテストチェック
おおよそ、ローカル環境でのテスト実行の流れを CI 環境でのテストの設定にも適用します。
ローカル環境でテストが通ることをチェックしつつ、簡単にテスト実行の流れを確認しておきます。
npm パッケージをインストール
以下のコマンドを実行して、必要となる npm パッケージをインストールしてください。
1 | npm install |
Firebase CLI ツールをインストール
Firebase CLI ツールをインストールしていない場合は、以下のコマンドを実行してインストールしてください。
1 | npm install -g firebase-tools |
Firestore エミュレータを起動
以下のコマンドを実行して、Firestore エミュレータを起動してください。
1 2 | firebase setup:emulators:firestore firebase emulators:start --only firestore |
テスト実行
以下のコマンドで、テストを実行してください。
1 | npm run test |
以下のように結果が表示されれば、テストは成功です！
1 2 3 4 5 6 7 8 9 10 11 12 13 | PASS tests/sample/firestore.rules.test.ts (6.033s) サンプルテスト デフォルトで全てのアクセスを拒否 √ 読み込み拒否 (4092ms) √ 書き込み拒否 (55ms) √ 認証付き読み込み拒否 (45ms) √ 認証付き書き込み拒否 (54ms) Test Suites: 1 passed, 1 total Tests: 4 passed, 4 total Snapshots: 0 total Time: 6.095s, estimated 8s Ran all test suites. |
ローカル環境でのテストの成功が確認できたので、続いて、CI 環境でのテストの設定について解説していきます。
CI 環境でのテスト設定方針
簡単な流れ
各CIツールでのテストは、おおよそ、以下の流れでコマンドを実行していきます。
- npm パッケージのインストール
- firebase-tools のインストール
- Firestore エミュレータをインストール
- エミュレータをバックグラウンド起動
- エミュレータの起動待機
- テスト実行
ローカル環境でのテスト環境のセットアップ、テスト実行の流れとおおよそ同じ内容ですが、以下のような違いもあります。
- CI 環境でのテストに合わせ、firebase-tools をローカルインストールする
- CI 用に調整したテストスクリプトを使用する
- Firestore エミュレータの起動をバックグラウンドで行う必要がある
注意事項
特に留意しておきたいのが、エミュレータの起動です。
CI 環境でのテストの場合、Firestore エミュレータをバックグラウンドで起動しないと、処理がそこで停滞してしまうため、肝心のテストが実行されません。
また、エミュレータが起動するまでに少し時間がかかるため、テストの実行前にエミュレータの起動待機時間の設定が必要になります。
次の項目では、以上の点に気を付けて、本題である「CI ツール別のテスト設定例」を紹介していきたいと思います。
CI ツール別のテスト設定例
CI ツールごとの設定の解説は、独立した内容となっています。
利用しない CI ツールの解説は、飛ばして読み進めても問題ありません。
また、テストに失敗する場合は、後述の「テストに失敗する場合は」の項目をチェックしてください。
GitHub Actions の場合
「GitHub Actions」でセキュリティルールをテストする場合は、 .github/workflows ディレクトリを作成して、 test.yml ファイルを追加してください。
.github/workflows/test.yml を作成したら、以下のように記述してください。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 | name: test on: [push] jobs: test: runs-on: ubuntu-latest strategy: matrix: node-version: [12.x] steps: - name: リポジトリのチェックアウト uses: actions/checkout@v2 - name: Node.js ${{ matrix.node-version }} セットアップ uses: actions/setup-node@v1 with: node-version: ${{ matrix.node-version }} - name: パッケージインストール run: npm install - name: firebase-toolsをインストール run: npm install firebase-tools - name: Firestoreエミュレータをインストール run: npm run setup:emu:firestore - name: エミュレータの起動 run: npm run emu:start:firestore & - name: エミュレータの起動待機... run: sleep 10 - name: テスト実行 run: npm run ci-test |
上記の設定のあと、GitHub にソースコードをプッシュすると、GitHub Actions で test ワークフローがスタートし、テストが実行されます。
結果
ワークフローの実行結果は、以下のようになります。
テスト結果は、以下の通りです。
1 2 3 4 5 6 7 8 9 10 11 12 13 | PASS tests/sample/firestore.rules.test.ts サンプルテスト デフォルトで全てのアクセスを拒否 ✓ 読み込み拒否 (1463ms) ✓ 書き込み拒否 (149ms) ✓ 認証付き読み込み拒否 (99ms) ✓ 認証付き書き込み拒否 (87ms) Test Suites: 1 passed, 1 total Tests: 4 passed, 4 total Snapshots: 0 total Time: 4.655s Ran all test suites. |
以上で、GitHub Actions でのセキュリティルールのテストの設定は完了です。
CircleCI の場合
「CircleCI」でセキュリティルールをテストする場合は、 .circleci ディレクトリを作成して、 config.yml ファイルを追加してください。
.circleci/config.yml を追加したら、以下のように記述してください。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | version: 2.1 jobs: test: docker: - image: circleci/node:lts-browsers steps: - checkout - run: name: パッケージインストール command: npm install - run: name: firebase-toolsをインストール command: npm install firebase-tools - run: name: Firestoreエミュレータをインストール command: npm run setup:emu:firestore - run: name: エミュレータの起動 & テスト実行 command: npm run emu:start:firestore & sleep 10; npm run ci-test workflows: test: jobs: - test |
config.yml ファイルを設定したら、CircleCI サイトでテスト対象の GitHub リポジトリをプロジェクトに追加してください。
上記の設定のあと、GitHub にソースコードをプッシュすると、CircleCI の test ワークフローがスタートし、テストが実行されます。
結果
ワークフローの実行結果は、以下のようになります。
テスト結果は、以下の通りです！
1 2 3 4 5 6 7 8 9 10 11 12 13 | PASS tests/sample/firestore.rules.test.ts サンプルテスト デフォルトで全てのアクセスを拒否 ✓ 読み込み拒否 (776ms) ✓ 書き込み拒否 (111ms) ✓ 認証付き読み込み拒否 (70ms) ✓ 認証付き書き込み拒否 (63ms) Test Suites: 1 passed, 1 total Tests: 4 passed, 4 total Snapshots: 0 total Time: 3.127s Ran all test suites. |
以上で、CircleCI でのセキュリティルールのテスト設定は完了です！
GitLab CI/CD の場合
「GitLab CI/CD」でセキュリティルールをテストする場合は、クローンしたリポジトリのルートに .gitlab-ci.yml ファイルを追加してください。
.gitlab-ci.yml を追加したら、以下のように記述してください。
1 2 3 4 5 6 7 8 9 10 11 12 13 | stages: - test test: image: circleci/node:lts-browsers stage: test script: - npm install - npm install firebase-tools - npm run setup:emu:firestore - npm run emu:start:firestore & - sleep 10 - npm run ci-test |
上記の設定のあと、GitLab にソースコードをプッシュすると、GitLab CI/CD でパイプラインがスタートして、テストが実行されます。
結果
パイプラインの実行結果は、以下のようになります。
テスト結果は、以下の通りです。
1 2 3 4 5 6 7 8 9 10 11 12 13 | PASS tests/sample/firestore.rules.test.ts (5.357s) サンプルテスト デフォルトで全てのアクセスを拒否 ✓ 読み込み拒否 (1456ms) ✓ 書き込み拒否 (210ms) ✓ 認証付き読み込み拒否 (127ms) ✓ 認証付き書き込み拒否 (107ms) Test Suites: 1 passed, 1 total Tests: 4 passed, 4 total Snapshots: 0 total Time: 5.394s Ran all test suites. |
以上で、GitLab CI/CD でのセキュリティルールのテスト設定は完了です。
テストに失敗する場合は
一部、または全てのテストに失敗する場合は、エミュレータが待機時間内で起動していない可能性があります。
待機時間は長めに設定していますが、場合によっては、テスト開始までにエミュレータが起動しない事があります。
テストが失敗する場合は、エミュレータの起動待機時間を調整してみてください。
逆に、起動待機時間が原因のテスト失敗がないのであれば、３～５秒程度に調整しても問題ありません。
まとめ
今回は、CI 環境でのセキュリティルールのテストについて解説してみました。
今回紹介した CI ツールの中でも、GitHub Actions は、GitHub アカウントさえあれば、記事中で紹介したような設定ファイルを追加するだけで簡単にはじめることができます。
まだ CI 環境を導入していない場合は、まずは GitHub Actions からはじめてみるのがオススメです！
では、最後に、今回の内容を簡単にまとめてみたいと思います。
- どの CI 環境でも、やることはローカル環境とほぼ同じ
- CI 環境での Firestore エミュレータの起動はバックグラウンドで
- Firestore エミュレータの起動後に待機時間が必要
- 一度設定してしまえば、プッシュのたびに自動リグレッションテスト！
- まだ CI 環境を導入していないなら、まずは GitHub Actions がおすすめ！
ライトコードよりお知らせ
にゃんこ師匠
ミツオカにゃんこ師匠ミツオカにゃんこ師匠ミツオカ一緒に働いてくれる仲間を募集しております！
ライトコードでは、仲間を募集しております！
当社のモットーは「好きなことを仕事にするエンジニア集団」「エンジニアによるエンジニアのための会社」。エンジニアであるあなたの「やってみたいこと」を全力で応援する会社です。
また、ライトコードは現在、急成長中！だからこそ、あなたにお任せしたいやりがいのあるお仕事は沢山あります。「コアメンバー」として活躍してくれる、あなたからのご応募をお待ちしております！
なお、ご応募の前に、「話しだけ聞いてみたい」「社内の雰囲気を知りたい」という方はこちらをご覧ください。
ライトコードでは一緒に働いていただける方を募集しております！
採用情報はこちら書いた人はこんな人
関連記事
採用情報
\ クリエイティブの最前線 /
フロントエンドエンジニア
\ 世界はお前の手の中に・・・ /
モバイルエンジニア
\ サービスの守り神！ /
インフラエンジニア
\ センスで挑め！ /
UI/UXデザイナー
\ 世界を震撼させろ！ /
WEB開発ディレクター
\ 妄想野郎カモン！ /
ゲームプランナー
\ ゲーム好き集合ー！ /
ゲームエンジニア
