Identity SDK Overview

Identity SDK lets you add Vatom Platform’s web3-ready Identity System to your application.

Vatom Platform provides ready-to-use standards-based Identity system with various authentication mechanisms. They include and not limited to:

• Passwordless
• Social Logins like Facebook, LinkedIn, Slack, etc.
• Enterprise SSO mechanisms via OIDC
• Web3 authentication for various chains and protocols e.g. WalletConnect

By using the IdentitySDK within your application you can bring web3 wallet technology (custodial wallets) to your application users while providing easy-to-use authentication interfaces.

Identity SDK is often used alongside Wallet SDK to provide additional control over user identity management. By default, Wallet SDK can manage user login when necessary without Identity SDK but this will not allow the app access to identity information and will not give it control over when login occurs.

Identity SDK Resources

If you are building the Identity SDK into a web app, you can download an NPM module containing the SDK:

• npmjs.com/package/@vatom/identity-sdk

Identity Host Whitelisting

When using the Identity SDK from a web app, the host URL must be whitelisted with Vatom identity servers. Contact Vatom to let us know what URLs you intend to use with the Identity SDK so that we can whitelist them for you. Send your request via email to support@vatom.com or visit the 'Submit a request' link at support.vatom.com. You may specify multiple URLs for your app including localhost ports for testing during development. For example, you may request all of the following URLs to be whitelisted even if you only need one of them for the version of the app running in production.

• http://localhost:3000
• https://example.com
• https://example.com/wallet

Identity SDK Client ID

When we confirm that your URLs have been whitelisted, we will give you a Client ID that identifies your app. You must provide this value as one of the parameters when initializing the Identity SDK.

A Tutorial

The next few pages walk through the steps for adding the Identity SDK to the sample app presented in the Wallet SDK tutorial. This adds an additional level of control over the login process and lets you integrate with your own systems that benefit from more information about an authenticated user.