Passquito

Fly with Passkey × AWS Cognito = Passquito!

A PoC on passkey authentication inspired by aws-samples/amazon-cognito-passwordless-auth.

Features:

• Rust × AWS Lambda → Snappy cold start!
• AWS Cognito Lambda triggers
• 💩 Ugly codebase

Getting started

Passquito consists of two packages:

• @codemonger-io/passquito-cdk-construct is a CDK construct which describes Passquito core resources on AWS.
• @codemonger-io/passquito-client-js is a JavaScript client library which facilitates the communication with Passquito core resources.

Steps

1. Add @codemonger-io/passquito-cdk-construct to your CDK project (replace 0.0.3-abc1234 with the version you want to install):

   npm install @codemonger-io/[email protected]

   Note that @codemonger-io/passquito-cdk-construct is only available from the GitHub npm registry for now. Please refer to its README for more details.

2. Add @codemonger-io/passquito-client-js to your web application (replace 0.0.2-abc1234 with the version you want to install):

   npm install @codemonger-io/[email protected]

   Note that @codemonger-io/passquito-client-js is only available from the GitHub npm registry for now. Please refer to its README for more details.

3. Include PassquitoCore in your CDK stack:

   import { Stack } from 'aws-cdk-lib';
   import type { Construct } from 'constructs';
   
   import { PassquitoCore } from '@codemonger-io/passquito-cdk-construct';
   
   export class CdkStack extends Stack {
       constructor(scope: Construct, id: string) {
           super(scope, id);
   
           const passquito = new PassquitoCore(this, 'Passquito');
       }
   }

4. Use @codemonger-io/passquito-client-js in your web application to communicate with Passquito core resources. Please refer to its README for how to use it.

Usage scenarios in a nutshell

Please refer to the README of @codemonger-io/passquito-client-js.

Interactions under the hood

Please refer to interactions-under-the-hood.md for how your app, Passquito, and AWS Cognito interact with each other.

License

MIT License

Except for the following materials licensed under CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0/):

• Passquito Logo by codemonger