Skip to content

Commit 4955d90

Browse files
committed
temp
1 parent c89ddac commit 4955d90

25 files changed

+585
-1353
lines changed

docs/authentication/advanced/mfa.mdx

Lines changed: 0 additions & 75 deletions
This file was deleted.

docs/authentication/authentication.mdx

Lines changed: 129 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@ image: "images/docs-meta-cards/documentation-card.png"
55
description: "Authentication | Documentation - Web3Auth"
66
---
77

8+
import Tiles from "@theme/Tiles";
9+
810
**Web3Auth** offers a robust authentication system designed to bridge the gap between Web2 and Web3
911
identity, providing developers with powerful tools to implement secure, flexible, and user-friendly
1012
onboarding flows. By offering fine-grained control over login experiences and wallet integrations,
@@ -19,34 +21,113 @@ mechanisms, supporting both traditional (Web2) and decentralized (Web3) identity
1921
Web3Auth supports a wide range of authentication options, enabling developers to meet the needs of
2022
diverse user bases and platform requirements.
2123

22-
### Email or SMS Login
24+
### Native Email & SMS Login
2325

24-
Provides passwordless login via one-time passcodes (OTP) sent to the user’s
26+
Provides passwordless login via one-time passcodes (OTP)/ magic links sent to the user’s
2527
[email address](/authentication/basic-logins/email-passwordless) or
2628
[phone number](/authentication/basic-logins/sms-otp). This method is widely accessible and
2729
especially useful for onboarding users unfamiliar with Web3 or crypto wallets.
2830

2931
### External Wallets
3032

3133
Users can also authenticate using
32-
[third-party wallets](/authentication/basic-logins/external-wallets) such as MetaMask,
33-
WalletConnect, Phantom, and others. Developers can select which wallets to display via the Web3Auth
34-
Dashboard, providing tailored options based on user preference or regional relevance.
34+
[third-party wallets](/authentication/basic-logins/external-wallets) such as MetaMask, Phantom, and
35+
other WalletConnect supported wallets. Developers can select which wallets to display via the
36+
Web3Auth Dashboard, providing tailored options based on user preference or regional relevance.
3537

3638
### OAuth and Social Login
3739

3840
Web3Auth supports a variety of social identity providers, allowing users to authenticate using
3941
accounts they already trust and use daily. Supported providers include:
4042

41-
- [Google](/authentication/social-logins/google)
42-
- [Apple](/authentication/social-logins/oauth/#login-with-apple)
43-
- [Twitter (X)](/authentication/social-logins/oauth/#login-with-x)
44-
- [Facebook](/authentication/social-logins/facebook)
45-
- [Discord](/authentication/social-logins/discord)
46-
- [Twitch](/authentication/social-logins/twitch)
47-
- [GitHub](/authentication/social-logins/oauth/#login-with-github)
48-
- [Farcaster](/authentication/social-logins/oauth/#login-with-farcaster)
49-
- and [more](/authentication/social-logins/oauth).
43+
export const SocialLoginSetup = [
44+
{
45+
name: "",
46+
description: "",
47+
tiles: [
48+
{
49+
key: "google",
50+
title: "Google",
51+
icon: "logo-google.png",
52+
path: "/authentication/social-logins/google",
53+
},
54+
{
55+
key: "apple",
56+
title: "Apple",
57+
icon: "logo-apple.png",
58+
path: "/authentication/social-logins/oauth/#login-with-apple",
59+
},
60+
{
61+
key: "twitter",
62+
title: "Twitter (X)",
63+
icon: "logo-twitter.png",
64+
path: "/authentication/social-logins/oauth/#login-with-x",
65+
},
66+
{
67+
key: "facebook",
68+
title: "Facebook",
69+
icon: "logo-facebook.png",
70+
path: "/authentication/social-logins/facebook",
71+
},
72+
{
73+
key: "discord",
74+
title: "Discord",
75+
icon: "logo-discord.png",
76+
path: "/authentication/social-logins/discord",
77+
},
78+
{
79+
key: "twitch",
80+
title: "Twitch",
81+
icon: "logo-twitch.png",
82+
path: "/authentication/social-logins/twitch",
83+
},
84+
{
85+
key: "github",
86+
title: "GitHub",
87+
icon: "logo-github.png",
88+
path: "/authentication/social-logins/oauth/#login-with-github",
89+
},
90+
{
91+
key: "farcaster",
92+
title: "Farcaster",
93+
icon: "logo-farcaster.png",
94+
path: "/authentication/social-logins/oauth/#login-with-farcaster",
95+
},
96+
{
97+
key: "reddit",
98+
title: "Reddit",
99+
icon: "logo-reddit.png",
100+
path: "/authentication/social-logins/oauth/#login-with-reddit",
101+
},
102+
{
103+
key: "kakao",
104+
title: "Kakao",
105+
icon: "logo-kakao.png",
106+
path: "/authentication/social-logins/oauth/#login-with-kakao",
107+
},
108+
{
109+
key: "linkedin",
110+
title: "LinkedIn",
111+
icon: "logo-linkedin.png",
112+
path: "/authentication/social-logins/oauth/#login-with-linkedin",
113+
},
114+
{
115+
key: "line",
116+
title: "Line",
117+
icon: "logo-line.png",
118+
path: "/authentication/social-logins/oauth/#login-with-line",
119+
},
120+
{
121+
key: "wechat",
122+
title: "WeChat",
123+
icon: "logo-wechat.png",
124+
path: "/authentication/social-logins/oauth/#login-with-wechat",
125+
},
126+
],
127+
},
128+
];
129+
130+
<Tiles tileGroups={SocialLoginSetup} />
50131

51132
Social login simplifies onboarding by reducing friction and improving usability—particularly in
52133
consumer-facing applications.
@@ -56,10 +137,40 @@ consumer-facing applications.
56137
Web3Auth allows integration with any existing JWT-based authentication system. This includes OpenID
57138
Connect (OIDC) and OAuth 2.0 compliant identity providers such as:
58139

59-
- [Auth0](/authentication/custom-connections/auth0)
60-
- [Firebase Authentication](/authentication/custom-connections/firebase)
61-
- [AWS Cognito](/authentication/custom-connections/aws-cognito)
62-
- [Custom JWT providers](/authentication/custom-connections/custom-jwt)
140+
export const JWTLoginSetup = [
141+
{
142+
name: "",
143+
description: "",
144+
tiles: [
145+
{
146+
key: "auth0",
147+
title: "Auth0",
148+
icon: "logo-auth0.png",
149+
path: "/authentication/custom-connections/auth0",
150+
},
151+
{
152+
key: "firebase",
153+
title: "Firebase",
154+
icon: "logo-firebase.png",
155+
path: "/authentication/custom-connections/firebase",
156+
},
157+
{
158+
key: "aws-cognito",
159+
title: "AWS Cognito",
160+
icon: "logo-aws-cognito.png",
161+
path: "/authentication/custom-connections/aws-cognito",
162+
},
163+
{
164+
key: "custom-jwt",
165+
title: "Custom JWT",
166+
icon: "logo-jwt.png",
167+
path: "/authentication/custom-connections/custom-jwt",
168+
},
169+
],
170+
},
171+
];
172+
173+
<Tiles tileGroups={JWTLoginSetup} />
63174

64175
This is ideal for applications that already have a secure identity layer and want to enhance it with
65176
non-custodial wallet generation and key management.

docs/authentication/basic-logins/email-passwordless.mdx

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -13,12 +13,31 @@ seamlessly using a one-time passcode (OTP) sent to their email address or phone
1313
passwordless authentication simplifies the onboarding process, removes friction for end users, and
1414
expands accessibility—especially in regions where social login options may be limited.
1515

16+
<div style={{ display: "flex", margin: "20px 0", justifyContent: "center" }}>
17+
<img
18+
src={EmailPasswordlessOnboarding}
19+
alt="Email Passwordless Onboarding"
20+
style={{
21+
maxWidth: "600px",
22+
border: "1px solid #eaeaea",
23+
borderRadius: "8px",
24+
boxShadow: "0 2px 6px rgba(0, 0, 0, 0.1)",
25+
}}
26+
/>
27+
</div>
28+
29+
## Set Up a Custom Email Connection
30+
1631
:::success Enable on Dashboard
1732

1833
To use this feature, developers must first enable `Email Passwordless` from the Social Connections
1934
section in the [Web3Auth Dashboard](https://dashboard.web3auth.io).
2035

21-
<div style={{ display: "flex", margin: "20px 0" }}>
36+
> By default, Web3Auth uses its own pre-configured credentials for email login.
37+
38+
:::
39+
40+
<div style={{ display: "flex", margin: "20px 0", justifyContent: "center" }}>
2241
<img
2342
src={EmailPasswordlessToggle}
2443
alt="Email Passwordless Toggle"
@@ -30,12 +49,6 @@ section in the [Web3Auth Dashboard](https://dashboard.web3auth.io).
3049
/>
3150
</div>
3251

33-
> By default, Web3Auth uses its own pre-configured credentials for email login.
34-
35-
:::
36-
37-
## Set Up a Custom Email Connection
38-
3952
For enhanced control and branding, developers are encouraged to configure a custom email connection.
4053
Follow these steps:
4154

@@ -45,7 +58,7 @@ Follow these steps:
4558
4. Enter your custom `Auth Connection ID`.
4659
5. Click `Add Connection` to complete the setup.
4760

48-
<div style={{ display: "flex", margin: "20px 0" }}>
61+
<div style={{ display: "flex", margin: "20px 0", justifyContent: "center" }}>
4962
<img
5063
src={EmailPasswordlessAddConnection}
5164
alt="Email Passwordless Add Connection"
@@ -59,19 +72,6 @@ Follow these steps:
5972

6073
## Usage
6174

62-
<div style={{ display: "flex", margin: "20px 0" }}>
63-
<img
64-
src={EmailPasswordlessOnboarding}
65-
alt="Email Passwordless Onboarding"
66-
style={{
67-
maxWidth: "600px",
68-
border: "1px solid #eaeaea",
69-
borderRadius: "8px",
70-
boxShadow: "0 2px 6px rgba(0, 0, 0, 0.1)",
71-
}}
72-
/>
73-
</div>
74-
7575
```tsx title="web3authContext.tsx"
7676
import { WALLET_CONNECTORS, WEB3AUTH_NETWORK } from "@web3auth/modal";
7777
import { type Web3AuthContextConfig } from "@web3auth/modal/react";

docs/authentication/basic-logins/external-wallets.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,15 @@ seamlessly using a one-time passcode (OTP) sent to their email address or phone
1212
passwordless authentication simplifies the onboarding process, removes friction for end users, and
1313
expands accessibility—especially in regions where social login options may be limited.
1414

15+
## Enable External Wallets
16+
1517
:::success Enable on Dashboard
1618

1719
To enable this feature, developers must first activate `External Wallets` from the Social
1820
Connections section in the [Web3Auth Dashboard](https://dashboard.web3auth.io).
1921

22+
:::
23+
2024
<div style={{ display: "flex", margin: "20px 0" }}>
2125
<img
2226
src={ExternalWalletsToggle}
@@ -29,14 +33,16 @@ Connections section in the [Web3Auth Dashboard](https://dashboard.web3auth.io).
2933
/>
3034
</div>
3135

32-
:::
33-
34-
## Enable External Wallets
35-
3636
To choose which external wallets to enable, click the `Settings` icon next to the **External
3737
Wallets** toggle in the Social Connections section of the
3838
[Web3Auth Dashboard](https://dashboard.web3auth.io).
3939

40+
:::note
41+
42+
Metamask Wallet is enabled by default and cannot be disabled.
43+
44+
:::
45+
4046
A wide range of wallets are available to choose from.
4147

4248
<div style={{ display: "flex", margin: "20px 0" }}>

0 commit comments

Comments
 (0)