Introduction to the InterSystems API Manager (IAM) Version 2.3
InterSystems API Manager (IAM) is a component of InterSystems IRIS® data platform that allows you to take advantage of microservices and APIs that are either exposed or consumed by your InterSystems IRIS applications. Acting as an API gateway between your InterSystems IRIS servers and applications, it gives you the ability to more effectively monitor and control the traffic of calls between your server-side APIs and your client-side applications. IAM enables you to monitor, control, and govern HTTP-based API traffic.
The more distributed your environment the more critical it becomes to properly govern and monitor your API traffic. IAM enables you to easily route all your traffic through a centralized gateway and forward API requests to appropriate target nodes.
The InterSystems API Manager is powered by Kong Enterprise Version 188.8.131.52, an industry-leading API manager from Kong, Inc. The InterSystems Worldwide Response Center (WRC) provides support for IAM including the Kong Enterprise features. The main source of information about IAM is provided by the Kong Enterprise 2.3 documentation. InterSystems provides information about installing and upgrading IAM and some details about the IAM environment.
For information on using the previous version of IAM, see InterSystems API Manager (IAM).
Benefits of Using IAM
Using IAM allows you to do the following:
Monitor your HTTP-based API traffic and understand who is using your APIs; what are your most popular APIs and which could require a rework.
Control who is using your APIs and restrict usage in various ways. From simple access restrictions to throttling API traffic and fine-tuning request payloads, you have fine-grained control and can react quickly.
Protect your APIs with central security mechanisms like OAuth2.0 or Key Token Authentication.
Onboard third-party developers and provide them with a superb developer experience right from the start by providing a dedicated Developer Portal for their needs.
Scale your API demands and deliver low-latency responses.
Provide a uniform API for underlying services that have different APIs.
IAM provided with InterSystems IRIS must be used only for APIs that are either provided by InterSystems IRIS or used by InterSystems IRIS. If you want to extend the use of IAM to cover APIs that are independent of InterSystems IRIS, contact InterSystems sales for more information.
Learning About IAM
The IAM Version 2.3 documentation provided by InterSystems includes:
For documentation of previous IAM releases, see IAM Versions.
The Kong Enterprise 2.3 documentation covers:
Kong API Gateway — is the open source foundation of Kong Enterprise. It is a lightweight, fast, and flexible cloud-native API gateway. It provides a central way to access REST APIs.
Kong Admin API — provides a REST API to administer and configure services, routes, plugins, and consumers.
Kong Manager — is the browser-based tool for monitoring and managing Kong Gateway. In addition to configuring services, routes, plugins, and consumers, you can define security groups, policies and monitor performance.
Kong Developer Portal — provides access to developers, so they can generate API documentation for REST interfaces through their specifications, and manage different versions of REST APIs.
Kong Plugins — provide advanced functionality such as authentication and rate limits.
Kong Vitals — provide metrics about the health and performance of API traffic.
The following features of Kong Enterprise are not included in the InterSystems API Manager: Kong Brain, Kong Immunity, and Kong Studio.
For additional information about IAM, see the InterSystems Developer Community article and the InterSystems online learning site. The online learning site has online classes, videos and documents that cover topics on IAM, such as building FHIR applications and best practices. On the online learning site, search for API Manager for these resources.