Chat now with support
Chat with Support

Identity Manager 8.2.1 - API Development Guide

Basic principles of API development Examples and help – Software Development Kit API configuration Implementing your own APIs API Designer Quick start – Creating an API with the API Designer Working with the API Designer
Starting the API Designer Project types User interface Global settings Database objects Labeling changes Find and replace Multilingual captions Managing database queries Managing tabs Managing layouts Displaying the change history (command list) Bookmarks Compiling an API Managing versions (compilation branches) Testing an API Linking C# projects to the API Designer
API projects API methods ImxClient command line program

Compiling TypeScript API clients

After you create an API plugin, you need to compile a corresponding TypeScript API client.

To compile a TypeScript API client

  1. Open a command line prompt.

  2. Run the following command:

    imxclient compile-api -N -W /copyapi imx-api-ccc.tgz /packagename imx-api-ccc

    The dialog to select the database connection is opened.

  3. In the dialog, perform one of the following actions:

    • to use an existing connection to the One Identity Manager database, select it in the Select a database connection menu.

      - OR -

    • to create a new connection to the One Identity Manager database, click Add new connection and enter a new connection.

  4. Select the authentication method and, under Authentication method, enter the login data for the database.

  5. Click Log in.

  6. Import the imx-api-ccc npm package into your TypeScript application.

API Designer

The API Designer allows you to create, record, compile, and publish a REST API (Representational State Transfer Application Programming Interface) in the quickest way possible. This API is based on the OpenAPI Specification and the One Identity Manager database model.

The main benefits of API Designer include:

  • Offers easy and fast operation.

  • The finished API "understands" the One Identity Manager database model.

  • Modifications to the API are transparent.

  • Supports the principles of good API design.

  • OpenAPI support: APIs that you create using the API Designer are based on the OpenAPI specification standard. This allows you to make use of other tools, including:

    • Swagger: Use Swagger to create code, documentation, and test cases.
    • Postman: Use Postman to test the various methods of your API.

Quick start – Creating an API with the API Designer

NOTE: One Identity recommends using the API plugin (see Implementing your own APIs) to create and implement APIs rather than the API Designer.

The following provides a general list of the steps you must take to create an API in the API Designer:

  1. Start the API Designer.

  2. Create API files (in which you can define an API method, for example).

  3. Create an API project or edit an existing one (for example, supplied by One Identity) to take advantage of the features already available and customize it to your own needs.

  4. Configure the authentication for the API project (Single Sign-On, for example).

    NOTE: If you edit an existing API project supplied by One Identity, you will no longer be able to change the authentication.

  5. Assign the created API files to the API project.

  6. Test the API.

  7. Compile the API.

  8. Save the changes to the database.

Related topics

Working with the API Designer

This section provides you with general information on working with the API Designer.

For example, you will learn:

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating