{"id":26642,"library":"webledger-auth-plugin","title":"Webledger Auth Plugin","description":"An authentication plugin for AdonisJS 5 that integrates with the Webledger auth service. Current version is 2.0.7, with no active release cadence. It provides a simple login plugin that extends the AdonisJS authentication system. Differentiates by being purpose-built for the Webledger ecosystem, offering easy configuration via `node ace configure`. Requires AdonisJS core 5.7.6 or higher.","status":"active","version":"2.0.7","language":"javascript","source_language":"en","source_url":"https://github.com/divamtech/webledger-auth-plugin","tags":["javascript","adonisjs","adonis","typescript"],"install":[{"cmd":"npm install webledger-auth-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add webledger-auth-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add webledger-auth-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for AdonisJS framework core functionality.","package":"@adonisjs/core","optional":false}],"imports":[{"note":"Default export, not named.","wrong":"import { WebledgerAuthPlugin } from 'webledger-auth-plugin'","symbol":"WebledgerAuthPlugin","correct":"import WebledgerAuthPlugin from 'webledger-auth-plugin'"},{"note":"Config file is exported from a separate path 'webledger-auth-plugin/config'.","wrong":"import { webledgerAuthConfig } from 'webledger-auth-plugin'","symbol":"webledgerAuthConfig","correct":"import webledgerAuthConfig from 'webledger-auth-plugin/config'"},{"note":"Routes are exported from 'webledger-auth-plugin/routes' as default.","wrong":"import { Routes } from 'webledger-auth-plugin'","symbol":"webledgerAuthRoutes","correct":"import webledgerAuthRoutes from 'webledger-auth-plugin/routes'"}],"quickstart":{"code":"import WebledgerAuthPlugin from 'webledger-auth-plugin';\n// In your start/app.js:\nconst providers = [\n  WebledgerAuthPlugin\n];\n// Then configure via node ace configure webledger-auth-plugin\n// Add config to config/auth.js:\nconst webledgerConfig = {\n  secret: process.env.WEBLEDGER_SECRET ?? '',\n  service: 'webledger'\n};","lang":"typescript","description":"Shows how to import and configure the plugin in AdonisJS 5."},"warnings":[{"fix":"Ensure your project uses @adonisjs/core ^5.7.6.","message":"Plugin requires AdonisJS 5.x only; not compatible with AdonisJS 4 or 6.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Run `node ace configure webledger-auth-plugin` in your project root.","message":"The plugin must be configured using `node ace configure` before use; manual configuration may cause errors.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Set WEBLEDGER_SECRET in your .env file.","message":"Missing environment variable WEBLEDGER_SECRET can cause authentication failures.","severity":"gotcha","affected_versions":"all versions"}],"env_vars":null,"search_vec":"'2.0.7':20 '5':9 '5.7.6':58 'ace':53 'activ':23 'adoni':63 'adonisj':8,35,56,62 'auth':2,15 'authent':5,36 'built':43 'cadenc':25 'configur':50,54 'core':57 'current':17 'differenti':38 'easi':49 'ecosystem':47 'extend':33 'higher':60 'integr':11 'javascript':61 'login':30 'node':52 'offer':48 'plugin':3,6,31 'provid':27 'purpos':42 'purpose-built':41 'releas':24 'requir':55 'servic':16 'simpl':29 'system':37 'typescript':64 'version':18 'via':51 'webledg':1,14,46","created_at":"2026-05-01T13:51:02.331885+00:00","updated_at":"2026-05-01T13:51:02.331885+00:00","problems":[{"fix":"Run `npm install webledger-auth-plugin` or `npm link webledger-auth-plugin`.","cause":"Plugin not installed or not linked correctly.","error":"Cannot find module 'webledger-auth-plugin'"},{"fix":"Ensure @adonisjs/ace is installed and run `node ace configure` from the project root.","cause":"AdonisJS ace is not available or incorrect version.","error":"Cannot find ace command 'configure'"},{"fix":"Use import path `webledger-auth-plugin/config` without extension.","cause":"The config file is not found because it's not exported correctly.","error":"Failed to load webledger-auth-plugin/config"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/divamtech/webledger-auth-plugin","docs":null,"changelog":null,"pypi":null,"npm":"https://www.npmjs.com/package/webledger-auth-plugin","openapi_spec":null,"status_page":null,"smithery":null,"categories":["auth-security","web-framework"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-05-01","next_check":"2026-07-30","install_tag":null}}