키와 시크릿

키

Keys 카드에는 계정에 연결되어 있고 앱에서 쓸 수 있는 서비스(Stripe, OpenAI, Shopify 등)가 개수와 함께 나열돼요. 이 앱의 연결만이 아니라 계정에서 사용 중인 모든 연결이 표시돼요. 카드를 누르면 커넥터가 열려요. 거기서 한 번만 추가하고, 서비스마다 어떤 앱이 쓸지 고르세요.

시크릿

커넥터가 없지만 앱이 호출하는 서비스를 위한 키예요. 날씨 서비스, SMS, 고객의 자체 API 같은 것이 여기에 해당해요. 메뉴의 Cloud 아래에 있고, 앱을 수정할 수 있는 사람이 필요해요. Add secret을 누르고, 이름과 서비스 주소를 입력한 다음 키를 붙여넣으세요.

• 키는 그 주소로만 전송되고, 다른 곳으로는 절대 보내지지 않으며, 앱의 코드 안에도 들어 있지 않아요.
• 키는 암호화되어 저장돼요. 저장한 뒤에는 교체하거나 삭제할 수 있지만, 읽을 수는 없어요.
• 변경은 바로 적용돼요. 미리보기에서도 게시된 앱에서도, 다시 게시하지 않아도 돼요.

그다음 채팅에서 이름으로 불러 달라고 요청하세요. “WEATHER_KEY로 파리의 날씨를 보여 주세요”처럼요. 앱은 키가 들어갈 자리에 이름을 쓰고, Setherion이 요청을 내보낼 때 키를 넣어 줘요. 시크릿을 쓰는 요청은 한 번마다 연동 크레딧이 1개 들어요. 직접 연결한 Supabase를 쓰는 앱은 아직 시크릿을 쓸 수 없어요.

시크릿 규칙

• 이름은 대문자, 숫자, 밑줄로 이루어지고 문자로 시작해야 하며, 2자에서 64자까지 가능해요. 예: WEATHER_KEY. 키 자체가 들어 있는 이름은 거부되고, 이미 쓰고 있는 이름도 거부돼요. 이전 시크릿은 그 메뉴에서 교체하세요.
• 값은 최대 4,096자까지 가능하고, 앱 하나에 시크릿을 50개까지 보관할 수 있어요.
• 서비스 주소는 공개된 https 주소여야 해요. IP 주소, localhost, 포트, 비공개 이름은 거부돼요. 링크 전체를 붙여넣으면 호스트만 저장돼요.
• 요청은 그 주소가 시크릿과 함께 저장된 주소와 같을 때만 전송돼요. 그렇지 않으면 시크릿은 그 호스트로만 보낼 수 있다는 메시지와 함께 거부돼요.
• 키는 앱이 응답을 보기 전에 응답에서 제거돼요.
• 요청은 최대 30초까지 기다리고, 리디렉션되지 않으며, 응답은 최대 5 MB까지 가능해요.
• 방문자는 한 시간에 이런 요청을 최대 600건까지 보낼 수 있어요. 백엔드가 일시 중지되어 있거나 월 사용 허용량이 중단된 동안에는 요청도 멈춰요.
• 표에는 각 시크릿의 이름, 전송되는 주소, 업데이트된 시각이 표시되고, 각 행에 Replace와 Delete가 있어요.