Crescendo Lab ドキュメント
日本語
無料で始める

アドレスとアクセス

各プロジェクトには公開アドレス、バージョンごとのプレビューアドレス、内部アドレスがあります。公開のままにするか、パスワードで保護できます。

最終更新

3 種類のアドレス#

アドレスはアドレスラベルと組織名で構成され、すべて HTTPS です。

アドレス開ける人例
公開アドレス誰でも。非公開プロジェクトはパスワードが必要https://order-api--acme.hosting.agentlab.run
バージョンのプレビューアドレスアドレスを知っている人。非公開プロジェクトはパスワードが必要バージョンごとに 1 つ。バージョンの横に表示
内部アドレス同じ組織のプロジェクトだけ。ブラウザでは開けませんhttps://order-api--acme.internal-hosting.agentlab.run

アドレスラベル#

アドレスラベルはプロジェクトの作成時に決めます。小文字の英字、数字、ハイフンが使えます。一度使ったラベルは組織に保持され、プロジェクトを完全に削除しても他の誰かに割り当てられることはありません。

ワークスペースのアドレス#

各アドレスの末尾にある組織名(例の acme)は、コンソールでは「ワークスペースのアドレス」と呼ばれ、コンソールもこのアドレスの下にあります。オーナーはワークスペース設定の「一般」で一度だけ変更できます。ただし、そのワークスペースでプロジェクト、データベース、キャッシュ、スケジュールジョブ、イメージを一度も作成していない場合に限ります。以前の名前がほかの誰かに使われることはなく、以前のコンソールのアドレスを開くと新しいアドレスが案内されます。

公開か非公開か#

プロジェクトの「設定」でアクセスを選びます。

選択肢動作
公開アドレスを知っている人なら誰でも閲覧できます。
非公開プロジェクトのすべてのアドレス(公開アドレスと各バージョンのプレビューアドレス)で、まずパスワードページが表示されます。

パスワードはコンソールで生成され、一度だけ表示されます。紛失した場合は再生成してください。

非公開プロジェクトは CDN を経由しません

少人数のレビューには十分ですが、大量のトラフィックには向きません。

別のプロジェクトから呼び出す#

同じ組織のプロジェクトどうしは、内部アドレスで呼び出します。

  • 呼び出せるのは、プラットフォーム内にある自組織のプロジェクトだけです。他の組織、ビルド、インターネットからは呼び出せません。
  • 証明書は公的に信頼されたものなので、標準の HTTP クライアントで追加設定なしに使えます。
  • 呼び出しは公開中のバージョンに届きます。新しいバージョンを公開すると、呼び出し先も一緒に切り替わります。
  • 内部アドレスにはパスワードページがありません。保護が必要なエンドポイントはコード側で確認してください。

内部アドレスに届いたリクエストには、送信元プロジェクトのアドレスラベルを示す X-Franky-Caller-App ヘッダーが付きます。公開アドレスへのリクエストからはプラットフォームがこのヘッダーを取り除きますが、それでも Host が内部ドメインのときだけ信頼してください。

server.js
const internal = req.headers.host?.endsWith(".internal-hosting.agentlab.run");
const caller = internal ? req.headers["x-franky-caller-app"] : undefined;

if (req.url.startsWith("/admin") && caller !== "billing-worker") {
  res.writeHead(403).end();
  return;
}