@corbado/nodejs

Corbado Node.js library

The Corbado Node.js library provides convenient access to the Corbado API from applications running on Node.js.

Documentation

See the Corbado API Reference and Corbado API-only integration guide to understand the usage of Corbado API.

Requirements

Node 8 or higher.

Installation

npm install @corbado/nodejs --save

Usage

The package needs to be configured with your Corbado account's project ID and API secret. All the parameters can be obtained from Corbado developer panel.

project ID and API secret should be provided when initializing the Corbado module:

const Configuration = require('@corbado/nodejs/src/config/configuration');
const Corbado = require('@corbado/nodejs');

const config = new Configuration()
config.projectID = process.env.PROJECT_ID
config.apiSecret = process.env.API_SECRET

const corbado = new Corbado(config)

Services

Corbado provides several services, e.g. PasskeyService, SessionService, EmailLinkService. To access specific methods in, e.g. SessionService, you can call:

corbado.session.verify(sessionToken, clientInfo);

In order to

Utilities

Corbado package also provides several useful utility functions that can ease the development process, e.g.:

corbado.utils.getClientInfo(req);

helps to obtain relevant client information (UserAgent, RemoteAddress, etc.) object from an HttpRequest.