14. Skip to content

14. System Components - Hardware Token/Capsule Server

This page describes the system components relevant to the Hardware Token/Capsule Server context. For the Smart-ID/Mobile-ID context, see SID/MID.

14.1 Shared Components

14.1.1 CDOC2 reference Java library

Implements client side functionality for CDOC2 system. Used by both the Hardware Token/Capsule Server and SID/MID contexts.

14.2 Hardware Token/Capsule Server Components

14.2.1 CDOC2 Capsule Server (CCS)

Stores encryption/decryption key material.

14.2.2 CDOC2 CLI user application

Command line utility to create/process CDOC2 files. Provides CLI interface to CDOC2 reference Java library.

14.3 Interfaces between system components

14.3.1 CDOC2 Capsule Server (CCS) interface

CCS interface provides the following endpoints:

  • /key-capsules/{transactionId} Get Server Capsule based on the transaction identifier. Used by recipient to request a Server Capsule.
  • /key-capsules Upload a Server Capsule to a CCS. Used by sender to upload Server Capsule to a CCS.

For full CCS OpenAPI specification, see API References.