Supabase Edge Functions
--platform supabase は、index.ts、main.js、prelude.js を持つ supabase/functions/<name>/ を書きます。supabase functions deploy <name> でデプロイします。ビルド を参照してください。空のディレクトリから関数全体を作る手順は 空のディレクトリから Supabase の関数まで を参照してください。
パス
プラットフォームは、関数の名前を先頭に付けたパスを関数に渡します (/functions/v1/api/books は /api/books として届きます)。エントリーは SERVER_CONTEXT_PATH を /<name> に設定するので、マッピングはサーバーのものと同じです。@GetMapping('/books') と書きます。
コンテキストは、インスタンスがロードされるときに起動します。
環境
関数の環境は、アプリケーションの環境です。シークレット GREETING は ${GREETING} で、SPRING_SUPABASE_AUTH_ISSUER は spring.supabase.auth.issuer です。
Supabase スターターとともに
spring_boot_starter_supabase があると、spring.supabase.url、anon-key、service-role-key は、SUPABASE_URL、SUPABASE_ANON_KEY、SUPABASE_SERVICE_ROLE_KEY がデフォルトになります。そのため、リポジトリ (REST パス)、Storage、リソースサーバーに設定は要りません。
使えるのは REST パスだけです。関数にはソケットがないので、spring.supabase.db.url も @Transactional もありません。
verify_jwt
supabase/config.toml で、関数に verify_jwt = false を設定してください。アプリケーションがトークンを自分で確認し (リソースサーバー)、誰にでも開いたエンドポイントを持てるようになります。
ベアラートークンとしての anon キー
ベアラートークンとしての anon キーは、トークンではありません。Supabase のクライアントは、サインインしていない人すべてのベアラートークンとして、プロジェクトの anon キーを送ります。このキーは公開されていて、誰の名前も表さないので、そのようなリクエストは Authorization ヘッダーなしで先に進みます (supabaseAnonKeyFilter)。開かれたエンドポイントはそれに答え、保護されたエンドポイントは 401 を返します。キーを送って得られるものはありません。
spring.edge.supabase.anon-key-as-anonymous: false にすると、代わりにリソースサーバーがそれを拒否します。サービスロールキーは、ユーザーのトークンには決してなりません。401 です。
ローカルスタック
ローカルスタックでは、関数は http://kong:8000 でプロジェクトに届きますが、トークンには http://127.0.0.1:54321 が書かれています。config.toml の [edge_runtime.secrets] に issuer を設定してください。
[edge_runtime.secrets]
SPRING_SUPABASE_AUTH_ISSUER = "http://127.0.0.1:54321/auth/v1"
ホスト型のプロジェクトでは必要ありません。
クライアントのアドレス
クライアントのアドレスは接続のアドレスで、それはプラットフォームのゲートウェイです。アドレスによるレート制限には spring.web.rate-limit.trusted-proxies が必要です。ユーザーによる制限には必要ありません。
例
example/supabase/function がそのような関数です。Dart で書く Edge Function を参照してください。
関連項目
- 関数のデプロイ: デプロイの手順。手作業と GitHub Actions
- 関数が異なる点
- すべてのプロパティ
- Supabase スターターの Edge Functions: アプリケーションから関数を呼び出す