Importing NuGet packages for web services
Use the Software Loader to import NuGet packages for web services into the One Identity Manager database. The files are distributed via the automatic software update. The web service can then be used in scripts in the or the System Debugger.
For more information about importing files with the Software Loader, see the One Identity Manager Operational Guide. For more information about automatic software updates, see the One Identity Manager Installation Guide.
To import the NuGet packages
-
Create a zip file for importing with the Software Loader.
Make sure that the zip file does not contain a version number. Otherwise there may be problems with subsequent updates. The NuGet package itself may contain a version number.
Example:
NuGet package: <project name>1.0.0.nupkg
Zip file: <project name>.nupkg.zip
-
Create a NuGet directory on the workstation on which you start the Software Loader and save the zip file in this directory.
Example: C:\Temp\NuGet\<project name>.nupkg.zip
-
Start the Software Loader and import the zip file. During the process, note the following:
-
On the Select files page, select the base directory, in this case C:\Temp, so that the NuGet subdirectory is displayed in the file list.
-
Open the NuGet directory from the file list and select the zip file <project name>.nupkg.zip..
-
This displays a warning. The NuGet subdirectory is required for correct processing of the import so confirm the message with Yes.
-
On the Assign machine roles page, select the Server and Workstation machine roles.
Referencing NuGet packages for web services in scripts
Web services can be used in scripts in the or the System Debugger.
Reference the NuGet package for the web service in the scripts. Use #R Notation.
Syntax
#R Package
Example: Applying an Add method from a calculator web service
#If Not SCRIPTDEBUGGER Then
#R OneIMCalculator
#End If
Public Function OneIMCalculator_Add(a As Integer, b As Integer) As Integer
Dim sw = New OneIMCalculator.CalculatorSoapClient(OneIMCalculator.CalculatorSoapClient.EndpointConfiguration.CalculatorSoap)
Dim result = sw.Add(a, b)
Return result
End Function
NOTE: When compiling a script with references to NuGet packages, additional dependency files may be registered in One Identity Manager. This enables an automatic software update to start.
Referencing web service projects in the System Debugger
Use the System Debugger to created, edit, and test the scripts you require. In the System Debugger, to use the web service class, you must define dependencies between the web service and scripts.
IMPORTANT: If you create scripts in the System Debugger, reference the NuGet package for the web service in the scripts. Use #R Notation.
To add a web service project to the system library
-
In the System Debugger, create a new system library.
-
In Visual Studio, load the SystemLibrary.sln project solution.
-
In the project solution, add the web service as the project reference.
-
In the project solution editor, select the SystemLibrary project solution.
-
Select the File > Add > Existing Project menu item.
-
Open the web service Visual Studio project file.
Your web service project is added as an additional project to the SystemLibary project solution.
-
Create the dependencies between the web service and scripts.
-
In the project folder editor, in the SystemLibrary project folder, select the Scripts project.
-
Select the Project > Add Project Reference menu item.
-
Enable the option for your web service.
In the project solution editor, a reference to the web service project is added to the Scripts project under Dependencies > Projects. This make the web service class available in the scripts and you can implement and test the required functions.
One Identity Manager as SCIM 2.0 service provider
One Identity Manager provides an interface corresponding to the System for Cross-domain Identity Management (SCIM) 2.0. The interface enables the import and export of One Identity Manager objects by a SCIM client. For example, the interface can be used to:
-
Import identity, department, cost center, and location data from an HR system
-
Import user account and group data from a cloud system
-
Match custom target systems that have a SCIM V2.0 client
-
Provision information about identities through a standardized interface for further processing in third-party systems
The SCIM 2.0 service provider for One Identity Manager is provided as a plugin for the API Server and you can select it when you install the API Server. Further configuration of the SCIM plugin itself is not necessary. You can check in theAPI Server's Administration Portal if the SCIM plugin was installed and activated successfully. For more information on installing an API Server, see the One Identity Manager Installation Guide.
Detailed information about this topic
