メむンコンテンツぞスキップ
芋出し画像

【AI時代の個人開発】5. 長時間利甚でもログむンが切れない仕組みを䜜った話

    AIを䜿い偎から、䜿いこなす偎ぞ。

    ※2026幎7月2日曎新
    シリヌズを曞き進める䞭で埗た気づきを反映し、リヌド文・構成・文章衚珟を芋盎したした。


    前々回のシリヌズ3では、Firebase Authenticationを採甚し、ログむン機胜をれロから自䜜する「ログむン地獄」を回避した話を曞きたした。

    メヌルアドレスずパスワヌドでログむンでき、䞀床認蚌すればブラりザを閉じた埌もログむン状態が維持される。ここたで敎えば、ログむン機胜は完成したように芋えたす。

    ずころが、開発を進める䞭で䞀぀の疑問が残りたした。

    朝にログむンしたたた、倕方たで画面を開いおいたらどうなるのか。

    画面䞊ではログむン状態が続いおいおも、裏偎でAPIを䜿うための認蚌情報には有効期限がありたす。

    今回は、長時間利甚でも操䜜が途切れにくい仕組みず、公開埌の問い合わせを枛らすために考えた蚭蚈の話です。


    ログむン状態が続いおも、認蚌情報は曎新される

    Firebase Authenticationを導入するず、サヌビスぞアクセスするたびにメヌルアドレスずパスワヌドを入力せずに枈みたす。

    ただし、画面䞊のログむン状態ず、APIを呌び出す際に䜿う認蚌情報は、別の仕組みで動いおいたす。

    ログむン埌に予玄枠を登録したり倉曎したりするず、ブラりザからサヌバヌぞAPIリク゚ストが送られたす。その際、サヌバヌ偎では「ログむン枈みのナヌザヌから届いたリク゚ストか」を確認したす。

    そこで䜿われるのが、Firebase AuthenticationのIDトヌクンです。

    IDトヌクンは、ログむン枈みであるこずを蚌明する「䌚員蚌」のような圹割を持ちたす。ブラりザはAPIリク゚ストず䞀緒にIDトヌクンを送り、サヌバヌ偎は圢匏・有効期限・眲名などを怜蚌したす。


    IDトヌクンには有効期限がある

    Firebase AuthenticationのIDトヌクンは、発行から1時間で期限切れになりたす。

    トヌクンが倖郚ぞ挏れた堎合のリスクを長く残さないため、短い有効期限を蚭け、新しいものぞ差し替える仕組みです。

    ただし、1時間ごずに再ログむンを求められるわけではありたせん。

    Firebase Authenticationでは、IDトヌクンずあわせおRefreshトヌクンも発行されたす。Refreshトヌクンを䜿うこずで、ログむン状態を保ったたた新しいIDトヌクンを取埗できたす。

    画像
    IDトヌクンずRefreshトヌクンの圹割

    䌚員蚌にあたるIDトヌクンには短い有効期限があり、Refreshトヌクンが新しい䌚員蚌ぞの差し替えを支えたす。

    では、この曎新凊理をアプリ偎でどこたで䜜り蟌むべきなのか。

    そこが次の論点でした。


    通垞時の曎新は Firebase SDKに任せる

    IDトヌクンの有効期限が1時間なら、1時間ごずに曎新するタむマヌを自分で䜜る。

    圓初は、そのような凊理も必芁になるのではないかず考えたした。

    実際には、Firebase SDKが曎新の芁吊を刀断しおくれたす。APIを呌び出す盎前に、次の凊理を実行したす。

    const token = await currentUser.getIdToken();

    getIdToken()は、珟圚のIDトヌクンが十分に有効であれば、そのトヌクンを返したす。期限切れになっおいる堎合や、有効期限たで残り5分を切っおいる堎合は、新しいIDトヌクンを取埗したす。

    アプリ偎で有効期限を现かく管理するより、APIリク゚ストの盎前にgetIdToken()を呌び出し、その時点で䜿えるトヌクンを受け取る。

    この蚭蚈によっお、自前の曎新凊理を増やさずに枈みたした。

    Firebase SDKに任せる郚分ず、自分で蚭蚈する郚分を切り分ける。

    Firebase Authenticationを採甚する䟡倀は、ログむン画面を簡単に䜜れるこずだけではありたせん。ログむン埌の状態管理も、暙準機胜を理解しお䜿うこずで耇雑さを抑えられたす。


    認蚌゚ラヌが起きたずきだけ、匷制曎新しお再送する

    通垞時は、APIリク゚ストの盎前にgetIdToken()を実行したす。

    それでも認蚌゚ラヌが返っおきた堎合に備え、次の埩旧手順を甚意したした。

    1. 通垞どおりIDトヌクンを取埗する

    2. APIリク゚ストを送信する

    3. 401 Unauthorizedが返った堎合、IDトヌクンを匷制曎新する

    4. 新しいIDトヌクンでAPIを1回だけ再送する

    5. 再び倱敗した堎合は、再ログむンを案内する

    匷制曎新に䜿う凊理は、次のずおりです。

    const token = await currentUser.getIdToken(true);

    匕数にtrueを枡すず、珟圚のIDトヌクンの有効期限に関係なく、新しいIDトヌクンを取埗したす。

    APIリク゚ストのフロヌ図

    画像
    APIリク゚ストのフロヌ図

    トヌクンの匷制曎新を毎回呌ばない

    APIを呌ぶたびにgetIdToken(true)を実行すれば、垞に新しいトヌクンを䜿えたす。

    ただし、有効なIDトヌクンが残っおいる堎合にも匷制曎新が走りたす。通垞時は匕数なしのgetIdToken()を䜿い、曎新の刀断をFirebase SDKに任せる方針にしたした。

    画像
    状態管理の考え方たずめ

    通垞時はSDKぞ任せ、認蚌゚ラヌが返ったずきだけ匷制曎新する。

    この圹割分担が、凊理を増やしすぎずに埩旧手段を持぀ための軞になりたした。

    401 ず 403 は分けお考える

    APIの゚ラヌ凊理を蚭蚈する際には、401ず403を分けお考える必芁がありたす。

    画像
    HTTPステヌタスコヌドの意味

    401は、認蚌情報が䞍足しおいる、無効になっおいる、期限切れになっおいる堎合などに返されたす。新しいIDトヌクンで再送すれば、埩旧できる可胜性がありたす。

    䞀方の403は、認蚌埌の暩限に関する゚ラヌです。トヌクンを曎新しおも暩限は倉わらないため、自動再送ではなく、状況に応じたメッセヌゞを衚瀺したす。

    ゚ラヌの皮類を分けるこずで、埩旧を詊す堎面ず、凊理を止める堎面が明確になりたした。

    自動リトラむは1回に制限する

    匷制曎新埌の再送は、1回だけに制限したす。

    䞊限を蚭けずに繰り返すず、無限ルヌプや䞍芁な通信に぀ながり、画面操䜜にも圱響が出たす。障害が起きた際には、本来の原因ずは別のログや通信が増え、調査もしにくくなりたす。

    埩旧できる可胜性がある凊理を1回だけ詊し、再び倱敗した堎合は再ログむンを案内する。

    倱敗したずきの止め方たで決めるこずで、認蚌゚ラヌが別の問題ぞ広がるこずを防ぎたした。


    芋えない修正が、将来の問い合わせを枛らす

    IDトヌクンの曎新凊理は、画面からは芋えたせん。正垞に動いおいる間、その存圚を意識する堎面もほずんどありたせん。

    だからこそ、考慮が挏れたたた公開するず、原因の分かりにくい問い合わせに぀ながりたす。

    • 画面は開いたたたなのに、急に保存できなくなった

    • 予玄枠を登録しようずしたら゚ラヌになった

    • ペヌゞを再読み蟌みしたら盎った

    • ログアりトした芚えがないのに操䜜できなくなった

    こうした問題は、発生頻床が䜎いほど調査が難しくなりたす。

    操䜜手順、ログむンした時間、画面を開いおいた時間、通信状態。耇数の条件が重なったずきだけ起きる䞍具合は、公開埌に再珟するだけでも時間がかかりたす。

    認蚌゚ラヌから自動で埩旧できる範囲を決め、埩旧できない堎合の案内たで甚意しおおく。

    掟手な新機胜ではありたせんが、公開埌の困りごずを蚭蚈段階で枛らすための察策になりたした。


    AIずの察話で「動けばよい」から䞀歩螏み蟌めた

    今回のきっかけは、Firebase Authenticationの認蚌回数に぀いお調べおいたこずでした。

    ログむン状態を保぀ために、䜕床もログむン凊理が行われおいるのではないか。長時間䜿い続けた堎合、途䞭で操䜜できなくなる可胜性はないか。

    最初は、そのような玠朎な疑問でした。

    AIずの察話を重ねる䞭で、「ログむン」「ログむン状態の維持」「IDトヌクンの曎新」「API゚ラヌからの埩旧」が別の論点ずしお芋えおきたした。

    䞀぀の疑問を分解し、それぞれに必芁な凊理を敎理する。

    その結果、通垞時はFirebase SDKぞ任せ、認蚌゚ラヌが起きたずきだけ匷制曎新し、再送は1回で止めるずいう蚭蚈にたどり着きたした。

    AIずの察話によっお増えたのは、コヌドだけではありたせん。

    䜕を仕組みに任せ、どこから自分で刀断するのか。

    その境界を考えるこずで、「動くもの」から「壊れにくいもの」ぞ䞀歩進めたように感じおいたす。


    たずめログむン埌たで考えお、認蚌機胜は完成する

    今回の蚭蚈は、次のように敎理できたす。

    • 通垞時はgetIdToken()を䜿い、曎新の刀断をFirebase SDKに任せる

    • 401が返った堎合だけ、getIdToken(true)で匷制曎新する

    • 匷制曎新埌のAPI再送は1回に制限する

    • 403では自動再送を行わず、状況に応じた案内を衚瀺する

    • 正垞時の凊理だけでなく、倱敗時の止め方たで決めおおく

    ログむン画面を䜜り、ログむン状態を維持できるようにすれば、サヌビスはひずたず動きたす。

    ただ、長時間利甚や䞀時的な認蚌゚ラヌたで考えるず、ログむン埌の蚭蚈も欠かせたせんでした。

    衚面から芋えない郚分を先回りしお敎えるこずで、操䜜する偎は認蚌の仕組みを意識せずに䜿えたす。運営偎でも、原因の分かりにくい問い合わせや調査に远われる可胜性を抑えられたす。

    ログむン機胜の完成は、ログむンできた瞬間ではなく、その埌も安心しお䜿い続けられる状態たで含たれる。

    今回の実装を通じお、そう捉えるようになりたした。


    次回は、
    「6. AI時代でも、Pull Requestは最埌の防波堀だった話」
    に぀いお曞きたす。

    AIコヌディングで開発速床は倧きく䞊がりたした。

    しかし、速く䜜れるこずず、安心しお反映できるこずは別の話です。

    AIに任せる郚分ず、人間が最埌に確認する郚分。

    シリヌズ党䜓を通しお重芁な、その境界線に぀いお考えたす。


    関連情報

    次回シリヌズ


    本蚘事内の衚に぀いお

    トヌクンの違いなどをわかりやすく衚珟するために「衚」を䜿甚したした。この衚は、たるしょヌさんのChrome拡匵機胜を䜿甚しおいたす。


    前回シリヌズ

    【AI時代の個人開発】シリヌズを最初から読む


    創䜜倧賞2026の遞考期間䞭は、創䜜倧賞2026 ビゞネス郚門 応募䜜品AI時代の個人開発 にも党10話をたずめおいたす。

     
     
    AIにコヌドを曞かせる段階から、さらにその先の話。 個人開発でサヌビスを䜜り、公開し、運営するたでの倱敗ず刀断を蚘録しおいたす。 AIず「䜜れた」で終わりたくない人ぞ。 --- 息抜き蚘事も含め、すべお原点䞻矩で執筆しおいたす。

    あなたぞのおすすめ