개요
개요 섹션@capgo/capacitor-social-login 웹, iOS, Android를 위한 모든-in-one 소셜 인증 플러그인입니다.
구현:
- Google Sign-In with Android Credential Manager
- Apple과 함께 Sign in, Android에서 OAuth
- Facebook 로그인, 현재 Facebook SDK
- Twitter/X를 통한 OAuth 2.0
- Generic OAuth2 및 OIDC 제공자, GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak 및 기타 호환 서버
Ionic Appflow Social Login 또는 Ionic Auth Connect로 이동하는 앱의 Capgo 마이그레이션 경로도 포함됩니다.
포크 및 마이그레이션 노트
포크 및 마이그레이션 노트 섹션이 플러그인은 @codetrix-studio/capacitor-google-auth의 fork로 시작되었습니다. 원래 패키지는 사실상 보관되어 있으므로 Capgo는 이 플러그인을 지원하는 대체품으로 유지합니다.
이전 버전의 @codetrix-studio/capacitor-google-auth, legacy Google Auth 마이그레이션 가이드를 따르세요. Capacitor에서 Ionic Auth Connect로 마이그레이션하는 경우, 내장된.
wrapper를 사용하여 SocialLoginAuthConnect , 및 auth0, azure, cognito, oktaprovider 이름을 사용하세요. onelogin Ionic Auth Connect 마이그레이션
호환성
호환성| 플러그인 버전 | Capacitor 호환성 | 유지보수 |
|---|---|---|
| v8.x | v8.x | 네 |
| v7.x | v7.x | 요구 시 |
| v6.x | v6.x | No |
| v5.x | v5.x | No |
Capacitor의 주요 버전을 따라하는 이 플러그인의 주요 버전입니다. 예를 들어, Capacitor 8을 사용하여 플러그인 v8을 사용합니다. 가장 최근의 주요 버전만이 활성으로 유지됩니다.
비디오 워크숍
비디오 워크숍 섹션이 플러그인 설정 및 로그인 흐름을 빠르게 시연해 보세요.
기본 기능
기본 기능 섹션initialize- 플러그인을 초기화합니다.login- 선택된 제공자와 로그인합니다.logout- 로그아웃합니다.isLoggedIn- 로그인 상태 여부.
공개 API
API라는 제목의 공개 섹션| 메서드 | 설명 |
|---|---|
initialize | 플러그인을 초기화합니다. |
login | 선택된 제공자와 로그인합니다. |
logout | 로그아웃합니다. |
isLoggedIn | 로그인 상태 여부. |
getAuthorizationCode | 현재 인증 code을 가져오세요. |
refresh | 액세스 토큰을 갱신하세요. |
refreshToken | 내장 OAuth2 제공자에 대한 OAuth2 리프레시 토큰 헬퍼입니다. |
handleRedirectCallback | 웹 전용: OAuth 리다이렉트 콜백을 처리하고 파싱된 결과를 반환하세요. |
decodeIdToken | JWT (일반적으로 OIDC ID 토큰)를 클레임으로 디코딩하세요. |
getAccessTokenExpirationDate | 액세스 토큰 만료 시간 스탬프 (밀리초 시대)를 ISO 날짜 문자열로 변환하세요. |
isAccessTokenAvailable | 액세스 토큰이 사용 가능한지 확인하세요 (비어 있지 않음). |
isAccessTokenExpired | 액세스 토큰이 만료되었는지 확인하세요. |
isRefreshTokenAvailable | 리프레시 토큰이 사용 가능한지 확인하세요 (비어 있지 않음). |
providerSpecificCall | 제공자별 호출을 실행하세요. |
getPluginVersion | 자연 Capacitor 플러그인 버전을 가져오세요. |
openSecureWindow | 보안된 창을 열어 OAuth2 인증을 시작하세요. 웹에서, 리다이렉트된 페이지에 code이 포함되어야 하며, 앱으로 리다이렉트된 URL을 보급 채널을 통해 전송할 수 있습니다. 예를 들어: html <html> <head></head> <body> <script> const searchParams = new URLSearchParams(location.search) if (searchParams.has("code")) { new BroadcastChannel("my-channel-name").postMessage(location.href); window.close(); } </script> </body> </html> For mobile, you should have a redirect uri that opens the 앱, something like: myapp://oauth_callback/ And make sure to register it in the 앱의 info.plist: xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array> And in the AndroidManifest.xml file: xml <activity> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:host="oauth_callback" android:scheme="myapp" /> </intent-filter> </activity> . |
Source Of Truth
Section titled “Source Of Truth”This reference is synced from src/definitions.ts in capacitor-social-login.
Keep going from @capgo/capacitor-social-login
Section titled “Keep going from @capgo/capacitor-social-login”If you are using @capgo/capacitor-social-login 인증 및 계정 흐름을 계획하고 연결하세요. @capgo/capacitor-social-login을 사용하여 @capgo/capacitor-social-login의 원시 기능을 사용하여 @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 정보를 사용하여 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric의 구현 세부 정보를 사용하여 두 단계 인증 두 단계 인증의 구현 세부 정보를 사용하여 SSO (기업) SSO (기업)의 구현 세부 정보를 사용하여