Client installation

This topic explains how to install the Entrust Identity as a Service Authentication API client while restricting each client package to its intended package source.

Review the SDK licenses and open source software notices before you download or use an API client.

System requirements

The IDaaS Authentication API client has the following system requirements:

Java

• Java 8 or higher
• Maven, or Gradle 6.2 or higher

CSharp

• .NET Standard 2.0
• .NET Standard 2.1
• .NET Framework 4.8
• .NET 8.0
• NuGet 6.0 or higher

Python

Python 3.9 or higher

Install the Authentication API client

Select your programming language and follow its installation instructions.

Java

The IDaaS Authentication API Java client is available from the IDaaS Maven repository.

Maven

warning

Maven 3 cannot restrict a package group to one repository in the POM. Before you add the client, configure your organization's repository manager so that it resolves com.entrustdatacard only from the IDaaS repository. Repository order alone does not provide this protection.

Add the IDaaS repository:

<repositories>
  <repository>
    <id>idaas-releases</id>
    <url>https://entrust.us.trustedauth.com/packages/client/java</url>
  </repository>
</repositories>

Add the dependency:

<dependency>
  <groupId>com.entrustdatacard</groupId>
  <artifactId>intellitrust-auth-Authentication</artifactId>
  <version>5.47</version>
</dependency>

Gradle

Restrict the com.entrustdatacard group to the IDaaS repository:

repositories {
    exclusiveContent {
        forRepository {
            maven {
                name = "idaasReleases"
                url = uri("https://entrust.us.trustedauth.com/packages/client/java")
            }
        }
        filter {
            includeGroup("com.entrustdatacard")
        }
    }
    mavenCentral()
}

Add the dependency:

implementation 'com.entrustdatacard:intellitrust-auth-Authentication:5.47'

By downloading the IDaaS Authentication API Java client, you agree to the terms of the license. See the Java open source software notices for included open source software.

CSharp

The IDaaS Authentication API C# client is available from the IDaaS NuGet repository.

warning

Use the complete nuget.config configuration. The <clear /> element removes inherited package sources, and packageSourceMapping restricts the client package to the IDaaS repository. Do not add the IDaaS source without this mapping.

Add the package sources and map the IDaaS package to its repository in your nuget.config file:

<configuration>
  <packageSources>
    <clear />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
    <add key="idaas-releases" value="https://entrust.us.trustedauth.com/packages/client/csharp/index.json" />
  </packageSources>
  <packageSourceMapping>
    <packageSource key="nuget.org">
      <package pattern="*" />
    </packageSource>
    <packageSource key="idaas-releases">
      <package pattern="com.entrustdatacard.intellitrust.auth" />
    </packageSource>
  </packageSourceMapping>
</configuration>

Add the package reference to your project file:

<ItemGroup>
  <PackageReference Include="com.entrustdatacard.intellitrust.auth" Version="5.47.0" />
</ItemGroup>

Use the following namespaces:

using com.entrustdatacard.intellitrust.auth.api;
using com.entrustdatacard.intellitrust.auth.Client;
using com.entrustdatacard.intellitrust.auth.model;

By downloading the IDaaS Authentication API C# client, you agree to the terms of the license. See the C# open source software notices for included open source software.

Python

Choose a package manager. The pip command uses a versioned package URL and SHA-256 hash. The uv and Poetry configurations restrict the client package to the IDaaS repository and record artifact hashes in their lock files.

warning

For pip, use the complete package URL and SHA-256 hash. For uv and Poetry, keep the explicit package-source mapping and commit the lock file. Do not configure the IDaaS repository as an unscoped additional package index.

pip

Install the client from its versioned package URL:

python3 -m pip install --upgrade \
  "intellitrust-python-authentication @ https://entrust.us.trustedauth.com/packages/client/python/simple/intellitrust-python-authentication/intellitrust_python_authentication-5.47-py3-none-any.whl#sha256=e19b8dcea1b1596e562405ce145e4313be0f505d35c00e0aa162aceaad393377"

uv

Add the dependency and explicit source mapping to the project configuration:

[project]
dependencies = [
  "intellitrust-python-authentication==5.47",
]

[tool.uv.sources]
intellitrust-python-authentication = { index = "idaas" }

[[tool.uv.index]]
name = "idaas"
url = "https://entrust.us.trustedauth.com/packages/client/python/simple"
explicit = true

uv lock
uv sync

Verify that uv.lock records the wheel hash sha256:e19b8dcea1b1596e562405ce145e4313be0f505d35c00e0aa162aceaad393377, then commit the lock file.

Poetry

Add the IDaaS repository as an explicit source, then add the client from that source:

poetry source add --priority=explicit idaas \
  https://entrust.us.trustedauth.com/packages/client/python/simple
poetry add --source idaas \
  "intellitrust-python-authentication==5.47"

Verify that poetry.lock records the wheel hash sha256:e19b8dcea1b1596e562405ce145e4313be0f505d35c00e0aa162aceaad393377, then commit the lock file.

By downloading the IDaaS Authentication API Python client, you agree to the terms of the license. See the Python open source software notices for included open source software.