公開と成長
公開前チェックリスト
アプリを公開する前にBuildliyが行う安全性と品質のチェックについて、公開不可になるもの、それぞれの直し方を説明します。
アプリを公開する前に、Buildliyは問題がないかをチェックします。対象は、あなたや利用者に害が及ぶおそれのある問題です。たとえば、誰でもコピーできてしまう秘密のキーや、他の人のデータが表示されてしまうページなどがあります。リンク切れやページタイトルの未設定など、もう少し整えたほうがよい小さな点もお知らせします。
公開できなくなるのは、重大な問題があるときだけです。それ以外はすべて提案なので、直すかどうかはあなたが決められます。
確認できる場所
同じチェックを、2か所で見られます。
- 公開ダイアログ。 公開をクリックすると、一番上に公開前の安全チェックカードが表示されます。対応が必要な項目が並び、ほとんどの項目に修正ボタンがあります。合格したチェック…件を表示をクリックすると、合格した項目も見られます。
- 「公開」タブ。 右上のワークスペースメニューを開き、公開を選びます。合格した項目を含むすべてのチェック、「公開できます — 修正をおすすめする項目が2件」のような短い見出し、100点満点の準備スコアが表示されます。
チェックは開くたびに最新の状態で実行されます。公開をクリックしたときにも、もう一度実行されます。そのため、表示されている一覧が、公開時に実際に適用される内容そのものです。
準備スコアは目安であり、必須の条件ではありません。スコアが低くても、公開できなくなることはありません。公開できなくなるのは、公開不可と表示された項目(公開ダイアログでは「重大」)だけです。
公開不可になるもの
これらは重大な問題です。直すまで、公開はできません。
| チェック名(「公開」タブでの表示) | 内容 |
|---|---|
| コード内にシークレットあり | 秘密のキー、トークン、パスワードがアプリのコードに直接書かれていて、訪問者なら誰でもコピーできる状態です。NEXT_PUBLIC_ の設定にサーバーキーを入れている場合も含まれます。この設定の値は、すべてのブラウザーに送られます。 |
| ブラウザ用コードにアプリの秘密キーがあります | アプリ自身のBuildliyキー(内蔵のAI、決済、ストレージなどのサービスで使うキー)がブラウザー上で読み取れる状態です。そのため、誰かにあなたのクレジットを使われるおそれがあります。 |
| ログインがありません | アプリの計画では利用者がログインすることになっているのに、アプリにログインがありません。そのため、非公開のはずの内容が、リンクを知っている人なら誰でも見られる状態です。 |
| 一部のユーザーのデータが本人だけに制限されていません | 新しいアプリで、一人ひとりのデータを保存するテーブルがデータベースで保護されていません。そのため、ログインしている人を確認し忘れたページがあると、全員のデータが表示されるおそれがあります。 |
| アプリにあなたの…のデータが表示されています | アプリが、あなたの非公開の記録(会計帳簿、スタッフの記録、会議の文字起こし、自分だけ(個人用)に設定したカスタムコネクタなど)を持つ接続済みアカウントを使っていて、しかもアプリにログインがありません。 |
| ホームページがありません | 訪問者が最初に開くメインページがアプリにありません。 |
このあとで説明する詳細な安全チェックでも、支払い前に価格を変更されるおそれがありますのような重大な項目や、他の人の情報が誰にでも見えてしまうページやデータリンクが見つかることがあります。
新しいアプリで人のデータを守る仕組み
Buildliyホスティング上の新しいアプリでは、データベース自体が一人ひとりのデータを分けて守ります。アプリは権限を絞ったログインでデータベースに接続し、データベースは、ログインしている人に自分の行だけを見せます。これは、ログインしている人の確認をページが忘れた場合でも変わりません。チェックリストでは、この状態が合格項目一人ひとりのデータはデータベースで守られていますとして表示されます。人のデータを保存するテーブルが保護されていない場合は、直すまで一部のユーザーのデータが本人だけに制限されていませんにより公開できません。
以前に作られたアプリでは、一人ひとりのデータはアプリのコードだけで分けられています。各ページがログインしている人を確認し、その人の行だけを読み込む方法です。チェックリストでは各ユーザーのデータはアプリのコードで分けられていますが「修正をおすすめする項目」に入ります。すべてのページがその確認を行うことに頼っている、と分かるようにするためです。この項目では公開できなくなることはありません。どちらの場合も、詳細な安全チェックで、人の情報を違う人に渡してしまうページやデータリンクも調べます。これらが見つかると、公開できなくなることがあります。
Buildliyの以前のデータベース構成で作られた一部の古いアプリでは、テーブルに対して、データアクセスに関する3つのチェックが代わりに行われます。保護されていないテーブル、行レベルセキュリティが未テストです、データアクセスのチェックに失敗しましたの3つです。テーブルが保護されてチェックに合格するまで、公開はできません。チェックは管理 → データベースから実行できます。
修正をおすすめする項目
これらは公開を妨げることはありませんが、直すとアプリがより良く、より安全になります。
- 前回のビルドは失敗しました: 直近のビルドがエラーで終了したため、その変更は保存されていません。公開では、最後に保存されたバージョンが使われます。
- APIキーが必要です: アプリが、保存された値のないキーを読み込もうとしています。そのため、公開後はその機能が動きません。
- 決済がありません: アプリの計画では決済を受け付けることになっているのに、チェックアウトが作られていません。
- 決済はテストモードです: Stripeを接続するまで、チェックアウトではテストカードしか使えません。公開前はこの状態が普通です。Stripeは、本番の決済を有効にする前に、公開中のサイトを確認するためです。
- …ページを追加: 決済を受け付けるアプリで、プライバシーポリシー、利用規約、返金ポリシーを追加するようお知らせするものです。購入者はこれらを探しますし、Stripeも本番の決済を有効にする前に確認します。
- 内部リンクが切れています: 存在しないページにつながっているリンクです。
- 代替テキストのない画像があります: スクリーンリーダーや検索エンジン向けの説明がない画像です。
- ラベルのないフォーム入力欄があります: スクリーンリーダーが名前を読み上げられないフォーム欄です。
- ページタイトルと説明がありません、またはサイトのタイトルがまだ仮のままです: 検索結果や共有されたリンクに表示される内容です。
- エラー時の代替画面がありません: 何か問題が起きたときに表示される、わかりやすい代わりのページがありません。
- モバイルの表示幅が固定されています: スマートフォンで、縮小されたページが表示されてしまいます。
- 各ユーザーのデータはアプリのコードで分けられています: 以前に作られたアプリに表示されます。問題なく動きますが、すべてのページがログインしている人を確認することに頼っています。
- アプリが表示する…のデータを確認: アプリが、お客様の情報を保存するサービス(CRM、ニュースレターの配信リスト、サポート用の受信トレイ、フォームの回答など)を使っていて、しかもログインがありません。データを送るだけのフォームなら問題ありません。保存された内容を表示するページは、ログインの内側に置いてください。
- ログインできる人を確認 — アプリにあなたの…が表示されています: アプリが、接続済みアカウントの非公開データをログインの内側で表示しています。新規登録やログインできるのが、あなたか、あなたが選んだ人だけになっているか確認してください。
- プランをスキップしましたまたはプランが未完了です: アプリの対象となる人について、AIが持つ情報が少なくなっています。
詳細な安全チェック
上のチェックに加えて、Buildliyはアプリが悪用される可能性についてもくわしく調べます。実行中は、カードに「アプリをチェックしています。知らない人が外から見るような確認も行っています…」と表示されます。
調べる内容は次のとおりです。
- 人のデータが違う人に渡ってしまう問題。 氏名、メールアドレス、電話番号、保存された記録が、ログインしていない訪問者に見えてしまうページやデータリンクです。持ち主だけでなく、ログインしているすべてのアカウントに見えてしまう場合も含みます。
- 訪問者が変更できる価格。 サーバー側で価格を調べずに、訪問者のブラウザーから送られた価格を使っているチェックアウトです。
- 誰でも使いすぎられるAI機能。 ログインも訪問者ごとの制限もないAI機能です。費用がかさむおそれがあります。これは提案であり、公開を妨げるものではありません。
- 外からの確認。 プレビューが動いているとき、Buildliyは知らない人と同じように、ログインせずにアプリのデータリンクを開いてみます。人の情報が渡されてしまうなら、重大な問題です。何も漏れていなければ、合格した項目の一覧に外からの確認済みと表示されます。
データの問題だとチェックが確信できる場合は、重大な問題になります。確信できない場合は、確認してもらうために「修正をおすすめする項目」に表示されます。
ワンクリックで問題を直す
公開ダイアログでは、各項目に、分かりやすいタイトルと、なぜ大事なのかを説明する1行が付いています。詳細をクリックすると、ファイル名などの技術的な内容を見られます。
- 修正は、その1つの項目をAIへの依頼として送ります。通常のビルドなので、他のビルドと同じようにクレジットを使います。
- 直して公開(または両方を直して公開、3件すべてを直して公開)は、重大な項目をすべてまとめて1回の依頼としてAIに送ります。ビルドが終わると、Buildliyが安全チェックをもう一度実行し、重大な項目が残っていなければ公開します。チャット欄の上には「修正が反映されて安全チェックに合格したら公開します」というメモが表示され、キャンセルボタンも付いています。
- そのビルドのあとでも直すべき項目が残っている場合は、「公開前に直す項目があと1件あります」と表示されるので、もう一度直せます。公開は行われません。
- 提案だけが残っているときは、カードに「これらの修正は任意です — 今すぐ公開できます」と表示され、公開ボタンが出ます。
「直して公開」のあとの自動公開は、ページを再読み込みすると忘れられます。そのため、あとから突然公開されることはありません。再読み込みした場合は、ビルドが終わってから、もう一度公開を開いてください。
項目によっては、修正の代わりにリンクが表示されます。たとえば決済はテストモードですには、Stripeを接続というリンクがあります。
よくある項目の直し方
コード内の秘密のキー
キーは、コードの中ではなく管理 → シークレットに置きます。次のように頼んでみましょう。
コード内のAPIキーをすべて外に出してください。代わりにサーバー専用の設定から読み込むようにして、管理 → シークレットに追加が必要なものを教えてください。
そのあと、それぞれのキーを管理 → シークレットに追加します。シークレットとAPIキーをご覧ください。
アプリに必要なキーが保存されていない
足りないキーを管理 → シークレットに追加するか、コネクタページでそのサービスを接続し、管理 → コネクタでこのアプリに対してオンになっていることを確認してください。コネクタをご覧ください。
ログインがない、またはログインなしで非公開データが表示される
アプリにログインを追加してください。私の非公開データや、ユーザーが保存した情報を表示するページはすべてログインの内側に置いて、ログインした人が自分のデータだけを見られるようにしてください。
アプリにアカウントが必要なくなった場合は、代わりに計画のほうを変更してください。アプリのログイン機能をご覧ください。
人のデータが保護されていない
その項目の修正ボタンを使ってください。そのページやデータリンクでログインを必須にし、ログインしている本人のデータだけを返すよう、AIに依頼します。
価格を変更されるおそれがある
修正を使うか、次のように頼んでください。「すべての価格を、商品をもとにサーバー側で調べるようにしてください。ブラウザーから送られた価格は決して信用しないでください。」支払いを受け付けるをご覧ください。
タイトルが仮のまま、または説明がない
AIに、アプリにふさわしいタイトルと説明を付けてもらうよう頼んでください。公開ダイアログのサイト情報タブでも設定できます。ここで設定した内容は、公開時に公開中のサイトへ追加されます。ただし、このチェックはアプリのコードを読み取るので、AIがアプリ本体に追加するまでは表示され続けます。タイトルが「Buildliy app」のような仮のままの場合、公開時にはプロジェクト名が代わりに使われます(プロジェクトが自動の名前のままの場合を除きます)。それでも、ご自身の言葉で付けたほうがより良くなります。SEOと共有をご覧ください。
リンク切れ、説明やラベルの不足
内部リンクの切れを直して、意味のある画像すべてに分かりやすい代替テキストを付け、すべてのフォーム欄に見えるラベルを付けてください。
AIからのメモ
「公開」タブのチェックの下には、未確認の印が付いたAIからのメモが表示されることがあります。これは、AIがアプリをビルドしている間に「見直したほうがよい」と提案した内容です。Buildliyは確認していません。これによって公開できなくなることはありません。
アプリを公開したあとは、「公開」タブに「公開中のサイト: 正常 · 5分前に確認」のような1行も表示されます。ホスティングをご覧ください。