커스텀 커넥터

커스텀 커넥터는 직접 설명해서 만드는 서비스예요. 키를 받는 인터넷상의 API라면 무엇이든 가능해요. 만들고 나면 앱은 목록에 있는 다른 커넥터와 똑같이 Setherion을 거쳐 사용하고, 키는 저희 서버에 보관돼요.

Connectors 페이지 오른쪽 위의 + 버튼을 누르고, Custom connector를 누른 다음 아래 항목을 채우세요.

• Details. Display name, 목록에 표시되는 Short description, 더 긴 Description, Category, 선택 사항인 문서 주소가 들어가요.
• Authentication. 키를 전달하는 방식이에요. Bearer token, API key in a header(헤더 이름을 직접 정해요), API key in the address(파라미터 이름을 직접 정해요), Username and password 중에서 골라요. 사람들에게 요청할 항목의 이름(예: “Password”)도 정할 수 있어요. What requests to this API will look like에 선택한 방식대로 요청의 모습이 표시돼요. 그다음 모든 요청이 시작되는 API base URL과 Test request를 입력해요. Test request는 유효한 키가 없으면 실패하는 간단한 호출로, 현재 계정을 돌려주는 호출 같은 것이에요.
• Who may use it. Only your app's team(기본값), Visitors can read, Anybody 중에서 고른 다음, 앱이 보낼 수 있는 요청의 종류를 정해요. GET은 읽기 요청이고, 나머지는 무언가를 바꾸는 요청이에요. Visitors can read를 고르면 앱을 여는 누구나 읽을 수 있고 팀만 바꿀 수 있어요. Anybody를 고르면 허용한 모든 호출을 누구나 할 수 있고, 방문자마다 호출이 더 엄격하게 제한돼요. 그런 용도로 만든 API에만 고르세요.
• Agent knowledge. 선택 사항이지만 적어 둘 만한 가치가 있어요. 경로, 경로마다 요청과 응답 하나씩, 그리고 틀리기 쉬운 점을 적어 주세요. Setherion은 앱을 만들 때 이것을 읽어요. 없으면 Setherion이 경로를 짐작해야 하는데, 짐작은 틀릴 수 있어요. 예를 들어 내 계정을 돌려주는 경로가 어느 것인지 적어 두세요. 여기에는 키를 절대 붙여 넣지 마세요.

폼에는 키를 넣지 않아요. Create를 누르면 커넥터 페이지가 열려요. 거기서 키를 추가하고 Test connection을 누른 다음, 다른 서비스와 똑같이 연결해요. Edit와 Delete도 그 페이지에 있어요. 삭제하면 키도 함께 삭제되고, 그 커넥터를 쓰는 앱은 즉시 연결할 수 없게 돼요.

요청해 보세요. 연결하고 앱에 체크하면 이름을 지정해서 요청하세요. “Acme의 진행 중인 프로젝트를 대시보드에 보여 주세요.” “Acme에 작업을 만드는 버튼을 추가해 주세요.”

• API base URL은 https://로 시작해야 하고 공개된 인터넷에 있어야 해요. 사설 네트워크 안의 주소, IP 주소, 443이 아닌 포트가 붙은 주소는 저장할 때와 호출할 때마다 거부돼요.
• 커스텀 커넥터는 내 것이에요. 팀 워크스페이스의 멤버에게 빌려주지 않고, 앱이 쓸 수 있는 커넥터를 목록으로 정해 둔 워크스페이스에서도 제외돼요.
• 최대 25개까지 만들 수 있어요.
• 앱 하나에 필요한 키가 하나뿐이라면 키와 시크릿으로 충분할 수 있어요.