Authentication - Intergraph Smart Completions - Intergraph Smart Completions Update 17 - Customization & Programming - Hexagon

Intergraph Smart Completions Smart API Programmer's Getting Started Guide (5.3.17)

Language
English
Product
Intergraph Smart Completions
Search by Category
Customization & Programming
Smart Completions Version
5.3.17

The Smart API requires an OAuth2.0 Identity Provider (IdP). If your application uses Okta, Smart API Manager (SAM), or Azure AD as an IdP, you must use one of the following authorization methods:

You can also use the Smart Completions authentication server (using the client credentials) to authenticate users. This approach requires successful authentication to the Smart Completions application without any configuration, as follows:

  1. In the web-browser, go to the Smart Completions authentication client using the following URL format:

    https://<SMART_COMPLETIONS_HOSTNAME>/authenticate/index.html

  2. When prompted, enter your credentials.

  3. After successful authentication, click Copy Access Token.

  4. Pass the access token in the Authorization header as a Key-Value pair whenever you send an API request via a REST client.

  5. SHARED Tip You can use Power BI or Postman to try out sending an API request.

    Key

    Value

    Authorization

    Bearer <access_token>

By default, the access token is valid for one hour. If the token expires, repeat the above steps to generate a new access token.

To summarize, the client must include an access token (JWT) in the request authorization header to be authenticated for use with the Smart API. To get an access token, a client must have client credentials. How you prefer to authenticate depends on the hosting platform.