Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Konektor kustom

Halaman ini memberikan ringkasan tentang fitur konektor kustom di Konektor Integrasi, dan mengasumsikan bahwa Anda sudah memahami konsep berikut:

• Integration Connectors
• Konektor versus koneksi
• Spesifikasi Open API

Fitur konektor kustom memungkinkan Anda menggunakan konektor yang bukan bagian dari konektor standar yang disediakan oleh Integration Connectors. Misalnya, Anda mungkin memiliki Sistem Pengelolaan Sumber Daya Manusia (HRMS) internal dengan protokol konektivitas eksklusif, yang ingin Anda ekspos ke Integrasi Aplikasi melalui konektor. Fitur konektor kustom berguna dalam skenario berikut:

• Konektor bawaan tidak tersedia di Konektor Integrasi untuk sumber data atau layanan yang ingin Anda hubungkan.
• Konektor bawaan tersedia di Konektor Integrasi, tetapi tidak memenuhi persyaratan Anda.

Bagaimana Integration Connectors mendukung konektor kustom?

Konektor Integrasi mendukung konektor kustom melalui spesifikasi Open API (versi 3.0.0 dan semua versi minornya). Anda dapat mengekspos backend sebagai endpoint publik, lalu menggunakan spesifikasi Open API endpoint untuk membuat konektor baru yang terhubung ke endpoint (backend) Anda.

Spesifikasi Open API endpoint menentukan kontrak antara Konektor Integrasi dan endpoint. Integration Connectors menggunakan spesifikasi API untuk membuat tindakan dan entity konektor. Spesifikasi API dapat berupa JSON atau YAML. Berikut adalah kutipan dari contoh spesifikasi Open API layanan backend:

{
"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! You 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"
}
}
}
}

Untuk melihat spesifikasi contoh lengkap, lihat Contoh repositori toko hewan peliharaan. Misalnya, Anda menggunakan spesifikasi contoh ini untuk membuat konektor kustom, Konektor Integrasi akan menghasilkan tindakan terpisah untuk setiap elemen di path. Misalnya, uploadImage dan findByStatus akan dicantumkan sebagai tindakan yang didukung oleh konektor kustom.

Skenario konektivitas backend

Konektor Integrasi mendukung konektor kustom untuk skenario konektivitas backend berikut:

• Konektivitas backend langsung
• Konektivitas backend tidak langsung

Catatan: Terlepas dari skenario konektivitas apa pun, Konektor Integrasi hanya dapat terhubung ke endpoint yang mematuhi Open API.

Skenario - Konektivitas backend langsung

Dalam skenario ini, runtime Konektor Integrasi langsung membuat konektivitas ke backend yang mematuhi Open API. Ilustrasi berikut menunjukkan konektivitas konektor dalam skenario ini:

Skenario - Konektivitas backend tidak langsung

Dalam skenario ini, runtime Konektor Integrasi akan membuat konektivitas ke backend Anda melalui layanan perantara (facade) yang mematuhi Open API. Layanan perantara kemudian terhubung ke backend Anda. Ilustrasi berikut menunjukkan konektivitas konektor dalam skenario ini:

• Konektor Integrasi tidak mengelola konektivitas antara layanan perantara dan backend Anda. Oleh karena itu, keterlambatan yang terjadi karena masalah konektivitas antara layanan perantara dan backend, berada di luar cakupan SLA Konektor Integrasi.
• Konektor Integrasi tidak mendukung jenis autentikasi OAuth 2.0 antara layanan perantara dan backend.

Versi konektor kustom

Dengan fitur pembuatan versi, Anda dapat membuat beberapa versi konektor kustom. Setiap versi dapat memiliki spesifikasi OpenAPI, metode autentikasi, dan variabel backend yang berbeda. Akibatnya, Anda memiliki banyak fleksibilitas dalam membuat konektor dengan berbagai konfigurasi.

Saat Anda membuat konektor baru, versi pertama konektor akan otomatis dibuat untuk Anda, dan detail versi akan ditampilkan di tab Versi di halaman detail konektor kustom. Untuk memahami cara membuat versi baru konektor, lihat Mengelola versi konektor kustom.

Langkah selanjutnya

Pahami cara membuat konektor kustom.