L'INTERFACE DE PROGRAMMATION D'APPLICATION À TRANSFERT D'ÉTAT REPRÉSENTATIF ou API REST (Representational State Transfer Application Programming Interface) est un moyen conforme à la norme permettant aux applications web de communiquer entre elles à l'aide de méthodes HTTP telles que GET, POST, PUT, DELETE, etc. Elle est conçue autour de ressources, qui peuvent être diverses, allant d'un utilisateur à un fichier.

🛠️ Gestion des configurations d'InterSystems API Manager (IAM = Kong Gateway) en CI/CD

🔍 Contexte : configurations d'InterSystems IAM

Dans le cadre de l'intégration d'InterSystems IAM dans un environnement sécurisé et contrôlé, InterSystems IAM repose sur Kong Gateway pour gérer les API exposées. Kong agit comme une API Gateway moderne, capable de gérer l’authentification, la sécurité, la gestion du trafic, les plugins, et bien plus encore.

Cependant, maintenir une configuration cohérente de Kong (routes, services, plugins.

InterSystems a le plaisir d'annoncer la sortie d'IAM 3.10. Première version significative depuis environ 18 mois, IAM 3.10 inclut de nombreuses nouvelles fonctionnalités importantes non disponibles dans IAM 3.4, notamment :

• Ajout de la prise en charge de la synchronisation incrémentielle de la configuration pour les déploiements en mode hybride. Au lieu d'envoyer l'intégralité de la configuration de l'entité aux plans de données à chaque mise à jour, la synchronisation incrémentielle permet d'envoyer uniquement la configuration modifiée aux plans de données.

Introduction

Dans le contexte actuel où les menaces évoluent rapidement, les organisations qui déploient des applications critiques doivent mettre en œuvre des architectures de sécurité robustes qui protègent les données sensibles tout en maintenant une haute disponibilité et des performances élevées.

Kong fournit en open source un outil de gestion de ses configurations (écrit en Go), appelé decK (pour declarative Kong)

• Vérifiez que decK reconnaît votre installation Kong Gateway via deck gateway ping

deck gateway ping   
Successfully connected to Kong!
Kong version:  3.4.3.11

• Exporter la configuration de Kong Gateway dans un fichier "kong.yaml" via deck gateway dump

deck gateway dump -o kong.yaml

• Après avoir modifié les adresses IP dans le fichier kong.yaml, afficher les différences via deck gateway diff

deck gateway diff kong.

IAM - InterSystems API Manager est un excellent outil pour surveiller votre trafic. Si vous essayez de l'utiliser dans votre cluster Kubernetes, vous avez peut-être essayé de faire un déploiement similaire à celui-ci :

apiVersion: intersystems.com/v1alpha1
kind: IrisCluster
metadata:
  name: iris
spec:
  licenseKeySecret:
    name: iris-key-secret
  configSource:
    name: iris-cpf
  imagePullSecrets:
    - name: intersystems-pull-secret
  topology:
    data:
      image: containers.intersystems.com/intersystems/iris-arm64:2024.1
      compatibilityVersion: "2024.1.

Les versions 2.8.4.11 et 3.4.3.11 d'InterSystems API Manager (IAM) sont désormais disponibles. Il s'agit des dernières versions des deux versions d'IAM prises en charge à long terme. Ces versions contiennent des correctifs importants et tous les clients sont encouragés à effectuer une mise à niveau.

Les clients d'IAM 3.0 ou 3.2 sont encouragés à effectuer une mise à niveau vers la version 3.4.3.11, car la prise en charge de ces versions prendra bientôt fin.

Les versions 2.8.4.10 et 3.4.3.10 d'InterSystems API Manager (IAM) sont désormais généralement disponibles. Il s'agit des dernières versions des deux versions d'IAM prises en charge à long terme. Ces versions contiennent des correctifs importants et tous les clients sont encouragés à effectuer la mise à niveau.

Les clients utilisant IAM 3.0 ou 3.2 sont encouragés à passer à la version 3.4.3.10, car la prise en charge de ces versions prendra bientôt fin.

Bonjour,

Je cherche à pouvoir activer l'authentification sur IAM.

Version IAM 3.4

La version 3.4.2 d'InterSystems API Manager (IAM) est désormais généralement disponible. En plus des corrections de bugs et des améliorations mineures, IAM 3.4 inclut plusieurs fonctionnalités susceptibles d'intéresser les clients IRIS.

• Les groupes de consommateurs constituent désormais une entité centrale. Avec les groupes de consommateurs, vous pouvez appliquer différentes configurations pour sélectionner des groupes de consommateurs. Ceux-ci peuvent être utilisés avec les transformateurs Rate Limiting Advanced, Request & Response.

Expérience et retour d'expérience du cours en ligne "Hands-On with InterSystems API Manager for Developers" 

Avec mes connaissances de base du conteneur Docker et de l'API REST, j'aimerais faire mon premier essai d'utilisation du gestionnaire d'API InterSystems pour prendre le contrôle des API et des microservices. J'ai suivi ce cours en ligne en utilisant mon instance IRIS locale comme hôte (système d'exploitation Windows) et IAM exécuté sur une machine virtuelle Linux (invité).

Version IAM 3.2

InterSystems API Manager (IAM) version 3.2.1 est désormais généralement disponible. En plus des corrections de bogues et des améliorations mineures, IAM 3.2 ajoute de nouveaux plug-ins susceptibles d'intéresser les clients IRIS.

• Validation OAS (oas-validation)
  
  • Validez les requêtes et les réponses HTTP en fonction d'une spécification d'API OpenAPI 3.0 ou Swagger.
• SAML (saml)
  
  • Fournit l'authentification et l'autorisation SAML v2.0 entre un fournisseur de services (Kong Gateway) et un fournisseur d'identité (IdP).
• Protection contre les menaces XML (xml-threat-protection)
  
  • Ce nouveau plugin vous permet de réduire le risque d'attaques XML en vérifiant la structure des charges utiles XML. Cela valide la complexité maximale (profondeur de l'arbre), la taille maximale des éléments et des attributs.
• AppDynamics (app-dynamics)
  
  • Intégrez Kong Gateway à la plateforme AppDynamics APM.
• Déchiffrement JWE (jwe-decrypt)
  
  • Permet de déchiffrer un jeton entrant (JWE) dans une requête.

Version IAM 2.8.1

InterSystems API Manager (IAM) version 2.8.1 est désormais généralement disponible. En plus d'une multitude d'améliorations des performances et de corrections de bogues, cette version ajoute de nouvelles fonctionnalités importantes, notamment :

• Essentiel
  • Groupes de consommateurs - Vous permet de regrouper des consommateurs pour créer des niveaux de service
  • Crochets d'événement - Permet à IAM d'appeler un crochet Web lorsque certains événements se produisent. Par exemple, envoyez un message PagerDuty si un point de terminaison échoue.

InterSystems API Management (IAM) - c'est une nouvelle fonctionnalité de la plate-forme de données InterSystems IRIS, qui vous permet de surveiller, de contrôler et de gérer le trafic vers et à partir des API basées sur le Web au sein de votre infrastructure informatique. Au cas où vous l'auriez manqué, voici le lien vers l'annonce. Et voici un article expliquant comment commencer à travailler avec IAM.

Dans cet article, nous allons utiliser InterSystems API Management pour assurer l'équilibrage de charge d'une API.

Dans notre cas, nous avons 2 instances InterSystems IRIS avec /api/atelier REST API que nous voulons publier pour nos clients.

Il y a de nombreuses raisons différentes pour lesquelles nous pourrions vouloir faire cela, par exemple :

• Équilibrage de la charge pour répartir la charge de travail entre les serveurs.
• Déploiement bleu-vert : nous avons deux serveurs, l'un "prod", l'autre "dev" et nous pouvons vouloir passer de l'un à l'autre.
• Déploiement canary: nous pourrions publier la nouvelle version sur un seul serveur et y transférer 1% des clients.
• Configuration de haute disponibilité
• etc.

Kong fournit en open source un outil de gestion de ses configurations (écrit en Go), appelé decK (pour declarative Kong)

• Vérifiez que decK reconnaît votre installation Kong Gateway via deck ping

deck ping   
Successfully connected to Kong!
Kong version:  2.3.3.2-enterprise-edition

• Exporter la configuration de Kong Gateway dans un fichier "kong.yaml" via deck dump

deck dump

• Après avoir modifié le kong.yaml, afficher les différences via deck diff

deck diff
updating service alerts  {
   "connect_timeout": 60000,
-  "host": "172.24.156.176",
+  "host": "192.10.10.

Cet article contient le matériel, les exemples, les exercices pour apprendre les concepts de base de IAM.

Toutes les ressources sont disponibles sur ce git : https://github.com/grongierisc/iam-training.

Les solutions sont dans la branche training.

Cet article couvre les sujets suivants :

• 1. Introduction
  • 1.1. Qu'est-ce que IAM ?
  • 1.2. Qu'est-ce que la gestion d''API ?
  • 1.3. Portail IAM
  • 1.4. Flux de cette formation
• 2. Installation
  • 2.1. Que devez-vous installer ?
  • 2.2. Comment IAM fonctionne avec IRIS
  • 2.3. Configuration
  • 2.4. Installer IAM
    • 2.4.1. Image Iris
    • 2.4.2. Image IAM
    • 2.4.3.