Skip to main content
Skip table of contents

Client Settings

Clients must exist within the context of an organization. To view all clients your user is allowed to see, go to tab My Clients in the navigation bar. The clients are listed by organizations.

For detailed information about navigating and filtering the list refer to Working with the API Management.

You can also view the list of existing clients for an organization by navigating to the Clients tab of the organization's details page. Click on a client tile to open the client's details page. Use the details page to modify the configuration.

clients_tab.png

Basic Settings

The Overview tab displays the most important information about a client and also offers various functionalities:

UI Element

Name

Description

Basic Settings (available in all tabs)

(1)

Name / Description

  • Name: The name of the client is displayed in read-only mode.

  • Description: The description of the client is changeable. Click in the field and start writing if you want to alter the displayed text. Your changes are saved automatically.

This setting is valid for all versions of the client.

(2)

Version

In this field, the current version of the client is displayed. Use the drop-down to switch between versions.To create a new version, click New Version (refer to The Concepts of API Management for detailed information).

(3)

Delete

Click Delete to remove the client. You will need to confirm the deletion in a separate pop-up window. This setting is valid for all versions of the client.

(4)

Status

In this field, the current status of the client is displayed. Use the drop-down to change the status. A client can have the following states:

status_created.png
status_registered.png
status_retired.png

(5)

Navigation Bar

Use the navigation bar to access the various tabs of the client's details page (details of all tabs see Client Details below).

Overview Tab Settings (available only in tab Overview)

(6)

Contracts

Shows the number of contracts associated with this client. Click in the URL field to copy the displayed URL.

(7)

Attached Policies

In this section, the user can see at a glance which policies are attached to this client and in which order they will be executed.  You can click on the name of a policy. This will open tab Policies where you can adapt the policies of this client.

(8)

API Key

Displays the API Key for all contracts of this client version. An API Key is automatically created when you are using a private API. To copy the API Key, click Copy to clipboard.

(9)

Useful Information

The displayed labels show some additional information about the client. The labels are interactive: Click on an entry to switch to the corresponding tab.

  • Pending Approvals: Shows the number of open approval requests from this client. Clicking the label will open tab Contracts.

  • Active Contracts: Displays the number of active contracts of this client. Clicking the label will open tab Contracts.

Client Details

In the navigation bar of the details page, you will find several tabs where you can manage the various settings of the client.

Contracts

Use tab Contracts to display a list of all contracts between this client all APIs. The list includes all APIs that this client can use, and also the APIs for which this client is still waiting for approval (refer to Handling Approval Requests for details):

Policies

The Policies tab allows you to manage the policies that should be applied whenever an API invocation is made by the client. These policies are applied in addition to whatever policies are defined by the API itself. 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 (refer to Policies > Policy Chain for details).

client_tab_policies.png

Option

Icon

Description

Add

add_policy_icon.png

To add another policy to this client, click one of the Plus buttons.
You will be redirected to page Add Policy, where you can choose a policy and customize it (refer to Attaching Policies for details).

Reorder

drag_policy_icon.png

Drag the policy and drop it on the desired new place in the hierarchy.

Edit

edit_policy_icon.png

If you want to adapt an attached policy, click Edit to open the policy configuration.

Delete

delete_policy_icon.png

If you want to delete a policy from this client, click Delete

Refer to chapter Policies for an overview of the standard policies supplied with Scheer PAS API Management. Page Attaching Policies explains how to attach and configure a policy.

Metrics

Navigate to tab Metrics to display metric information about the client. Once a client has consumed an API, you can use the Metrics tab to view basic analytics information:

client_tab_metrics.png

Refer to Metrics for detailed information about the available options.

Change Log

Navigate to the Change Log tab if you want to see an overview of changes made for this client. All configuration changes made by API Management users associated with this client are listed here:

client_tab_changelog.png
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.