This guide explains how to install and configure the Scheer PASAPI Management.
Overview on the Docker Setup of API Management
Have a look at the figure below to get a technical overview on the Docker setup of Scheer PASAPI Management.
Overview on the Installation Containers
Container Name
Description
Default port
api-mgmt/gateway
This container contains the engine of API Management. It handles all incoming client requests, applies the policies and forwards the requests to the API endpoint. The gateway is powered by Eclipse Vert.x which can handle a lot of concurrency using a small number of kernel threads. Vert.x lets your app scale with minimal hardware.
8444
api-mgmt/ui
This container provides the UI to manage all your APIs and gateways. It also allows you to view corresponding metrics. The UI is powered by Apache Tomcat.
8443
api-mgmt/keycloak
This container contains the authentication provider Keycloak. Keycloak is used to authenticate users of the API Management UI and users of the Keycloak OAuth policy. Keycloak runs on JBoss WildFly.
8445
elasticseach
This container contains an official version of Elasticsearch. API Management stores all metrics information and configuration in Elasticsearch.
mysql
This container contains an official version of MySQL. Keycloak uses MySQL to store users and configurations.
System Requirements
For Scheer PAS API Management, you have to consider that there are several components running on the same host (see Overview on the Installation Containers above). For a lean setup, you should have at least 8 GB of memory available on your API Management host.
MultiExcerpt named prerequisites was not found -- Please check the page name and MultiExcerpt name used in the MultiExcerpt-Include macro
Overview on the Installation Process
To install the Scheer PAS API Management, you need to got through the following steps:
Download and Extract the Software API Management uses Docker to provide a simple setup which is easy to update and scalable if necessary.
Configure the Installation Settings Configure the installation settings in the Docker configuration file.
Prepare the Certificate You need a certificate to establish secure connections between clients and API Management, as well as between the different components of API Management itself. You can use an official certificate, or you can create a self-signed one. Refer to Certificates and Keystores for more information on certificate and keystore handling.
Configure the Authentication Service (Keycloak) Keycloak is an open source identity and access management solution and is used to create and manage the users of API Management and OAuth2 secured APIs. Before you can start API Management, you need to change some of the Keycloak settings in the Docker configuration file.
Start All Services To start API Management, start all Docker containers.
Login to API Management Finally you can log in to API Management and test the connections.