Smart Clients (Retired Help Topic)

Intergraph Smart API Manager Help Retired Topics

English (United States)

This topic has moved.

To see the updated version, click here then choose your Smart API Manager version. For Smart API Manager versions 2020 (4.0) and earlier, choose help version 4.0.

How do I choose a help version?

When you click the link above, a current version of the this topic opens in the Preview window. The Version drop-down at the top of the window shows which version you're looking at. To see a different version, select it from the drop-down:

If you click the Read the topic in context button at the bottom of the Preview window, you will open the topic in the help for the selected version.

SHARED Tip Anytime you are looking at the help, you can switch to the help for a different version using the drop-down at the top of the help window.

Smart Clients are software applications that consume one or more Smart APIs. Smart Clients can be Hexagon PPM software applications, third-party software applications, or custom software.

A Smart Client must request authorization to call one or more Smart APIs based on the identity of its users.

How Smart Clients authenticate with Smart API Manager

To call Smart APIs, a software application must be registered as a Smart Client with Smart API Manager. When you register a Smart Client, you must specify an authorization flow.

The authorization flow you select is determined largely by what type of application you are writing. For example, the Implicit flow works well for web client applications, but the Resource Owner flow might be required for legacy desktop applications.

At the end of registering your Smart Client, the following values are set:

  • Client ID

  • Secret (if required by the authorization flow)

The Smart Client software developer must write code to request an access token—which will be included with each call to a Smart API—to authorize access. Client ID and Secret (depending on the authorization flow) are required when requesting the access token. The source code will differ based on the type of client being developed, authorization flow specified, and so forth.

For more information regarding Smart Client development, click Dev Docs on the left panel.

Smart Client setup

There are two tasks required to initially set up Smart Clients:

  1. Register a new Smart Client

  2. Specify a web page for redirection after a user logs on or off

Smart Client administration

After a Smart Client is set up, administration tasks help you meet the ongoing access and security needs of your company. You can:

If you do not know which Smart Client you need to modify, start with Find a Smart Client.