Okta VDC SDK for Node.js

Server-side SDK for verifying digital credentials with the Okta Verified Digital Credentials platform.

Installation

npm install @okta/vdc-sdk-node

Quick Start

import {
  OktaVdcSdk,
  CredentialRequestResponseMode,
  CredentialProtocol,
  CredentialFormat,
  CredentialType,
} from "@okta/vdc-sdk-node";

// 1. Initialize the SDK
const sdk = new OktaVdcSdk({
  clientId: process.env.OKTA_VDC_CLIENT_ID,
  clientSecret: process.env.OKTA_VDC_CLIENT_SECRET,
});

// 2. Create and initiate a credential request
const request = sdk.createCredentialRequest({
  responseMode: CredentialRequestResponseMode.DIRECT_POST,
  protocol: CredentialProtocol.OPENID4VP_SIGNED,
  dcqlQuery: {
    credentials: [
      {
        id: "age_verification",
        format: CredentialFormat.MDOC,
        meta: { doctype_value: CredentialType.MDL },
        claims: [
          { path: ["org.iso.18013.5.1", "age_over_21"], intent_to_retain: false },
        ],
      },
    ],
  },
});

const presentation = await request.initiate();

// 3. Verify response and retrieve claims
const request = await sdk.getCredentialRequestFromSessionId(sessionId);
const { status, claims } = await request.verifyResponseAndGetClaims();

License

Apache 2.0 - See LICENSE for details.