To implement your own APIs, you can create API plugins.
The API Server loads all DLLs matching the *.CompositionApi.Server.PlugIn.dll naming scheme and deploys the API definitions contained therein.
To implement your own API
Create an API plugin (see Creating and editing API plugins).
Compile the appropriate TypeScript API client (see Compiling TypeScript API clients).
With the help of API plugins, you can implement and use your customized APIs.
Prerequisites:
You use a version management system (for example, Git).
You use an Integrated Development Environment (IDE).
To create an API plugin
Start your IDE (such as Visual Studio).
Create a new .NET Framework 4.8 project named CCC.CompositionApi.Server.Plugin.
Add references to the following DLL files from the One Identity Manager installation directory:
QBM.CompositionApi.Server.dll
VI.Base.dll
VI.DB.dll
Create the API code.
Compile the DLL file in your IDE.
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.
Restart the API Server and ensure that the CCC.CompositionApi.Server.Plugin.dll file is present.
To edit an existing API plugin
Start your IDE (such as Visual Studio).
Open the existing .NET Framework 4.8 project.
Edit the API code.
Compile the DLL file in your IDE.
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.
Restart the API Server and ensure that the CCC.CompositionApi.Server.Plugin.dll file is present.
After you create an API plugin, you need to compile a corresponding TypeScript API client.
To compile a TypeScript API client
Open a command line prompt.
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.
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.
Select the authentication method and, under Authentication method, enter the login data for the database.
Click Log in.
Import the imx-api-ccc npm package into your TypeScript application.
You can use the ImxClient command line tool to run different functions for managing the API Server and files on the command line.
© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center
