キーとシークレット

キー

Keysカードには、アカウントに接続されていてアプリから使えるサービス（Stripe、OpenAI、Shopifyなど）が件数付きで一覧表示されます。このアプリだけでなく、アカウントで有効なすべての接続が表示されます。カードを押すとコネクタが開きます。そこで一度追加し、どのアプリがどのサービスを使うかを選びます。

シークレット

コネクタのないサービス（天気サービス、SMS、クライアント自身のAPIなど）をアプリが呼び出すためのキーです。メニューのCloudの中にあり、アプリを編集できる人が必要です。Add secretを押し、名前とサービスのアドレスを入力して、キーを貼り付けます。

• キーは、そのアドレスにだけ送られ、ほかには決して送られません。また、アプリのコードの中にも置かれません。
• キーは暗号化して保管されます。保存後は、置き換えや削除はできますが、読み取ることはできません。
• 変更はすぐに反映されます。プレビューでも公開済みのアプリでも、再公開は不要です。

あとは、チャットで名前を指定して使うよう頼みます：「WEATHER_KEYを使ってパリの天気を表示して」。アプリはキーを入れる場所に名前を書き、Setherionが送信時にキーを差し込みます。シークレットを使うリクエストは、1回ごとに連携クレジットを1つ使います。ご自身のSupabaseを使っているアプリでは、まだシークレットを使えません。

シークレットのルール

• 名前は大文字、数字、アンダースコアで、先頭は英字、2文字から64文字です。例：WEATHER_KEY。キーそのものが入っている名前は受け付けられず、すでに使われている名前も受け付けられません。古いものはそのメニューから置き換えてください。
• 値は4,096文字まで、1つのアプリに保管できるシークレットは50個までです。
• サービスのアドレスは、公開されているhttpsアドレスである必要があります。IPアドレス、localhost、ポート番号、プライベートな名前は受け付けられません。リンク全体を貼り付けた場合は、そのホストだけが保存されます。
• リクエストは、そのアドレスがシークレットと一緒に保存されたものと同じ場合にだけ送信されます。違う場合は、シークレットはそのホストにしか送れないというメッセージで拒否されます。
• キーは、アプリが応答を受け取る前に応答から取り除かれます。
• リクエストは最大30秒待ち、リダイレクトはされず、応答は最大5 MBです。
• 訪問者は1時間に最大600回までこうしたリクエストを送れます。バックエンドが一時停止している間や、月ごとの利用枠が止まっている間は、リクエストも止まります。
• 表には、各シークレットの名前、送信先のアドレス、更新日時が表示され、各行にReplaceとDeleteがあります。