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
<PackageReference Include="Gecko.NCore.Client" Version="12.0.1" />
<PackageVersion Include="Gecko.NCore.Client" Version="12.0.1" />
<PackageReference Include="Gecko.NCore.Client" />
paket add Gecko.NCore.Client --version 12.0.1
#r "nuget: Gecko.NCore.Client, 12.0.1"
#:package Gecko.NCore.Client@12.0.1
#addin nuget:?package=Gecko.NCore.Client&version=12.0.1
#tool nuget:?package=Gecko.NCore.Client&version=12.0.1
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 | Versions 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. |
-
net10.0
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- System.IdentityModel.Tokens.Jwt (>= 8.23.0)
- System.Security.Cryptography.Xml (>= 10.0.13)
- System.ServiceModel.Http (>= 10.0.652802)
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 |
# 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);
```