capgo/capacitor-social-login

모든 소셜 로그인 플러그인.

개요

@capgo/capacitor-social-login 웹, iOS, Android을 위한 모든-in-one 소셜 인증 플러그인입니다.

구현하는 기능은 다음과 같습니다.

Google Sign-In with Android Credential Manager
Sign in with Apple, Android에서 OAuth를 포함합니다.
Facebook 로그인에 사용하는 현재 Facebook SDK
Twitter/X를 통해 OAuth 2.0을 사용합니다.
일반 OAuth2 및 OIDC 제공자, GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak 및 기타 호환 서버를 포함합니다.

이 플러그인은 또한 Ionic Appflow Social Login 또는 Ionic Auth Connect로 이동하는 앱의 Capgo 마이그레이션 경로입니다.

포크 및 마이그레이션 노트

이 플러그인은 @codetrix-studio/capacitor-google-auth. The original package is effectively archived, so Capgo maintains this plugin as the supported replacement.

이 플러그인은 지원되는 대체품으로 유지합니다. @codetrix-studio/capacitor-google-authIonic Auth Connect로 마이그레이션 중인 경우, 의 내장 .

을 사용하세요. legacy Google Auth 마이그레이션 가이드 SocialLoginAuthConnect __CAPGO_KEEP_0__ auth0, azure, cognito, okta의 wrapper onelogin , 및

Keycloak 설정

제목 ‘호환성’	Capacitor compatibility	__CAPGO_KEEP_0__ 호환성
유지보수됨	v8.x	예
v7.x	v7.x	원하는 시점에
v6.x	v6.x	아니요
v5.x	v5.x	아니요

Capacitor의 주요 버전을 따르는 이 플러그인의 주요 버전은 Capacitor의 주요 버전을 사용합니다. 예를 들어, Capacitor 8과 함께 플러그인 v8을 사용합니다. 가장 최근의 주요 버전만 활성으로 유지됩니다.

동영상_walkthrough

플러그인 설정 및 로그인 흐름을 빠르게 시연해 보세요.

기본 기능

initialize - 플러그인을 초기화합니다.
login - 선택한 제공자와 로그인합니다.
logout - 로그아웃합니다.
isLoggedIn - isLoggedIn.

공개 API

메서드	설명
`initialize`	플러그인을 초기화합니다.
`login`	선택한 제공자로 로그인합니다.
`logout`	로그아웃합니다.
`isLoggedIn`	로그인 상태 여부.
`getAuthorizationCode`	현재 인증 code을 가져옵니다.
`refresh`	액세스 토큰을 갱신합니다.
`refreshToken`	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>` 모바일에서, 앱을 열 수 있는 리다이렉트 URI를 등록해야 합니다. 예를 들어: `myapp://oauth_callback/` 그리고 앱의 info.plist에 등록해야 합니다: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` 그리고 AndroidManifest.xml 파일에 등록해야 합니다: `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>` .

실질적인 출처

이 참조는 src/definitions.ts 내 capacitor-social-login.

Capgo-사회 로그인과 같은 경우 @capgo/capacitor-social-login Capgo-사회 로그인을 사용하여 인증 및 계정 흐름을 계획하고 연결하세요. Using @capgo/capacitor-social-login for the native capability in Using @capgo/capacitor-social-login, @capgo/capacitor-passkey for the implementation detail in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric Capgo의 @capgo/capacitor-native-biometric 구현 세부 사항 두 단계 인증 Capgo의 두 단계 인증 구현 세부 사항, 그리고 SSO (기업) Capgo의 SSO (기업) 구현 세부 사항