メインコンテンツへスキップ
見出し画像

管理画面でデータが消える、一括登録でログインできない。データベースを直接さわる前に知っておきたい 2 つ

    今回の話

    • 前回は、アプリを作る前に決めておく 3 つの話でした。今回は、作ったあとにデータベースを直接さわって失敗した話です

    • 1 つ目は、守りを固めたら、管理者まで入れなくなったこと

    • 2 つ目は、名簿から一括で登録したら、誰もログインできなかったこと

    • どちらも、データベースの「見えないところで動いているもの」を知らなかったのが原因でした



    1 つ目:守りを固めたら、管理者も入れなくなった

    1-12 で、Supabase には、データの表ごとに「誰がどの行を見られるか」を決める仕組みがある、と書きました。
    これが RLS(行レベルセキュリティ) です。

    組合ポータルでは、組合員の情報が入った表に、こんな制限をかけています。

    • 組合員は、自分の情報だけを見られる

    • ほかの人の情報は見られない

    倉庫にたとえると、倉庫番が「あなたの荷物はこれだけです」と、本人の分しか渡さない状態です。
    個人情報を守るための、大事な仕組みです。

    ところが、管理画面を作っていたときのこと。
    組合員の名前を一緒に表示するページを開いたら、「見つかりません」と出てしまいました。
    別のページでは、組合員の人数を数えるところでエラーになりました。

    管理者としてログインしているのに、なぜ?

    Claude と調べてみると、原因はこの RLS でした。
    管理画面は、ふつうの利用者と同じ窓口から、倉庫にデータを取りに行っていたんです。
    倉庫番は、相手が管理者でも関係なく、ルールどおり「あなたの分しか渡せません」と答えます。

    画像
    RLS

    守りを固めたこと自体は、正しかったんです。
    足りなかったのは、管理者用の窓口でした。

    直し方は、2 段構えにしました。

    1. 管理画面では、管理者専用の窓口を使う。Supabase には、倉庫番のルールを飛ばして、すべてのデータを取れる「マスターキー」のような窓口があります

    2. マスターキーを使う前に、必ず「本当に管理者か」を確かめる。強力な鍵なので、使い方を間違えると、誰でも全部のデータを見られてしまいます

    2 つ目:一括登録したら、誰もログインできなかった

    組合ポータルは、本来、組合員が自分で登録を申し込んで、執行部が承認する流れです。
    でも、数百人に 1 人ずつ申し込んでもらうのは、現実的ではありません。

    そこで、組合の名簿をもとに、全員分のアカウントを一括で作ることにしました。
    ログイン ID と最初のパスワードは、どちらも社員番号です。

    Claude に名簿を渡して、データベースに直接まとめて登録する命令文を作ってもらいました。
    実行すると、あっという間に全員分のアカウントができました。

    ところが、執行部のメンバーに試してもらったら、「ログインできない」。
    社員番号もパスワードも合っているのに、入れない。
    調べてみると、一括で登録した全員が同じ状態でした。

    原因は、ログインの仕組みが、裏で2 枚の台帳を見ていたことでした。

    • 会員名簿:誰がアカウントを持っているか

    • ログイン方法の台帳:その人が、どの方法でログインするか

    画像
    台帳

    ふつうに画面から登録すると、この 2 枚は自動でセットで作られます。
    ところが今回は、効率を優先して、データベースに直接書き込みました。
    その結果、会員名簿には載っているのに、ログイン方法の台帳には載っていない状態になっていたんです。

    会社でいえば、社員名簿には名前があるのに、入館証が発行されていないようなもの。
    受付で「名簿にはあるけど、入館証がないので通せません」と言われていたわけです。

    足りなかった台帳を全員分まとめて作り、全員がログインできるようになりました。
    あわせて、2 枚の台帳の人数が合っているかも確かめたら、登録のときの重なりで残っていた「幽霊アカウント」が見つかったので、それも消しました。

    2 つに共通していたこと

    並べてみると、どちらも同じところでつまずいていました。

    ふつうの入口を通ると、データベースは見えないところで、いろいろやってくれています。
    1 つ目は、倉庫番が、誰にでも同じルールで目を光らせていた。
    2 つ目は、画面から登録すると、ログイン方法の台帳を自動で作ってくれていた。

    直接さわるときは、その「見えないところ」を、自分で面倒を見ないといけない。
    それを知らないまま近道したのが、2 つとも原因でした。

    正直なところ

    1 つ目の管理画面のほうは、僕は結構入力していた気がするのに、一度も止まった覚えがないんですよね。

    一括登録で誰もログインできないと分かったときは、最初は、入力のしかたが違うんじゃないか、と使う側のほうを疑いました。
    でも、「まだできません」が続くと、これは僕のほうか……?と、だんだん不安になってきて。

    もともと今回のプロジェクトは、「自分が作る」と言い切っていたのもあるので、
    「結局そういうところができないじゃん」と言われるのがすごく嫌だったので、急いで原因を探して修正しました。

    近道をしたのは、こういうアプリって、「使いました」に至るまでが一番難しいと思っていたからです。
    なくてもいいもの、便利になるものの導入って、人を動かすのが一番難しい。
    ある程度こちらが準備してあげないと難しいかな、と思って、一括で登録しました。

    いまは、本番をバンバン更新するようなことはなくなりました。
    事故がないように、ちゃんと見直しながら本番に上げるようにしています。

    いまは、こうしている

    この 2 つのあと、決めたことがあります。

    • 管理画面で組合員の情報を一緒に取らない。マスターキーの窓口で別々に取って、あとで組み合わせる

    • マスターキーを使う処理は、必ず最初に権限を確かめる

    • 一括で何かをしたら、必ず 1 件、実際に試す。それも、自分ではなく、ほかの人の立場で

    • 登録のあとは、台帳どうしの数が合っているかを確かめる

    最初の 2 つは全体ルールに書き足しました。
    2 つ目のアプリ(練習受付)では、そのおかげで同じ問題は起きませんでした。

    振り返ってみると

    • 守りの仕組みは、管理者にも同じように効く。管理者には専用の窓口を。ただし、使う前に必ず本人確認

    • 「見つかりません」は、本当にないのではなく、見せてもらえていないだけのことがある

    • 近道には落とし穴がある。画面から登録すれば自動で作られるものが、直接書き込むと作られない

    「効率化のための近道」は、仕事でもよくやります。
    でも、正規の入口が裏で何をしてくれていたのかを知らないまま近道すると、こういうことが起きる。
    いい勉強になりました。

    画像
    まとめ

    次回:状態を掛け算で作ると、ややこしくなる。目安箱で学んだ「1 つにまとめる」設計。


    連載の記事は、テーマごとにマガジンにまとめています。

     
     
    本業は都内の会社で新規事業の企画。エンジニアではないけれど、AI(Claude)といろんなアプリを作っています。組合の連絡アプリ「Unite」、ハンドボールの記録「HandLog」など、だんだん実際に使われるものが増えてきました。その記録と、つまずいた話を書いています。

    あなたへのおすすめ