커스텀 커넥터

이 페이지에서는 Integration Connectors의 커스텀 커넥터 기능을 간략하게 설명하고 다음 개념에 익숙하다고 가정합니다.

커스텀 커넥터 기능을 사용하면 Integration Connectors에서 제공하는 표준 커넥터에 속하지 않는 커넥터를 사용할 수 있습니다. 예를 들어 독점 연결 프로토콜을 사용하는 사내 인적 자원 관리 시스템(HRMS)이 있으며 커넥터를 통해 Application Integration에 노출하려 할 수 있습니다. 커스텀 커넥터 기능은 다음과 같은 시나리오에서 유용합니다.

  • 연결하려는 데이터 소스나 서비스의 Integration Connectors에서는 기본 제공 커넥터를 사용할 수 없습니다.
  • Integration Connectors에서 사용할 수 있지만 요구사항을 충족하지 않는 기본 제공 커넥터입니다.

Integration Connectors에서 커스텀 커넥터를 지원하는 방법

Integration Connectors는 Open API 사양(버전 3.0.0 및 모든 부 버전)을 통해 커스텀 커넥터를 지원합니다. 백엔드를 공개 엔드포인트로 노출한 후 엔드포인트의 Open API 사양을 사용하여 엔드포인트(백엔드)에 연결하는 새 커넥터를 만들 수 있습니다.

엔드포인트의 Open API 사양은 Integration Connectors와 엔드포인트 간의 계약을 정의합니다. Integration Connectors는 API 사양을 사용하여 커넥터의 작업과 항목을 생성합니다. API 사양은 JSON 또는 YAML일 수 있습니다. 다음은 백엔드 서비스의 샘플 Open API 사양에서 발췌한 것입니다.

{
"openapi":"3.0.2",
"info":{
	"title":"Swagger Petstore - OpenAPI 3.0",
	"description":"This is a sample Pet Store Server based on the OpenAPI 3.0 specification.
  You can find out more about\nSwagger at [
	http://swagger.io](http://swagger.io). In the third iteration of the pet store,
	we've switched to the design first approach!\nYou can now help us improve the API whether
  it's by making changes to the definition itself or to the code.\nThat way,
	with time, we can improve the API in general, and expose some of the new
  features in OAS3.\n\nSome useful links:\n-
  [
	   The Pet Store repository
	]
.....
.....
"paths":{
"/pet/{petId}/uploadImage":{
  "post":{
    "tags":[  
},
.....
.....  
"/pet/findByStatus":{
  "get":{
    "tags":[
      "pet"
    ],
.....
.....  
},
"api_key":{
  "type":"apiKey",
  "name":"api_key",
  "in":"header"
}
}
}
}

전체 샘플 사양을 보려면 샘플 애완동물 스토어 저장소를 참조하세요. 이 샘플 사양을 사용하여 커스텀 커넥터를 만든다고 가정합니다. 그러면 Integration Connectors에서 path의 요소마다 별도의 작업을 생성합니다. 예를 들어 uploadImage 및 findByStatus는 커스텀 커넥터에서 지원하는 작업으로 나열됩니다.

백엔드 연결 시나리오

Integration Connectors는 다음 백엔드 연결 시나리오의 커스텀 커넥터를 지원합니다.

  • 직접 백엔드 연결
  • 간접 백엔드 연결

시나리오 - 직접 백엔드 연결

이 시나리오에서 Integration Connectors 런타임은 Open API 호환 백엔드에 대한 연결을 직접 설정합니다. 다음 이미지에서는 이 시나리오의 커넥터 연결을 보여줍니다.

직접 백엔드 연결

시나리오 - 간접 백엔드 연결

이 시나리오에서 Integration Connectors 런타임은 Open API를 준수하는 중간(퍼사드) 서비스를 통해 백엔드에 대한 연결을 설정합니다. 그러면 중개 서비스가 백엔드에 연결합니다. 다음 이미지에서는 이 시나리오의 커넥터 연결을 보여줍니다.

간접 백엔드 연결

커스텀 커넥터 버전

버전 관리 기능을 사용하면 여러 버전의 커스텀 커넥터를 만들 수 있습니다. 각각의 버전에 다른 OpenAPI 사양, 인증 방법, 백엔드 변수가 있을 수 있습니다. 따라서 다양한 구성으로 더욱 유연하게 커넥터를 만들 수 있습니다.

새 커넥터를 만들면 해당 커넥터의 첫 번째 버전이 자동으로 생성되고 버전 세부정보가 커스텀 커넥터 세부정보 페이지의 버전 탭에 표시됩니다. 새 커넥터 버전을 만드는 방법을 확인하려면 을 참조하세요.

다음 단계

커스텀 커넥터를 만드는 방법 알아보기