Learn how to seamlessly integrate passkeys into your enterprise stack, covering website, customer support, auditing, and reporting systems.
Vincent
Created: October 28, 2024
Updated: October 30, 2024
Our mission is to make the Internet a safer place, and the new login standard passkeys provides a superior solution to achieve that. That's why we want to keep you up to date on the latest developments in the industry.
Integrating passkeys into your existing systems is a crucial step in adopting this new authentication method. It involves connecting passkey functionality to various components of your current infrastructure to ensure a seamless user experience and maintain operational efficiency. When third-party systems are involved, careful planning is essential to align different technologies and processes.
In this article, we will explore the key areas where integration is necessary, posing one important question for each:
For each area, we'll discuss the integration challenges and explain how Corbado can assist you in seamlessly incorporating passkeys into your existing landscape.
Let’s start by having a look at the customer-facing site of the integration: the website and frontend applications.
Recent Articles
♟️
Enterprise Guide: Passkeys for Existing Large-Scale Consumer Deployments
♟️
Enterprise Passkeys Guide: Part 1 - Initial Assessment and Planning
♟️
Enterprise Passkeys Guide: Part 2 - Stakeholder Engagement
♟️
Enterprise Passkeys Guide: Part 3 – Product, Design & Strategy Development
♟️
Enterprise Passkeys: Apple, Google & Microsoft's Offerings
Integrating passkeys into your website and frontend applications is a critical step. Passkeys offer a secure and user-friendly alternative to traditional authentication methods like passwords, but their implementation requires careful planning and execution on the frontend side – a large portion of the passkey implementation also takes place in the frontend as it needs to call APIs in the browser / operating system. To leverage this improved user experience, your frontend applications must support the following high level functionalities:
While the Web Authentication API (WebAuthn) provides the foundational methods like navigator.credentials.create()
for passkey creation and navigator.credentials.get()
for passkey retrieval, the real challenges lie in the
surrounding processes:
Implementing Multi-Step Authentication Flows: Unlike traditional password authentication, passkey creation and login require multiple backend API calls and careful handling of cryptographic data.
Providing Fallback Options: Not all users will have devices that support passkeys, or they may encounter issues during the authentication process. Your frontend must gracefully handle these scenarios by:
Ensuring Cross-Platform, Cross-Device and Cross-Browser Compatibility: Users access your services from a variety of devices and browsers, each with different levels of support for passkeys. Your frontend should account for:
Designing Intuitive User Interfaces: A successful passkey integration requires thoughtful UI/UX design to guide users through the new authentication processes:
Managing Passkey Lifecycle: Users may need to manage their passkeys over time, as they may add new devices or remove old ones. Your frontend should facilitate this by:
Implementing Security Measures: Security is of utmost importance in authentication systems. Your frontend must ensure that:
Overcoming Implementation Challenges: Implementing passkeys on the frontend can introduce unexpected challenges:
Integrating passkeys into your website and frontend applications is more than just implementing new API calls; it requires a holistic approach that considers user experience, technical challenges, security, and adaptability. By thoroughly understanding these needs and planning accordingly, you can provide a secure, seamless, and modern authentication experience that meets user expectations and supports your organization's goals.
Subscribe to our Passkeys Substack for the latest news, insights and strategies.
SubscribeCorbado focuses on connecting the frontend of large scale consumer deployments seamlessly, therefore a considerable amount of work has been done in order to create an optimized and reliable passkeys experience.
Corbado has the leading passkey intelligence engine that incorporates all available signals to optimize passkey experience. It is designed to optimize the user experience and increase login conversion by protecting users from confusing passkey-related situations. While protecting users, Passkey Intelligence also attempts to offer as many passkey login opportunities as possible, including cross-device logins (in case it is configured to do so). To make informed decisions, Passkey Intelligence takes into account the following input data:
Metadata about the user’s current device: Includes details about the operating system, browser, LocalStorage
availability, Bluetooth support, etc.
Existing passkeys: Evaluates whether passkeys are already stored, where they are saved (e.g., on a specific device, cloud synced), and if they are available for cross-device authentication.
Data about previous passkey operations: Tracks previous passkey operations, such as successful and failed login attempts in similar environments.
Optimization Goals:
Maximize successful passkey logins: Ensure as many successful passkey logins as possible after suggesting & starting a passkey login.
Minimize failed logins after allowing a passkey login: Avoid offering passkey logins where failure is likely, directly falling back to alternative authentication measures.
The system uses a dynamic decision-making process based on these inputs to decide when to offer a passkey login or fall back to other methods such as password and legacy 2FA. The data is continously updated based on new behaviours, specification and changes to browsers that can help improve authentication changes such as WebAuthn Client hints recently. It powers all products of Corbado including Corbado Complete and Corbado Connect.
Become part of our Passkeys Community for updates and support.
JoinCorbado provides ready-to-use UI components for passkey creation, login, and management. These components are designed to deliver a consistent and user-friendly experience. All three UI components are designed for easy integration into any frontend framework (React, Vue, Angular, etc.). Developers can also embed them using simple HTML and JavaScript without requiring any deep knowledge of the underlying code. Each UI component automatically adapts to the environment & device (responsive design), ensuring that passkeys are only offered when supported by the user’s browser and device. Corbado provides the following UI components.
CorbadoConnectLogin: The CorbadoConnectLogin UI component provides users with the ability to log in using their previously created passkeys. This component can automatically detect if a passkey is available for the user and prompts them to log in securely using passkeys.
First passkey login
After the first passkey login
Passkey as second factor
CorbadoConnectAppend: The CorbadoConnectAppend UI component allows users to append a new passkey to their account. This component is typically used when a user completes an initial login with another method (e.g., password) and is given the option to add a passkey for future logins.
Passkey Creation: Users can append a passkey to their account, improving future login security.
Conditional Rendering: The UI component decides whether to display based on factors such as device capabilities and user eligibility (e.g., gradual rollout decisions or passkey intelligence).
Customizable: You can adjust behaviors like skipping passkey creation or handling the completion of the passkey append process and customize the UI to match your design. Different wordings can be used based on existing examples within the industry.
CorbadoConnectPasskeyList: The CorbadoConnectPasskeyList UI component allows users to manage their existing passkeys. This includes listing all passkeys associated with their account and providing options to delete or append new passkeys.
Passkey Management: Users can view, append, or delete passkeys directly from their account management page. It also shows which passkey is synced in a cloud and if it can be used for cross-device authentication.
In summary, Corbado’s pre-built UI components provide a smooth, secure, and customizable user experience, whether it’s for creating, managing, or using passkeys for authentication. These components are designed with flexibility in mind, making it easy for developers to embed them into existing projects.
Corbado not only provides pre-built UI components for seamless passkey integration in the web but also ensures that these components remain up-to-date with the latest security standards and WebAuthn standard advancements.
Automatic Updates for UI Components
Regular Updates: The UI components provided by Corbado are continuously maintained and updated to ensure they are aligned with the evolving WebAuth standard and browser capabilities (e.g. WebAuthn Signal API). These updates are automatically applied to the UI components delivered via the Corbado CDN, reducing the burden on developers to manually maintain or upgrade the components in dedicated release processes.
Backward Compatibility: Corbado ensures that updates maintain backward compatibility, so your current integration remains unaffected while receiving new passkey features and improvements.
Dedicated SDKs for Native Apps
For native mobile applications on iOS and Android, Corbado provides SDKs tailored to different platforms, enabling smooth passkey integration into native environments. These SDKs offer the same passkey management features as the web components, optimized for mobile performance.
iOS SDK: The iOS SDK is designed to integrate seamlessly into native iOS apps. It supports passkey creation, management, and authentication, leveraging Apple’s secure ecosystem (such as Face ID and Touch ID) for a smooth user experience**.**
Android SDK: The Android SDK provides native Android support for passkey integration, making use of platform-specific features like fingerprint and face scanning authentication. This SDK ensures a secure and consistent experience across different Android devices.
Want to find out how many people can use passkeys?
View Adoption DataOne of the key features of Corbado’s UI components and SDKs is their built-in support for gradual rollout, a mechanism that enables enterprises to control which users can access passkey features. Rulesets are defined within the management panel and managed by Corbado for large enterprise deployments.
Whether using the pre-built UI components or the dedicated SDKs for mobile and backend integrations, all Corbado implementations are designed to work seamlessly with gradual rollout rulesets and integrate into the overall system.
Gradual Rollout Support for UI Components
The UI components for passkey login, append, and passkey management are all capable of evaluating gradual rollout rules to decide whether to display certain options to users. For example:
These decisions are made dynamically by calling Corbado’s Frontend API, which evaluates the rules and sends back the appropriate response for the user’s current session.
Gradual Rollout for SDKs
Corbado’s SDKs for Flutter, iOS, and Android are also fully integrated with the gradual rollout feature. This means that mobile applications can implement controlled rollouts of passkey features, ensuring that only a specific subset of users – based on criteria like platform, app version, or random selection – will have access to passkey functionality at a given time.
In addition, backend SDKs and API integrations are designed to respect the gradual rollout rulesets as well. Backend processes, such as deciding whether a user can append or delete passkeys via a native app or web app, can be controlled in the same way. This ensures consistency across frontend and backend operations.
Customizable Rollout Strategy
Gradual rollout gives enterprises the flexibility to roll out passkey features in stages:
This approach minimizes risk while ensuring a smooth transition to passkey authentication for both developers and end-users.
You already have an existing authentication system that needs to be updated or connected to the new passkey solution. Let’s see what implications that has.
Integrating passkeys into your existing authentication and Multi-Factor Authentication (MFA) systems is a critical step that requires careful consideration. It's not just about adding a new authentication method, it's about ensuring that passkeys seamlessly integrate with your current infrastructure without disrupting user experience or compromising security – this is the reason we already have created and analyzed the MFA roadmap earlier. Here are the key aspects to understand:
One of the fundamental requirements for integrating passkeys is having control over the frontend of your application including the authentication part. This control is crucial for several reasons:
If you're unsure about this step, feel free to contact us so we can determine together if we can assist you in deploying passkeys. If you prefer to retain control over your frontends and not use Corbado UI Components, we can expose the API directly.
Before integrating passkeys, you need to determine how they will fit into your authentication flows. There are a lot of ways to integrate passkeys but there are two fundamental approaches:
Passkeys as a Self-Contained MFA or Login Method (replacing Password + SMS OTP):
Passkeys as a Second Factor after Password-Login (replacing SMS OTP):
Depending on the approach, different parts need to be adjusted within your existing implementation. Also keep in mind that even between those two fundamental approaches there are more passkey integration options that bring different results in quality and adoption.
Integrating passkeys into your authentication system necessitates careful planning of your backend infrastructure, particularly concerning your database schema and the choice of a WebAuthn server library. This integration impacts how you store and manage user credentials, handle authentication processes, and maintain security and compliance.
Storing Passkey Credentials
Credential Data: Implementing passkeys requires securely storing users' public keys, credential IDs, and other associated metadata. This data is essential for verifying authentication requests and managing user credentials.
Database Schema Design: Designing a matching database schema is crucial to handle the diverse data formats required by the WebAuthn standard, such as cryptographic keys, challenge responses, and attestation objects. This may involve extending your existing user tables or creating new tables dedicated to passkey information.
credential_id
, user_id
(as a foreign key), public_key
, attestation_type
, AAGUID, signature_count
, and timestamps for creation and last use.You can find more information regarding the database in our dedicated article around Passkeys & WebAuthn databases.
Passkey Intelligence Data (optional)
We already explained what Passkey Intelligence is regarding the frontend, but actually implementing it requires the information also to be stored in the database. Incorporating passkey intelligence into your authentication system enhances the user experience by optimizing when and how passkey authentication is offered. This involves collecting and analyzing data to make informed decisions about authentication flows.
This is especially important if you want to implement a system with high adoption and passkey usage rate, when you first query the user identifier and then automatically start a passkey authentication (Identifier-first approach: which we also call Automatic Passkey Login approach). To be sure when the passkey authentication should be started, additional information needs to be stored to determine passkey availability when a user logs in.
Collecting Authenticator Metadata:
LocalStorage
availability, and support for features like Bluetooth or biometric sensors.Tracking Passkey Usage and Behavior:
Optimization Goals:
Implementing Passkey Intelligence Engine:
Security and Compliance:
Infrastructure Adjustments
WebAuthn Server Integration: Integrate a WebAuthn server library into your backend to handle the generation and verification of WebAuthn challenges. Adjust your authentication logic to incorporate passkey authentication alongside or in place of existing methods.
Scalability and Performance: Passkey operations involve cryptographic computations and additional database interactions. Optimize backend processes to handle this load efficiently. Consider load balancing, caching strategies, and database indexing to improve performance.
Testing Across Environments: Conduct extensive testing across different devices, browsers, and operating systems to ensure compatibility and consistent user experiences. This includes handling various authenticator types and adapting to platform-specific behaviors.
Challenges with WebAuthn Server Library Implementations
By thoroughly planning your database schema – including considerations for passkey intelligence data – selecting an appropriate WebAuthn server library, and adjusting your infrastructure, you can successfully integrate passkeys into your authentication system. This integration will enhance security, provide a modern and user-friendly authentication experience, and maintain compliance with security standards and regulations.
Want to try passkeys yourself? Check our Passkeys Demo.
Try PasskeysWhen integrating passkeys into your existing authentication system, consider the following:
User Experience Design:
Fallback Mechanisms:
Cross-Platform Compatibility:
Security Enhancements:
Logging and Monitoring:
Scalability and Performance:
Development and Maintenance Effort:
By thoroughly considering these factors and leveraging expertise where needed, you can successfully integrate passkeys, providing a modern, secure authentication experience for your users.
Corbado specializes in seamlessly integrating passkeys into any existing authentication and MFA systems, regardless of their complexity or architecture. We focus on providing flexible solutions that adapt to your current infrastructure, ensuring a smooth transition to passkey authentication without disrupting your existing processes. Here's how Corbado can assist in this critical integration phase:
Integration with Any Authentication System
Customizable Handlers and Components
MFA Status Management
Maintaining Backend as the Primary Store
Streamlined Integration Process
Adaptable Solutions for Complex Scenarios
Ongoing Support and Updates
Overall Corbado can help you add passkeys to your existing authentication stack without having the pressure migrate and adjust your complete authentication stack.
Integrating customer support into the process of implementing passkeys is crucial because authentication and Multi-Factor Authentication (MFA) are critical components of user security and experience. As passkeys become a primary method of authentication, users may encounter issues that require assistance. Here's why and how customer support integration is essential:
Importance of Customer Support in Authentication
Functional Requirements of a Good Customer Support Solution
To effectively support users with passkey-related issues, a customer support solution should provide:
Detailed MFA Status and Passkey Information:
Passkey & MFA Management Capabilities:
Hierarchical Support Structure: Support does not only include phone support, but it should also be a complete strategy.
Level 0 - Self-Help Resources:
First Level - Customer Support Agents:
Second Level - Technical Support for Customer Support Systems:
Key Considerations for Implementation
Role-Based Access Control: Ensure that support agents have appropriate access levels, with sensitive actions like passkey revocation restricted to authorized personnel.
Data Privacy Compliance: Handle user data in accordance with privacy regulations, ensuring that sensitive information is protected during support interactions.
Training and Knowledge Management:
Integration with Support Tools:
Integrating customer support into the passkey authentication process is essential for providing users with the assistance they need while maintaining high security standards. By offering a structured support system that includes self-help resources, knowledgeable support agents, and technical escalation paths, you ensure that users can navigate passkey-related challenges effectively. This integration not only enhances the user experience but also reinforces the security and reliability of your authentication system.
Corbado is dedicated to empowering your customer support teams at every level to ensure a seamless and secure passkey authentication experience for your users:
Level 0 - Self-Help Resources
Comprehensive Documentation and FAQs: Drawing from our extensive operational experience, Corbado provides detailed, user-friendly guides, FAQs, and tutorials tailored to your current implementation. These resources help users understand how to set up and manage passkeys effectively, reducing the need for direct support.
Interactive Troubleshooting Tools: We offer interactive tools like the passkey-debugger.io that assist users in resolving common passkey-related issues independently. These tools enhance the self-service capabilities of your platform, improving user satisfaction.
First Level - Customer Support Agents
Tailored Support Documentation: Corbado supplies in-depth documentation specifically designed for your customer support agents. This includes procedures for assisting users with passkey setup, resetting MFA, and troubleshooting login difficulties, ensuring consistent and accurate support.
Training and Knowledge Transfer: We provide comprehensive training programs for your support staff, equipping them with the knowledge and skills needed to handle passkey-related inquiries effectively. Our training covers common issues, resolution procedures, and best practices in passkey authentication.
Second Level - Technical Support
Seamless Integration with Existing Support Systems
Backend API Integration: Corbado's solutions are designed for seamless integration into your existing customer support systems via our backend APIs. This allows you to embed passkey management functions directly into your tools, displaying information consistently with our CorbadoPasskeyList format. Support agents can access all necessary passkey data within their familiar interfaces, enhancing efficiency.
Role-Based Access Control: Our platform incorporates robust role-based access control mechanisms. We ensure that only authorized support personnel have access to sensitive passkey information and functionalities, such as passkey revocation and MFA modifications, maintaining compliance with your security policies.
Ongoing Support and Training
Training Across All Support Levels: Corbado is committed to providing training and resources for all levels of your support hierarchy. From customer-facing agents to technical support teams, we offer continuous education to keep your staff updated on the latest developments in passkey technology and security best practices.
Knowledge Base Maintenance: We assist in maintaining and updating your internal knowledge bases and self-help resources, ensuring that both your users and support teams have access to the most current information.
By partnering with Corbado, you not only provide top-tier support for your users but also reinforce the security and reliability of your authentication system. Our solutions help build user trust and confidence in your platform's security measures, encouraging widespread adoption of passkeys and adherence to best practices.
Maintaining Integrating passkeys into your authentication system significantly enhances security by leveraging strong cryptographic methods and reducing reliance on traditional passwords. However, the introduction of passkeys also necessitates a thorough integration with your existing security, logging, and audit systems to maintain a robust security posture. This integration is essential for several reasons:
Real-Time Monitoring of Authentication Activities
Integration with Security Infrastructure
Compliance and Regulatory Requirements
By thoroughly integrating passkey authentication events into your security, logging, and audit systems, you enhance your organization's ability to detect and respond to threats, maintain compliance, and uphold a strong security posture.
Corbado offers comprehensive solutions to enhance your security, logging, and audit systems when integrating passkeys into your authentication infrastructure.
Real-Time Monitoring of Authentication Activities
Integration with Security Infrastructure
Compliance and Regulatory Requirements
Expert Support and Collaboration
By integrating Corbado's advanced security features, you ensure that your passkey authentication system not only enhances user experience but also strengthens your overall security infrastructure. Our solutions provide the tools and support necessary to maintain a secure, compliant, and efficient authentication environment.
Integrating reporting and analytics into your passkey implementation is essential for monitoring performance, understanding user behavior, and making strategic decisions. Key Performance Indicators (KPIs) play a crucial role in assessing the effectiveness of passkey adoption and usage within your system. Depending on which part of the system you are focusing on, different KPIs are important:
By combining the Passkey Adoption Rate and Passkey Login Rate, you can estimate the total number of saved SMS messages or other traditional authentication methods over a period of 12 to 36 months. This calculation acknowledges that the uptake of passkeys across your entire user base takes time, and long-term tracking provides a clearer picture of the overall impact on your authentication system.
Monitoring these KPIs helps you:
Use data-driven insights to guide future investments in authentication technologies and user education initiatives.
Corbado provides robust tools and features to help you monitor, analyze, and optimize the performance of your passkey implementation:
A/B Testing Support: Corbado is equipped to facilitate A/B tests of different versions of your authentication processes. All relevant information can be segmented based on these tests, allowing you to compare the effectiveness of various approaches and implement the most successful strategies.
Data Export for BI and Data Warehouses: All collected data can be exported for use in your Business Intelligence tools or data warehouses/lakes. This integration ensures that passkey analytics can be combined with other business data for comprehensive analysis and reporting.
Custom Reports for Enterprise Deployments: For larger organizations with specific reporting needs, Corbado offers custom report generation. These reports can be tailored to focus on the KPIs and metrics that are most important to your enterprise, providing deeper insights into your passkey implementation's performance.
By leveraging Corbado's analytics and reporting capabilities, you can continuously monitor and improve your passkey system, ensuring it delivers maximum security benefits while providing a seamless user experience.
Integrating passkeys into your existing systems is a multifaceted process that requires careful planning. Let's revisit the key questions posed in the introduction and summarize how they can be addressed:
Website and Frontend Applications: By implementing passkeys thoughtfully in your frontend, you can provide a secure and seamless authentication experience. This involves using Passkey Intelligence to optimize when and how passkey prompts are presented, employing pre-built UI components for ease of integration, and ensuring cross-platform compatibility through automatic updates and native SDKs. Gradual rollout minimizes risks.
Authentication and MFA Systems: Successful integration requires control over the frontend, deciding on the appropriate implementation approach (whether as a standalone login method or a second factor), and adjusting your database schema and infrastructure to handle passkey data securely. By selecting suitable WebAuthn server libraries and considering factors like scalability and performance, you can seamlessly incorporate passkeys without overhauling your entire authentication stack.
Customer Support Systems: Integrating customer support involves providing self-help resources, training support agents, and offering advanced tools for technical support teams. By supplying comprehensive documentation, interactive troubleshooting tools, and a secure management panel, you empower your support teams to assist users effectively, fostering trust and encouraging passkey adoption.
Security, Logging, and Audit Systems: Enhancing security involves real-time monitoring of authentication activities, integrating passkey events into your security infrastructure, and ensuring compliance with regulatory requirements. Customizable event streaming, SIEM compatibility, and robust logging practices enable prompt threat detection and incident response, maintaining a strong security posture.
Reporting, Business Intelligence, and Data Warehouses: By calculating key performance indicators like Passkey Adoption Rate and Passkey Login Rate, you gain valuable insights into user behavior and system performance. Corbado's tools facilitate detailed KPI reporting, funnel analytics, A/B testing, and data export capabilities, allowing you to optimize the authentication flow and make data-driven strategic decisions.
By addressing these critical integration points, you ensure that the introduction of passkeys not only strengthens your security but also enhances user experience without disrupting operational efficiency. Corbado specializes in facilitating this complex integration process. Our comprehensive solutions are tailored to meet your organization's specific needs, making the adoption of passkeys a manageable and efficient endeavor. With Corbado's expertise and support, integrating passkeys into your large-scale consumer deployment becomes a streamlined process. We help you navigate technical challenges, optimize user adoption, and fully leverage the enhanced security and convenience that passkeys offer.
Table of Contents
Enjoyed this read?
🤝 Join our Passkeys Community
Share passkeys implementation tips and get support to free the world from passwords.
🚀 Subscribe to Substack
Get the latest news, strategies, and insights about passkeys sent straight to your inbox.
We provide UI components, SDKs and guides to help you add passkeys to your app in <1 hour
Start for free
Recent Articles
Enterprise Guide: Passkeys for Existing Large-Scale Consumer Deployments
Vincent - September 26, 2024
Why Passkey Implementation is 100x Harder Than You Think – Misconceptions, Pitfalls and Unknown Unknowns
Vincent - April 27, 2024
Enterprise Passkeys Guide: Part 3 – Product, Design & Strategy Development
Vincent - October 16, 2024