【第2回】アプリケーションを世界へ届ける鍵:Cloudflare APIトークンの安全な取得手順


Webアプリを開発し、それを世界中のユーザーに届けるための最初の関門が「インフラ環境(サーバー)の準備」です。手元のパソコン(ローカル環境)でどれほど素晴らしいコードを書いても、それを配置する場所がなければ誰にも使ってもらえません。

本連載では、無料で高機能なホスティングサービスである「Cloudflare Pages」を採用します。そして今回は、手元のパソコンからCloudflareへ安全にアプリのデータを転送するために必須となる「APIトークン」の取得手順を解説します。

APIトークンとは何か?
APIトークンとは、一言で言えば「プログラム専用の合鍵」です。

普段私たちがWebサービスにログインする際は、メールアドレスとパスワードを入力します。しかし、開発ツールを使って手元のパソコンからプログラムをアップロードする際、毎回手動でパスワードを入力するのは非効率であり、セキュリティ上のリスクも伴います。
そこで、「Cloudflare Pagesへのアップロード機能だけ」を許可した専用の合鍵(APIトークン)を発行し、それを開発環境に持たせることで、安全かつ自動的なデプロイ(本番環境への反映)を実現するのです。

画面を見ずに理解する、トークン取得の論理的ステップ
Cloudflareの管理画面は多機能ゆえに初心者には複雑に見えるかもしれませんが、以下の論理的ステップを追っていけば迷うことはありません。

アカウントの作成とログイン
まずはCloudflareの公式サイトにアクセスし、アカウントを作成してログインします。

APIトークンの管理画面へアクセス
ログイン後、画面右上にある人型のアイコン(マイプロフィール)をクリックし、メニューから「APIトークン」を選択します。ここが、すべてのアカウント権限を管理する心臓部です。

カスタムトークンの作成
「トークンを作成する」ボタンを押すと、いくつかのテンプレートが提案されますが、今回は一番下にある「カスタムトークンを作成」を選びます。これは「最小権限の原則」に従い、必要最低限の権限だけを持たせた安全な鍵を自作するためです。

権限(パーミッション)の厳密な設定
トークンに名前(例:「タロットアプリ用デプロイ鍵」など、後から見て用途がわかる名前)を付けたら、権限を設定します。
権限のプルダウンメニューから「アカウント」→「Cloudflare Pages」→「編集(Edit)」の順に選択します。これにより、「この合鍵はPagesの書き換えだけが許される」という厳格なルールが設定されます。

トークンの発行と厳重な保管
画面の案内に従って作成を完了すると、ランダムな英数字の羅列(APIトークン)が一度だけ画面に表示されます。

開発者の鉄則:鍵の厳重管理
ここで画面に表示されたAPIトークンは、絶対に他人に教えてはいけません。

また、後日作成するソースコードの中に直接書き込んだり、GitHubなどの公開スペースに誤ってアップロードしたりすることも厳禁です。クレジットカードの暗証番号と同じレベルの機密情報として、パスワード管理ツールや手元の安全なメモ帳に確実にコピーして保存してください(セキュリティ保護のため、一度画面を閉じると二度と確認できなくなります)。

次回(第3回)は、今回取得した合鍵を使用し、いよいよ皆様のパソコン内にReactを使った「開発の土台」を構築していきます。黒い画面(ターミナル)へのコマンド入力が始まりますが、一つひとつの意味を紐解きながら進めますのでご安心ください。

【編集後記】
初めてクラウドサービスの本格的な管理画面に触れると、見慣れない英語や専門用語の多さに圧倒され、無意識に「自分にはまだ早いかも」とブラウザを閉じたくなってしまうかもしれません。しかし、今回のように「何のために」「どこを設定するのか」という目的さえ明確になっていれば、巨大なインフラのシステムも決して怖くありません。安全な合鍵を手に入れた今、いよいよ本格的な開発のスタートラインに立ちました!