> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getpara.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Social Login
> Instructions for implementing social login with the ParaSwift SDK.
export const DemoCallout = ({variant = "card", title = "Interactive Demo", description = "Try the live demo to explore authentication flows and customize your modal before integrating."}) => {
if (variant === "subtle") {
return
;
};
export const Link = ({href, label, newTab = false}) => {
const [isHovered, setIsHovered] = useState(false);
return setIsHovered(true)} onMouseLeave={() => setIsHovered(false)}>
{label}
;
};
## Overview
Social login (OAuth) is integrated directly into Para's unified authentication experience. This guide covers how to implement social login alongside email and phone authentication in a single, streamlined interface. Para supports Google, Apple, and Discord as OAuth providers.
Have your own OpenID Connect provider? Once you [set up Custom OIDC](/v3/general/developer-portal-custom-oidc), use `CUSTOM_OIDC` as the OAuth method — it works like any other provider.
## Prerequisites
## Prerequisites
To use Para, you need an API key. This key authenticates your requests to Para services and is essential for
integration.
Don't have an API key yet? Request access to the to create API keys, manage billing, teams, and more.
You must have the ParaSwift SDK installed and configured in your project. If you haven't done this yet, please refer to our .
## Unified Authentication Approach
Para's recommended approach is to integrate social login directly into your main authentication view alongside email and phone options. This provides users with all authentication methods in one place.
### Environment Setup
Ensure your authentication view can access the system authentication helpers and register the default web session once:
```swift theme={null}
@Environment(\.webAuthenticationSession) private var webAuthenticationSession
@Environment(\.authorizationController) private var authorizationController
var body: some View {
VStack { /* auth UI */ }
.task {
paraManager.setDefaultWebAuthenticationSession(webAuthenticationSession)
}
}
```
## Implementing Social Login
### Integration with Unified Auth View
Social login should be integrated alongside email and phone authentication in your main authentication view. Here's a basic example:
```swift theme={null}
import SwiftUI
import ParaSwift
import AuthenticationServices
struct AuthView: View {
@EnvironmentObject var paraManager: ParaManager
@Environment(\.webAuthenticationSession) private var webAuthenticationSession
@Environment(\.authorizationController) private var authorizationController
@State private var emailOrPhone = ""
var body: some View {
VStack(spacing: 20) {
// Email/Phone input
TextField("Email or phone number", text: $emailOrPhone)
.textFieldStyle(RoundedBorderTextFieldStyle())
Button("Continue") {
handleEmailPhoneAuth()
}
.buttonStyle(.borderedProminent)
// Divider
Text("or")
.foregroundColor(.gray)
// Social login buttons
Button("Continue with Google") {
handleSocialLogin(.google)
}
Button("Continue with Apple") {
handleSocialLogin(.apple)
}
Button("Continue with Discord") {
handleSocialLogin(.discord)
}
}
.padding()
.task {
paraManager.setDefaultWebAuthenticationSession(webAuthenticationSession)
}
}
}
```
### Handling Social Login
Implement the social login handler that manages the OAuth flow:
```swift theme={null}
private func handleSocialLogin(_ provider: OAuthProvider) {
Task {
do {
try await paraManager.handleOAuth(
provider: provider,
authorizationController: authorizationController
)
// OAuth flow completed successfully
// User is now logged in and wallets are available
print("User authenticated successfully")
// Navigate to authenticated area of your app
} catch {
// Handle OAuth error
print("OAuth error: \(error.localizedDescription)")
}
}
}
```
The `handleOAuth` method:
* Authenticates the user with the OAuth provider
* Checks if a Para account exists for the user
* For new users: creates a Para account and sets up a passkey automatically
* For existing users: logs them in directly
* Returns nothing on success, throws errors on failure
* Uses the default `WebAuthenticationSession` you registered; pass a custom one only if you need to override it for a specific call.
### Creating Social Login Buttons
Create buttons for each OAuth provider:
```swift theme={null}
// Google Login
Button("Continue with Google") {
handleSocialLogin(.google)
}
// Apple Login
Button("Continue with Apple") {
handleSocialLogin(.apple)
}
// Discord Login
Button("Continue with Discord") {
handleSocialLogin(.discord)
}
```
## Available OAuth Providers
The ParaSwift SDK supports the following OAuth providers:
* Google (`.google`)
* Apple (`.apple`)
* Discord (`.discord`)
## Key Points
* Social login is handled through the `handleOAuth` method
* The method manages the complete OAuth flow including user authentication, Para account creation/lookup, and passkey setup for new users
* For existing users, it logs them in directly
* The SDK supports Google, Apple, and Discord as OAuth providers
* Social login should be integrated with email/phone authentication for a unified experience
## Next Steps
After implementing social login, you might want to:
1. for new users
2. for session management
3. as an additional security layer