Gecko.NCore.Client 12.0.1

dotnet add package Gecko.NCore.Client --version 12.0.1
                    
NuGet\Install-Package Gecko.NCore.Client -Version 12.0.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Gecko.NCore.Client" Version="12.0.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Gecko.NCore.Client" Version="12.0.1" />
                    
Directory.Packages.props
<PackageReference Include="Gecko.NCore.Client" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Gecko.NCore.Client --version 12.0.1
                    
#r "nuget: Gecko.NCore.Client, 12.0.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Gecko.NCore.Client@12.0.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Gecko.NCore.Client&version=12.0.1
                    
Install as a Cake Addin
#tool nuget:?package=Gecko.NCore.Client&version=12.0.1
                    
Install as a Cake Tool

About

Gecko.NCore.Client is a NuGet package for .NET based development with the Elements® Integration Services (EIS) APIs.

How it works

The NCore.Client is used to develop so-called EIS integrations. These are applications (apis/services/frontends) used to integrate Elements with domain- and/or customer-specific applications, e.g. to update Elements with archive-worthy data. EIS is based on the WCF framework and SOAP protocols.

It is intended to be a helpful tool for integrating parties to more easily perform the functions that the EIS offers. It provides LINQ support and strongly typing to the underlying object model.

NCore.Client provides these main APIs (services):

  • ObjectModelService defines models for CRUD operations, as well as endpoints for running both predefined and ad hoc queries.
  • FunctionService defines a set of specific functions in the caseworker, archiving and meeting domain.
  • DocumentService defines operations for checking in and out documents, and to upload or download documents.
  • MetadataService defines operations for retrieving metadata associated with specific object types and keys.

Token-based authentication

Authentication is handled via Elements.Authentication.Client. Use scope eis in EisAuthenticationOptions.Scopes.

There are two usage modes:

Full EIS context (Gecko.NCore.Client)

Use IEisContextFactory.

services.AddEisContext(new EisContextOptions
{
	BaseAddress = "https://ncore.example.com",
	ExternalSystemName = "MySystem",
	Authentication = new EisAuthenticationOptions
	{
		ClientId = "some-eis-client",
		AuthorityUrl = "https://authority.example.com",
		Scopes = ["eis"]
	},
	ObjectModel = new AdapterRegistration<IAsyncObjectModelAdapter>(
		EisServiceAddresses.ObjectModelV3No,
		(identity, settings) => new AsyncObjectModelAdapterV3No(identity, settings)),
	Functions = new AdapterRegistration<IAsyncFunctionsAdapter>(
		EisServiceAddresses.FunctionsV2,
		(identity, settings) => new AsyncFunctionsAdapter(identity, settings)),
	Documents = new AdapterRegistration<IAsyncDocumentsAdapter>(
		EisServiceAddresses.DocumentsV3,
		(identity, settings) => new AsyncDocumentsAdapter(identity, settings))
});

ObjectModel, Functions, Documents, and Metadata registrations are all optional and can be set on-demand. Register only what your integration uses.

public class MyService(IEisContextFactory factory)
{
	public async Task RunAsClientAsync()
	{
		var context = factory.Create();
		var persons = await context.Query<Person>().ToListAsync();
	}

	public async Task RunOnBehalfOfUserAsync()
	{
		var context = factory.CreateAsUser("alice");
		var persons = await context.Query<Person>().ToListAsync();
	}
}

Flow notes:

  • Client credentials flow: Use this for service-to-service access. The client/app authenticates as itself and gets a token representing the application, not a user. The identity client must allow client_credentials.
  • On-behalf-of-user flow: Use this when a trusted client / app needs a token for a specific existing user. The client / app authenticates itself and sends a signed user assertion with the target user’s sub (subject id). If that user exists, the server issues a token for that user. The identity client must allow urn:ietf:params:oauth:grant-type:jwt-bearer.

Individual WCF proxy (e.g. Gecko.NCore.Client.Claims.V1)

services.AddClaimServiceClient(new EisClientOptions
{
	BaseAddress = "https://ncore.example.com",
	RelativeServiceAddress = EisServiceAddresses.ClaimV1,
	Authentication = new EisAuthenticationOptions
	{
		ClientId = "some-eis-client",
		AuthorityUrl = "https://authority.example.com",
		Scopes = ["eis"]
	}
});
public class ClaimSyncService(IEisClientFactory<ClaimServiceClient> factory)
{
	public void RunAsClient()
	{
		using var client = factory.Create();
		// Use client here
	}

	public void RunOnBehalfOfUser()
	{
		using var client = factory.CreateAsUser("alice");
		// Use client here
	}
}

All service clients use the shared EisClientOptions configuration object. The RelativeServiceAddress property specifies the relative service endpoint path and can be set explicitly or will default to the appropriate value for the service being registered. Available service addresses are defined in the EisServiceAddresses constants.

IEisClientFactory<TClient> is the shared factory contract for the token-authenticated WCF proxies. It exposes:

  • Create(string tenantId = null, string baseAddress = null)
  • CreateAsUser(string username, string tenantId = null, string baseAddress = null)

identityserver client setup example that uses service-user SVC_INT (client credentials)

"some-eis-client": {
  "Enabled": true,
  "ClientName": "some-eis-client",
  "ClientSecrets": [
	{
	  "Type": "JsonWebKey",
	  "Value": "{...}",
	  "Description": "",
	  "Expiration": ""
	}
  ],
  "Claims": [
	{
	  "Type": "sub",
	  "Value": "SVC_INT"
	}
  ],
  "AllowedGrantTypes": [
	"client_credentials"
  ],
  "AllowedScopes": [
	"eis"
  ],
  "AllowOfflineAccess": false,
  "RequireClientSecret": true
}
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on Gecko.NCore.Client:

Package Downloads
Gecko.NCore.Client.ObjectModel.V3.No

For authentication setup and usage, see the package page on [NuGet.org](https://www.nuget.org/packages/Gecko.NCore.Client)

Gecko.NCore.Client.Documents.V3

For authentication setup and usage, see the package page on [NuGet.org](https://www.nuget.org/packages/Gecko.NCore.Client)

Gecko.NCore.Client.ObjectModel.V3.En

For authentication setup and usage, see the package page on [NuGet.org](https://www.nuget.org/packages/Gecko.NCore.Client)

Gecko.NCore.Client.Documents.V2

For authentication setup and usage, see the package page on [NuGet.org](https://www.nuget.org/packages/Gecko.NCore.Client)

Gecko.NCore.Client.Functions.V2

For authentication setup and usage, see the package page on [NuGet.org](https://www.nuget.org/packages/Gecko.NCore.Client)

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
12.0.1 2,200 10/16/2026
12.0.1-beta.1 83 10/16/2026
12.0.0 271 10/9/2026
12.0.0-beta.5 109 10/2/2026
12.0.0-beta.4 96 8/26/2026
12.0.0-beta.3 80 8/26/2026
12.0.0-beta.2 89 8/26/2026
12.0.0-beta.1 86 8/25/2026
11.0.0 10,452 8/7/2026
10.6.2 1,611 7/6/2026
10.6.1 1,238 6/19/2026
10.6.0 138 6/19/2026
10.5.0 4,338 6/19/2026
10.4.0 272 6/19/2026
10.3.4 1,241 6/19/2026
10.3.3 311 6/19/2026
10.3.2 187 6/19/2026
10.3.1 2,674 6/19/2026
10.3.1-beta-1 353 6/19/2026
10.3.0 702 6/19/2026
Loading failed

# Gecko.NCore.Client
This is a .NET library with basic functionality for integrating with
Element Integration Services (EIS).

## `12.0.1`
- Bundle the authentication client assembly in Gecko.NCore.Client and remove its package-feed dependency.

## `12.0.0`
- Remove .NET 8 support from all Gecko.NCore.Client projects; packages now target .NET 10.0 only.
- Add token-based authentication support; for setup and usage examples see README.

## `11.0.0`
- Migrate packable Gecko.NCore.Client projects to multi-target net8.0 and net10.0.
- Remove legacy net48/netstandard compatibility branches from shared runtime code.
- Remove obsolete `ClientSettings.EndpointName` property (only supported on .NET4.8); service client configuration now relies solely on `Address`.

## `10.6.0`
- Add .NET 10.0 support

## `10.4.0`
PBI #
- Improve service client binding creation based on endpoint address for netstandard2.0 package version

## `10.3.4`
PBI #563823
- Add property Vedtak and Behandling to UtvalgSakBehandling

## `10.3.2`
PBI #560946
- Interface AsyncDataObjectQueryProvider : IAsyncDataObjectQueryProvider, for easier mocking and stubbing.

## `10.3.1`
PBI #515804
- Update nuget packages, get rid of vulnerable transitive dependencies.

## `10.3.0`
PBI #430556
- End of support for ".NET4.5".
Consider migrating to supported versions ".Net 4.8" or ".NETStandard 2.0".

## `10.2.0`
Bug #443901
- (netstandard2.0) Use a custom implementation of `IHttpMessageHandlerFactory` registered as
service in asp.net core/.net application (it efficiently creates and uses
`HttpClient`'s to prevent potential TCP port exhaustion).
``` c#

// add the IHttpClientFactory and related services to the IServiceCollection
IServiceProvider.AddHttpClient();
...

// create client adapter
var clientSettings = new ClientSettings
{
Address = ...,
HttpMessageHandlerFactory = _httpMessageHandlerFactory // factory resolved from registered services
};
var adapter = new ...Adapter(EphorteContextIdentity, clientSettings);
```