Chat now with support
Chat with Support

Identity Manager 9.2 - API Development Guide

Implementing your own APIs

To implement your own APIs, you can create API plug-ins.

The API Server loads all DLLs matching the *.CompositionApi.Server.PlugIn.dll naming scheme and deploys the API definitions contained in them.

To implement your own APIs, the following options are available:

Detailed information about this topic

Managing API plug-ins

With the help of API plug-ins, you can implement and use your own customized APIs and API projects.

Prerequisites:

  • You use a version management system (for example, Git).

  • You use an Integrated Development Environment (IDE).

Detailed information about this topic

Creating API plug-ins

To implement your own customized APIs and API projects, you can create API plug-ins.

To create an API plug-in

  1. Start your IDE (such as Visual Studio).

  2. Create a new .NET Framework 4.8 project with a name that complies with the format: <project name>.CompositionApi.Server.Plugin.

  3. Add references to the following DLL files from the One Identity Manager installation directory:

    • QBM.CompositionApi.Server.dll

    • VI.Base.dll

    • VI.DB.dll

  4. Create the API code.

  5. Compile the DLL file in your IDE.

  6. Copy the DLL file to the bin subdirectory of your IIS installation.

  7. Import the DLL file into your One Identity Manager database using the Software Loader and assign it to the Business API Server machine role. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.

  8. Copy the DLL file to the One Identity Manager install directory.

  9. Import the DLL file into your One Identity Manager database using the Software Loader and assign it to the Development and Testing machine role. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.

  10. Restart the API Server and ensure that the <project name>.CompositionApi.Server.Plugin file exists in the bin folder of the API Server install directory.

  11. Compile the appropriate TypeScript API client (see Compiling TypeScript API clients).

Editing API plug-ins

You can edit existing API plug-ins.

To edit an existing API plug-in

  1. Start your IDE (such as Visual Studio).

  2. Open an existing .NET Framework 4.8 project.

  3. Edit the API code.

  4. Compile the DLL file in your IDE.

  5. Copy the DLL file to the bin subdirectory of your IIS installation.

  6. Import the DLL file into your One Identity Manager database using the Software Loader. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.

  7. Copy the DLL file to the One Identity Manager install directory.

  8. Import the DLL file into your One Identity Manager database using the Software Loader. For more information on importing files using the Software Loader, see the One Identity Manager Operational Guide.

  9. Restart the API Server and ensure that the <project name>.CompositionApi.Server.Plugin file exists in the bin folder of the API Server install directory.

  10. Compile the appropriate TypeScript API client (see Compiling TypeScript API clients).

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating