@konooc/strapi-plugin-passwordless
v4.0.15
Published
A plugin for Strapi Headless CMS that provides ability to sign-in/sign-up to an application by link had sent to email.
Downloads
6
Maintainers
Readme
A plugin for Strapi Headless CMS that provides ability to sign-in/sign-up to an application by link had sent to email. A plugin works together with Strapi User Permissions Plugin and extends it functionality. For working with emails a plugin use Strapi Email Plugin.
⏳ Installation
Install Strapi with this Quickstart command to create a Strapi project instantly:
- (Use yarn to install the Strapi project (recommended). Install yarn with these docs.)
# with yarn
yarn create strapi-app my-project --quickstart
# with npm/npx
npx create-strapi-app my-project --quickstart
Configure the
Strapi email
plugin ( official documentation )Add the
strapi-plugin-passwordless
plugin
yarn add strapi-plugin-passwordless@latest
# or
npm i -S strapi-plugin-passwordless@latest
- After successful installation you've to build a fresh package that includes plugin UI. To archive that simply use:
yarn build && yarn develop
# or
npm run build && npm run develop
- or just run Strapi in the development mode with
--watch-admin
option:
yarn develop --watch-admin
#or
npm run develop --watch-admin
The Passwordless plugin should appear in the Plugins section of Strapi sidebar after you run app again.
🔌 Usage
REST API
Email user with login link
POST /api/passwordless/send-link
{
"email": "[email protected]"
"username": "John Bull" // username for new user
"context": {
// context of authentification, optional parameter e.g. "currentUrl": "...my page..."
...
}
}
Send mail to user by username
POST /api/passwordless/send-link
{
"username": "John Bull"
}
Login with token
GET /api/passwordless/login?loginToken={tokenFromEmail}
Response:
{
"jwt": "...jwt auth token..."
"user": {
...strapi user...
},
"context": {
... context, provided to sendlink, e.g. currentPage, sessionId etc.
}
}
GraphQL API
WIP
🙌 Versions
[email protected]
- version for strapi v4[email protected]
- version for strapi v3 (dev branch)
🤝 Contributing
Feel free to fork and make a Pull Request to this plugin project. All the input is warmly welcome!
⭐️ Show your support
Give a star if this project helped you.
License
MIT License Copyright (c) Andrey Kucherenko.