初回セットアップを完了する

新しいデータディレクトリでは、BeaRust はちょうど1回だけセットアップリクエストを受け付けます。このリク エストで最初の管理者が作成され、その後初期化はクローズされます。

初期化ステータスを確認する

デフォルトのコントロールプレーンはホストのローカル 127.0.0.1:8081 です:

curl http://127.0.0.1:8081/api/setup/status

セットアップ前は {"initialized":false} が返ることを想定してください。最初の管理者が作成された後は {"initialized":true} が返ることを想定してください。

最初の管理者を作成する

生成されたセットアップトークン、または BEARUST_SETUP_TOKEN に設定した決定的な値を使用します。この例で は意図的にプレースホルダーを使用しています。12文字以上のユニークなパスワードを使用し、実際の認証情報を 含んだコマンドを共有履歴に残さないでください。

curl -i -c cookies.txt \
  -H 'Content-Type: application/json' \
  -d '{"email":"admin@example.com","password":"<12文字以上の管理者パスワード>","setup_token":"<setup-token>"}' \
  http://127.0.0.1:8081/api/setup/initialize

成功すると 201 Created と有効化された admin ユーザーのレスポンスが返ります。セッション作成が成功す ると、レスポンスは HttpOnly の bearust_session クッキーと bearust_csrf クッキーを設定します。どちら も Secure 属性が付いているため、cookies.txt には記録されますが、curl やブラウザはこれらを平文の http://127.0.0.1:8081 コントロールリスナーには送信しません。セットアップリクエストと未認証のステータ ス確認は、そのローカル HTTP リスナー経由で引き続き使用できます。認証済みのブラウザまたは API 利用には、 TLS を終端して loopback のコントロールプレーンへ転送する HTTPS ゲートウェイが必要です。無効なトークンは 403、無効なメールアドレスまたは12文字未満のパスワードは 400、2回目のセットアップ試行は 409 already_initialized を返します。

デフォルトの loopback-only マッピングは公開ログインエンドポイントではなく、安全境界です。ローカルのまま にするか、意図的に保護された HTTPS ゲートウェイを前段に配置してください。近道としてポート 8081 を インターネットに公開しないでください。