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.

Connecteurs personnalisés

Cette page présente la fonctionnalité de connecteurs personnalisés dans Integration Connectors. Nous partons du principe que vous connaissez les concepts suivants :

• Integration Connectors
• Différence entre connecteur et connexion
• Spécifications OpenAPI

La fonctionnalité de connecteurs personnalisés vous permet d'utiliser des connecteurs qui ne font pas partie des connecteurs standards fournis par Integration Connectors. Par exemple, vous pouvez avoir un système de gestion des ressources humaines (SGRH) interne avec un protocole de connectivité propriétaire que vous souhaitez exposer à Application Integration au moyen d'un connecteur. La fonctionnalité de connecteurs personnalisés est utile dans les cas suivants :

• Les connecteurs intégrés ne sont pas disponibles dans Integration Connectors pour une source de données ou un service que vous souhaitez connecter.
• Les connecteurs intégrés sont disponibles dans Integration Connectors, mais ils ne répondent pas à vos besoins.

Comment Integration Connectors prend-il en charge les connecteurs personnalisés ?

Integration Connectors prend en charge les connecteurs personnalisés par le biais de la spécification OpenAPI (version 3.0.0 et toutes ses versions mineures). Vous pouvez exposer votre backend en tant que point de terminaison public, puis utiliser la spécification OpenAPI de votre point de terminaison pour créer un connecteur qui se connecte à votre point de terminaison (backend).

La spécification OpenAPI d'un point de terminaison définit le contrat entre Integration Connectors et le point de terminaison. Integration Connectors utilise la spécification de l'API pour générer les actions et les entités du connecteur. La spécification de l'API peut être au format JSON ou YAML. Voici un extrait d'un exemple de spécification OpenAPI pour un service de 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"
}
}
}
}

Pour consulter l'exemple de spécification complet, consultez cet exemple de dépôt d'animalerie. Supposons que vous utilisiez cet exemple de spécification pour créer un connecteur personnalisé. Integration Connectors générera une action distincte pour chaque élément de path. Par exemple, uploadImage et findByStatus sont listés comme actions compatibles par le connecteur personnalisé.

Types de connectivité du backend

Integration Connectors prend en charge les connecteurs personnalisés pour ces types de connectivité du backend :

• Connectivité directe avec le backend
• Connectivité indirecte avec le backend

Remarque : Quel que soit le type de connectivité, Integration Connectors ne peut se connecter qu'à des points de terminaison conformes à OpenAPI.

Connectivité directe avec le backend

Pour ce type de connectivité, l'environnement d'exécution Integration Connectors établit directement la connectivité avec votre backend conforme à OpenAPI. Le diagramme suivant illustre la connectivité avec le connecteur pour ce cas de figure :

Connectivité indirecte avec le backend

Pour ce type de connectivité, l'environnement d'exécution Integration Connectors établit la connectivité avec votre backend au moyen d'un service intermédiaire (façade) conforme à OpenAPI. Le service intermédiaire se connecte ensuite à votre backend. Le diagramme suivant illustre la connectivité avec le connecteur pour ce cas de figure :

• Integration Connectors ne gère pas la connectivité entre le service intermédiaire et votre backend. Par conséquent, les retards dus à des problèmes de connectivité entre le service intermédiaire et le backend ne sont pas couverts par le SLA d'Integration Connectors.
• Integration Connectors ne prend pas en charge le type d'authentification OAuth 2.0 entre le service intermédiaire et le backend.

Versions de connecteurs personnalisés

La fonctionnalité de gestion des versions vous permet de créer plusieurs versions d'un connecteur personnalisé. Chaque version peut avoir une spécification OpenAPI, une méthode d'authentification et des variables de backend différentes. Vous bénéficiez donc d'une grande flexibilité pour créer un connecteur avec différentes configurations.

Lorsque vous créez un connecteur, la première version est créée automatiquement pour vous. Les détails de la version s'affichent dans l'onglet Versions de la page d'informations du connecteur personnalisé. Pour savoir comment créer une version d'un connecteur, consultez Gérer les versions de connecteurs personnalisés.

Étape suivante

Découvrez comment créer un connecteur personnalisé.