Page History
...
Chapter | Excerpt Name | Page of the Original | (Re-)Usage |
---|---|---|---|
Administration | data_export | ||
Administration | backup | ||
Administration | data_import | ||
Administration | restore | ||
Administration | keycloak_login |
| |
Policies | definition | ||
Policies | info_post_requests |
| |
Metrics | api_metrics | ||
Metrics | client_metrics | Metrics |
Info |
---|
Some API Management excerpts are saved within the documenation, see API Management excerpts managed directly in the documentation for an overview. |
...
hideControls | true |
---|---|
inverse | false,,false |
sparkName | Sparkline |
column | Group,Name |
sort | Group ⇧,Name ⇧ |
separator | Point (.) |
labels | ‚‚ |
default | ,, |
cell-width | ,, |
datepattern | dd M yy |
globalFilter | true |
id | 1550843185735_1800880779 |
worklog | 5|8|w d h m|w d h m |
isOR | AND |
order | 0,1,2 |
...
Multiexcerpt | ||
---|---|---|
| ||
API Management uses the Keycloak application to manage its users. Keycloak is an identity and access management software that can manage users for multiple applications. Data for each application is stored in so called "realms":
Thus, you need to have to separate admin accounts: one for Keycloak, and one for API Management. |
...
...
Multiexcerpt | ||
---|---|---|
| ||
If the configuration is invalid, an error message will be shown including further information about the error itself: |
...
...
Multiexcerpt | ||
---|---|---|
| ||
If the gateway configuration is correct, you will get a success message: |
...
...
retired
...
MultiExcerptName | private_api_testcode |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
schemes:
- https
security:
- X-API-Key: []
securityDefinitions:
X-API-Key:
description: Authenticate using pre-acquired API key
in: header
name: X-API-Key
type: apiKey |
Note |
---|
Note: Depending on the used policies, further entries in the YAML or JSON file may be necessary. |
...
retired
...
MultiExcerptName | public_api_testcode |
---|
Code Block | ||||||
---|---|---|---|---|---|---|
| ||||||
basePath: /yourOrganizationNameHere/yourApiNameHere/theApiVersionNumberHere
host: yourHostNameHere:portNumberHere |
Tip |
---|
You can copy the basePath and host in the APIs tab Endpoint or in the Client's tab APIs (use icon in column Endpoint). |
...
MultiExcerptName | api_registered_client |
---|
Note |
---|
Before the client is registered with the runtime gateway, it is not possible to make requests to backend APIs on behalf of that client. |
...
...
MultiExcerptName | swagger_ui |
---|
Tip |
---|
For more information about the functions of the Swagger UI, go to the Swagger homepage. |
...
...
MultiExcerptName | api_displayed_when_published |
---|
Info |
---|
This tab is only visible for published APIs. |
...
- API Settings (twice)
- Metrics
...
MultiExcerptName | api_displayed_when_registered |
---|
Info |
---|
This tab is only visible for registered clients. |
...
...
MultiExcerptName | api_link_to_policy_page |
---|
Tip |
---|
On page Policies you can find an overview of the standard policies supplied with Scheer PAS API Management. Page Assigning Policies shows how to configure a policy. |
...
...
MultiExcerptName | api_my_all_hint |
---|
Info |
---|
If you want to edit API Management elements, you need to access them via the My... menu items (see "My" API Management items). |
...
...
Multiexcerpt | ||
---|---|---|
| ||
Do not forget to click the Save button when you have finished. |
...
- API Settings (several times)
...
MultiExcerptName | api_version_number_note |
---|
Info |
---|
You can enter numbers and text in the Version field which allows the use of version numbers (e.g. 1.0, 2.1 ...) as well as version descriptions (e.g. Gold, Super etc.). |
...
...
Multiexcerpt | ||
---|---|---|
| ||
Click to add a new item to a list, click to show/hide the list of items. |
...
...
General Notes, Infos, Tips
...
note_read_confirmation_dialog
...
MultiExcerptName | note_read_confirmation_dialog |
---|
Note |
---|
Please read the confirmation dialog carefully. |
...
...
Multiexcerpt | ||
---|---|---|
| ||
Kibana is an open source analytics and visualization tool designed to work with Elasticsearch. With Kibana you can search, view, and interact with data stored in Elasticsearch indices. You can perform advanced data analysis and visualize your data in a variety of charts, tables, and maps. |
...
...
Organizations
...
MultiExcerptName | api_org_creation |
---|
Note |
---|
Only users with role Administrator can create new organizations. |
...
...
MultiExcerptName | locked_plans |
---|
Note |
---|
Once a plan is locked, it cannot be revised anymore. However, you can still create a new version of this plan. |
...
...
MultiExcerptName | api_behind_proxy |
---|
Note |
---|
Please disable the TLS check if you are using Scheer PAS 21.1, because this version is running behind a proxy server. |
...
...
MultiExcerptName | api_blacklist_whitelist |
---|
Note |
---|
An IP Blacklist policy overrides an IP Whitelist policy. |
...
...
MultiExcerptName | api_enable_option |
---|
Note |
---|
It is strongly recommended to enable this option. |
...
...
Multiexcerpt | ||
---|---|---|
| ||
The order of the policies is important. The order in which the policies appear in the user interface determines the order they will be applied at runtime. You can drag a policy up and down the list to change the order: |
...
...
MultiExcerptName | api_no_ipv6 |
---|
Note |
---|
The use of IPv6 is neither possible in the blacklist nor in the whitelist policy. |
...
- Policies (twice)
- IP Blacklist
- IP Whitelist
...
Multiexcerpt | ||
---|---|---|
| ||
API Management sets the CORS headers in the following order:
|
...
...
MultiExcerptName | proxy_x_real |
---|
Info |
---|
In the default setup the gateway runs behind a proxy. In the default scenario there is no need to add the header X-Real-IP in the custom header field IP Address HTTP Header. |
...
...
moved to academy_excerpts, delete after publication of version 21.2.2_api
...
MultiExcerptName | api_definition_details |
---|
Tip |
---|
Detailed information about the necessary settings in the definition file can be found on page API Settings. |
...
goto_chapter_apis
moved to academy_excerpts, delete after publication of version 21.2.2_api
...
MultiExcerptName | goto_chapter_apis |
---|
Tip |
---|
Go to APIs to learn more about the details of an API and its configuration options. |
...
goto_chapter_organizations
moved to academy_excerpts, delete after publication of version 21.2.2_api
...
MultiExcerptName | goto_chapter_organizations |
---|
Tip |
---|
Go to Organizations to learn more about the details of an organization and its configuration options. |
...
Step by Step Guides
...
step_by_step_policies
moved to academy_excerpts, delete after publication of version 21.2.2_api
...
MultiExcerptName | step_by_step_policies |
---|
Tip |
---|
On page Policies you can find an overview of all policies provided in API Management. Each policy and its configuration options are explained on dedicated pages. |
...
Multiexcerpt | ||
---|---|---|
| ||
|
...
...
MultiExcerptName | api_contracts_and_keys |
---|
API Contracts and API Keys
Only public APIs can be accessed by any consumer. The only way for a client to consume a private API is by using an API contract. An API contract is a link between a client and an API through a plan offered by that API.
API contracts can only be created between clients and published APIs which are offered through at least one plan. An API contract cannot be created between a client and a public API.
When an API contract is created, the system generates a unique API Key. This key is unique per client and the same for all contracts of this client. All requests made to the API by a client through the gateway must include this API Key. The API Key is used to create the runtime policy chain from the policies configured on the API, plan and client.
Info |
---|
You can forward the X-API-Key to the service using the API Key policy. However, you cannot define your own value for the X-API-Key, since the gateway uses the key to identify the clients. |
...
...
Multiexcerpt | ||
---|---|---|
| ||
APIs in API Management represent real back-end APIs (Application Programming Interfaces). An API is also known as a service, meaning anything that can be invoked remotely by some sort of client. API Management provides a way to turn unmanaged (raw) back-end APIs into managed APIs by attaching policies to them. Every managed API can be published as Public API or Private API or both:
In API Management, users can create new APIs manually or easily import them from the API Catalog. |
...
...
Multiexcerpt | ||
---|---|---|
| ||
The client is the consumer of the API:
|
...
...
Multiexcerpt | ||
---|---|---|
| ||
A contract relates a client to an API, using a plan. |
...
...
Terms & Definitions
...
Multiexcerpt | ||
---|---|---|
| ||
Almost everything in the API Management data model exists in the context of an organization:
|
...
...
Multiexcerpt | ||
---|---|---|
| ||
A plan is a set of policies that defines the level of service API Management provides for an API.
|
...
...
Multiexcerpt | ||
---|---|---|
| ||
Policies are at the lowest level of the data model, but they are the most important concept: A policy is a rule or a set of rules API Management uses to manage access to your APIs.
|
...
...
moved to page _general_excerpts - delete after publication of doc-version 21.2
...
MultiExcerptName | click_to_see_gif |
---|
Tip |
---|
Click the image to see an animated version. |
...
moved to page _general_excerpts - delete after publication of doc-version 21.2
...
MultiExcerptName | click_to_see_gif_above |
---|
Tip |
---|
Click the image above to see an animated version. |
API Management excerpts managed directly in the documentation
...
API Management Backup and Restore
...
API Management Backup and Restore
...
API Management Backup and Restore
...
API Management Backup and Restore
...
Managing Users and Permissions
...
- Managing Users and Permissions (twice)
...
...
...
...
- Caching Resources (twice)
...
...
...