
# Supabase Edge Functions

`--platform supabase` は、`index.ts`、`main.js`、`prelude.js` を持つ `supabase/functions/<name>/` を書きます。`supabase functions deploy <name>` でデプロイします。[ビルド](building.md) を参照してください。空のディレクトリから関数全体を作る手順は [空のディレクトリから Supabase の関数まで](first-function.md) を参照してください。

## パス

プラットフォームは、関数の名前を先頭に付けたパスを関数に渡します (`/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-boot-starter-supabase/index.md) があると、`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 を設定してください。

```toml
[edge_runtime.secrets]
SPRING_SUPABASE_AUTH_ISSUER = "http://127.0.0.1:54321/auth/v1"
```

ホスト型のプロジェクトでは必要ありません。

## クライアントのアドレス

クライアントのアドレスは接続のアドレスで、それはプラットフォームのゲートウェイです。アドレスによるレート制限には `spring.web.rate-limit.trusted-proxies` が必要です。ユーザーによる制限には必要ありません。

## 例

[`example/supabase/function`](https://github.com/farum-azula/spring_core_dart/tree/main/example/supabase/function) がそのような関数です。[Dart で書く Edge Function](../spring-boot-starter-supabase/edge-function.md) を参照してください。

## 関連項目

- [関数のデプロイ](deploying.md#supabase-edge-functions): デプロイの手順。手作業と GitHub Actions
- [関数が異なる点](differences.md)
- [すべてのプロパティ](properties.md)
- [Supabase スターターの Edge Functions](../spring-boot-starter-supabase/functions.md): アプリケーションから関数を呼び出す
